2.1 平台选型与环境要求
本节先解决两个问题：
- 我该选哪个平台安装 OpenClaw？
- 我的机器和环境是否满足最低要求？
不同平台优缺点对比
| 平台 | 优点 | 缺点 | 推荐人群 |
|---|---|---|---|
| macOS | 体验稳定，安装路径最顺滑 | 仅苹果设备可用 | 个人开发者、长期本机使用 |
| Windows（原生） | 易上手，PowerShell 可直接安装 | 兼容性仍在持续改进 | 仅想快速试用的用户 |
| Windows + WSL2 | 官方推荐，稳定性与兼容性更好 | 首次要配置 WSL2 与 systemd | Windows 主力用户（推荐） |
| Linux（本机） | 可控性高，便于服务化运行 | 需要命令行基础 | 开发者、进阶用户 |
| Docker | 环境隔离，便于迁移与复现 | 资源与运维复杂度较高 | 团队、容器化场景 |
| Linux 服务器/VPS | 24x7 在线，远程访问方便 | 需要网络与安全配置经验 | 长期在线、多人共享 |
新手推荐顺序
- macOS 原生安装
- Windows 优先 WSL2
- Linux 原生安装
- Docker / VPS（有明确运维诉求再选）
系统版本最低要求与推荐
| 项目 | 最低要求 | 推荐 |
|---|---|---|
| Node.js | 22.16+ | 24.x |
| 操作系统 | macOS / Windows / Linux | 近两年仍维护版本 |
| Windows 方案 | 原生可用 | WSL2 更推荐 |
| Docker | Docker Engine/Desktop + Compose v2 | 同时具备 4GB+ 可用内存更稳 |
运行环境最低要求
必需条件
- 一个可用模型供应商的 API Key（onboarding 会引导配置）
- 网络可访问模型供应商 API
- 终端可正常执行
curl与npm
资源建议
| 场景 | 最低建议 | 推荐 |
|---|---|---|
| 本机（macOS/Windows/WSL2/Linux） | 2 核 CPU / 4GB 内存 / 10GB 可用磁盘 | 4 核 CPU / 8GB 内存 / 20GB+ 可用磁盘 |
| Docker 构建 | 2GB 内存（更低可能 OOM） | 4GB+ 内存、SSD |
| VPS | 1 vCPU / 2GB 内存 | 2 vCPU / 4GB+ 内存 |