OpenClaw 发展迅速（尚未 “1.0”）。像发布基础设施一样对待更新：更新 → 运行检查 → 重启（或使用 openclaw update，它会重启）→ 验证。

首选的更新路径是重新运行网站上的安装程序。它会检测现有安装，就地升级，并在需要时运行 openclaw doctor。

curl -fsSL https://openclaw.ai/install.sh | bash

注意：

• 如果您不想再次运行入门向导，请添加 --no-onboard。
• 对于 源码安装，使用：

  curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard

  仅当仓库是干净的时，安装程序才会 git pull --rebase。
• 对于 全局安装，脚本在底层使用 npm install -g openclaw@latest。
• 遗留说明：openclaw 仍然作为兼容性垫片可用。

• 了解您的安装方式：全局 (npm/pnpm) vs 从源码 (git clone)。
• 了解您的网关如何运行：前台终端 vs 受监管服务 (launchd/systemd)。
• 快照您的定制：
  • 配置：~/.openclaw/openclaw.json
  • 凭据：~/.openclaw/credentials/
  • 工作区：~/.openclaw/workspace

全局安装（任选其一）：

npm i -g openclaw@latest

pnpm add -g openclaw@latest

我们不推荐将 Bun 用于网关运行时（存在 WhatsApp/Telegram bug）。

切换更新频道（git + npm 安装）：

openclaw update --channel beta
openclaw update --channel dev
openclaw update --channel stable

使用 --tag <dist-tag|version> 进行一次性安装标签/版本。

查看 开发频道 了解频道语义和发布说明。

注意：在 npm 安装上，网关会在启动时记录更新提示（检查当前频道标签）。通过 update.checkOnStart: false 禁用。

然后：

openclaw doctor
openclaw gateway restart
openclaw health

注意：

• 如果您的网关作为服务运行，openclaw gateway restart 优于杀死 PID。
• 如果您固定在特定版本，请参阅下面的“回滚 / 固定”。

对于 源码安装 (git checkout)，首选：

openclaw update

它运行一个相对安全的更新流程：

• 需要干净的工作树。
• 切换到选定的频道（标签或分支）。
• 获取 + 变基 (rebase) 对照配置的上游（dev 频道）。
• 安装依赖，构建，构建控制 UI，并运行 openclaw doctor。
• 默认重启网关（使用 --no-restart 跳过）。

如果您通过 npm/pnpm 安装（无 git 元数据），openclaw update 将尝试通过您的包管理器更新。如果它无法检测到安装，请改用“更新（全局安装）”。

控制 UI 有 Update & Restart (RPC: update.run)。它：

1. 运行与 openclaw update 相同的源码更新流程（仅 git checkout）。
2. 写入带有结构化报告（stdout/stderr 尾部）的重启哨兵。
3. 重启网关并使用报告 ping 最后一个活动会话。

如果变基失败，网关将中止并在不应用更新的情况下重启。

从仓库检出目录：

首选：

openclaw update

手动（大致相当）：

git pull
pnpm install
pnpm build
pnpm ui:build # 首次运行时自动安装 UI 依赖
openclaw doctor
openclaw health

注意：

• 当您运行打包的 openclaw 二进制文件 (openclaw.mjs) 或使用 Node 运行 dist/ 时，pnpm build 很重要。
• 如果您在没有全局安装的情况下从仓库检出运行，请使用 pnpm openclaw ... 执行 CLI 命令。
• 如果您直接从 TypeScript 运行 (pnpm openclaw ...)，通常不需要重建，但 配置迁移仍然适用 → 运行 doctor。
• 在全局安装和 git 安装之间切换很容易：安装另一种风味，然后运行 openclaw doctor，以便将网关服务入口点重写为当前安装。

Doctor 是“安全更新”命令。它故意很无聊：修复 + 迁移 + 警告。

注意：如果您在 源码安装 (git checkout) 上，openclaw doctor 会提议先运行 openclaw update。

它通常做的事情：

• 迁移已弃用的配置键 / 旧配置文件位置。
• 审计 DM 策略并对有风险的“开放”设置发出警告。
• 检查网关健康状况并可以提议重启。
• 检测并迁移旧的网关服务（launchd/systemd；旧版 schtasks）到当前的 OpenClaw 服务。
• 在 Linux 上，确保 systemd 用户逗留 (linger)（以便网关在注销后存活）。

详情：Doctor

CLI（无论操作系统如何均可工作）：

openclaw gateway status
openclaw gateway stop
openclaw gateway restart
openclaw gateway --port 18789
openclaw logs --follow

如果您受监管：

• macOS launchd (app-bundled LaunchAgent): launchctl kickstart -k gui/$UID/bot.molt.gateway (使用 bot.molt.<profile>；旧版 com.openclaw.* 仍然有效)
• Linux systemd 用户服务: systemctl --user restart openclaw-gateway[-<profile>].service
• Windows (WSL2): systemctl --user restart openclaw-gateway[-<profile>].service
  • launchctl/systemctl 仅在服务已安装时有效；否则运行 openclaw gateway install。

运行手册 + 确切的服务标签：网关运行手册

安装一个已知良好的版本（将 <version> 替换为上一个工作版本）：

npm i -g openclaw@<version>

pnpm add -g openclaw@<version>

提示：要查看当前发布的版本，请运行 npm view openclaw version。

然后重启 + 重新运行 doctor：

openclaw doctor
openclaw gateway restart