OpenClaw 安装指南

安装 OpenClaw:完整实用指南

这份指南帮助你在 Windows、macOS、Linux、Ubuntu 或 WSL2 上安装 OpenClaw。它聚焦安装本身:推荐安装方式、gateway 检查、安装后验证,以及安装失败时如何排查。

简体中文 View English source

托管替代方案

如果你只是想快速运行 OpenClaw,而不是维护本地机器、VPS、daemon、端口和更新流程,可以直接使用 Lobsterland 托管 OpenClaw。托管实例会预装运行环境,并提供 dashboard chat、workspace editor、skills、cron、Hosted Browser、provider auth 和用量可视化。

方法 1:installer script(推荐)

优先使用官方 installer script。它会处理 Node 检查和 onboarding 流程,是大多数个人和小团队摩擦最少的路径。安装后运行 openclaw onboard --install-daemon,再检查 gateway 是否健康。

Ubuntu 和 WSL2 安装路径

如果你搜索的是 Ubuntu 安装,通常直接使用 Linux 安装方式即可。在 Windows 上,这一般意味着使用 WSL2 里的 Ubuntu。完成安装后继续做 gateway setup,并确认 dashboard 可以连接。

方法 2:npm / pnpm install

如果你的环境已经标准化全局包管理,可以使用 npm 或 pnpm。单机快速安装优先 npm;团队已经使用 pnpm workspace 时,继续使用 pnpm 会更一致。

方法 3:从源码安装

从源码安装适合贡献者、自定义 fork 或需要本地 patch 的高级用户。普通运营场景不建议先走这条路,因为后续更新和排障成本更高。

验证 checklist

doctor:没有阻塞性的配置或 runtime 问题

status:gateway service 健康

dashboard:控制台可以打开并连接

什么时候改用托管

如果安装、daemon、browser relay、provider auth 或渠道接入已经占用太多时间,换成托管实例通常更划算:导入现有实例,保留上下文,把运维交给 Lobsterland。

Cookie 偏好设置