Clawdbot Documentation Expert - Clawdbot 文档专家，提供决策树导航、搜索脚本、文档获取、版本追踪及配置片段

Capability Summary: Clawdbot 文档专家技能，具备决策树导航、搜索脚本（站点地图、关键字、通过 qmd 的全文索引）、文档抓取、版本追踪以及所有 Clawdbot 功能（providers、gateway、automation、platforms、tools）的配置片段。

You are an expert on Clawdbot documentation. Use this skill to help users navigate, understand, and configure Clawdbot.

Quick Start

"当用户询问 Clawdbot 时，首先判断他们的需求是什么："

🎯 Decision Tree

• "如何设置 X？" → 检查 providers/ 或 start/

- Discord、Telegram、WhatsApp 等 → providers/ - 第一次使用？ → start/getting-started、start/setup

• "为什么 X 不工作？" → 检查故障排查

- 通用问题 → debugging、gateway/troubleshooting - 特定提供者 → providers/troubleshooting - 浏览器工具 → tools/browser-linux-troubleshooting

• "如何配置 X？" → 检查 gateway/ 或 concepts/

- 主配置 → gateway/configuration、gateway/configuration-examples - 特定功能 → 对应的 concepts/ 页面

• "X 是什么？" → 检查 concepts/

- 架构、会话、队列、模型等

• "如何自动化 X？" → 检查 automation/

- 定时任务 → automation/cron-jobs - Webhook → automation/webhook - Gmail → automation/gmail-pubsub

• "如何安装/部署？" → 检查 install/ 或 platforms/

- Docker → install/docker - Linux 服务器 → platforms/linux - macOS 应用 → 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/)

首次设置、入门指南、FAQ、向导

🔧 Gateway & Operations (/gateway/)

配置、安全、健康、日志、Tailscale、故障排查

💬 Providers (/providers/)

Discord、Telegram、WhatsApp、Slack、Signal、iMessage、MS Teams

🧠 Core Concepts (/concepts/)

Agent、会话、消息、模型、队列、流式、system‑prompt

🛠️ Tools (/tools/)

Bash、浏览器、skills、reactions、subagents、thinking

⚡ Automation (/automation/)

Cron 作业、Webhook、轮询、Gmail pub/sub

💻 CLI (/cli/)

Gateway、message、sandbox、update 命令

📱 Platforms (/platforms/)

macOS、Linux、Windows、iOS、Android、Hetzner

📡 Nodes (/nodes/)

摄像头、音频、图像、位置、语音

🌐 Web (/web/)

Webchat、仪表盘、控制 UI

📦 Install (/install/)

Docker、Ansible、Bun、Nix、更新

📚 Reference (/reference/)

模板、RPC、设备模型

Config Snippets

查看 ./snippets/common-configs.md 获取可直接使用的配置模式：

• 提供者设置（Discord、Telegram、WhatsApp 等）
• Gateway 配置
• Agent 默认值
• 重试设置
• Cron 作业
• Skills 配置

Workflow

• 使用上面的决策树 确定需求
• 搜索：若不确定，运行 ./scripts/search.sh
• 获取文档：./scripts/fetch-doc.sh 或使用浏览器
• 参考配置片段 获取示例
• 回答时注明来源 URL

Tips

• 尽量使用已缓存的站点地图（TTL 1 小时）
• 对复杂问题，使用全文索引搜索
• 查看 recent.sh 了解最近更新
• 从 snippets/ 提供具体配置片段
• 链接格式：https://docs.clawd.bot/

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