OpenClaw Docs Search + Config Patterns 是一个专为 OpenClaw 配置管理设计的本地工具，旨在防止因误操作导致配置文件损坏。在使用 `openclaw.json` 进行任何修改前，该工具强制要求用户先查阅内嵌的配置模式文档，从而规避常见错误。它通过提供正确配置示例与典型反模式的对比，帮助用户理解关键配置项的实际影响，尤其适用于绑定、通道、会话、心跳机制和定时任务等核心模块的设置。 该工具支持两种工作模式：一是直接调用内嵌的参考文档（如 `config-bindings.md`、`config-channel-management.md`），快速获取针对特定任务的配置建议；二是当问题不在预设模板范围内时，启用全文档搜索功能，基于 FTS5 全文检索技术对 OpenClaw 官方文档进行离线匹配。所有索引均存储在本地路径 `~/.openclaw/docs-index/openclaw-docs.sqlite`，无需网络连接，保障了查询速度与隐私安全。此外，工具内置了决策树指引，根据具体操作类型推荐应阅读的参考资料，极大降低了学习成本与配置风险。 为了确保配置变更的安全性，使用本工具前必须首先阅读 `AGENTS.md` 文件中的强制性工作流程与反模式概述。该文件明确了哪些场景下不应使用此技能，例如日常记忆查询应改用 `memory_search`，数据库相关操作则推荐使用专用工具链。整体设计强调预防性干预，而非事后修复，体现了其作为前置检查机制的核心定位。
核心功能特点
- 内嵌配置模式库，包含正确实践与常见反模式对比
- 提供决策树引导，按任务类型推荐对应参考文档
- 支持本地全文检索，基于 FTS5 实现离线关键词匹配
- 强制前置检查机制，修改 openclaw.json 前必读指南
- 涵盖绑定、通道、会话、心跳、定时任务等关键配置主题
适用场景
该工具最适用于需要在生产环境中对 OpenClaw 进行配置调整的开发者或运维人员。无论是新增代理绑定、切换通道状态，还是优化会话重置策略，使用者都能通过内嵌文档快速识别高风险操作并避免配置冲突。例如，在部署新服务时启用特定通信渠道，若未遵循 `config-channel-management.md` 中的规范，可能导致消息路由失败或资源泄漏——而该工具能提前警示此类反模式，提升系统稳定性。 对于遭遇配置异常后的排查场景，此工具同样具有显著价值。当某次更新后 OpenClaw 行为异常，用户可通过 `troubleshooting-config-breaks.md` 快速定位常见问题根源，并结合历史最佳实践恢复正常运行。同时，其文档搜索功能可作为补充手段，用于查找未被预设模板覆盖的技术细节，如特定 API 参数含义或第三方集成注意事项。 值得注意的是，该工具并非为日常记忆辅助或通用编程问题解答而生。若仅需回顾个人笔记或处理 Supabase 数据库事务，应转而使用其他专用技能；同理，Next.js 开发相关问题也不在此工具的服务范围内。其核心价值在于将配置知识系统化、结构化，并通过流程约束降低人为失误概率，特别适合团队协作中统一配置标准与维护一致性。