Setup Doctor v3.0
Install: INLINECODE0
Diagnose OpenClaw setup issues. Like brew doctor — one command, clear results.
Language
Detect from user's message language. Default: English.
Auto-Detection
Run automatically when:
- - User mentions setup issues, errors, or "doesn't work"
- Gateway fails to start or connect
- A command returns an unexpected error
- User says "doctor check", "diagnose", "hvorfor fungerer ikke"
Quick Check (default, ~10s)
CODEBLOCK0
Report:
CODEBLOCK1
If issues found, include one-line fix:
CODEBLOCK2
Full Check (opt-in)
Trigger: "doctor full", "full diagnose"
Includes Quick Check PLUS:
- - Config: File exists
- Workspace: Directory exists, key files present (SOUL.md, AGENTS.md, etc.)
- Platform: Windows (long paths, PowerShell policy), macOS (Homebrew PATH), Linux (systemd)
- Common pitfalls: Known version conflicts, deprecated patterns
Fix Mode
Trigger: "fix it", "fix det"
- 1. Show exactly what will change
- Get user confirmation
- Apply fix
- Re-run check to verify
Never fix without confirmation.
Workspace Audit
Trigger: "workspace audit"
Report file existence and size only — never read contents:
CODEBLOCK3
Quick Commands
| User says | Action |
|---|
| "doctor check" / "kjor doctor" | Quick Check |
| "doctor full" |
Full Check |
| "fix it" | Auto-fix with confirmation |
| "workspace audit" | File existence check |
HEARTBEAT Integration
User can add to HEARTBEAT.md:
CODEBLOCK4
Guidelines for Agent
- 1. Auto-detect issues — run quick check when user reports problems
- Keep it fast — quick check in ~10 seconds
- One-line fixes — clear, copy-pasteable solutions
- Never read file contents — existence and size only
- Never fix without asking — show what changes, get confirmation
- Match user language in reports
What This Skill Does NOT Do
- - Does NOT read file contents (existence/size only)
- Does NOT access credentials without explicit approval
- Does NOT modify config automatically
- Does NOT modify HEARTBEAT.md or MEMORY.md
More by TommoT2
- - context-brief — Persistent context survival across sessions
- tommo-skill-guard — Security scanner for installed skills
- locale-dates — Format dates/times per locale
Install the full suite:
CODEBLOCK5
Setup Doctor v3.0
安装： clawhub install setup-doctor
诊断 OpenClaw 设置问题。类似 brew doctor —— 一条命令，清晰结果。
语言
根据用户消息语言自动检测。默认：英语。
自动检测
在以下情况自动运行：
- - 用户提及设置问题、错误或无法工作
- 网关启动或连接失败
- 命令返回意外错误
- 用户说doctor check、diagnose、hvorfor fungerer ikke
快速检查（默认，约10秒）
bash
node --version
npm --version
openclaw gateway status 2>&1
报告：
Setup Doctor — 快速检查
Node.js: ✅ v24.11.1
npm: ✅ 10.9.2
Gateway: ✅ 运行中（已运行4小时）
问题：无
如果发现问题，包含一行修复建议：
Gateway: ❌ 未运行 → 修复：openclaw gateway start
完整检查（可选）
触发词：doctor full、full diagnose
包含快速检查 PLUS：
- - 配置：文件是否存在
- 工作区：目录是否存在，关键文件是否存在（SOUL.md、AGENTS.md 等）
- 平台：Windows（长路径、PowerShell 策略）、macOS（Homebrew PATH）、Linux（systemd）
- 常见陷阱：已知版本冲突、已弃用模式
修复模式
触发词：fix it、fix det
- 1. 显示将要更改的内容
- 获取用户确认
- 应用修复
- 重新运行检查以验证
未经确认绝不修复。
工作区审计
触发词：workspace audit
仅报告文件存在性和大小 —— 绝不读取内容：
工作区审计：
SOUL.md ✅ 1.2 KB
AGENTS.md ✅ 2.8 KB
MEMORY.md ✅ 3.1 KB
HEARTBEAT.md ✅ 0.4 KB
TOOLS.md ✅ 0.3 KB
快速命令
| 用户说 | 操作 |
|---|
| doctor check / kjor doctor | 快速检查 |
| doctor full |
完整检查 |
| fix it | 自动修复（需确认） |
| workspace audit | 文件存在性检查 |
HEARTBEAT 集成
用户可添加到 HEARTBEAT.md：
markdown
设置检查
- - 如果检测到网关错误：运行 doctor quick check
代理指南
- 1. 自动检测问题 —— 当用户报告问题时运行快速检查
- 保持快速 —— 快速检查约10秒
- 一行修复 —— 清晰、可复制粘贴的解决方案
- 绝不读取文件内容 —— 仅检查存在性和大小
- 未经询问绝不修复 —— 显示更改内容，获取确认
- 报告使用用户语言
此技能不做什么
- - 不读取文件内容（仅检查存在性/大小）
- 未经明确批准不访问凭据
- 不自动修改配置
- 不修改 HEARTBEAT.md 或 MEMORY.md
TommoT2 的更多技能
- - context-brief —— 跨会话持久上下文存活
- tommo-skill-guard —— 已安装技能的安全扫描器
- locale-dates —— 按区域设置格式化日期/时间
安装完整套件：
bash
clawhub install setup-doctor context-brief tommo-skill-guard locale-dates
