OpenClaw 汉化版更新检测插件

检测 OpenClaw 汉化版 更新并支持一键升级。

功能特点

• 🔍 自动检测 - 启动时自动检查最新版本
• 📊 版本对比 - 显示当前版本与最新版本对比
• 🚀 一键升级 - 支持命令行直接升级
• 🐳 Docker 智能提示 - 检测 Docker 环境并给出正确升级方式
• ✅ 全平台支持 - Windows / Linux / macOS

安装

npm install @qingchencloud/openclaw-updater

或使用 pnpm / yarn:

pnpm add @qingchencloud/openclaw-updater
yarn add @qingchencloud/openclaw-updater

使用方法

自动检测

安装插件后，OpenClaw 启动时会自动检测更新：

[更新检测] 发现新版本！
  当前版本: v2026.2.1-zh.1 (全局安装)
  最新版本: v2026.2.5-zh.1
  
  运行以下命令升级:
  npm update -g @qingchencloud/openclaw-zh

手动检查

使用 /update 命令手动检查更新：

/update

查看当前版本

使用 /version 命令查看当前安装的版本：

/version

输出示例：

OpenClaw 汉化版: v2026.2.1-zh.1 (全局安装)

升级方式

npm 安装用户

# 全局安装
npm update -g @qingchencloud/openclaw-zh

# 本地安装
npm update @qingchencloud/openclaw-zh

Docker 用户

# 拉取最新镜像
docker pull ghcr.io/1186258278/openclaw-zh:latest

# 重新创建容器
docker-compose down
docker-compose up -d

配置选项

| 选项 | 类型 | 默认值 | 说明 | |------|------|--------|------| | autoCheck | boolean | true | 启动时自动检查更新 | | checkInterval | number | 24 | 自动检查间隔 (小时) |

配置示例

# 禁用自动检查
openclaw config set plugins.openclaw-updater.autoCheck false

# 设置检查间隔为 12 小时
openclaw config set plugins.openclaw-updater.checkInterval 12

AI 工具

本插件注册了两个 AI 可调用的工具：

| 工具名 | 功能 | |--------|------| | check_openclaw_update | 检测是否有新版本 | | update_openclaw | 执行升级操作 |

常见问题

Q: 为什么显示权限不足？

全局安装的包升级可能需要管理员权限：

• Windows: 使用管理员权限运行终端
• Linux/macOS: 使用 sudo npm update -g @qingchencloud/openclaw-zh

Q: Docker 容器内如何升级？

Docker 容器内无法直接升级，需要拉取新镜像并重建容器。插件会自动检测 Docker 环境并给出正确提示。

Q: 升级后需要重启吗？

是的，升级完成后需要重启 OpenClaw 以使更新生效。

相关链接

• OpenClaw 汉化版
• 晴辰导航

晴辰天下 - 让 AI 更懂中文