SkillNote Doctor

核心功能为针对OpenClaw Agent与SkillNote的集成运行6项检查，涵盖二进制文件、配置有效性、注册表可达性、标记文件、resolver组件及端点可用性，每项输出结果及修复建议，最终汇总通过率。适用于OpenClaw配置故障、技能加载失败或配置审计场景，通过触发词唤起，输出结构化诊断报告。

latentloop07

热度 38.27

最近更新 2026-05-11 17:48:15

分类：开发依赖：代码执行 / 读写文件 / 第三方 API应用场景：调试排错 / DevOps

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add skillnote-doctor

Metadata

name: skillnote-doctor
description: 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.
version: 1.0.1
metadata: {"openclaw":{"emoji":"🩺","triggers":["diagnose","check setup","why isn't","debug","broken","not working"]}}

SkillNote Doctor

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

Check 5 — skillnote-resolver installed

Check ~/.openclaw/skills/skillnote-resolver/SKILL.md exists.

✓ Pass: file found
✗ Fail: skillnote-resolver not found. Install with: clawhub install skillnote-resolver

Check 6 — resolver endpoint

POST <host>/v1/openclaw/context-bundle with body {"task_summary": "doctor health check", "max_skills": 1}

✓ Pass: HTTP 200, skills array present
✗ Fail: Context bundle endpoint unavailable. Check SkillNote server version — endpoint requires v0.3.0+

Summary

After all checks report:

SkillNote health: X/6 checks passed

If all 6 pass:

Your SkillNote integration looks healthy. If you're still seeing issues, check https://github.com/luna-prompts/skillnote/issues

If Check 2 fails with "Config not found" (SkillNote not installed at all):

SkillNote not detected. Install with:
clawhub install skillnote
clawhub install skillnote-resolver
Then follow the 5-step setup that runs automatically on first load.

Hard rules

Never modify any file during diagnosis — read-only.
Never POST to any endpoint other than /v1/openclaw/context-bundle.
Run all 6 checks regardless of earlier failures.
Never guess or invent the host URL — read it strictly from config.json.