openclaw-doctor

用途

OpenClaw Doctor 是一个综合诊断审计技能，用于对 OpenClaw 基础设施进行“智能体对智能体”的健康检查。当被要求检查系统健康、诊断问题或审计 OpenClaw 子系统时使用。它会运行覆盖 10 个领域的完整审计，将每一项发现按严重程度分类，并生成带有可执行修复建议的结构化报告。

该技能为只读性质——绝不应用修复，只推荐修复。

主要能力

审计覆盖以下 10 个领域：

Gateway Health（网关健康）：检查网关服务是否加载、运行、PID 存活；延迟是否低于 500ms；版本是否为最新（落后超过 5 个版本为 WARN，未运行为 CRITICAL）；端口 18789 是否响应，是否存在“Address already in use”。
Security（安全）：运行深度安全审计；检查配置文件权限（应为 600，644 为 CRITICAL）；凭据/状态目录应为 700；API 密钥是否硬编码在配置中而非环境变量；网关令牌认证是否启用（无认证为 WARN）。
Channels（通道）：逐通道检查启用/配置/运行/探测是否通过；已配置通道探测失败为 CRITICAL；完全没有通道为 WARN；DM 策略为 open 还是 pairing（open 为 INFO）。
Auth & Models（认证与模型）：主模型探测是否成功（失败为 CRITICAL）；是否配置回退模型（无则 WARN）；是否配置图像模型（无则 WARN）；子智能体模型是否设置为更便宜的模型（与主模型相同为 INFO）；单一提供商、无多样性为 INFO。
Memory System（记忆系统）：索引健康（dirty 标志、chunk 数量、文件数量）；flush 是否启用并设置阈值（禁用为 WARN）；dirty 索引 + 0 chunks 为 WARN（已损坏）；是否配置记忆搜索提供商（无则 WARN）；索引中的智能体名称是否与当前智能体匹配（不匹配为 WARN）。
Context & Compaction（上下文与压缩）：对照参考值评估——是否设置 pruning 模式（none 为 WARN，推荐 adaptive）；keepLastAssistants 是否设置（未设置为 INFO）；reserveTokensFloor 是否 >= 20000（低于为 WARN）；memoryFlush.softThresholdTokens 是否在 4000-8000 之间（超出为 INFO）。
Heartbeat & Cron（心跳与定时任务）：心跳启用但 HEARTBEAT.md 为空为 WARN（浪费 token）；心跳间隔 >= pruning TTL 为 WARN（缓存先于心跳过期）；存在任务但 cron 调度器未运行为 WARN；无心跳/无 cron 为 INFO（可能是有意为之）。
Hooks & Skills（钩子与技能）：钩子就绪数与错误数（错误为 WARN）；技能就绪/阻塞/禁用数量；插件加载与错误（错误为 WARN）；多个技能因同一缺失依赖被阻塞为 INFO。
Workspace Integrity（工作区完整性）：检查 ~/.openclaw/workspace/ 中必需文件（AGENTS.md、SOUL.md、USER.md、SESSION-STATE.md、IDENTITY.md、TOOLS.md、HEARTBEAT.md 缺失均为 CRITICAL；BOOTSTRAP.md 应不存在，存在为 WARN）；IDENTITY.md 是否填写还是模板占位符（模板为 WARN）；配置备份累积（~/.openclaw/openclaw.json.bak* 超过 5 个为 INFO）。
System & Network（系统与网络）：Tailscale 守护进程是否运行、版本是否匹配（不匹配为 WARN）；LaunchAgent 是否加载；日志目录总大小（错误日志超过 10MB 为 WARN）；.openclaw/ 总磁盘占用（超过 1GB 为 WARN）。

使用方式

快速开始：使用清单跟踪全部 10 个领域的进度；运行每个领域的命令、解读输出、分类发现；查阅 references/config-reference.md 获取推荐值；查阅 references/severity-rules.md 获取分类规则；最后呈现统一的健康报告。

审计协议：运行全部 10 个领域，收集发现，绝不提前停止——完整图景很重要。

执行准则：尽可能并行运行独立命令；注意平台差异（Linux 上使用 stat -c "%a %n" 而非 stat -f "%Lp %N"）；优雅处理失败（命令失败记为 INFO 并继续，绝不中止）；不做任何变更（绝不运行 config set、--fix、gateway restart 或任何写操作）；交叉引用参考文件。

报告模板：审计完成后呈现 OpenClaw 健康报告，包含版本、网关状态、运行时间、按严重程度（CRITICAL/WARNING/INFO/PASS）统计的摘要表、各严重程度下的发现列表（CRITICAL 和 WARNING 附带修复命令，INFO 附带建议）、增值机会，以及仅包含 CRITICAL 和 WARNING 修复的快速修复脚本。报告规则：每个领域都要出现（发现或 PASS）；CRITICAL 和 WARNING 包含修复命令；INFO 包含建议；快速修复脚本只含 CRITICAL + WARNING 修复；注明修复应使用 openclaw-admin 变更纪律。

适用场景

适用于需要检查 OpenClaw 系统健康、诊断问题或审计 OpenClaw 各子系统的场景。

限制

该技能为只读，绝不应用修复，只推荐修复。绝不运行 config set、--fix、gateway restart 或任何写操作。

技能介绍

用途

主要能力

使用方式

适用场景

限制

相关技能