✓ Verified 💻 Development ✓ Enhanced Data

Clawd Docs V2

Smart ClawdBot documentation access with local search index.

Rating: 4.5 (457 reviews)
Downloads: 612 downloads
Version: 1.0.0

Overview

Smart ClawdBot documentation access with local search index.

✨Key Features

Check Golden Snippets First

Search Index (if snippet doesn't exist)

Check Full Page Cache

Fetch Page (only if NOT in cache)

Complete Documentation

View Source →

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:

bash

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:

bash

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 brightdata, check if the page is already cached:

bash

# Convert path: concepts/memory → concepts_memory.md
ls ~/clawd/data/docs-cache/ | grep "concepts_memory"

If exists, read locally (0 tokens!):

bash

cat ~/clawd/data/docs-cache/concepts_memory.md

Step 4: Fetch Page (only if NOT in cache)

Use native web_fetch tool (part of Clawdbot core - FREE and fast!):

javascript

web_fetch({ url: "https://docs.clawd.bot/{path}", extractMode: "markdown" })

Example:

javascript

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 ✅

Search Index Structure

Location: ~/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"]
  }
}

Use synonyms for fuzzy matching.

TTL Strategy (Freshness)

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:

bash

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: web_fetch({ url: "https://docs.clawd.bot/tools/skills", extractMode: "markdown" })

"Multi-agent routing"

Search index → concepts/multi-agent
Fetch: web_fetch({ url: "https://docs.clawd.bot/concepts/multi-agent", extractMode: "markdown" })

Fallback: Full Index Refresh

If you can't find what you need:

javascript

web_fetch({ url: "https://docs.clawd.bot/llms.txt", extractMode: "markdown" })

Returns complete list of all documentation pages.

Token Efficiency Guide

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!

Data Locations

text

~/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

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

Changelog

v2.2.0 (2026-01-26)

Migration to web_fetch - replaced brightdata MCP with native Clawdbot tool
Benefits: FREE ($0), faster (~400ms vs 2-5s)
No external dependencies (mcporter no longer required)
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 brightdata fetch only

This skill provides smart documentation access - always cached snippets first, fetch only when necessary.

Installation

Terminal bash


openclaw install clawd-docs-v2

Copied!

💻Code Examples

ls ~/clawd/data/docs-snippets/

ls-clawddatadocs-snippets.txt

**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

cat-clawddatadocs-snippetstelegram-setupmd.txt

### 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 brightdata**, check if the page is already cached:

cat ~/clawd/data/docs-cache/concepts_memory.md

cat-clawddatadocs-cacheconceptsmemorymd.txt

### Step 4: Fetch Page (only if NOT in cache)

Use native **web_fetch** tool (part of Clawdbot core - FREE and fast!):

web_fetch({ url: "https://docs.clawd.bot/tools/skills", extractMode: "markdown" })

webfetch-url-httpsdocsclawdbottoolsskills-extractmode-markdown-.txt

**web_fetch advantages:**
| | web_fetch | brightdata |
|---|-----------|------------|
| **Cost** | $0 (free!) | ~$0.003/call |
| **Speed** | ~400ms | 2-5s |
| **Quality** | Markdown ✅ | Markdown ✅ |

---

## Search Index Structure

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

}

.txt

**Use synonyms** for fuzzy matching.

---

## TTL Strategy (Freshness)

| 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

head--10-clawddatadocs-snippetstelegram-setupmd--grep-expires.txt

---

## Common Scenarios

### "Ako nastaviť Telegram?"
1. ✅ Read `~/clawd/data/docs-snippets/telegram-setup.md`

### "allowFrom nefunguje"
1. ✅ Read `~/clawd/data/docs-snippets/telegram-allowfrom.md`

### "Token expired / oauth error"
1. ✅ Read `~/clawd/data/docs-snippets/oauth-troubleshoot.md`

### "Ako updatnúť ClawdBot?"
1. ✅ Read `~/clawd/data/docs-snippets/update-procedure.md`

### "Ako pridať nový skill?" (nie je snippet)
1. Search index → tools/skills
2. Fetch: `web_fetch({ url: "https://docs.clawd.bot/tools/skills", extractMode: "markdown" })`

### "Multi-agent routing"
1. Search index → concepts/multi-agent
2. Fetch: `web_fetch({ url: "https://docs.clawd.bot/concepts/multi-agent", extractMode: "markdown" })`

---

## Fallback: Full Index Refresh

If you can't find what you need:

web_fetch({ url: "https://docs.clawd.bot/llms.txt", extractMode: "markdown" })

webfetch-url-httpsdocsclawdbotllmstxt-extractmode-markdown-.txt

Returns **complete list** of all documentation pages.

---

## Token Efficiency Guide

| 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!

---

## Data Locations

example.json

{
  "pages": [
    {
      "path": "channels/telegram",
      "ttl_days": 7,
      "keywords": ["telegram", "tg", "bot", "allowfrom"]
    }
  ],
  "synonyms": {
    "telegram": ["tg", "telegrambot"],
    "configuration": ["config", "nastavenie", "settings"]
  }
}

example.txt

~/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)