核心功能
claw-doctor 是一款专为 OpenClaw 部署设计的本地诊断工具，执行覆盖 11 个关键维度的深度健康检查，包括：安装版本验证、配置一致性审计、会话维护策略、模型上下文对齐、会话健康度、定时任务状态、安全 misconfiguration、资源使用统计、网关进程健康、系统指令 Token 预算等。
显著优点
1. 全面性：11 个诊断模块覆盖从安装到运行的完整生命周期，单次扫描即可定位配置漂移、会话膨胀、安全漏洞等隐蔽问题
2. 结构化输出：CRITICAL/WARNING/INFO 三级 severity 分级，配合具体修复命令，降低运维决策成本
3. 交互式修复：支持一键批量修复 WARNING 及以下级别问题，CRITICAL 问题单独确认，平衡效率与安全
4. Token 预算意识：独创的系统指令健康检查（Section 11），量化静态 prompt 占用的上下文窗口比例，预防运行时截断
5. 安全设计：强制敏感信息脱敏（API key 仅显示前8位），所有修改操作需用户显式确认
潜在局限
- 平台限制：仅支持 macOS/Linux，Windows 环境无法运行
- 依赖前置：要求本地已安装
openclaw与jq二进制 - 只读优先：除用户确认外不自动修改任何文件，某些场景下需手动执行建议命令
- 无网络诊断：纯本地工具，不验证远程网关可达性或 API 配额状态
适用人群
- 长期运行的 OpenClaw 生产环境管理员
- 遇到「会话莫名其妙丢失」「上下文被截断」「定时任务堆积」等疑难杂症的进阶用户
- 需要安全审计或迁移前健康评估的运维人员
常规风险
- 误报可能：某些 WARNING（如
requireMention: false）可能是业务需求所需，需人工判断 - 修复副作用：批量清理 orphan session 文件前建议备份，尽管工具会 dry-run 预览
- Token 计算误差：系统指令 Token 估算基于字符数近似，实际因 tokenizer 差异可能存在 ±10% 偏差