Agent Skills
返回列表
OpenClaw 升级助手

OpenClaw 升级助手

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_22ea8151/openclaw-update。

技能介绍

要解决的问题

OpenClaw 升级不只是换 npm 包：旧配置可能在 2026.7.1 的 schema 收紧后暴露问题，gateway 也可能卡在 LaunchAgent installed but not loaded。手动启动会留下 PPID 不等于 1 的孤儿进程，KeepAlive 有时只在看状态时显得正常。

技能如何工作

它把升级组织成可验证的闭环：先做 升级前健康基线，再检查版本、备份到 ~/backups/pre-upgrade/、执行升级，然后运行 openclaw doctor --fix，并处理 schema 违规和插件工具名冲突。

关键边界是 launchd 接管：openclaw gateway install --force 只写 plist，不会注册服务；技能会显式执行 launchctl load -w，再验证 Runtime: running、Listening: *:18789 和父进程为 1。最后通过 KeepAlive 破坏性测试 确认关闭终端或进程退出后仍能自动拉起。

适用边界与注意点

仅限 macOS 和 OpenClaw 9.x 及以上版本，依赖 launchd 与可解析的 openclaw / npm 工具链。备份失败、npm install 失败或出现非临时性 critical error 时应停止，不强行继续。修改 models.json 等配置时，优先使用 openclaw config set，避免 gateway 重启后回滚文件编辑。

使用场景

  • 在 macOS 上把 OpenClaw 从 9.x 升到最新版本，并确认 gateway 由 launchd 接管。
  • 升级后处理 models.json schema 报错和 mem9 与 memory-core 工具名冲突。
  • 备份当前 OpenClaw 状态并跑 doctor 自动修复，避免脏配置被升级放大。
  • 验证 KeepAlive 能在 gateway 进程被 kill 后自动拉起，确保关终端不中断服务。

适合人员

  • 维护本地 OpenClaw gateway 的 macOS 工程师，需要在升级后确认 launchd 接管和 KeepAlive 可靠。
  • 处理 OpenClaw 配置漂移的 IT 运维，需要在升级前后跑 doctor 并清理 schema 或插件冲突。
  • 管理 launchd 服务的桌面自动化工程师，需要避免孤儿进程和 plist 未加载导致手动启动。
  • 升级 OpenClaw 后排查 memory-core 被 mem9 阻塞的 AI 应用负责人，需要恢复 memory_search 工具。