clawddocs

核心用法

Clawddocs 是专为 Clawdbot 生态打造的文档专家技能，采用决策树导航模式帮助用户快速定位所需信息。用户可通过结构化问答路径（如"如何设置X""为什么X不工作""如何配置X"等）自动路由到对应文档章节，无需手动翻阅完整文档库。技能内置 7 个 Shell 脚本工具，覆盖站点地图浏览、关键词搜索、全文索引构建、文档获取、版本变更追踪等核心场景，并附带常用配置片段库，可直接复制用于生产环境。

显著优点

1. 结构化导航效率极高：决策树设计将复杂的文档体系转化为可交互的问答流程，显著降低新用户的学习成本。
2. 多维度检索能力：支持关键词搜索、全文语义检索（需 qmd 工具）、时间维度筛选（recent.sh）三种发现机制，适应不同查询习惯。
3. 配置即拿即用：snippets/common-configs.md 提供经过验证的 JSON 配置模板，涵盖主流平台（Discord、Telegram、WhatsApp 等）的接入方案，减少试错成本。
4. 版本感知：track-changes.sh 支持文档快照与差异对比，便于追踪 Clawdbot 功能迭代对配置的影响。
5. 生态完整性：覆盖从安装部署（Docker/Linux/macOS）、平台接入、网关配置到自动化任务（Cron/Webhook）的全生命周期场景。

潜在缺点与局限性

1. 脚本为占位实现：当前版本所有 Shell 脚本仅输出提示信息，无实际功能，用户需手动执行对应操作或等待后续更新。
2. 全文索引依赖外部工具：语义搜索功能需要额外安装 qmd 工具，增加了使用门槛。
3. 缓存机制简单：1 小时 TTL 的缓存策略在文档频繁更新时可能导致信息滞后。
4. 无实时验证能力：技能无法直接检测用户配置的有效性，仅能提供文档参考，配置错误仍需用户自行排查。
5. 平台覆盖偏向海外：Provider 列表以 Discord、Telegram、WhatsApp 等国际平台为主，国内平台（微信、钉钉、飞书）支持情况需额外确认。

适合的目标群体

• Clawdbot 新用户：需要快速完成首次部署和平台接入配置
• 运维与 SRE 工程师：负责网关配置、健康监控、日志排查等运维任务
• 自动化开发者：需要配置 Cron 任务、Webhook、Gmail Pub/Sub 等自动化流程
• 多平台 Bot 开发者：同时在多个聊天平台（Discord、Telegram、Slack 等）部署机器人的技术团队
• 技术文档贡献者：需要追踪文档变更历史、理解信息架构的社区成员

使用风险

1. 功能依赖风险：当前脚本为占位实现，若用户误以为是自动化工具直接调用，可能导致操作未执行而误以为完成。
2. 配置片段适用性：提供的 JSON 配置为通用模板，实际部署时需根据具体版本和环境调整，直接复制可能引发兼容性问题。
3. 文档时效性：缓存机制可能导致用户获取到已过时信息，关键配置变更建议通过 recent.sh 或官方渠道二次确认。
4. 外部工具链依赖：全文索引、文档获取等高级功能依赖 qmd 等外部工具，环境缺失时功能降级为纯文本提示。
5. 无权限隔离设计：技能本身不处理敏感数据，但用户在使用过程中可能自行输入 API Key、Token 等凭证，需注意终端历史记录的安全清理。