核心用法
skilled-openclaw-advisor 是一个基于本地 SQLite FTS5 全文索引的文档查询技能，专为 OpenClaw 生态设计。用户首次安装后需运行 build_index.py 构建索引，该脚本扫描本地 OpenClaw 文档目录（~/.npm-global/lib/node_modules/openclaw/docs 或等效路径），生成位于 ~/.openclaw/skills-data/skilled-openclaw-advisor/index.db 的检索数据库。
查询通过 query_index.py 脚本执行，支持多种模式：--mode agent 为智能体提供极简 token 输出，默认模式面向人类可读内容，--verbosity detailed 则返回完整摘录及在线文档链接。额外支持 --lang zh-CN 中文结果输出及 --status 索引状态检查。索引维护通过 update_index.py 实现增量更新，或强制重建。
显著优点
- 极致速度：本地 FTS5 索引，查询延迟低于 10ms，无网络开销
- 零外部依赖：不调用任何 API，完全离线运行
- 精准定位：针对 OpenClaw 特定概念（channels、providers、cron、sessions、agents 等）优化，远胜通用训练数据
- 灵活输出：三级详细度（concise/standard/detailed）+ 双语支持
- 安全隔离：仅读取本地文档，写入限定于技能数据目录，不触碰凭证或
openclaw.json运行时配置
潜在局限
- 前置依赖：必须预先安装 OpenClaw 及 Python3，且需手动执行首次索引构建
- 范围受限：严格限定于 OpenClaw 生态，无法处理通用编程问题或第三方服务咨询
- 时效性瓶颈：依赖本地文档版本，若 OpenClaw 升级后未重建索引，内容可能滞后
- 无语义理解：基于关键词全文检索，非向量语义搜索，复杂语义匹配能力有限
适合人群
- OpenClaw 日常使用者：快速查询 CLI 参数、配置项、插件用法
- 运维/开发者：排查 OpenClaw 运行时错误、理解 session/agent 机制
- CI/CD 集成：通过
agent模式为自动化流程提供结构化文档引用
常规风险
- 索引失效风险：OpenClaw 升级后若未运行
update_index.py或build_index.py --force，查询结果可能指向过时文档 - 磁盘占用：全文索引可能占用显著存储空间（取决于文档规模）
- Python 环境依赖：
python3必须可用，且脚本依赖未明确列出的 Python 标准库/第三方库（如sqlite3外是否有其他依赖未说明） - 路径硬编码风险：文档路径基于常见 npm 全局安装位置，非标准路径安装可能导致索引构建失败