什么是oc-doctor
OpenClaw Doctor 是一款专为本地 OpenClaw 安装环境设计的全面健康检查工具，能够对系统进行 11 个维度的深度诊断。它通过自动化脚本扫描关键配置文件、会话数据、定时任务、资源占用和安全设置，输出结构化的诊断报告，并按严重程度标记问题等级（CRITICAL、WARNING、INFO）。该工具不依赖网络请求，所有操作均在本地完成，确保用户隐私与数据安全。其核心目标是帮助用户识别并修复可能导致性能下降、功能异常或安全隐患的配置错误，从而维持 OpenClaw 的稳定高效运行。
核心功能特点
- 执行全面的 11 项健康检查，涵盖安装状态、配置一致性、会话管理、模型对齐等多个方面
- 自动检测并分析会话膨胀、模型漂移、上下文溢出等运行时问题，提供具体修复建议
- 集成系统指令文件分析，评估工作区文档对 AI 上下文窗口的占用情况，优化长期记忆效率
- 支持交互式修复模式，可批量处理警告级问题，并对关键操作进行确认提示
- 严格保护敏感信息，自动脱敏 API 密钥和令牌，避免在报告中泄露机密数据
适用场景
OpenClaw Doctor 特别适合在以下场景下使用：当用户发现 OpenClaw 响应变慢、出现意外行为或频繁报错时，可通过运行医生工具快速定位潜在原因，例如会话文件堆积过多或模型配置不匹配。对于刚完成新安装或升级的用户，建议在首次使用前执行一次全面检查，确保各组件版本兼容且配置合理。日常维护中，可将此工具作为定期巡检手段，特别是在添加了新的频道机器人或调整了 cron 任务后，用以验证系统整体健康状况。此外，当用户怀疑存在安全漏洞（如开放群组策略或未授权访问权限）时，医生工具能迅速揭示风险点并提供加固方案。无论是个人开发者还是小型团队部署，该工具都能显著降低运维门槛，提升系统可靠性。