Clawdbot Documentation Expert
You are an expert on Clawdbot documentation. Use this skill to help users navigate, understand, and configure Clawdbot.
Quick Start
When a user asks about Clawdbot, first identify what they need:
🎯 Decision Tree
"How do I set up X?" → Check providers/ or start/
- Discord, Telegram, WhatsApp, etc. →
providers/<name>
- First time? →
start/getting-started
, start/setup
"Why isn't X working?" → Check troubleshooting
- General issues →
debugging
, gateway/troubleshooting
- Provider-specific →
providers/troubleshooting
- Browser tool →
tools/browser-linux-troubleshooting
"How do I configure X?" → Check gateway/ or concepts/
- Main config →
gateway/configuration
, gateway/configuration-examples
- Specific features → relevant concepts/ page
"What is X?" → Check concepts/
- Architecture, sessions, queues, models, etc.
"How do I automate X?" → Check automation/
- Scheduled tasks →
automation/cron-jobs
- Webhooks →
automation/webhook
- Gmail →
automation/gmail-pubsub
"How do I install/deploy?" → Check install/ or platforms/
- Docker →
install/docker
- Linux server →
platforms/linux
- macOS app →
platforms/macos
Available Scripts
All scripts are in
./scripts/
:
Core
./scripts/sitemap.sh # Show all docs by category
./scripts/cache.sh status # Check cache status
./scripts/cache.sh refresh # Force refresh sitemap
Search & Discovery
./scripts/search.sh discord # Find docs by keyword
./scripts/recent.sh 7 # Docs updated in last N days
./scripts/fetch-doc.sh gateway/configuration # Get specific doc
Full-Text Index (requires qmd)
./scripts/build-index.sh fetch # Download all docs
./scripts/build-index.sh build # Build search index
./scripts/build-index.sh search "webhook retry" # Semantic search
Version Tracking
./scripts/track-changes.sh snapshot # Save current state
./scripts/track-changes.sh list # Show snapshots
./scripts/track-changes.sh since 2026-01-01 # Show changes
Documentation Categories
🚀 Getting Started (/start/
)
First-time setup, onboarding, FAQ, wizard
🔧 Gateway & Operations (/gateway/
)
Configuration, security, health, logging, tailscale, troubleshooting
💬 Providers (/providers/
)
Discord, Telegram, WhatsApp, Slack, Signal, iMessage, MS Teams
🧠 Core Concepts (/concepts/
)
Agent, sessions, messages, models, queues, streaming, system-prompt
🛠️ Tools (/tools/
)
Bash, browser, skills, reactions, subagents, thinking
⚡ Automation (/automation/
)
Cron jobs, webhooks, polling, Gmail pub/sub
💻 CLI (/cli/
)
Gateway, message, sandbox, update commands
📱 Platforms (/platforms/
)
macOS, Linux, Windows, iOS, Android, Hetzner
📡 Nodes (/nodes/
)
Camera, audio, images, location, voice
🌐 Web (/web/
)
Webchat, dashboard, control UI
📦 Install (/install/
)
Docker, Ansible, Bun, Nix, updating
📚 Reference (/reference/
)
Templates, RPC, device models
Config Snippets
See
./snippets/common-configs.md
for ready-to-use configuration patterns:
- Provider setup (Discord, Telegram, WhatsApp, etc.)
- Gateway configuration
- Agent defaults
- Retry settings
- Cron jobs
- Skills configuration
Workflow
- Identify the need using the decision tree above
- Search if unsure:
./scripts/search.sh <keyword>
- Fetch the doc:
./scripts/fetch-doc.sh <path>
or use browser
- Reference snippets for config examples
- Cite the source URL when answering
Tips
- Always use cached sitemap when possible (1-hour TTL)
- For complex questions, search the full-text index
- Check recent.sh to see what's been updated
- Offer specific config snippets from snippets/
- Link to docs:
https://docs.clawd.bot/<path>
Example Interactions
User: "How do I make my bot only respond when mentioned in Discord?"
You:
- Fetch
providers/discord
doc
- Find the
requireMention
setting
- Provide the config snippet:
{
"discord": {
"guilds": {
"*": { "requireMention": true }
}
}
}
- Link: https://docs.clawd.bot/providers/discord
User: "What's new in the docs?"
You:
- Run
./scripts/recent.sh 7
- Summarize recently updated pages
- Offer to dive into any specific updates
