ClawdBot官方文档智能访问工具，采用三层缓存架构实现零成本快速检索，支持本地索引、预缓存片段和按需抓取，显著降低Token消耗。
说明：
## 核心用法
clawd-docs-v2 是一个专为 ClawdBot 设计的智能文档访问助手，采用**三层递进式架构**：
1. **Golden Snippets（黄金片段）**：预缓存 7 个高频查询答案（300-500 tokens），覆盖 Telegram 设置、OAuth 排错、更新流程等 80-90% 的常见需求
2. **本地搜索索引**：零 Token 消耗的 keyword 匹配，支持同义词扩展
3. **按需抓取**：仅当缓存未命中时，使用 Clawdbot 原生 `web_fetch` 工具获取完整页面（8-12k tokens）
**关键操作流程**：检查本地 snippet → 查询索引 → 读取页面缓存 → web_fetch 抓取，严格遵循成本递增原则。
## 显著优点
– **极致 Token 效率**：相比直接抓取，80-90% 查询可通过 snippets 解决，节省 90%+ Token
– **零外部成本**：v2.2.0 迁移至原生 `web_fetch`，彻底替代 brightdata（$0.003/次 → $0）
– **速度优势**：snippet 读取毫秒级，web_fetch 约 400ms，远快于 brightdata 的 2-5s
– **智能保鲜**：TTL 分层策略（安装文档 1 天刷新，概念文档 14 天），平衡时效与成本
– **多语言支持**：内置斯洛伐克语关键词映射（”ako nastavi?”、”re?tart” 等）
## 潜在局限
– **覆盖范围依赖**：仅 7 个预定义 snippets，边缘问题仍需完整抓取
– **索引维护成本**：`docs-index.json` 需随官方文档更新手动同步
– **缓存失效盲区**：TTL 到期后首次查询可能返回陈旧内容
– **无交互式搜索**：不支持语义相似度匹配，纯关键词 + 同义词规则
– **仓库未公开**：T3 来源可信度，GitHub 仓库状态不透明
## 适合人群
– **ClawdBot 管理员**：日常配置、排错、更新操作的高频用户
– **多代理系统开发者**：需要查询 multi-agent routing、memory search 等概念文档
– **成本敏感型部署**：Token 预算有限，追求极致性价比的生产环境
## 常规风险
– **误依赖风险**：用户可能跳过 snippet 检查直接发起抓取，丧失成本优势
– **缓存污染**：本地 `~/clawd/data/docs-cache/` 目录若被手动修改，可能返回错误信息
– **域名可用性**：完全依赖 docs.clawd.bot 在线状态，无离线镜像机制
– **工具版本锁定**：依赖 Clawdbot 核心的 `web_fetch`，迁移至其他平台需适配
会员专属
