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 同步。

核心功能与使用方式

clawd-docs-v2 是一款面向 ClawdBot 用户的智能文档查询工具，采用三层缓存架构实现高效、低成本的文档访问：

1. Golden Snippets（黄金片段）：预缓存7个高频查询主题（如 Telegram 设置、OAuth 排错、更新流程等），300-500 tokens 即可回答80-90%的常见问题
2. 本地搜索索引：零 token 消耗的 keyword 快速匹配，支持同义词扩展
3. 按需完整抓取：针对未缓存内容，调用 ClawdBot 原生 web_fetch 工具免费获取（~8-12k tokens，400ms 响应）

显著优点

• 极致 Token 效率：相比直接抓取完整页面，节省90%以上 tokens
• 零成本运行：依赖 ClawdBot 核心工具 web_fetch，无外部 API 费用
• 多语言友好：内置斯洛伐克语/英语关键词同义词映射
• 智能过期策略：按页面类型设置1-30天不等的 TTL，平衡新鲜度与效率
• 隐私合规：仅读取本地缓存，不收集用户敏感数据

潜在局限与风险

• 来源可信度限制：维护者为个人开发者（aranej），来源评级为 T3
• 文档依赖风险：内容准确性完全依赖 docs.clawd.bot 官方站点，存在 DNS 劫持或内容篡改的潜在风险（尽管报告建议验证 HTTPS 证书）
• 缓存滞后性：概念类页面14天、参考类页面30天的 TTL 可能导致信息不够及时
• 覆盖范围有限：仅~50个核心页面有索引，边缘功能可能需完整抓取

适合人群

• ClawdBot 日常用户，尤其是需要频繁查阅配置文档的技术用户
• 对 token 消耗敏感、希望快速获取答案而非完整文档的开发者
• 使用 Telegram/Discord 等渠道集成的多平台部署者

常规风险提示

该工具本身无可执行代码，纯 Markdown 指引文档，扫描评分为95分（A级）。但需注意：文档中的示例命令（如 cat ~/clawd/...）仅作路径说明，实际执行取决于用户环境配置。建议定期核查文档来源完整性。