Agent Skills
返回列表
OpenClaw 网关诊断修复

OpenClaw 网关诊断修复

IT 运维与安全 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_15292d5a/yjkj-doctor-call。

技能介绍

要解决什么问题

OpenClaw 网关一旦挂掉或配置异常,常见症状是链路不通、openclaw doctor 长时间卡住,而运维又未必能随时介入。Doctor Call 把「先看清楚、再动手修、必要时自己拉起来」收成一套可重复执行的流程,而不是每次手工拼命令。

技能如何工作

子命令分工明确:

  • check:优先执行 openclaw doctor --lint 做完整诊断;若 doctor 挂起,则退回到基础系统检查,避免排查本身卡死。
  • fix:先判断网关是否在跑;若未运行则立即重启,再执行 openclaw doctor --repair 处理配置类问题。
  • status:汇总 OpenClaw 进程、磁盘与内存占用,以及是否已启用自动重启。
  • setup / remove:安装或移除基于 systemd 的定时自愈;setup 会按小时触发 doctor-call fix,在网关崩溃且无法联系维护者时仍可尝试恢复。

自动重启(文档强调的核心能力)通过 systemd 服务与定时器实现:周期性检测网关状态,宕机时用 openclaw gateway start 拉起;配合 doctor --repair 处理配置错误。默认 check / status 为只读;只有显式调用 fix 才会改系统状态,并会报告发现与执行结果;修复失败时会给出可手工执行的命令,而不是静默失败。

适用边界与注意点

技能面向 OpenClaw 网关 运维场景,依赖本机已安装 openclaw CLI 与(若使用自愈)systemd。它不能替代对业务层故障的根因分析;若 doctor 本身或底层环境损坏,仍可能需要人工介入。启用 setup 后,定时任务会在机器上长期运行,移除前请用 remove 清理,避免与既有运维策略冲突。

使用场景

  • 边缘节点上 OpenClaw 网关异常退出,维护者暂时无法登录时,用 `setup` 让 systemd 按小时跑 `fix` 尝试拉起并修配置。
  • 变更网关配置或升级 OpenClaw 后,先跑 `check` 执行 `openclaw doctor --lint`;若 doctor 卡住则依赖降级系统检查继续排查。
  • 值班交接或故障复盘前,用 `status` 确认网关进程、磁盘与内存占用,以及自动重启是否已启用。
  • 确认网关未在运行或链路中断时,显式调用 `fix`:先重启网关再跑 `openclaw doctor --repair`,并阅读输出中的手工补救命令。

适合人员

  • 在树莓派或无头服务器上自托管 OpenClaw 网关、崩溃时无法随时到场、希望靠定时自愈减少人工介入的维护者。
  • 负责 OpenClaw 网关稳定性、改配置或重启前习惯用只读 `check`/`status` 摸清现状的运维工程师。
  • 已为网关环境配置 systemd、需要清楚 `setup` 与 `remove` 对定时任务影响、避免与既有运维策略冲突的基础设施同学。
  • 远程排查时 `openclaw doctor` 经常挂起,需要技能在 `check` 中自动降级到基础系统检查、避免排查流程卡死的值班人员。