AI摘要：OpenClaw 处于快速迭代阶段，尚未发布 1.0 正式版。本文介绍了其更新流程、推荐方式、不同安装方式的更新操作，包括全局安装、源码安装等，还提及网关操作、版本回滚/固定等内容，强调更新后需执行 openclaw doctor 等步骤。

OpenClaw 目前处于快速迭代阶段（尚未发布 1.0 正式版）。建议将更新流程视为标准化的发布基建流程：执行更新 → 运行检查 → 重启服务（或直接使用自带重启机制的 openclaw update 命令）→ 验证更新结果。
推荐更新方式：重新运行网站安装程序（原地升级）

最推荐的更新路径是重新执行官网的安装脚本，该脚本会自动检测现有安装环境、完成原地升级，并在必要时运行 openclaw doctor 命令：
bash
运行
curl -fsSL https://openclaw.ai/install.sh | bash
补充说明：
若无需再次执行新手引导向导，可添加参数 --no-onboard；
针对源码安装方式，使用以下命令：
bash
运行
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard
仅当代码仓库处于干净状态时，安装程序才会执行 git pull --rebase 操作；
全局安装场景下，该脚本底层实际执行的是 npm install -g openclaw@latest 命令；
兼容说明：旧版的 clawdbot 仍可作为兼容性垫片使用。
更新前准备工作
确认安装方式：全局安装（npm/pnpm）或源码安装（git clone）；
确认网关（Gateway）运行方式：前台终端运行或受管服务运行（launchd/systemd）；
备份自定义内容：
配置文件：~/.openclaw/openclaw.json
凭证文件：~/.openclaw/credentials/
工作区目录：~/.openclaw/workspace
不同安装方式的更新操作

1. 全局安装版本更新
   选择以下任一命令执行：
   bash
   运行
   npm i -g openclaw@latest

   或

   pnpm add -g openclaw@latest
   注意：不建议使用 Bun 作为网关（Gateway）运行时环境（WhatsApp/Telegram 相关功能存在已知 Bug）。
   切换更新渠道（适用于 git + npm 混合安装）：
   bash
   运行
   openclaw update --channel beta # 测试版渠道
   openclaw update --channel dev # 开发版渠道
   openclaw update --channel stable # 稳定版渠道
   如需一次性安装指定版本 / 标签，使用：
   bash
   运行
   openclaw update --tag <dist-tag|version>
   渠道定义及发布说明可参考「开发渠道」文档。
   注意：npm 安装版本中，网关启动时会检查当前渠道标签并输出更新提示，可通过配置 update.checkOnStart: false 关闭该提示。
   更新后需执行：
   bash
   运行
   openclaw doctor # 运行健康检查与配置迁移
   openclaw gateway restart # 重启网关
   openclaw health # 验证网关健康状态
   补充说明：
   若网关以服务形式运行，优先使用 openclaw gateway restart 重启，而非直接杀死进程 PID；
   若需固定特定版本，可参考下文「回滚 / 版本固定」章节。

2. 通过 openclaw update 命令更新（推荐源码安装使用）
   源码安装（git checkout）场景下，首选以下命令：
   bash
   运行
   openclaw update
   该命令执行的是一套相对安全的更新流程：
   检查代码仓库工作树是否干净；
   切换至选定的更新渠道（标签 / 分支）；
   拉取上游代码并执行 rebase（dev 渠道默认）；
   安装依赖、构建项目、构建控制 UI，并运行 openclaw doctor；
   默认重启网关（可添加 --no-restart 参数跳过重启）。
   注意：若通过 npm/pnpm 安装（无 git 元数据），openclaw update 会尝试通过包管理器更新；若检测不到安装环境，需改用「全局安装版本更新」方式。
3. 通过控制 UI / RPC 更新
   控制 UI 提供「更新并重启」功能（对应 RPC 接口：update.run），该功能：
   执行与 openclaw update 完全一致的源码更新流程（仅适用于 git checkout 安装）；
   生成包含结构化报告（标准输出 / 错误输出尾部内容）的重启标记文件；
   重启网关并向最后活跃的会话发送更新状态 Ping 报告；
   若 rebase 操作失败，网关会终止更新流程并恢复重启（不应用本次更新）。
4. 源码手动更新（git 仓库直接操作）
   首选方式：
   bash
   运行
   openclaw update
   手动等效操作步骤：
   bash
   运行
   git pull # 拉取最新代码
   pnpm install # 安装依赖
   pnpm build # 构建项目
   pnpm ui:build # 构建控制 UI（首次运行会自动安装 UI 依赖）
   openclaw doctor # 健康检查与配置迁移
   openclaw health # 验证健康状态
   补充说明：
   若运行打包后的 openclaw.mjs 二进制文件，或通过 Node 运行 dist/ 目录，pnpm build 步骤必不可少；
   若直接从 git 仓库运行（无全局安装），CLI 命令需改为 pnpm openclaw ...；
   若直接运行 TypeScript 源码（pnpm openclaw ...），通常无需重新构建，但仍需运行 doctor 完成配置迁移；
   全局安装与 git 安装可自由切换：安装另一种方式后，执行 openclaw doctor 即可将网关服务入口重写为当前安装版本。
   必执行步骤：运行 openclaw doctor
   doctor 是保障「安全更新」的核心命令，主要执行基础检查与修复操作（逻辑简单但关键）：配置修复 + 版本迁移 + 风险警告。
   注意：源码安装（git checkout）场景下，openclaw doctor 会提示优先运行 openclaw update。
   该命令的核心功能：
   迁移已废弃的配置项、调整旧版配置文件路径；
   审计私信策略，对高风险的「开放」配置发出警告；
   检查网关健康状态，必要时提示重启；
   将旧版网关服务（launchd/systemd、旧版 schtasks）迁移至当前 OpenClaw 服务；
   Linux 系统下，确保 systemd 用户持续运行（保证登出后网关仍能存活）。
   详细功能可参考「Doctor 命令文档」。
   网关（Gateway）启停 / 重启操作
   通用 CLI 命令（全系统兼容）：
   bash
   运行
   openclaw gateway status # 查看网关状态
   openclaw gateway stop # 停止网关
   openclaw gateway restart # 重启网关
   openclaw gateway --port 18789 # 指定端口启动网关
   openclaw logs --follow # 实时查看网关日志
   受管服务方式（系统级操作）：
   macOS（launchd 服务，应用捆绑的 LaunchAgent）：
   bash
   运行
   launchctl kickstart -k gui/$UID/bot.molt.gateway
   （多配置文件场景使用 bot.molt.；旧版 com.openclaw.* 仍兼容）
   Linux/WSL2（systemd 用户服务）：
   bash
   运行
   systemctl --user restart openclaw-gateway[-].service
   注意：上述 launchctl/systemctl 命令仅在服务已安装时有效；未安装则需先执行 openclaw gateway install。
   服务配置手册及完整服务标签可参考「Gateway 网关运行手册」。
   版本回滚 / 固定（更新异常时使用）

5. 全局安装版本固定
   安装已知可用的版本（将 替换为最后正常运行的版本号）：
   bash
   运行
   npm i -g openclaw@

   或

   pnpm add -g openclaw@
   提示：执行 npm view openclaw version 可查看当前最新发布版本。
   版本安装完成后，执行以下命令：
   bash
   运行
   openclaw doctor # 配置迁移与健康检查
   openclaw gateway restart # 重启网关

6. 源码安装按日期固定版本
   如需回滚到指定日期的代码版本（示例：2026-01-01 时 main 分支的状态）：
   bash
   运行
   git fetch origin
   git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
   随后重新安装依赖并重启：
   bash
   运行
   pnpm install # 重新安装依赖
   pnpm build # 构建项目
   openclaw gateway restart # 重启网关
   若需恢复到最新版本：
   bash
   运行
   git checkout main
   git pull
   总结
   OpenClaw 更新核心逻辑：优先用官方安装脚本或 openclaw update 命令，更新后必执行 openclaw doctor + 重启网关 + 健康验证；
   不同安装方式（全局 / 源码）对应不同更新命令，源码安装需保证仓库干净，全局安装可通过包管理器指定版本；
   更新异常时可通过「固定版本号」（全局安装）或「回滚 git 提交」（源码安装）恢复，操作后需重启网关并验证。