OpenClaw Docs Intelligence
Local FTS5 index of all OpenClaw documentation. No external API calls. Sub-10ms queries.
What This Skill Does
This skill bundles three Python scripts and queries a local SQLite FTS5 index
built from the OpenClaw docs installed on this machine
(~/.npm-global/lib/node_modules/openclaw/docs or equivalent). It reads only
the local docs directory and writes only to ~/.openclaw/skills-data/skilled-openclaw-advisor/.
The query and build scripts make no network requests. The update script optionally sends a local notification via the openclaw message CLI when doc changes are detected (no direct network calls). The scripts do not access credentials or config secrets,
and does not read openclaw.json at runtime (config keys listed below are optional
overrides that the user may set — they are not required).
First-Time Setup
Build the index after installing the skill:
python3 $SKILL_DIR/scripts/build_index.py
This scans the local OpenClaw docs and creates a SQLite index at
~/.openclaw/skills-data/skilled-openclaw-advisor/index.db.
Query
# Compact output for agent use
python3 $SKILL_DIR/scripts/query_index.py --query "YOUR QUESTION" --mode agent
# Human-readable
python3 $SKILL_DIR/scripts/query_index.py --query "YOUR QUESTION"
# Full detail with online link
python3 $SKILL_DIR/scripts/query_index.py --query "YOUR QUESTION" --verbosity detailed
# Chinese results
python3 $SKILL_DIR/scripts/query_index.py --query "YOUR QUESTION" --lang zh-CN
# Index status
python3 $SKILL_DIR/scripts/query_index.py --status
Index Updates
# Incremental update (checks for doc changes)
python3 $SKILL_DIR/scripts/update_index.py
# Force full re-index
python3 $SKILL_DIR/scripts/build_index.py --force
When to Use
- OpenClaw configuration questions
- CLI commands and options
- Channel, provider, cron, session, agent setup
- Troubleshooting OpenClaw errors
When Not to Use
- General coding questions unrelated to OpenClaw
- Questions about third-party services
- If index is not built yet (run
build_index.pyfirst)
Response Modes
| Mode | Use Case | Description |
|---|---|---|
agent | Default agent queries | Ultra-compact, minimal tokens |
human + standard | Human questions | Clear explanation + key points |
human + detailed | Deep dives | Full excerpt + examples |
Optional Config
Settings in skills.entries.openclaw-docs.config in openclaw.json (all optional):
| Key | Default | Description |
|---|---|---|
defaultLang | "en" | Language: en or zh-CN |
defaultVerbosity | "standard" | Output: concise, standard, detailed |
maxResults | 5 | Max results returned |
fallbackToEnglish | true | Fall back to English if no results in requested language |
includeOnlineUrl | true | Include https://docs.openclaw.ai/... links in detailed output |