OpenClaw 目前仍处于快速发展阶段，在正式发布 1.0 版本之前，功能和组件都会持续更新。因此在使用过程中，定期更新、检查系统状态并确保 Gateway 网关正常运行，是维护 OpenClaw 稳定运行的重要步骤。

家兴网络整理了一套比较完整的 OpenClaw 更新与维护流程，适用于日常升级、源码安装更新以及出现问题后的回滚处理。

一、OpenClaw 更新的基本原则

在 OpenClaw 的维护流程中，可以遵循一个简单的步骤：

更新 → 检查 → 重启 → 验证

简单来说就是：

1. 更新程序

2. 运行系统检查

3. 重启 Gateway 网关

4. 确认服务状态正常

OpenClaw 官方也提供了 openclaw update 命令，可以在更新完成后自动重启服务。

二、推荐更新方式：重新运行安装脚本

最推荐的升级方式，是重新运行官方安装脚本。
安装脚本会自动检测当前系统是否已经安装 OpenClaw，并执行原地升级。

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

安装脚本会完成以下操作：

• 检测当前 OpenClaw 安装

• 自动升级程序

• 必要时运行系统检查工具 openclaw doctor

如果不希望再次运行新手引导，可以添加参数：

--no-onboard

如果你的安装方式是 源码安装，可以使用：

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

需要注意的是：

安装程序只有在 仓库没有本地修改（干净工作树） 时，才会执行 git pull --rebase。

三、更新之前建议先备份

在执行更新操作之前，建议先确认当前安装方式，并备份关键文件。

需要了解的两点：

1 安装方式

OpenClaw 可能通过以下方式安装：

• npm / pnpm 全局安装

• git clone 源码安装

2 Gateway 网关运行方式

Gateway 可能运行在：

• 前台终端

• 系统服务（systemd / launchd）

建议备份以下目录：

~/.openclaw/openclaw.json
~/.openclaw/credentials/
~/.openclaw/workspace

这些文件包含配置、凭证以及工作区数据。

四、全局安装用户的更新方法

如果 OpenClaw 是通过 npm 或 pnpm 安装，可以使用包管理器更新。

例如：

npm i -g openclaw@latest

或

pnpm add -g openclaw@latest

需要注意：

Bun 运行时目前不推荐用于 Gateway 网关，因为在 WhatsApp 和 Telegram 场景下仍然存在兼容问题。

更新完成后建议执行：

openclaw doctor
openclaw gateway restart
openclaw health

这样可以确保服务状态正常。

五、使用 openclaw update 更新

如果你是通过 源码安装（git checkout），推荐使用：

openclaw update

该命令会自动执行完整更新流程：

• 检查工作树是否干净

• 切换到指定更新渠道

• 拉取最新代码并 rebase

• 安装依赖

• 编译项目

• 构建控制 UI

• 运行 openclaw doctor

• 自动重启 Gateway 网关

如果不希望自动重启，可以使用：

--no-restart

六、从源码手动更新

如果需要手动更新源码，可以执行：

git pull
pnpm install
pnpm build
pnpm ui:build

更新完成后执行：

openclaw doctor
openclaw health

需要注意：

如果你是运行 dist 编译版本 或 openclaw.mjs，pnpm build 是必要步骤。

七、为什么一定要运行 openclaw doctor

openclaw doctor 是 OpenClaw 的系统检查工具，也是升级过程中非常关键的一步。

它主要会执行以下检查：

• 迁移旧版本配置

• 检查安全策略设置

• 检测 Gateway 网关健康状态

• 修复旧版本服务配置

• 检查 Linux systemd lingering 设置

如果系统存在潜在问题，doctor 会给出修复建议。

因此很多用户把它称为 OpenClaw 的“安全升级工具”。

八、Gateway 网关管理命令

OpenClaw 提供了一组 CLI 命令用于管理 Gateway 网关。

常见命令如下：

查看状态

openclaw gateway status

停止服务

openclaw gateway stop

重启服务

openclaw gateway restart

查看日志

openclaw logs --follow

如果 Gateway 以系统服务运行，也可以使用：

Linux：

systemctl --user restart openclaw-gateway.service

macOS：

launchctl kickstart -k gui/$UID/bot.molt.gateway

九、出现问题时如何回滚版本

在少数情况下，新版本可能与当前环境不兼容。这时可以回滚到稳定版本。

如果是全局安装：

npm i -g openclaw@<version>

或

pnpm add -g openclaw@<version>

更新完成后重新运行：

openclaw doctor
openclaw gateway restart

十、源码安装按日期回滚

如果是源码安装，可以回到某个时间点的版本。

例如：

git fetch origin
git checkout "$(git rev-list -n 1 --before="2026-01-01" origin/main)"

然后重新安装依赖：

pnpm install
pnpm build
openclaw gateway restart

如果需要恢复最新版本：

git checkout main
git pull

结语

由于 OpenClaw 仍处于持续迭代阶段，保持系统更新并定期检查服务状态非常重要。

一个比较稳妥的维护习惯是：

• 更新前备份配置

• 使用官方安装脚本升级

• 更新后运行 openclaw doctor

• 确认 Gateway 服务状态

这样可以在保证新功能可用的同时，也尽量避免运行环境出现问题。