核心用法
skilled-openclaw-advisor 是 OpenClaw 生态的强制性文档查询技能，要求在任何 OpenClaw 相关问题前优先查询本地索引，禁止依赖训练数据或网络搜索。通过 Python 脚本 query_index.py 执行 FTS5 全文检索，支持多语言（en/zh-CN）、多模式（agent/human）及三级详细度（concise/standard/detailed）。
关键命令：
- 默认代理查询：
--mode agent（最小 token 消耗） - 状态检查：
--status - 增量更新：
update_index.py（每日 5:30 自动运行） - 强制重建：
build_index.py --force
显著优点
1. 极致性能：零外部 API 调用，查询延迟 <10ms
2. 权威实时：本地 FTS5 索引直接映射官方文档，避免模型幻觉
3. 多模态输出：agent 模式压缩至极简令牌，human 模式提供可读解释
4. 语言自适应：自动回退英文，支持中英双语结果
5. 集成工作流：与 openclaw.json 配置联动，支持热更新参数
潜在局限
- 索引依赖：首次使用需运行
build_index.py，未构建时不可用 - 范围限定：仅覆盖 OpenClaw 官方文档，第三方服务需外部查询
- 离线约束：文档更新依赖本地
update_index.py执行，非实时同步上游 - 脚本路径敏感：依赖
$SKILL_DIR环境变量正确定向
适合人群
- OpenClaw 开发者：配置调试、CLI 命令速查、架构理解
- 平台运维人员：Cron/Session/Heartbeat 等运行时机制排查
- AI Agent 系统：作为工具调用实现零延迟知识检索
- 中文用户：原生支持
--lang zh-CN降低阅读成本
常规风险
| 风险项 | 等级 | 说明 |
|--------|------|------|
| 索引过时 | 中 | 未运行 `update_index.py` 可能获取旧版文档 |
| 路径配置错误 | 低 | `$SKILL_DIR` 未设置导致脚本执行失败 |
| 误触发广泛查询 | 低 | 关键词如 "how do I" 可能误激活非 OpenClaw 场景 |
| 语言结果为空 | 低 | 中文文档覆盖不全时自动回退英文 |
建议：生产环境配置 update_index.py 为定时任务，并监控 --status 输出。