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:
CODEBLOCK0
This scans the local OpenClaw docs and creates a SQLite index at
~/.openclaw/skills-data/skilled-openclaw-advisor/index.db.
Query
CODEBLOCK1
Index Updates
CODEBLOCK2
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.py first)
Response Modes
| Mode | Use Case | Description |
|---|
| INLINECODE6 | Default agent queries | Ultra-compact, minimal tokens |
| INLINECODE7 + INLINECODE8 |
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 |
|---|
| INLINECODE13 | INLINECODE14 | Language: en or INLINECODE16 |
| INLINECODE17 |
"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 |
技能名称: skilled-openclaw-advisor
详细描述:
OpenClaw 文档智能
所有 OpenClaw 文档的本地 FTS5 索引。无需外部 API 调用。查询时间低于 10 毫秒。
该技能的功能
该技能捆绑了三个 Python 脚本，并查询基于本机安装的 OpenClaw 文档（~/.npm-global/lib/node_modules/openclaw/docs 或等效路径）构建的本地 SQLite FTS5 索引。它仅读取本地文档目录，并仅写入 ~/.openclaw/skills-data/skilled-openclaw-advisor/。查询和构建脚本不发起任何网络请求。更新脚本在检测到文档变更时，可选择通过 openclaw message CLI 发送本地通知（无直接网络调用）。这些脚本不访问凭据或配置密钥，并且在运行时不会读取 openclaw.json（下面列出的配置键是用户可设置的可选覆盖项，并非必需）。
首次设置
安装技能后构建索引：
bash
python3 $SKILLDIR/scripts/buildindex.py
这将扫描本地 OpenClaw 文档，并在 ~/.openclaw/skills-data/skilled-openclaw-advisor/index.db 创建一个 SQLite 索引。
查询
bash
为代理使用提供紧凑输出
python3 $SKILL
DIR/scripts/queryindex.py --query 你的问题 --mode agent
人类可读格式
python3 $SKILL
DIR/scripts/queryindex.py --query 你的问题
包含在线链接的完整详情
python3 $SKILL
DIR/scripts/queryindex.py --query 你的问题 --verbosity detailed
中文结果
python3 $SKILL
DIR/scripts/queryindex.py --query 你的问题 --lang zh-CN
索引状态
python3 $SKILL
DIR/scripts/queryindex.py --status
索引更新
bash
增量更新（检查文档变更）
python3 $SKILL
DIR/scripts/updateindex.py
强制完全重新索引
python3 $SKILL
DIR/scripts/buildindex.py --force
使用时机
- - OpenClaw 配置问题
- CLI 命令和选项
- 频道、提供商、定时任务、会话、代理设置
- OpenClaw 错误排查
不使用时机
- - 与 OpenClaw 无关的通用编码问题
- 关于第三方服务的问题
- 如果索引尚未构建（先运行 build_index.py）
响应模式
| 模式 | 使用场景 | 描述 |
|---|
| agent | 默认代理查询 | 超紧凑，最少令牌 |
| human + standard |
人类提问 | 清晰解释 + 关键点 |
| human + detailed | 深入探究 | 完整摘录 + 示例 |
可选配置
openclaw.json 中 skills.entries.openclaw-docs.config 的设置（全部可选）：
| 键 | 默认值 | 描述 |
|---|
| defaultLang | en | 语言：en 或 zh-CN |
| defaultVerbosity |
standard | 输出：concise、standard、detailed |
| maxResults | 5 | 返回的最大结果数 |
| fallbackToEnglish | true | 如果请求的语言没有结果，则回退到英语 |
| includeOnlineUrl | true | 在详细输出中包含 https://docs.openclaw.ai/... 链接 |
