Updating | OpenClaw 中文解释版

更新 OpenClaw 就像给你的玩具城堡添砖加瓦。在开始之前，我们先要记住三件重要的事，就像出门前要检查书包一样：

要知道你的 OpenClaw 是怎么“住”进电脑的。是像从商店买玩具一样直接安装的（这叫 global 安装），还是像自己动手拼乐高一样从代码拼起来的（这叫 from source 安装）。
要知道 OpenClaw 的“心脏”——Gateway（网关）——是怎么工作的。是你在一个黑窗口里看着它运行（foreground terminal），还是它自己像个小精灵一样在后台默默工作（supervised service）。
要给你的设置“拍个照”留作纪念。把 ~/.openclaw/openclaw.json（配置文件）、~/.openclaw/credentials/（密码钥匙包）和 ~/.openclaw/workspace（你的工作区）这三个地方的东西备份好，这样更新后如果不喜欢，还能变回来。

好啦，现在我们来学怎么更新。最简单、最推荐的方法就像重新看一遍安装说明书：

打开电脑上的“终端”黑窗口。
输入这个长长的“魔法咒语”并按回车：curl -fsSL https://openclaw.ai/install.sh | bash。这个咒语会从网上把安装脚本请下来，它会自己找到你已经安装的 OpenClaw 并帮它升级。
- 如果你不想让安装后的引导小助手再跑出来，可以在咒语后面加上 --no-onboard。
- 如果你的 OpenClaw 是自己从代码拼起来的（source install），需要用这个特别的咒语：curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard。

如果你当初是用 npm 或 pnpm 命令直接安装的（global install），可以这样更新：

在终端黑窗口里，输入 npm i -g openclaw@latest 或者 pnpm add -g openclaw@latest 其中一个命令，然后按回车。这就像告诉包管理器：“请给我最新版的 OpenClaw！”
- 注意：文档说不建议用 Bun 这个工具来运行 Gateway，因为它和 WhatsApp/Telegram 聊天时可能会有小 bug。
你还可以选择更新到不同的“频道”，就像选择看电视的儿童台、动画台一样。命令是 openclaw update --channel beta（测试版）或 openclaw update --channel dev（开发版）。默认是 stable（稳定版）。

如果你是自己从代码拼装 OpenClaw 的（source install），最好的更新方法是：

在终端里，进入你存放 OpenClaw 代码的文件夹。
输入命令 openclaw update 并按回车。这个聪明的命令会做很多事：检查你的代码是不是整洁的，切换到你想去的频道，拉取最新的代码，安装需要的零件，重新拼装，最后还会重启 Gateway。

非常重要的一步：无论你用哪种方法更新，之后都一定要请“医生”来检查一下！这个“医生”就是 openclaw doctor 命令。你只需要在终端输入它并按回车，它就会自动帮你修复小问题、搬家旧设置，并告诉你一切是否健康。这就像更新完玩具后，让爸爸检查一下螺丝有没有拧紧。

更新完了，有时候我们需要重启、停止或启动 Gateway 这个“心脏”：

如果更新后，新版本让你觉得不好用，我们可以“回到过去”，装回旧的、好用的版本：

如果你是直接安装的（global），就用 npm i -g openclaw@<旧版本号> 或 pnpm add -g openclaw@<旧版本号>，记得把 <旧版本号> 换成你知道能用的那个数字。
如果你是自己拼代码的（source），可以用命令回到某个日期的样子，比如 git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"（这就像坐时光机回到2026年元旦那天），然后别忘了运行 pnpm install 和 pnpm build 重新拼装。

最后，如果你在更新时被卡住了，别着急：