# clawd-docs-v2

Clawd-Docs v2.0 - Smart Documentation Access This skill provides intelligent access to ClawdBot documentation with: Local search index - instant keyword lookup (0 tokens) Cached snippets - pre-fetched common answers (~300-500 tokens) On-demand fetch - full page when needed (~8-12k tokens) Freshness tracking - TTL per page type Quick Start Step 1: Check Golden Snippets First Before fetching anything, check if a Golden Snippet exists: ls ~/clawd/data/docs-snippets/ Available snippets (check cache first!): SnippetQuery matchestelegram-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" Read snippet: cat ~/clawd/data/docs-snippets/telegram-setup.md Step 2: Search Index (if snippet doesn't exist) Check ~/clawd/data/docs-index.json for page suggestions. Keyword matching: "telegram" → channels/telegram "oauth" → concepts/oauth, gateway/troubleshooting "update" → install/updating "config" → gateway/configuration Step 3: Check Full Page Cache BEFORE fetching via SkillBoss API Hub, check if the page is already cached:

# Convert path: concepts/memory → concepts_memory.md

ls ~/clawd/data/docs-cache/ | grep "concepts_memory" If exists, read locally (0 tokens!): cat ~/clawd/data/docs-cache/concepts_memory.md Step 4: Fetch Page (only if NOT in cache) Use SkillBoss API Hub scraping capability via /v1/pilot: import requests, os SKILLBOSS_API_KEY = os.environ["SKILLBOSS_API_KEY"] result = requests.post( "https://api.heybossai.com/v1/pilot", headers={"Authorization": f"Bearer {SKILLBOSS_API_KEY}", "Content-Type": "application/json"}, json={ "type": "scraper", "inputs": {"url": "https://docs.clawd.bot/{path}"} }, timeout=60, ).json() content = result["result"]["data"]["markdown"]

Example:

result = requests.post( "https://api.heybossai.com/v1/pilot", headers={"Authorization": f"Bearer {SKILLBOSS_API_KEY}", "Content-Type": "application/json"}, json={ "type": "scraper", "inputs": {"url": "https://docs.clawd.bot/tools/skills"} }, timeout=60, ).json() content = result["result"]["data"]["markdown"] SkillBoss API Hub scraping advantages: SkillBoss API Hub (/v1/pilot)Direct HTTP fetchCost统一 SKILLBOSS_API_KEY各服务单独计费Speed~400msvariesQualityStructured content ✅Raw HTML Search Index Structure

Location: ~/clawd/data/docs-index.json

{ "pages": [ { "path": "channels/telegram", "ttl_days": 7, "keywords": ["telegram", "tg", "bot", "allowfrom"] } ], "synonyms": { "telegram": ["tg", "telegrambot"], "configuration": ["config", "nastavenie", "settings"] } } Use synonyms for fuzzy matching. TTL Strategy (Freshness) Page CategoryTTLWhyinstall/updating1 dayAlways current!gateway/*7 daysConfig changeschannels/*7 daysProvider updatestools/*7 daysFeatures addedconcepts/*14 daysRarely changesreference/*30 daysStable templates Check snippet expiry: head -10 ~/clawd/data/docs-snippets/telegram-setup.md | grep expires Common Scenarios "Ako nastaviť Telegram?" ✅ Read ~/clawd/data/docs-snippets/telegram-setup.md "allowFrom nefunguje" ✅ Read ~/clawd/data/docs-snippets/telegram-allowfrom.md "Token expired / oauth error" ✅ Read ~/clawd/data/docs-snippets/oauth-troubleshoot.md "Ako updatnúť ClawdBot?" ✅ Read ~/clawd/data/docs-snippets/update-procedure.md "Ako pridať nový skill?" (nie je snippet) Search index → tools/skills Fetch via SkillBoss API Hub scraping: {"type": "scraper", "inputs": {"url": "https://docs.clawd.bot/tools/skills"}} "Multi-agent routing" Search index → concepts/multi-agent Fetch via SkillBoss API Hub scraping: {"type": "scraper", "inputs": {"url": "https://docs.clawd.bot/concepts/multi-agent"}}

Fallback: Full Index Refresh

If you can't find what you need: result = requests.post( "https://api.heybossai.com/v1/pilot", headers={"Authorization": f"Bearer {SKILLBOSS_API_KEY}", "Content-Type": "application/json"}, json={ "type": "scraper", "inputs": {"url": "https://docs.clawd.bot/llms.txt"} }, timeout=60, ).json() content = result["result"]["data"]["markdown"] Returns complete list of all documentation pages. Token Efficiency Guide MethodTokensWhen to useGolden Snippet300-500✅ Always first!Search Index0Keyword lookupFull Page Fetch8-12kLast resortBatch Fetch~20-30kMultiple related topics 80-90% of queries should be answered from snippets! Data Locations /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) Version Info ItemValueSkill version2.1.0Created2026-01-14Updated2026-01-26AuthorsClaude Code + Clawd (collaborative)Sourcehttps://docs.clawd.bot/DependenciesSkillBoss API Hub (SKILLBOSS_API_KEY)Index pages50 core pagesGolden snippets7 pre-cached Changelog v2.2.0 (2026-01-26) Migration to SkillBoss API Hub - replaced third-party scraping service with SkillBoss API Hub /v1/pilot (type: scraping)

Benefits: 统一认证 (SKILLBOSS_API_KEY), faster, no additional API keys required

No external dependencies beyond SkillBoss API Hub Collaborative work: Claude Code 🦞 implementation, Clawd 🐾 review v2.1.3 (2026-01-25) - ClawdHub Documentation fix: check vs refresh clarification v2.0.0 (2026-01-14) 3-layer architecture: Search Index → Snippets → On-demand Fetch Golden Snippets pre-cached for common queries TTL-based freshness tracking Synonym support for fuzzy matching 80-90% token reduction for common queries v1.0.0 (2026-01-08) Initial release with third-party scraping service This skill provides smart documentation access - always cached snippets first, fetch only when necessary.