OpenClaw Update Runbook — OpenClaw 更新运行手册
v1.0.0在更新 OpenClaw 或更新后调试 OpenClaw 实例时使用。此技能充当结构化更新运行手册，重点关注网关启动、service-manager 状态、插件注册表和安装漂移、bundled-vs-npm/clawhub 插件混淆、升级过程中遗留的过时配置、通道健康状态、任务日志损坏以及日志解释更新系统为什么变慢、断开连接或半损坏。
0· 0·0 当前·0 累计
by 下载技能包
License
MIT-0
运行时依赖
无特殊依赖
安装命令
点击复制官方npx clawhub@latest install claw-update-runbook
镜像加速npx clawhub@latest install claw-update-runbook --registry https://cn.longxiaskill.com镜像同步中
技能文档
OpenClaw 更新运行手册 当 OpenClaw 主机刚刚更新、即将更新或更新后行为异常时，请使用此技能。它是一个通用的操作员运行手册，而不是特定版本的检查清单。此技能应作为一个文件夹安装，而不是作为单个文件复制。它假设 references/failure-patterns.md 文件存在于同一个技能包中的 SKILL.md 旁边。
目标不仅是让其运行，还要确定哪个层次出现了问题：
- 服务生命周期和服务管理器状态
- 主机包版本
- 插件/包兼容性
- 配置漂移
- 模型/提供者运行时
- 路由通道健康
- 任务账本健康
- 运行时性能
- 命令路径和更新通道假设
快速工作流程：
- 确立实际的起始状态。如果您通过非交互式 SSH 连接，请不要假设登录 shell PATH 可用。
- 首先找到二进制文件，例如包管理器前缀和 ~/.local/bin/openclaw，然后为审计会话导出正确的 PATH。
- 检查：
- 验证网关是否被正确管理。检查服务管理器状态、运行 PID 和 /health。
- 从 openclaw status --deep 和/或服务定义中推导服务标签/名称和网关端口，而不是猜测它们。
- 不要仅仅相信：
- 分离捆绑插件和全局安装的插件。
- 首先检查插件健康状况：
- 重要规则：如果一个功能应该被捆绑，请验证是否有过时的全局 npm 安装遮蔽它。如果一个功能没有被捆绑，请在假设配置错误之前检查 npm 和 ClawHub。
- 检查在升级过程中携带的配置是否不再有效。
- 注意：
- 如果 doctor 说一个提供者或插件未知，请检查实际配置文件，并不要假设 doctor --fix 已经完全清理。
- 将插件安装记录与磁盘上的内容进行比较。
- 检查：
- 查找：
- 在更改太多之前检查最近的网关日志。
- 读取：
- 优先检查最近的启动行和警告，包括：
- 在升级后检查运行时/任务健康状况。
- 检查：
- 成功的包更新仍然可能使系统不健康，如果过时的任务阻塞重启或使审计变红。
- 证明主要模型路由，而不仅仅是总体代理成功。
- 使用新鲜的会话 ID 运行狭窄的直接代理冒烟测试，并检查返回的元数据：
- 将状态：ok 视为不足，如果主要模型失败并且回退提供者完成了运行。
- 测试至少一个代表性的 cron 路径。
- 检查：