Skip to content

安装与 Onboarding 深入指南

目标

把“能跑起来”升级为“可稳定运维”的安装方案,并明确不同环境下推荐路径。

官方优先顺序

  1. 安装脚本(推荐)
  2. openclaw onboard --install-daemon
  3. openclaw gateway status 验证服务状态
  4. openclaw dashboard 验证控制面可用

参考:

安装路径选择

路径 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 当成上线里程碑的一部分,形成验收清单。
  • 明确“哪些能力首发上线,哪些能力后续灰度”。