search-openclaw-docs

search-openclaw-docs 是一款专为 OpenClaw 框架设计的离线文档搜索与配置辅助技能，旨在解决配置修改过程中常见的静默损坏问题。

核心用法：该技能提供两种工作模式。第一种是嵌入式参考模式，包含 8 个关键配置文件，涵盖代理绑定、通道管理、会话重置、心跳监测、定时任务等核心配置场景，每个文件均包含正确模式、常见反模式、错误原因分析及示例代码。用户通过决策树快速定位所需参考，在修改 openclaw.json 前进行强制性检查。第二种是文档搜索模式，基于 SQLite FTS5 全文检索技术，对本地 OpenClaw 文档建立索引，支持关键词模糊匹配和 camelCase 术语识别，实现毫秒级离线检索。

显著优点：首先，完全离线运行确保零网络延迟与绝对数据隐私，所有操作均在本地完成。其次，防配置损坏机制通过嵌入式反模式库，提前拦截常见配置错误，避免系统故障。第三，决策树工作流将复杂的配置场景结构化，降低学习成本。第四，基于 better-sqlite3 的索引系统提供高效的模糊搜索能力，支持 Porter 词干提取，匹配精度高。

潜在缺点与局限性：该技能强依赖 Node.js 运行时环境，且 better-sqlite3 需要编译原生模块，在部分系统上可能存在安装障碍。功能高度专属于 OpenClaw 生态，不具备通用文档搜索能力。作为个人开发者维护项目（T3 来源），长期维护稳定性存在不确定性。此外，索引需要手动维护，OpenClaw 版本更新后必须重建索引，否则可能返回过期信息。

适合的目标群体：主要面向 OpenClaw 框架的使用者，特别是负责配置管理的系统管理员、DevOps 工程师和后端开发者。对于频繁调整代理绑定、通道策略或会话策略的技术团队，该技能可作为配置变更前的强制性检查点。同时适合需要离线查阅 OpenClaw 文档的开发者。

使用风险：性能方面，初次使用需构建全文索引，在文档量较大时可能耗时较长。依赖项方面，better-sqlite3 的版本锁定在 major 版本，存在潜在的兼容性风险。来源可信度方面，作为个人项目，建议审查代码后再部署于生产环境。索引文件存储于用户主目录，需注意磁盘权限管理。