选择部署方式
这个页面帮你选出最适合你环境的部署路径。不同路径的复杂度和适用场景差别很大。
决策树
你有服务器吗?
├── 有 VPS/云服务器
│ ├── 想最快上手 → VPS 5 分钟部署
│ ├── 需要隔离环境 → Docker 生产部署
│ └── 批量部署多台 → Ansible
├── 用自己的 Mac/Linux
│ ├── 日常使用 → 安装脚本 (一行命令)
│ └── 参与开发 → From Source
├── 用 Windows
│ └── WSL2 → 同 Linux 流程
└── 已有 K8s 集群
└── Kubernetes 部署方案对比
| 方案 | 启动时间 | 复杂度 | 持久化 | 适合 |
|---|---|---|---|---|
| VPS 5 分钟部署 | ~5 min | ⭐ | 原生文件系统 | 个人/小团队 |
| Docker 生产部署 | ~10 min | ⭐⭐ | 挂载卷 | 需要隔离/可复现 |
| systemd 服务 | 已含在 VPS 部署中 | ⭐ | 原生 | 开机自启 |
| Kubernetes | ~30 min | ⭐⭐⭐ | PV/PVC | 生产集群 |
| Ansible | ~15 min | ⭐⭐⭐ | 自动配置 | 多台服务器 |
| From Source | ~15 min | ⭐⭐ | Git 仓库 | 开发者/贡献者 |
系统要求
- Node.js: 24(推荐)/ 22 LTS (22.16+)
- 操作系统: macOS / Linux / Windows WSL2
- 内存: 最低 1GB(Docker 构建需 2GB+)
- 磁盘: 500MB+ (含依赖)
关键路径
| 文件/目录 | 用途 |
|---|---|
~/.openclaw/openclaw.json | 主配置文件 (JSON5) |
~/.openclaw/credentials/ | 认证凭证 |
~/.openclaw/workspace/ | 工作区(Skills、Memory、文件) |
/tmp/openclaw/ | 运行日志 |
TIP
不确定选哪个?直接看 VPS 5 分钟部署,这是最快路径。