核心用法
Clawddocs 是一款专为 Clawdbot 生态打造的文档专家技能，通过结构化决策树帮助用户精准定位所需信息。当用户咨询 Clawdbot 相关问题时，系统首先识别需求类型——无论是首次配置、故障排查、功能配置、概念理解还是自动化部署——然后导向对应的文档路径（如 providers/、gateway/、automation/ 等）。
技能内置丰富的命令行脚本工具集：
- sitemap.sh：展示全站文档分类结构
- search.sh：关键词快速检索
- fetch-doc.sh：获取指定路径文档内容
- build-index.sh：构建全文语义索引（支持 qmd）
- recent.sh：追踪最近 N 天文档更新
- track-changes.sh：版本快照与变更历史
此外，技能提供 ./snippets/common-configs.md 配置模板库，涵盖 Discord/Telegram/WhatsApp 等主流平台接入、网关配置、定时任务、重试策略等常用场景。
显著优点
1. 结构化导航系统：决策树设计大幅降低文档检索成本，新手也能快速定位入口
2. 全文搜索能力：支持语义级搜索（build-index.sh search），超越简单关键词匹配
3. 版本感知机制：内置变更追踪脚本，可对比文档历史版本，适合持续关注新特性的用户
4. 零配置开箱即用：纯 Markdown 实现，无第三方依赖，部署成本极低
5. 丰富配置模板：预设多平台、多场景的 JSON/YAML 配置片段，减少重复劳动
潜在缺点与局限性
1. 依赖外部文档源：所有内容指向 docs.clawd.bot，若官方文档更新滞后或结构变更，导航可能失效
2. 搜索索引需手动维护：全文索引不会自动更新，用户需定期执行 build-index.sh 同步
3. 离线场景受限：未缓存状态下无法访问最新文档内容
4. 社区规模限制：Clawdbot 生态相对小众，部分边缘问题的文档覆盖度可能不足
适合人群
- 初次接触 Clawdbot 的开发者，需要快速完成平台接入（Discord/Telegram/WhatsApp 等）
- 运维人员需要排查网关、消息队列、会话管理等运行时问题
- 希望实现自动化工作流（Cron、Webhook、Gmail Pub/Sub）的进阶用户
- 需要跟踪文档更新、保持配置与官方最佳实践同步的长期维护者
常规风险
- T3 来源可信度：作者 NicholasSpisak 为个人开发者，虽代码透明公开，但建议关键环境使用前人工审查
- 文档时效性风险：官方文档更新可能滞后于软件版本，配置示例需结合实际版本验证
- 脚本执行权限：内置 bash 脚本需适当文件系统权限，建议遵循最小权限原则配置