（2396期）DocClaw – OpenClaw 官方文档的智能检索与验证中枢

OpenClaw 官方文档的智能检索与验证中枢 DocClaw 为 OpenClaw 提供实时文档搜索、精准 Markdown 获取与离线本地文档三重能力，确保配置参数与官方文档严格一致，杜绝臆测行为。 使用说明 核心用法 DocClaw 是一款面向 OpenClaw 生态的专业文档技能，设计目标是在用户询问 how/why 类问题、查询精确配置键值或获取权威文档链接时，提供可追溯、可验证的答案来源。其工作流程分为三级： 1. 实时文档搜索（Primary）通过 openclaw docs "<query>" 快速检索官方文档库，返回 3-7 条带相关性说明的链接，适用于快速定位主题。 2. 精准模式（Precision Mode） 索引刷新：refreshdocsindex.py 更新文档索引 精确获取：fetchdocmarkdown.py 按 slug 或标题关键词拉取 Markdown 原文，支持如 cli/models、gateway/configuration 等精确路径 3. 离线回退（Offline Fallback）当网络不可用时，自动切换至本地文档根目录，通过 findlocaldocs.py 定位并配合 rg（ripgrep）进行本地搜索。 显著优点 权威对齐：强制使用 docs.openclaw.ai 域名，拒绝第三方来源，确保答案与官方标准一致 防幻觉机制：明确禁止"发明"参数、路径或行为，要求关键行为必须通过 openclaw <cmd> --help 二次验证 纵深防御：1.0.3 版本引入 URL 重验证机制，索引来源的链接须经可信域名校验，防止索引污染攻击 跨平台兼容：原生支持 macOS 与 Linux，依赖标准 Python3 环境 潜在缺点与局限性 网络依赖：实时搜索与精准获取需 HTTPS 连接，离线模式依赖预置本地文档，更新滞后 范围锁定：仅覆盖 OpenClaw 官方文档生态，对第三方插件或社区扩展文档无原生支持 验证负担：安全策略要求用户主动运行 --help 交叉验证，增加交互步骤 单点域名：严格限制 docs.openclaw.ai，若官方迁移域名需技能更新 适合人群 OpenClaw 运维工程师与 DevOps 从业者 需要编写合规配置、避免"幻觉参数"的技术写作者 在受限网络环境（如内网部署）中工作的管理员 常规风险 | 风险类别 | 描述 | 缓解措施 ||---------|------|---------|| 供应链攻击 | 本地脚本被篡改导致拉取恶意文档 | 1.0.3 版本强制 URL 域名验证，拒绝 off-domain 条目 || 索引投毒 | 恶意索引条目指向钓鱼域名 | 重验证机制 + HTTPS 强制 || 内容可信 | 拉取文档与运行时行为不一致 | 强制 --help 二次验证 || 离线数据陈旧 | 本地文档未同步最新变更 | 建议定期执行索引刷新脚本 | 版本与维护 当前版本 1.0.3（2026-02-18），为安全补丁版本，重点强化索引 URL 验证与测试覆盖率。打包时需注意从父目录构建 zip，排除 .DS_Store 与 pycache。 原始说明 DocClaw is a documentation skill for OpenClaw that combines live docs search, direct markdown fetch, and offline local-doc fallback.