Openclaw Diagnostics

# OpenClaw Diagnostics

Configuration diagnostics and troubleshooting skill for OpenClaw, powered by built-in AI without external dependencies.

## Quick Diagnostics

When a user reports an OpenClaw issue:

### 1. Gather Diagnostic Info

```bash
~/.openclaw/workspace/skills/openclaw-diagnostics/scripts/get-diagnostic-info.sh
```

### 2. Run Basic Checks

```bash
~/.openclaw/workspace/skills/openclaw-diagnostics/scripts/check-common-issues.sh
```

### 3. Analyze Based on Issue Type

Refer to `references/common-issues.md` for diagnostic rules.

## Diagnostic Workflow

```
User reports issue
        ↓
Gather info (config + status + logs)
        ↓
Run basic checks
        ↓
Lookup relevant docs from knowledge base
        ↓
Analyze and provide diagnosis
        ↓
Suggest fixes
```

## Knowledge Base

The skill includes a built-in knowledge base with 335 OpenClaw documentation pages.

**Location:** `assets/default-snapshot.json`

**Structure:**
```json
{
  "meta": { "pageCount": 335, "snapshotDate": "...", "sizeBytes": 3240482 },
  "index": [{ "slug": "...", "title": "...", "url": "...", "description": "..." }],
  "pages": { "slug": "markdown content..." }
}
```

**To lookup a document:**
1. Read `references/knowledge-base-index.md` to find relevant slugs
2. Load `assets/default-snapshot.json`
3. Access `pages[slug]` for content

**Common Document Slugs:**

| Topic | Slugs |
|-------|-------|
| Group Messages | `008888be`, `0bfb808e` |
| Pairing | `919c126f` |
| Message Routing | `a99b0ed8` |
| Automation Troubleshooting | `a632126a` |
| Auth Monitoring | `87e3285b` |
| Cron Jobs | `b239629c` |
| Channels Overview | `6569d3b4` |
| WhatsApp | `d09047a0` |
| Telegram | `d423ce29` |
| Feishu | `90a33c43` |

### Updating Knowledge Base

The knowledge base can be updated to get the latest OpenClaw documentation.

**Requirements:** Network connection (no LLM needed)

**Check for updates:**
```bash
cd ~/.openclaw/workspace/skills/openclaw-diagnostics
npx tsx scripts/update-kno...