部署与安装
把部署视为一个顺序,而不是炫技项目:先本地安装,再用 Docker 做隔离,最后只在你真正需要长期在线时才转向云平台或 VPS。
系统要求
- 本地安装当前要求 Node.js 22 或更高版本。
- npm、pnpm、bun 都可用;macOS 用户需要先装好 Xcode Command Line Tools。
- Windows 用户强烈建议通过 WSL2 运行,而不是原生 Windows 运行时。
- 如果不是云平台自带模型套餐,最好在开始前就想清楚至少一条模型路径。
本地快速启动
建议先走 npm 全局安装路径。它最容易帮你确认运行时、onboard、守护进程,以及第一条可用模型链是否正常。
终端复制
$ npm install -g openclaw@latest
$ openclaw onboard --install-daemon
诊断、更新、备份
在去接渠道或开放访问之前,先把环境确认干净。稳定运行的前提,是你知道它能自检、能更新、也能回滚。
$ openclaw doctor
$ openclaw update --channel stable
$ openclaw backup create