OpenClaw文档检索专家。当用户询问OpenClaw配置、维护、故障排除、通道接入、技能安装、模型配置等问题时使用。支持快速定位官方文档、给出精确URL和关键命令。高价值触发场景包括:(1)配置gateway、channels、plugins;(2)排查连接/认证/权限问题;(3)安装/管理技能。
openclaw-doc-finder是一项面向实际任务的技能,主要用于OpenClaw 官方文档检索技能;识别用户意图,路由到正确文档,给出精确 URL + 关键命令片段;
诊断决策树 (可选):如问题模糊("任务卡住"、"没有反应"),先用 references/diagnostic-tree.md 引导用户细化。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
OpenClaw 官方文档检索技能。识别用户意图,路由到正确文档,给出精确 URL + 关键命令片段。
用户问题 → 意图识别 → 诊断决策树(可选)→ 文档路由 → 本地片段 → 缓存命中 → 远程拉取 → 回答 → 记录速查
严格顺序,不得跳步:
references/diagnostic-tree.md 引导用户细化references/doc-index.md 定位目标文档列表references/ 已有片段references/fetched/.md 是否已有缓存且未过期(7 天内)references/doc-lookups.md见 references/doc-index.md 的「意图→文档路由表」。优先精确匹配场景关键词。
常见场景映射:
| 场景 | 目标文档 |
|---|---|
| 首次安装 / 开始上手 | start/getting-started.md / start/quickstart.md |
| gateway 配置 / 配置文件 | gateway/configuration.md |
| gateway 配置项详解 | gateway/configuration-reference.md |
| 通道接入(Discord/Telegram/飞书等) | channels/index.md + 对应通道文档 |
| 技能安装 / clawhub / skillhub | tools/clawhub 或 start/hubs.md |
| 故障排除 / 报错 | gateway/troubleshooting.md / channels/troubleshooting.md |
| 凭证 / secrets / API key | gateway/secrets.md |
| 模型配置 / 供应商 | providers/ 目录 + gateway/configuration.md |
| CLI 命令用法 | cli/ 目录 |
| openclaw doctor | gateway/doctor.md |
| 安全策略 / 权限 | gateway/security/ + gateway/sandboxing.md |
| 远程访问 / VPS 部署 | gateway/remote.md + vps.md |
| 心跳 / 自动化任务 | gateway/heartbeat.md + cron-jobs |
| 节点配对 / 移动端 | nodes/ 目录 |
| 任务阻塞 / 队列 / 并发 | concepts/queue.md + references/diagnostic-tree.md |
references/doc-index.md — 始终可用,路由总表references/diagnostic-tree.md — 新增"症状→排查路径"决策树references/config-guide.md — gateway 配置高频片段references/troubleshoot.md — 常见报错速查references/doc-lookups.md — 已查阅问题速查(查阅前优先检查)references/fetched/.md — 新增已缓存的远程文档(7 天有效期)当本地和缓存均无目标内容时,按以下顺序尝试:
1. web_fetch ↓ 失败(Blocked / 网络错误) 2. firecrawl_scrape ↓ 失败(Blocked / 超时) 3. exec → curl(最终兜底) ↓ 失败 4. 提供手动查询链接
# 文档 URL 格式:https://docs.openclaw.ai/# 用 curl 拉取并提取正文(去除 HTML 标签) curl -sL "<完整URL>" | python3 -c " import sys, re html = sys.stdin.read() html = re.sub(r'', '', html, flags=re.DOTALL) html = re.sub(r'', '', html, flags=re.DOTALL) text = re.sub(r'<[^>]+>', ' ', html) text = re.sub(r' ', ' ', text) text = re.sub(r's+', ' ', text).strip() # 提取核心内容(从第一个段落开始) idx = text.find('。') if '。' in text else text.find('. ') if idx > 0: print(text[idx:idx+3000]) "
references/fetched/..md> (如 queue.20260405.md)如三种方式均失败,回答格式:
⚠️ 无法自动拉取文档(网络限制)。请手动查看:
- 文档地址:https://docs.openclaw.ai/
- 文档站搜索:https://docs.openclaw.ai/search?q=<关键词>
VERSION(语义化版本,格式 v1.0.0)references/ 内容,必须同步更新 VERSION不要在每次回答前都运行 sync-version.py(开销太大)。
正确做法:
/openclaw_doc_finder_check# 手动触发版本同步(干跑) python3 scripts/sync-version.py --dry-run # 执行同步 python3 scripts/sync-version.py
回答必须包含:
https://docs.openclaw.ai/)当无法拉取时:
⚠️ 无法自动拉取文档。请手动查看: - https://docs.openclaw.ai/
当问题模糊时(先用决策树引导):
在给出具体文档之前,我需要先确认一下: [引用 diagnostic-tree.md 中的关键问题]
禁止:
每次使用本技能查询文档后,必须将问题与结论追加到 references/doc-lookups.md:
相关专题
热门下载
相关下载
精品课程
共1课时 | 178人学习
共0课时 | 0人学习
共1课时 | 227人学习