介绍
# Clawd-Docs v2.0 - Smart Documentation Access
此技能为 ClawdBot 文档提供**智能访问**，具有： - **本地搜索索引** - 即时关键字查找（0 tokens） - **缓存片段** - 预取常见答案（~300-500 tokens） - **按需获取** - 需要时获取完整页面（~8-12k tokens） - **新鲜度跟踪** - 每种页面类型的 TTL
---
## 快速开始
### 步骤 1：优先检查黄金片段
在获取任何内容之前，检查是否存在**黄金片段**：
```bash ls ~/clawd/data/docs-snippets/ ```
**可用片段（先检查缓存！）：** | 片段 | 匹配查询 | |---------|---------------| | `telegram-setup.md` | "ako nastaviť telegram", "telegram setup" | | `telegram-allowfrom.md` | "allowFrom", "kto mi môže písať", "access control" | | `oauth-troubleshoot.md` | "token expired", "oauth error", "credentials" | | `update-procedure.md` | "ako updatnuť", "update clawdbot" | | `restart-gateway.md` | "restart", "reštart", "stop/start" | | `config-basics.md` | "config", "nastavenie", "konfigurácia" | | `config-providers.md` | "pridať provider", "discord setup", "nový kanál" | | `memory-search.md` | "memory", "vector search", "pamäť", "embeddings" |
**读取片段：** ```bash cat ~/clawd/data/docs-snippets/telegram-setup.md ```
### 步骤 2：搜索索引（如果片段不存在）
检查 `~/clawd/data/docs-index.json` 以获取页面建议。
**关键字匹配：** - "telegram" → channels/telegram - "oauth" → concepts/oauth, gateway/troubleshooting - "update" → install/updating - "config" → gateway/configuration
### 步骤 3：检查完整页面缓存
**在通过 brightdata 获取之前**，检查页面是否已缓存：
```bash # Convert path: concepts/memory → concepts_memory.md ls ~/clawd/data/docs-cache/ | grep "concepts_memory" ```
**如果存在，则本地读取（0 tokens！）：** ```bash cat ~/clawd/data/docs-cache/concepts_memory.md ```
### 步骤 4：获取页面（仅当不在缓存中时）
使用原生的 **web_fetch** 工具（Clawdbot 核心的一部分 - 免费且快速）：
```javascript web_fetch({ url: "https://docs.clawd.bot/{path}", extractMode: "markdown" }) ```
**示例：** ```javascript web_fetch({ url: "https://docs.clawd.bot/tools/skills", extractMode: "markdown" }) ```
**web_fetch 优势：** | | web_fetch | brightdata | |---|-----------|------------| | **成本** | $0 (免费！) | ~$0.003/call | | **速度** | ~400ms | 2-5s | | **质量** | Markdown ✅ | Markdown ✅ |
---
## 搜索索引结构
**位置：** `~/clawd/data/docs-index.json`
```json { "pages": [ { "path": "channels/telegram", "ttl_days": 7, "keywords": ["telegram", "tg", "bot", "allowfrom"] } ], "synonyms": { "telegram": ["tg", "telegrambot"], "configuration": ["config", "nastavenie", "settings"] } } ```
**使用同义词**进行模糊匹配。
---
## TTL 策略（新鲜度）
| 页面类别 | TTL | 原因 | |---------------|-----|-----| | `install/updating` | 1 天 | 始终最新！ | | `gateway/*` | 7 天 | 配置更改 | | `channels/*` | 7 天 | 提供商更新 | | `tools/*` | 7 天 | 新增功能 | | `concepts/*` | 14 天 | 很少更改 | | `reference/*` | 30 天 | 稳定模板 |
**检查片段过期：** ```bash head -10 ~/clawd/data/docs-snippets/telegram-setup.md | grep expires ```
---
## 常见场景
### "Ako nastaviť Telegram?" 1. ✅ 读取 `~/clawd/data/docs-snippets/telegram-setup.md`
### "allowFrom nefunguje" 1. ✅ 读取 `~/clawd/data/docs-snippets/telegram-allowfrom.md`
### "Token expired / oauth error" 1. ✅ 读取 `~/clawd/data/docs-snippets/oauth-troubleshoot.md`
### "Ako updatnúť ClawdBot?" 1. ✅ 读取 `~/clawd/data/docs-snippets/update-procedure.md`
### "Ako pridať nový skill?" (nie je snippet) 1. 搜索索引 → tools/skills 2. 获取：`web_fetch({ url: "https://docs.clawd.bot/tools/skills", extractMode: "markdown" })`
### "Multi-agent routing" 1. 搜索索引 → concepts/multi-agent 2. 获取：`web_fetch({ url: "https://docs.clawd.bot/concepts/multi-agent", extractMode: "markdown" })`
---
## 回退：完整索引刷新
如果您找不到所需内容：
```javascript web_fetch({ url: "https://docs.clawd.bot/llms.txt", extractMode: "markdown" }) ```
返回所有文档页面的**完整列表**。
---
## Token 效率指南
| 方法 | Tokens | 使用场景 | |--------|--------|-------------| | 黄金片段 | ~300-500 | ✅ 始终首选！ | | 搜索索引 | 0 | 关键字查找 | | 完整页面获取 | ~8-12k | 最后手段 | | 批量获取 | ~20-30k | 多个相关主题 |
**80-90% 的查询**应通过片段回答！
---
## 数据位置
``` ~/clawd/data/ ├── docs-index.json # Search index ├── docs-stats.json # Usage tracking ├── docs-snippets/ # Cached Golden Snippets │ ├── telegram-setup.md │ ├── telegram-allowfrom.md │ ├── oauth-troubleshoot.md │ ├── update-procedure.md │ ├── restart-gateway.md │ └── config-basics.md └── docs-cache/ # Full page cache (future) ```
---
## 版本信息
| 项目 | 值 | |------|-------| | **技能版本** | 2.1.0 | | **创建时间** | 2026-01-14 | | **更新时间** | 2026-01-26 | | **作者** | Claude Code + Clawd (协作) | | **来源** | https://docs.clawd.bot/ | | **依赖** | web_fetch (Clawdbot 核心工具) | | **索引页面** | ~50 个核心页面 | | **黄金片段** | 7 个预缓存 |
---
## 更新日志
### v2.2.0 (2026-01-26) - **迁移到 web_fetch** - 用原生 Clawdbot 工具替换了 brightdata MCP - 优势：免费（$0），更快（~400ms vs 2-5s） - 无外部依赖（不再需要 mcporter） - 协作工作：Claude Code 🦞 实现，Clawd 🐾 审核
### v2.1.3 (2026-01-25) - ClawdHub - 文档修复：check 与 refresh 的澄清
### v2.0.0 (2026-01-14) - 3 层架构：搜索索引 → 片段 → 按需获取 - 为常见查询预缓存黄金片段 - 基于 TTL 的新鲜度跟踪 - 支持模糊匹配的同义词 - 常见查询减少 80-90% 的 tokens
### v1.0.0 (2026-01-08) - 初始版本，仅包含 brightdata 获取
---
*此技能提供智能文档访问 - 始终优先使用缓存片段，仅在必要时获取。*