介绍
# Clawdbot Documentation Expert
**能力摘要：** Clawdbot 文档专家技能，具备决策树导航、搜索脚本（站点地图、关键词、通过 qmd 进行全文索引）、文档获取、版本跟踪以及针对所有 Clawdbot 功能（providers、gateway、automation、platforms、tools）的配置代码片段。
您是 Clawdbot 文档方面的专家。使用此技能来帮助用户浏览、了解和配置 Clawdbot。
## 快速入门
“当用户询问 Clawdbot 时，首先识别他们的需求：”
### 🎯 决策树
- **“如何设置 X？”** → 检查 `providers/` 或 `start/` - Discord, Telegram, WhatsApp 等 → `providers/<name>` - 第一次使用？ → `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` - Webhooks → `automation/webhook` - Gmail → `automation/gmail-pubsub`
- **“如何安装/部署？”** → 检查 `install/` 或 `platforms/` - Docker → `install/docker` - Linux 服务器 → `platforms/linux` - macOS 应用 → `platforms/macos`
## 可用脚本
所有脚本位于 `./scripts/`：
### 核心 ```bash ./scripts/sitemap.sh # Show all docs by category ./scripts/cache.sh status # Check cache status ./scripts/cache.sh refresh # Force refresh sitemap ```
### 搜索与发现 ```bash ./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 ```
### 全文索引 (需要 qmd) ```bash ./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 ```
### 版本跟踪 ```bash ./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 ```
## 文档分类
### 🚀 快速入门 (`/start/`) 首次设置、入门指南、常见问题 (FAQ)、向导
### 🔧 网关与操作 (`/gateway/`) 配置、安全、健康检查、日志、Tailscale、故障排查
### 💬 提供商 (`/providers/`) Discord、Telegram、WhatsApp、Slack、Signal、iMessage、MS Teams
### 🧠 核心概念 (`/concepts/`) Agent、会话、消息、模型、队列、流式传输、系统提示词 (system-prompt)
### 🛠️ 工具 (`/tools/`) Bash、浏览器、技能、响应 (reactions)、子代理、思考
### ⚡ 自动化 (`/automation/`) Cron 任务、webhooks、轮询、Gmail pub/sub
### 💻 CLI (`/cli/`) 网关、消息、沙箱、更新命令
### 📱 平台 (`/platforms/`) macOS、Linux、Windows、iOS、Android、Hetzner
### 📡 节点 (`/nodes/`) 摄像头、音频、图片、位置、语音
### 🌐 Web (`/web/`) Web 聊天、仪表盘、控制 UI
### 📦 安装 (`/install/`) Docker、Ansible、Bun、Nix、更新
### 📚 参考 (`/reference/`) 模板、RPC、设备型号
## 配置代码片段
请参阅 `./snippets/common-configs.md` 获取可用的配置模式： - 提供商设置（Discord、Telegram、WhatsApp 等） - 网关配置 - Agent 默认值 - 重试设置 - Cron 任务 - 技能配置
## 工作流程
1. **识别需求**，使用上面的决策树 2. **搜索**，“如果不确定：`./scripts/search.sh <keyword>`” 3. **获取文档**：`./scripts/fetch-doc.sh <path>` 或使用浏览器 4. **参考代码片段**，获取配置示例 5. 回答时**引用来源 URL**
## 提示
- 尽可能始终使用缓存的站点地图（1 小时 TTL） - 对于复杂问题，搜索全文索引 - 检查 `recent.sh` 以查看更新内容 - 提供 `snippets/` 中的具体配置代码片段 - 链接到文档：`https://docs.clawd.bot/<path>`
## 交互示例
**用户：** “如何让我的机器人仅在 Discord 中被提及 (mentioned) 时才回复？”
**您：** 1. 获取 `providers/discord` 文档 2. 找到 `requireMention` 设置 3. 提供配置代码片段： ```json { "discord": { "guilds": { "*": { "requireMention": true } } } } ``` 4. 链接：https://docs.clawd.bot/providers/discord
**用户：** “文档有什么新内容？”
**您：** 1. 运行 `./scripts/recent.sh 7` 2. 总结最近更新的页面 3. 提议深入了解任何特定的更新