clawd-docs-v2Smart ClawdBot documentation access with local search index, cached snippets, and on-demand fetch. Token-efficient and freshness-aware.
Install via ClawdBot CLI:
clawdbot install aranej/clawd-docs-v2This skill provides intelligent access to ClawdBot documentation with:
Before fetching anything, check if a Golden Snippet exists:
ls ~/clawd/data/docs-snippets/
Available snippets (check cache first!):
| Snippet | Query matches |
|---------|---------------|
| 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" |
Read snippet:
cat ~/clawd/data/docs-snippets/telegram-setup.md
Check ~/clawd/data/docs-index.json for page suggestions.
Keyword matching:
BEFORE fetching via brightdata, 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
Use native web_fetch tool (part of Clawdbot core - FREE and fast!):
web_fetch({ url: "https://docs.clawd.bot/{path}", extractMode: "markdown" })
Example:
web_fetch({ url: "https://docs.clawd.bot/tools/skills", extractMode: "markdown" })
web_fetch advantages:
| | web_fetch | brightdata |
|---|-----------|------------|
| Cost | $0 (free!) | ~$0.003/call |
| Speed | ~400ms | 2-5s |
| Quality | Markdown ✅ | Markdown ✅ |
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.
| Page Category | TTL | Why |
|---------------|-----|-----|
| install/updating | 1 day | Always current! |
| gateway/* | 7 days | Config changes |
| channels/* | 7 days | Provider updates |
| tools/* | 7 days | Features added |
| concepts/* | 14 days | Rarely changes |
| reference/* | 30 days | Stable templates |
Check snippet expiry:
head -10 ~/clawd/data/docs-snippets/telegram-setup.md | grep expires
~/clawd/data/docs-snippets/telegram-setup.md~/clawd/data/docs-snippets/telegram-allowfrom.md~/clawd/data/docs-snippets/oauth-troubleshoot.md~/clawd/data/docs-snippets/update-procedure.mdweb_fetch({ url: "https://docs.clawd.bot/tools/skills", extractMode: "markdown" })web_fetch({ url: "https://docs.clawd.bot/concepts/multi-agent", extractMode: "markdown" })If you can't find what you need:
web_fetch({ url: "https://docs.clawd.bot/llms.txt", extractMode: "markdown" })
Returns complete list of all documentation pages.
| Method | Tokens | When to use |
|--------|--------|-------------|
| Golden Snippet | ~300-500 | ✅ Always first! |
| Search Index | 0 | Keyword lookup |
| Full Page Fetch | ~8-12k | Last resort |
| Batch Fetch | ~20-30k | Multiple related topics |
80-90% of queries should be answered from snippets!
~/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)
| Item | Value |
|------|-------|
| Skill version | 2.1.0 |
| Created | 2026-01-14 |
| Updated | 2026-01-26 |
| Authors | Claude Code + Clawd (collaborative) |
| Source | https://docs.clawd.bot/ |
| Dependencies | web_fetch (Clawdbot core tool) |
| Index pages | ~50 core pages |
| Golden snippets | 7 pre-cached |
This skill provides smart documentation access - always cached snippets first, fetch only when necessary.
Generated Feb 27, 2026
A small business deploying ClawdBot for customer service uses this skill to quickly access setup guides and troubleshooting steps, reducing support ticket resolution time by checking cached snippets for common issues like OAuth errors or Telegram configuration.
A software development team integrates this skill into their internal documentation system to help new hires learn ClawdBot features efficiently, using the search index to find relevant pages and snippets for concepts like multi-agent routing without fetching full documents.
A technical writer managing ClawdBot's documentation leverages the TTL strategy to ensure content freshness, regularly checking cached pages and using web_fetch to update install guides and configuration references with minimal token usage.
An online learning platform incorporates this skill into its curriculum to provide students with instant access to ClawdBot documentation, enabling hands-on exercises where learners query snippets for setup procedures and avoid high token costs.
Offer basic access to cached snippets and search index for free, while charging for premium features like advanced analytics, custom snippet creation, or priority updates to full page fetches, targeting small teams and individual developers.
Sell licenses to large organizations for embedding this skill into their internal help desks or developer portals, providing tailored support, SLA guarantees, and integration with existing tools like Slack or Jira for streamlined documentation access.
Generate revenue by offering consulting to customize the skill for specific industries, such as adding domain-specific snippets or optimizing the search index, along with training sessions to maximize token efficiency and documentation freshness.
💬 Integration Tip
Start by checking the golden snippets directory for common queries to minimize token usage, and use the web_fetch tool for on-demand fetches only when necessary to keep costs low.
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
Create, search, and manage Bear notes via grizzly CLI.
Track water and sleep with JSON file storage
Notion API for creating and managing pages, databases, and blocks.
Work with Obsidian vaults as a knowledge base. Features: fuzzy/phonetic search across all notes, auto-folder detection for new notes, create/read/edit notes with frontmatter, manage tags and wikilinks. Use when: querying knowledge base, saving notes/documents, editing existing notes by user instructions.
Organize your agent's knowledge using PARA (Projects, Areas, Resources, Archive) — then make it ALL searchable. The symlink trick enables full semantic search across your entire knowledge base, not just MEMORY.md. Includes session transcript indexing and memory flush protocol. Your agent finally has a real second brain.