菜单
系统诊断与修复：全面检查认证、配置、Gateway、安全、沙箱、工作区等 17 个诊断模块。当需要排查系统问题、执行自动修复或查看系统健康度时使用此技能。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
统一多通道通知工具。发送分级通知（hint/info/warning/critical），检测环境前置依赖（python3/node/go 等），查询最近通知列表。
定时任务与提醒管理：创建定时提醒、周期执行任务、管理闹钟与计划。支持 cron 表达式、固定间隔和一次性定时。当用户需要定时提醒、周期执行、计划任务或查看任务历史时触发此技能。
人设文件编辑：修改工作区的SOUL.md、USER.md、BOOTSTRAP.md文件。当用户要求更新人设、个人信息、引导配置时触发。
三省六部军团管理：实例生命周期监控、三层预算治理、熔断器控制、卡死检测。当需要查看运行中的智能体实例状态或管理军团资源时使用此技能。
多智能体编排协调（三省六部治理框架）：消息总线通信、Supervisor/Pipeline/Swarm 三种编排模式、智能体间任务交接。当需要协调多个子智能体协作完成复杂任务时使用此技能。
智能体自动触发调度（三省六部治理框架）：cron 定时触发、事件驱动触发、消息匹配触发。当需要配置子智能体的自动执行计划时使用此技能。
| name | doctor-diagnostics |
| description | 系统诊断与修复：全面检查认证、配置、Gateway、安全、沙箱、工作区等 17 个诊断模块。当需要排查系统问题、执行自动修复或查看系统健康度时使用此技能。 |
| tools | gateway, bash |
| metadata | {"category":"operations","emoji":"🩺","tree_id":"system/gateway","tree_group":"system","min_tier":"task_write","intent_priority":10,"intent_keywords":{"zh":["系统诊断","诊断问题","系统体检","排查问题","自动修复","doctor","健康检查","系统问题","出错了","不正常","排查"],"en":["diagnostics","system diagnosis","health check","troubleshooting","auto repair","doctor"]},"scene_hint":"全面系统诊断用此→只看运行状态用crabclaw status→具体配置问题用system-config→认证报错用auth-management"} |
用户遇到系统问题需要排查，或需要全面检查系统健康度时触发。
| 场景 | 工具/技能 |
|---|---|
| 全面系统诊断 | 本技能 |
| 仅查看运行状态 | crabclaw status CLI |
| 配置问题 | → system-config |
| 认证问题 | → auth-management |
| 插件问题 | → plugins-management |
crabclaw doctor
运行所有诊断模块，输出检查结果。
| 标志 | 说明 |
|---|---|
--deep | 深度扫描，包含文件系统权限和完整性检查 |
--repair | 自动修复检测到的问题 |
--force | 允许激进修复（含破坏性操作） |
--yes | 自动确认所有修复提示 |
--non-interactive | 无交互模式运行 |
# 仅诊断，不修复
crabclaw doctor
# 深度诊断 + 安全修复
crabclaw doctor --deep --repair
# CI/自动化环境
crabclaw doctor --non-interactive --repair --yes
# 严重问题强制修复（谨慎使用）
crabclaw doctor --deep --repair --force --yes
Doctor 包含 17 个诊断模块，按顺序执行：
| 模块 | 检查内容 |
|---|---|
| auth | 认证状态、API Key 有效性、Token 过期 |
| completion | Shell 补全安装与修复 |
| config_flow | 配置文件格式、必填字段、JSON5 语法 |
| gateway_daemon_flow | Daemon 服务安装状态与运行状态 |
| gateway_health | Gateway 健康检查（HTTP 连通性、响应时间） |
| gateway_services | Gateway 各子服务状态（频道、MCP、浏览器等） |
| install | 安装完整性（二进制文件、Native Messaging Host） |
| legacy_config | 旧版配置迁移检查 |
| platform_notes | 平台特定注意事项（macOS/Linux/Windows） |
| sandbox | 沙箱环境可用性（Docker/原生沙箱） |
| security | 安全配置审计（文件权限、绑定地址、TLS） |
| state_integrity | 状态文件完整性（数据库、缓存、会话存储） |
| state_migrations | 状态目录迁移状态 |
| ui | UI 协议版本与前端资源新鲜度 |
| update | 更新可用性检查 |
| workspace | 工作区配置 |
| workspace_status | 工作区运行状态 |
| 级别 | 图标 | 说明 |
|---|---|---|
PASS | ✓ | 检查通过 |
WARN | ⚠ | 警告，不影响核心功能 |
FAIL | ✗ | 失败，需要修复 |
SKIP | - | 跳过（不适用于当前平台/配置） |
| 问题 | 自动修复 |
|---|---|
| API Key 格式无效 | 提示重新配置 |
| OAuth Token 过期 | 刷新 Token |
| 提供商不可达 | 切换到回退提供商 |
| 问题 | 自动修复 |
|---|---|
| 配置文件语法错误 | 提示手动修复 |
| 缺少必填字段 | 填入默认值 |
| 旧版格式 | 自动迁移 |
| 问题 | 自动修复 |
|---|---|
| Daemon 未安装 | --repair 自动安装 |
| Gateway 端口被占用 | 提示更换端口 |
| Native Host 未安装 | --repair 自动安装 |
| 问题 | 自动修复 |
|---|---|
| 状态目录权限过宽 | --repair 修正为 0700 |
| Gateway 绑定 0.0.0.0 | 警告提示 |
| TLS 证书过期 | 提示重新生成 |
| 问题 | 自动修复 |
|---|---|
| Docker 未安装 | 提示安装或切换到原生沙箱 |
| 沙箱容器损坏 | --repair 重建容器 |
| 工具 | 范围 | 使用场景 |
|---|---|---|
crabclaw doctor | 全面诊断 | 首次安装、系统异常 |
crabclaw status | 运行状态概览 | 快速查看 |
crabclaw health | Gateway 健康检查 | 连通性验证 |
crabclaw security audit | 安全专项审计 | 安全审查 |
crabclaw plugins doctor | 插件专项诊断 | 插件加载问题 |
| CLI 命令 | 说明 |
|---|---|
crabclaw doctor | 标准诊断 |
crabclaw doctor --deep | 深度诊断（含文件系统） |
crabclaw doctor --repair | 诊断 + 自动修复 |
crabclaw doctor --force --repair | 含激进修复 |
crabclaw doctor --non-interactive --yes | 无交互诊断 |