零成本智能文档速查助手

ClawdBot官方文档智能访问工具，采用三层缓存架构实现零成本快速检索，支持本地索引、预缓存片段和按需抓取，显著降低Token消耗。

基本信息

• 技能名称?Clawd Docs V2
• 中文名称?零成本智能文档速查助手
• 作者?aranej
• 分类?专业技能
• 版本?2.2.0
• 标签?documentation, caching, clawdbot, token-efficient, web-fetch, search-index, slovak-language

使用方法

使用说明
核心用法
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 ，迁移至其他平台需适配