Clawd Docs V2

核心用法

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，迁移至其他平台需适配

核心用法

Clawd-Docs v2 是一套专为 ClawdBot 生态设计的智能文档检索系统，采用「黄金片段 → 搜索索引 → 按需获取」的三层递进攻略：

1. Golden Snippets（黄金片段）：预缓存 7 个高频查询场景（如 Telegram 设置、OAuth 排错、更新流程），300-500 Token 即可直接回答 80-90% 的常见问题
2. 本地搜索索引：~/clawd/data/docs-index.json 提供零 Token 消耗的模糊匹配，支持斯洛伐克语/英语同义词（如 "telegram" ↔ "tg"、"config" ↔ "nastavenie"）
3. 按需抓取：仅当片段和索引均不满足时，调用原生 web_fetch 工具获取完整页面（约 8-12K Token）

显著优点

| 维度 | 表现 |

|------|------|

| **成本效率** | 使用原生 web_fetch 替代 BrightData，从 $0.003/次降至 $0，延迟从 2-5s 优化至 ~400ms |

| **Token 节省** | 三层架构使常见查询 Token 消耗降低 80-90% |

| **多语言支持** | 内置斯洛伐克语同义词库，服务当地用户群体 |

| **新鲜度管理** | TTL 分级策略（更新类 1 天、配置类 7 天、概念类 14 天、参考类 30 天） |

局限性与风险

| 限制 | 说明 |

|------|------|

| **覆盖范围** | 仅 50+ 核心页面被索引，边缘功能可能需要完整抓取 |

| **缓存依赖** | 若本地 `~/clawd/data/` 目录被篡改，可能返回错误信息 |

| **来源可信度** | T3 社区项目，虽经人工验证，仍需关注后续版本更新 |

| **语言局限** | 同义词库以斯洛伐克语为主，其他小语种支持有限 |

适合人群

• ClawdBot 管理员/用户：需要快速查询配置、排错、更新流程
• 斯洛伐克语用户：原生支持 "ako nastaviť"、"reštart" 等本地化查询
• Token 敏感场景：高频客服问答、嵌入式设备文档查询

常规风险

• 误报历史：安全扫描曾标记 2 处疑似威胁（THREAT-001/002），均经人工验证为文档示例中的合法文件读取，非恶意行为
• 未来依赖风险：当前零第三方依赖，若后续引入 MCP 工具需重新评估

技术演进亮点

v2.2.0 完成了从 BrightData MCP 到原生 web_fetch 的迁移，实现了真正的零成本、低延迟文档访问，体现了社区协作开发（Claude Code + Clawd 联合实现）的高效迭代模式。