OpenClaw Guide

Use this skill for OpenClaw-specific guidance, not general coding or generic Linux/macOS support.

Scope

Good fits:

• OpenClaw config questions
• gateway restarts / health / logs
• channel routing issues (Telegram, Discord, iMessage, etc.)
• session / agent / cron behavior questions
• “why is OpenClaw doing X?” troubleshooting

Do not use this skill for:

• general shell/debug work unrelated to OpenClaw
• building new features unless the request is specifically about OpenClaw behavior
• security review of third-party code (use a review/audit flow instead)

Default workflow

1. Clarify the lane

Identify whether the request is about:

• docs / usage
• config / schema
• runtime health
• channel routing
• skill structure
• cron behavior

1. Check local docs first

Prefer local docs before web docs:

• /Users/donzurbrick/.openclaw/workspace/docs
• /Users/donzurbrick/.openclaw/workspace/AGENTS.md
• /Users/donzurbrick/.openclaw/workspace/TOOLS.md
• /Users/donzurbrick/.openclaw/workspace/MEMORY.md

1. Inspect only the relevant config subtree

Before answering config-field questions or making config changes, inspect the targeted schema subtree.

Examples:

• channels.telegram
• agents.defaults
• gateway.auth
• commands

1. Prefer the smallest explanation or change
• answer with the specific field/path involved
• avoid dumping unrelated config
• prefer a minimal patch over a broad rewrite

1. Verify after mutation

If a restart or config change happens:

• run the pre-restart validator if relevant
• verify after restart
• report pass/fail/warn cleanly

Troubleshooting sequence

For runtime issues, use this order:

1. Determine whether the issue is ingress, routing, authorization, model/provider, or delivery
2. Check the most specific evidence source available
3. Avoid guessing from stale sessions when live config/logs can answer it
4. Separate:
• what is verified
• what is inferred
• what still needs a test

Skill structure rule

When asked to extend OpenClaw behavior, prefer:

1. existing tools
2. a skill with supporting files
3. retrieval/progressive disclosure
4. a specialist sub-agent
5. a new first-class tool

Do not recommend a new primitive unless the Tool Addition Gate is satisfied.

Supporting references

Read these only if relevant:

• references/triage-checklist.md — quick diagnostic flow for common OpenClaw failures
• references/skill-design-notes.md — how to decide between skill vs tool vs subagent

Output style

• Lead with the diagnosis or answer
• Name the exact config path / command / failure mode
• Distinguish verified facts from best guesses
• Keep it tight unless the issue is architectural