OpenClaw Docs CN

安装部署 / 栏目总览

安装部署总览

Install Overview

安装这一章先解决一件事:帮你选对路线。

这页不是具体安装教程,而是安装入口页。目标很简单:让你先判断自己该走哪条安装路线,再进入对应系统页面动手。对大多数中文用户来说,只要路线选对,后面就会顺很多。

安装入口页 10-30 分钟内跑通 中国用户路线优先
Choose First

大多数人只需要在 3 条路线里选 1 条

OpenClaw 官方安装方式很多,但对绝大多数中文用户来说,真正常用的只有下面这三条。

官方一键安装脚本 最适合新手。官方当前仍把安装脚本作为主路线,会处理 Node 检测、OpenClaw 安装,并通常进入 onboarding。
Docker 路线 适合想长期跑、放到服务器、或者不想污染本机环境的人。中国用户也常走社区 Docker-CN 方案。
源码安装 适合开发者、贡献者和想自己改代码的人。普通用户不建议把它当成第一条路线。
结论先说 如果你现在还在犹豫,优先选“官方一键安装脚本”;如果你一开始就想长期跑服务器,再看 Docker。
By Device

按你的设备和目标选安装方式

你不用先看完所有安装文档,只要先找到最像你当前情况的那一条。

我是 Mac 用户

优先看 macOS,通常是最简单的一键安装流程。

我怕把本机环境搞乱

优先看 Docker 路线,它更适合隔离环境,也更容易迁移到服务器。

Before You Install

安装前先记住 3 个关键事实

很多人卡住,不是因为不会复制命令,而是先入为主地理解错了。

Windows 不是只能用 WSL2

  • 官方也提供 PowerShell 安装脚本
  • 但官方明确强烈推荐 WSL2
  • 如果你想少踩坑,WSL2 仍然是首选

官方安装脚本通常会进入 onboarding

  • 不是每次都要额外手动补跑
  • npm / pnpm / 源码路线更常需要手动跑
  • openclaw onboard --install-daemon 更适合手动安装场景

Docker-CN 是社区增强路线

  • 它很适合中国用户
  • 但它不是官方标准安装方式
  • 使用前要看镜像来源和维护状态
Requirements

系统要求先看结论就够了

这页不展开讲细节,只保留你在选路线时最需要记住的要求。

内存 2GB 起步能用,4GB 更稳;本地跑模型、浏览器工具和多 Skill 时建议更高。
Node.js 需要 22 或更高版本。官方安装脚本一般会自动帮你处理。
Docker 如果走容器路线,需要 Docker Desktop 或 Docker Engine,以及 Compose v2。
网络 至少要能访问 openclaw.ai 和 npm;如果还要拉 GitHub 和镜像仓库,网络准备更重要。
Read Next

这一章最推荐的阅读顺序

如果你不想反复跳来跳去,安装这一章建议按这个顺序往下看。

After Install

装好以后怎么确认成功

别只看终端有没有报错,真正的成功标准是能进入可用状态。

openclaw doctor

先做基础检查,看看关键依赖和环境是不是正常。

openclaw status

看系统整体状态,确认 CLI 和运行状态是不是正常。

openclaw gateway status

如果你更想确认网关服务本身,这条命令最直接。

openclaw dashboard

只要 Dashboard 能正常打开,你就已经跨过安装关了。

Start Now

现在就按你的系统开始

如果你已经知道自己属于哪一类,直接进入对应教程,不用再在这页停留。

一句话总结

安装这一章最重要的不是命令本身,而是先选对路线。路线对了,OpenClaw 往往并不难装;路线错了,后面会一直在环境和排障里打转。