# Send Confucius Debug to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "confucius-debug",
    "name": "Confucius Debug",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/sstklen/confucius-debug",
    "canonicalUrl": "https://clawhub.ai/sstklen/confucius-debug",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/confucius-debug",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=confucius-debug",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/analyze.sh",
      "scripts/search.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "confucius-debug",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T02:16:56.875Z",
      "expiresAt": "2026-05-09T02:16:56.875Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=confucius-debug",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=confucius-debug",
        "contentDisposition": "attachment; filename=\"confucius-debug-2.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "confucius-debug"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/confucius-debug"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/confucius-debug",
    "downloadUrl": "https://openagent3.xyz/downloads/confucius-debug",
    "agentUrl": "https://openagent3.xyz/skills/confucius-debug/agent",
    "manifestUrl": "https://openagent3.xyz/skills/confucius-debug/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/confucius-debug/agent.md"
  }
}
```
## Documentation

### Confucius Debug — 孔子除錯

"不貳過" — Never repeat a mistake. (Confucius, Analects 6.3)

### IMPORTANT — Automatic Behavior

When this skill is active, follow these rules:

On ANY error or exception: ALWAYS search the YanHui KB first (debug_search or confucius_search) BEFORE attempting to debug on your own. This is free and takes <1 second.
If no match found: Use debug_analyze to get an AI-powered fix. The fix is saved to KB so the next person gets it instantly.
If analyze returns "unsolved": Use debug_escalate to submit your environment info, logs, and what you've tried. This helps offline research.
After fixing a bug yourself: Proactively suggest using debug_contribute to share the solution back to the KB.
Never skip step 1. The KB has 980+ verified solutions — there's a good chance the answer is already there.

AI-powered debugging assistant backed by the YanHui Knowledge Base — a growing collection of 6,800+ scraped issues and 980+ imported solutions from real AI agent projects (OpenClaw, Claude Code, MCP, Anthropic SDK, Codex, Aider, and more).

### How It Works

You hit a bug
    ↓
1. Search YanHui KB (FREE, instant)
    ↓
   Found? → Use the fix directly
   Not found? ↓
2. Confucius AI analyzes (FREE)
    ↓
   High confidence? → Fix saved to KB → Next person gets it FREE
   Low confidence? → status: "unsolved"
    ↓
3. debug_escalate (FREE) — send environment + logs
    ↓
   Queued for offline research → solved → added to KB

### confucius_search — Search the Knowledge Base (FREE)

Always try this first. Searches 980+ verified solutions for matching patterns.

# Search for a bug pattern
curl -s -X POST https://api.washinmura.jp/api/v2/debug-ai/search \\
  -H "Content-Type: application/json" \\
  -d '{"query": "OpenClaw Telegram plugin not connecting", "limit": 5}'

When to use: Any time you encounter an error. It's free and instant.

### confucius_analyze — AI-Powered Analysis (FREE)

Only if search returns 0 results. Confucius AI analyzes your error, finds root cause, and provides a fix.

# Analyze a new bug
curl -s -X POST https://api.washinmura.jp/api/v2/debug-ai \\
  -H "Content-Type: application/json" \\
  -d '{
    "error_description": "OpenClaw Telegram bot not responding after restart",
    "error_message": "Error: ETELEGRAM: 409 Conflict: terminated by other getUpdates request",
    "lobster_id": "'"$CONFUCIUS_LOBSTER_ID"'"
  }'

What you get back:

root_cause — Why this happened
fix_description — How to fix it
fix_patch — Actual code to apply
confidence — How sure Confucius is

### confucius_escalate — Submit Unsolved Bug for Research (FREE)

When confucius_analyze returns status: "unsolved" (low confidence), submit more context to help offline research.

curl -s -X POST https://api.washinmura.jp/api/v2/debug-ai/escalate \\
  -H "Content-Type: application/json" \\
  -d '{
    "error_description": "The original error",
    "lobster_id": "'"$CONFUCIUS_LOBSTER_ID"'",
    "environment": {"os": "macOS 15", "runtime": "bun 1.2.1", "key_deps": {"hono": "4.7"}},
    "logs": "Error: something failed\\n  at file.ts:42",
    "tried": ["restarted", "cleared cache", "downgraded version"],
    "project_structure": "src/ routes/ db/"
  }'

What you provide:

environment — OS, runtime versions, key dependencies
logs — Recent error output (last 50 lines)
tried — List of things already attempted
project_structure — Brief overview of project layout

### confucius_contribute — Share Your Fix (FREE)

Solved a bug? Share it so nobody hits it again.

curl -s -X POST https://api.washinmura.jp/api/v2/debug-ai/onboard \\
  -H "Content-Type: application/json" \\
  -d '{
    "lobster_id": "'"$CONFUCIUS_LOBSTER_ID"'",
    "entries": [{
      "error_description": "What was the bug",
      "fix_description": "How you fixed it",
      "error_category": "config_error"
    }]
  }'

### MCP Integration (Recommended)

For Claude Desktop, Claude Code, or any MCP-compatible client:

{
  "mcpServers": {
    "confucius-debug": {
      "url": "https://api.washinmura.jp/mcp/debug"
    }
  }
}

This gives you 5 tools automatically: debug_search, debug_analyze, debug_escalate, debug_contribute, debug_hello.

### What's in the Knowledge Base?

PlatformBugs SolvedA-RateMCP (Model Context Protocol)26187%Anthropic / Claude39280%Telegram10197%Memory / RAG9487%Browser7392%OpenAI / GPT5487%Docker5184%Discord4093%Cron / Scheduler3792%WhatsApp1694%Google / Gemini15100%Ollama / Local LLM1493%

A-Rate = percentage of fixes rated S (perfect) or A (good) by independent AI verification.

### Track Record

280 replies posted on GitHub issues
9 confirmed correct by project maintainers (including OpenClaw creator)
0 corrections (zero mistakes confirmed by community)
Knowledge base growing daily via automated pipeline

### Setup

Set your identity (required for analyze and contribute, optional for search):
export CONFUCIUS_LOBSTER_ID="your-username"



Test the connection (no ID needed for search):
curl -s https://api.washinmura.jp/api/v2/debug-ai/search \\
  -X POST -H "Content-Type: application/json" \\
  -d '{"query": "test", "limit": 1}'



Start debugging! When you hit any error, search first, analyze if needed.

### Workflow for OpenClaw Users

When OpenClaw throws an error:

Copy the error message
Search YanHui KB — confucius_search("your error message")
Found a match? — Apply the fix directly
No match? — confucius_analyze("description", "error message")
Fixed it yourself? — confucius_contribute(...) to help others

### External Endpoints

ServiceURLPurposeConfucius Debug APIhttps://api.washinmura.jp/api/v2/debug-aiSearch, Analyze, ContributeConfucius MCPhttps://api.washinmura.jp/mcp/debugMCP protocol endpoint

### Security & Privacy

What leaves your machine: Only the error description and error message you provide. No source code, no file contents, no environment variables are sent.
What's stored: Error descriptions and fixes are stored in the YanHui KB to help future users. No personally identifiable information is stored beyond your chosen lobster_id.
Authentication: Everything is free. Your lobster_id is used for identification only, not billing.
Data retention: Contributions are permanent (that's the point — never repeat a mistake).

### Credits

Author: Washin Village (washinmura) — an animal sanctuary on the Boso Peninsula, Japan.
Repository: github.com/sstklen/confucius-debug
License: MIT

Powered by Claude (Anthropic) and the Confucius philosophy: learn from mistakes, never repeat them.

🦞 The bigger the Knowledge Base, the stronger Confucius becomes.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: sstklen
- Version: 2.0.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-02T02:16:56.875Z
- Expires at: 2026-05-09T02:16:56.875Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/confucius-debug)
- [Send to Agent page](https://openagent3.xyz/skills/confucius-debug/agent)
- [JSON manifest](https://openagent3.xyz/skills/confucius-debug/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/confucius-debug/agent.md)
- [Download page](https://openagent3.xyz/downloads/confucius-debug)