部署方案

部署与安装

把部署视为一个顺序,而不是炫技项目:先本地安装,再用 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
下一步
配置模型栈