核心用途
claw-wiki 是一个面向 OpenClaw 产品的本地文档知识库技能。其核心功能是提供离线的、可验证的产品文档查询能力，覆盖部署配置、CLI 命令、网关行为、通道机制、工具使用及故障排查等场景。同时支持在显式请求时刷新本地快照，与上游文档保持同步。
显著优点
权威性与可验证性
- 所有回答严格基于本地
openclaw_docs/快照，而非模型记忆，确保信息可追溯、可验证 - 响应中明确标注引用的文件路径，便于用户快速核查原文
- 支持版本溯源：通过
state/source-lock.json提供当前快照的 commit、ref 及同步时间
高效的检索策略
- 采用分层路由机制：
routing-cheatsheet.md处理宽泛意图 →query-examples.md优化弱关键词 →rg精准搜索 - 优先文件名匹配，再扩展至内容，避免全树遍历的性能损耗
- 对超大文件支持段落级跳转，兼顾速度与上下文完整性
可控的更新机制
- 支持显式刷新：
sync_docs.py→validate_docs.py→build_knowledge.py→diff_docs.py的确定性流水线 - 更新范围清晰：仅读取上游（local checkout 或 git fetch/clone），禁止写操作（无 push、无 PR、无上传）
潜在局限
内容时效性约束
- 本地快照非实时同步，用户需主动请求更新才能获取最新文档
- 对于"最新"特性询问，必须显式声明快照版本，避免误导
语言覆盖局限
- 仅保证英文文档集的可用性；
docs.json中的本地化导航条目可能存在但未经完整验证
查询依赖用户意图清晰度
- 若用户意图模糊且关键词薄弱，需依赖
routing-cheatsheet.md和query-examples.md的启发式路由，存在一定理解偏差风险
适合人群
- OpenClaw 运维/开发工程师：需要快速查询部署配置、CLI 用法、网关行为
- 技术支持人员：处理故障排查、诊断指南、安全策略相关咨询
- 产品集成者：了解通道、提供商、插件、节点等集成机制
- 文档维护者：需要定期同步上游文档变更的自动化场景
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 信息过时 | 本地快照可能滞后于上游 | 响应中强制声明快照版本；用户要求"最新"时触发更新流程 |
| 幻觉生成 | 模型可能编造不存在的参数或命令 | 严格禁止发明未在文档中出现的 flags、defaults、config keys |
| 权限越界 | 误执行写操作至上游仓库 | 明确禁止 `git push`、PR 创建、上传 skill 文件夹 |
| 搜索遗漏 | 宽泛查询导致关键文档未命中 | 采用"文件名→内容→扩大范围"的渐进式搜索策略 |
| 本地化误导 | 非英文文档内容准确性未验证 | 优先使用英文文档集，非英文内容需显式声明验证状态 |