安装与 Onboarding 深入指南
目标
把“能跑起来”升级为“可稳定运维”的安装方案,并明确不同环境下推荐路径。
官方优先顺序
- 安装脚本(推荐)
openclaw onboard --install-daemonopenclaw gateway status验证服务状态openclaw dashboard验证控制面可用
参考:
- https://docs.openclaw.ai/start/getting-started.md
- https://docs.openclaw.ai/install/index.md
- https://docs.openclaw.ai/start/onboarding-overview.md
安装路径选择
路径 A:标准安装(团队默认)
bash
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
openclaw gateway status适用:
- 新团队落地
- 希望快速统一安装方式
路径 B:npm / pnpm 安装(已具备 Node 22+)
bash
npm install -g openclaw@latest
openclaw onboard --install-daemon适用:
- 已有统一 Node 环境
- 想把安装流程并入现有脚本体系
路径 C:源码安装(贡献者/定制)
适用:
- 需要阅读源码或二次开发
- 需要实验性功能验证
Onboarding 输出检查
完成 openclaw onboard 后,至少确认:
- 网关已安装为服务并可启动
- 默认配置可通过
openclaw config读取 - 模型 Provider 已可用
- Dashboard 可访问
给开发者的建议
- 首次上线只接入一个渠道,先验证消息闭环。
- 先用最小 tool profile,别直接
full。
给产品经理的建议
- 把 Onboarding 当成上线里程碑的一部分,形成验收清单。
- 明确“哪些能力首发上线,哪些能力后续灰度”。
