{"id":171,"date":"2026-03-21T22:47:20","date_gmt":"2026-03-21T14:47:20","guid":{"rendered":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/install-updating\/"},"modified":"2026-03-21T23:23:49","modified_gmt":"2026-03-21T15:23:49","slug":"install-updating","status":"publish","type":"post","link":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/install-updating\/","title":{"rendered":"\u66f4\u65b0"},"content":{"rendered":"

更新<\/h1>\n

OpenClaw 发展迅速（尚未到”1.0″）。将更新视为发布基础设施：更新 → 运行检查 → 重启（或使用会重启的 openclaw update<\/code>）→ 验证。<\/p>\n

推荐：重新运行网站安装程序（原地升级）<\/h2>\n

首选<\/strong>的更新路径是重新运行网站上的安装程序。它会检测现有安装、原地升级，并在需要时运行 openclaw doctor<\/code>。<\/p>\n

“`bash theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
\ncurl -fsSL https:\/\/openclaw.ai\/install.sh | bash<\/p>\n

\n说明：\n\n* 如果你不想再次运行新手引导向导，添加 `--no-onboard`。\n* 对于**源码安装**，使用：\n  ```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\n  curl -fsSL https:\/\/openclaw.ai\/install.sh | bash -s -- --install-method git --no-onboard\n  ```\n  安装程序**仅**在仓库干净时才会执行 `git pull --rebase`。\n* 对于**全局安装**，脚本底层使用 `npm install -g openclaw@latest`。\n* 旧版说明：`clawdbot` 仍可作为兼容性垫片使用。\n\n## 更新之前\n\n* 了解你的安装方式：**全局**（npm\/pnpm）还是**源码**（git clone）。\n* 了解你的 Gateway 网关运行方式：**前台终端**还是**受管理服务**（launchd\/systemd）。\n* 快照你的定制内容：\n  * 配置：`~\/.openclaw\/openclaw.json`\n  * 凭证：`~\/.openclaw\/credentials\/`\n  * 工作区：`~\/.openclaw\/workspace`\n\n## 更新（全局安装）\n\n全局安装（选择一个）：\n\n```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\nnpm i -g openclaw@latest\n<\/code><\/pre>\n
“`bash  theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
\npnpm add -g openclaw@latest<\/p>\n
\n我们**不**推荐将 Bun 用于 Gateway 网关运行时（WhatsApp\/Telegram 有 bug）。\n\n切换更新渠道（git + npm 安装）：\n\n```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\nopenclaw update --channel beta\nopenclaw update --channel dev\nopenclaw update --channel stable\n<\/code><\/pre>\n
使用 --tag <dist-tag|version><\/code> 进行一次性安装指定标签\/版本。<\/p>\n
渠道语义和发布说明参见开发渠道<\/a>。<\/p>\n
注意：在 npm 安装上，Gateway 网关在启动时会记录更新提示（检查当前渠道标签）。通过 update.checkOnStart: false<\/code> 禁用。<\/p>\n
然后：<\/p>\n
“`bash  theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
\nopenclaw doctor
\nopenclaw gateway restart
\nopenclaw health<\/p>\n
\n说明：\n\n* 如果你的 Gateway 网关作为服务运行，`openclaw gateway restart` 优于杀死 PID。\n* 如果你固定在特定版本，参见下面的\"回滚\/固定\"。\n\n## 更新（`openclaw update`）\n\n对于**源码安装**（git checkout），首选：\n\n```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\nopenclaw update\n<\/code><\/pre>\n
它运行一个相对安全的更新流程：<\/p>\n