OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书
查看原始文档 最近生成：2026/03/08 15:37

简要总结

Install

这页说明书是教你怎么把 OpenClaw 这个工具装到你的电脑上。它就像一个安装指南，告诉你电脑需要先有什么（比如一个叫 Node 的“引擎”），然后给你好几种安装方法，就像搭积木有不同的开始方式一样。如果你已经跟着“开始”那页做完了，那就不用看这个啦！这页主要是给想用其他方法安装，或者电脑系统比较特别的小朋友看的。

五岁小孩版解释

在开始安装之前，你的电脑需要准备好一些东西。这就像你要玩一个玩具，得先有电池一样。

  1. 你的电脑需要 Node 22 或更高版本。 Node 就像玩具的“引擎”，能让 OpenClaw 跑起来。如果你没有，后面推荐的安装脚本会帮你装上它。
  2. 你的电脑可以是苹果电脑（macOS）、Linux 电脑或者 Windows 电脑。
  3. 如果你选择从“源代码”安装，才需要 pnpm 这个工具。 这就像你要自己用零件拼装玩具，才需要特殊的螺丝刀。

要小心哦： 如果你用的是 Windows 电脑，我们非常非常建议你在一个叫 WSL2 的“小房子”里运行 OpenClaw，这样会更顺利。

怎么安装呢？我们有几种好玩的方法

最推荐的方法是用“安装脚本”，它就像一个全自动的安装机器人，能帮你检查电脑、安装 Node，还能带你完成第一次设置，特别方便！

要小心哦： 如果你是在网上租的电脑（VPS/云主机），尽量不要用别人准备好的“一键安装”图片。最好从一个干净的系统开始，然后用我们的安装机器人来装。

方法一：使用安装脚本（全自动机器人） 这个方法最简单！你只需要告诉你的电脑去一个网址拿安装脚本，然后运行它。

  • 在苹果电脑、Linux 电脑或 WSL2 里： 打开一个叫“终端”的窗口，输入一行魔法咒语：curl -fsSL https://openclaw.ai/install.sh | bash，然后按回车。
  • 在 Windows 电脑的 PowerShell 里： 打开 PowerShell，输入另一行魔法咒语：iwr -useb https://openclaw.ai/install.ps1 | iex，然后按回车。

机器人就会开始工作啦！如果你想跳过第一次的设置向导，只安装工具本身，可以在上面的咒语后面加上 --no-onboard（苹果/Linux/WSL2）或者 -NoOnboard（Windows）。

方法二：使用 npm 或 pnpm（自己动手安装） 如果你的电脑已经有 Node 22+ 了，你也可以像安装其他软件一样来安装 OpenClaw。

  • 用 npm 安装： 在终端里输入 npm install -g openclaw@latest。如果安装时遇到一个叫 sharp 的零件出错，可以试试用 SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest 这个咒语。
  • 用 pnpm 安装： 在终端里输入 pnpm add -g openclaw@latest。安装后，你可能会看到一个警告，这时需要再输入 pnpm approve-builds -g 来批准安装。

用这两种方法装好后，都别忘了运行 openclaw onboard --install-daemon 来完成第一次设置。

方法三：从源代码安装（像拼乐高一样） 这个方法适合想自己从零开始搭建，或者想帮忙改进 OpenClaw 的小朋友。步骤稍微多一点：

  1. 克隆和搭建： 先把 OpenClaw 的所有“设计图纸”（源代码）下载到你的电脑，然后搭建它。你需要依次运行 git clone、cd、pnpm install、pnpm ui:build 和 pnpm build 这几条命令。
  2. 链接命令： 让电脑在任何地方都能认识 openclaw 这个命令。运行 pnpm link --global。
  3. 运行设置向导： 最后，运行 openclaw onboard --install-daemon 来完成设置。

安装好了，我们来检查一下

安装完成后，我们来看看一切是否正常。你可以在终端里试试下面几个命令：

  • 输入 openclaw doctor，它会像医生一样检查你的电脑设置有没有问题。
  • 输入 openclaw status，看看 OpenClaw 的“大门”（网关）开没开。
  • 输入 openclaw dashboard，它会在你的浏览器里打开一个漂亮的管理页面。

如果电脑说“找不到 openclaw 命令”怎么办？

有时候安装好了，电脑却说不认识 openclaw 这个命令。这通常是因为电脑不知道去哪个文件夹找它。我们可以这样检查和修复：

  1. 先诊断一下，在终端里运行 node -v、npm -v、npm prefix -g 和 echo $PATH 这几个命令看看。
  2. 如果 npm prefix -g 告诉你的那个文件夹路径，没有出现在 $PATH 里，就需要把它加进去。
  3. 对于苹果或 Linux 电脑，打开你的 ~/.zshrc 或 ~/.bashrc 文件，加上一行：export PATH="$(npm prefix -g)/bin:$PATH"。
  4. 对于 Windows 电脑，把 npm prefix -g 命令输出的路径，添加到系统的 PATH 环境变量里。
  5. 最后，关掉终端再重新打开一个新的，或者运行 rehash (zsh) / hash -r (bash) 命令。

其他事情

这页说明书还告诉你怎么更新 OpenClaw、怎么把它搬到新电脑上，以及怎么彻底卸载它。你可以在页面底部找到这些内容的链接。