OpenClaw 检修技师

要解决什么问题

OpenClaw 网关、插件、定时任务、模型路由和通道往往叠在同一台宿主上。症状可能是更新后全面异常、某条 cron 费用飙高、通道静默失败，或某次 openclaw gateway status 看起来正常但 agent 仍走 fallback。单靠「全量扫描」容易淹没在审计误报和历史告警里，改配置又可能误触 gateway 重启而让网内 agent 丢失续跑上下文。

技能如何工作

Claw Mechanic 把流程写成可执行的检修手册：先确认你是外部运维 agent 还是 OpenClaw 内派 agent（后者在 gateway 重启前要先安排唤醒/续跑路径），再在真实运行环境上采集小 baseline，而不是默认盯仓库 checkout。

典型 intake 会区分：用户是否有明确症状、近期变更、涉及的 agent/channel/cron/model，或指定日志。随后按 Quick Workflow 推进：

• 锁定目标：可达性、openclaw 二进制与 state 目录、非交互 SSH 的 PATH、版本与 config 路径
• 小 baseline：openclaw gateway status --deep、config validate、plugins doctor、channels status --deep、tasks audit，必要时 cron list、models status、secrets audit
• 先读日志再猜：gateway.log、gateway.err.log、按症状关键词检索 plugin/fallback/cron/secret 等
• 按子系统分支：插件与 shadowing、gateway/服务/config、模型与 SecretRef、memory/context、cron 的 lightContext、approvals、channels、secrets/security
• 只修失败层：优先 config set / Gateway config.patch；改前备份；避免无证据地升级 OpenClaw、重装插件或重写整份 openclaw.json
• 验证：不迷信单条绿灯命令，用 health、smoke、cron 列表与受影响层的检查配对证明

症状混杂或更新后问题时，可先对照 references/root-failure-taxonomy.md 归类，再按需读 references/failure-map.md；重复维护同一宿主可用 references/host-profile-template.md 沉淀非机密安装事实。

适用边界与注意点

• Focused audit 适合点名单一子系统；Full audit 适合用户明确要求、多层漂移、费用异常或安全/鉴权场景，但仍应从用户症状切入，避免变成无重点清单。
• 未经用户明确同意，不读取 raw secrets、env、session 正文或 agent workspace 内容；配置敏感改动前记录 openclaw --version，并以对应版本文档为准。
• 找不到根因时，技能要求区分「已证明健康」与「仍未证明」，给出最小 containment（例如禁用一条 cron、钉住已知良好路由），并整理可交接的红acted 证据包，而不是宣称「一切正常」。