A diagnostic tool for OpenClaw agents -- checks skill registry connectivity, AGENTS.md setup, config file validity, and installed skill health. Use when your setup seems broken, skills aren't loading, or you want to audit your agent's configuration.
Diagnose your SkillNote + OpenClaw integration in 6 checks. Run every check even if an earlier one fails — the user needs the full picture. Report ✓ pass or ✗ fail with specific remediation for each.
Check 1 — clawhub binary
Run: which clawhub
✓ Pass: binary found
✗ Fail: clawhub not found. Install from https://clawhub.ai or run: npm install -g clawhub
Check 2 — SkillNote config
Read ~/.openclaw/skills/skillnote/config.json.
✓ Pass: file exists, valid JSON, host is non-empty
✗ Fail (missing): Config not found. SkillNote is not installed. Install with: clawhub install skillnote && clawhub install skillnote-resolver
✗ Fail (invalid JSON): Config is malformed. Delete ~/.openclaw/skills/skillnote/config.json and re-run skillnote setup.
✗ Fail (empty host): Config exists but host is empty. Ask your agent to re-setup skillnote.
Check 3 — Registry reachability
GET <host>/v1/skills?limit=1
✓ Pass: HTTP 200
✗ Fail (timeout/refused): SkillNote at <host> is unreachable. Verify the URL and that your instance is running. Self-host guide: https://github.com/luna-prompts/skillnote
✗ Fail (non-200): Unexpected HTTP <N>. Check SkillNote server logs.
Check 4 — AGENTS.md marker
Read ~/.openclaw/workspace/AGENTS.md. Check for exact string <skillnote v1>.
✓ Pass: marker found
✗ Fail: AGENTS.md marker missing. Ask your agent: "re-graft skillnote into AGENTS.md" — or reinstall: clawhub install skillnote