clawd-docs-v2

核心用法

Clawd-Docs v2 是一个专为 ClawdBot 设计的智能文档访问工具，采用三层架构实现高效查询：首先检查预缓存的「Golden Snippets」常用答案片段（300-500 tokens），其次查询本地搜索索引进行关键词匹配（0 tokens），最后才通过原生 web_fetch 工具按需获取完整页面（8-12k tokens）。该设计确保 80-90% 的常见问题无需网络请求即可秒级响应。

显著优点

极致成本优化：完全摒弃第三方付费服务（如 Brightdata），改用 Clawdbot 核心 web_fetch 工具，实现零调用成本；智能缓存策略：7 个 Golden Snippets 覆盖高频场景（Telegram 设置、OAuth 排错、更新流程等），配合 TTL freshness 机制（安装类 1 天、概念类 14 天）平衡时效与性能；多语言支持：内置斯洛伐克语-英语同义词映射，支持模糊匹配；Token 效率：相比直接抓取全站，Token 消耗降低 80-90%。

潜在缺点与局限性

覆盖范围受限：仅 50 个核心页面入索引，边缘功能可能需手动检索；缓存滞后风险：概念类页面 14 天 TTL 可能导致新特性说明延迟获取；单域名锁定：严格限定 docs.clawd.bot，无法扩展至第三方生态文档；无交互式诊断：纯文档检索，无法执行配置验证或连通性测试。

适合的目标群体

ClawdBot 管理员与开发者、多语言技术支持团队（尤其斯洛伐克语用户）、注重 API 成本控制的自动化运维场景、需要离线优先访问文档的边缘部署环境。

使用风险

依赖项单一：核心功能绑定 web_fetch 工具，若 Clawdbot 核心更新可能导致兼容性中断；缓存失效盲区：用户本地 ~/clawd/data/ 目录若被误删或权限变更，将强制触发全量抓取增加延迟；文档站点可用性：官方 docs.clawd.bot 的 SSL 证书过期或 DNS 故障将阻断按需获取链路；版本漂移：Skill 版本（2.2.0）与文档站点内容可能存在发布时差，建议关注 changelog 同步。