核心用法
skilled-openclaw-advisor 是 OpenClaw 生态的文档检索技能，基于本地 FTS5 全文索引实现高性能查询。核心命令为 query_index.py，支持 --mode agent（极简令牌模式）、--lang zh-CN（中文结果）、--verbosity concise/standard/detailed（三级详略）三种维度的灵活组合。首次使用需运行 build_index.py 构建索引，update_index.py 支持夜间自动增量更新。
显著优点
- 零外部依赖：纯本地索引，无 API 调用，响应时间 <10ms
- 权威性优先：强制规则要求所有 OpenClaw 相关问题必须先查文档，禁止依赖训练数据猜测
- 多语言支持：内置英文/中文切换，智能回退机制
- Agent 优化：
--mode agent输出极致精简，显著降低令牌消耗 - 自动化运维：支持定时更新、状态检查、变更 diff 追踪
潜在局限
- 索引冷启动：首次必须手动执行
build_index.py，未构建索引时不可用 - 文档覆盖边界：仅索引 OpenClaw 官方文档，第三方服务需外部查询
- 配置分散：多键配置（
defaultLang、agentMode等）分散在openclaw.json和脚本硬编码两处 - 中文分词依赖：FTS5 对中文支持依赖外部分词器，极端长词查询可能召回不足
适合人群
- OpenClaw 平台开发者与运维工程师
- 需要高频查询配置项的自动化 Agent
- 对响应延迟敏感的 CLI 重度用户
常规风险
- 索引滞后风险：文档源更新后若未及时运行
update_index.py，可能返回过时信息 - 路径硬编码风险：脚本路径包含
workspace-ada等环境标识，跨工作空间迁移需手动调整 - 权限风险：索引文件需读/写权限，多用户环境可能出现访问冲突
- 回退语义风险：
fallbackToEnglish=true时，用户可能未察觉结果语言已切换