OpenClaw文档检索专家。当用户询问OpenClaw配置、维护、故障排除、通道接入、技能安装、模型配置等问题时使用。支持快速定位官方文档、给出精确URL和关键命令。高价值触发场景包括:(1)配置gateway、channels、plugins;(2)排查连接/认证/权限问题;(3)安装/管理技能。
openclaw-doc-finder
功能概述
openclaw-doc-finder是一项面向实际任务的技能,主要用于OpenClaw 官方文档检索技能;识别用户意图,路由到正确文档,给出精确 URL + 关键命令片段;
核心要点
- 检索流程(Pipeline);
- 严格顺序,不得跳步:;
- 意图识别 :解析用户问题,判断属于哪个场景类别;
使用与执行
诊断决策树 (可选):如问题模糊("任务卡住"、"没有反应"),先用 references/diagnostic-tree.md 引导用户细化。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
结果检查与注意事项
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
openclaw-doc-finder
OpenClaw 官方文档检索技能。识别用户意图,路由到正确文档,给出精确 URL + 关键命令片段。
检索流程(Pipeline)
用户问题 → 意图识别 → 诊断决策树(可选)→ 文档路由 → 本地片段 → 缓存命中 → 远程拉取 → 回答 → 记录速查
严格顺序,不得跳步:
- 意图识别:解析用户问题,判断属于哪个场景类别
- 诊断决策树(可选):如问题模糊("任务卡住"、"没有反应"),先用
references/diagnostic-tree.md引导用户细化 - 文档路由:查
references/doc-index.md定位目标文档列表 - 本地片段优先:检查
references/已有片段 - 缓存命中:检查
references/fetched/是否已有缓存且未过期(7 天内).md - 远程拉取:本地/缓存均无 → 按"远程拉取规则"拉取,成功后自动缓存
- 版本检查:回答结尾检查 VERSION
- 记录速查:将问题与结论追加到
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/— 新增已缓存的远程文档(7 天有效期).md
远程拉取规则
拉取顺序(降级策略)
当本地和缓存均无目标内容时,按以下顺序尝试:
1. web_fetch ↓ 失败(Blocked / 网络错误) 2. firecrawl_scrape ↓ 失败(Blocked / 超时) 3. exec → curl(最终兜底) ↓ 失败 4. 提供手动查询链接
curl 降级命令模板
# 文档 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) - 有效期:7 天(自动清理过期缓存)
- 写入时机:远程拉取成功后立即写入
无法拉取时的兜底
如三种方式均失败,回答格式:
⚠️ 无法自动拉取文档(网络限制)。请手动查看:
- 文档地址:https://docs.openclaw.ai/
- 文档站搜索:https://docs.openclaw.ai/search?q=<关键词>
版本管理
- 版本文件:
VERSION(语义化版本,格式 v1.0.0) - 每次更新
references/内容,必须同步更新 VERSION - 大版本更新(文档 breaking changes):主版本号 +1,并记录 CHANGELOG
版本同步策略(优化)
不要在每次回答前都运行 sync-version.py(开销太大)。
正确做法:
- 技能初始化时检查一次(后台静默执行)
- 用户手动触发:
/openclaw_doc_finder_check - OpenClaw 大版本升级后主动提醒
# 手动触发版本同步(干跑) python3 scripts/sync-version.py --dry-run # 执行同步 python3 scripts/sync-version.py
输出格式规范
回答必须包含:
- 文档标题 + 完整 URL(
https://docs.openclaw.ai/) - 关键命令(从文档中提取的 CLI 命令,用 ```bash 包裹)
- 配置片段(关键配置项示例)
- 版本提示(如已拉取最新内容,提醒技能版本)
当无法拉取时:
⚠️ 无法自动拉取文档。请手动查看: - https://docs.openclaw.ai/
当问题模糊时(先用决策树引导):
在给出具体文档之前,我需要先确认一下: [引用 diagnostic-tree.md 中的关键问题]
禁止:
- 不带 URL 的泛泛回答
- 混用多个不相关的文档链接
速查记录规则
每次使用本技能查询文档后,必须将问题与结论追加到 references/doc-lookups.md:
- 已有相同问题记录 → 更新对应条目而非重复追加
- 新问题 → 在对应分类下按格式追加
- 记录内容:问题、官方结论、相关文档路径、查阅时间
- 这样下次遇到同类问题时可直接复用,无需重复查阅
CHANGELOG
v1.2.0
- 新增:远程拉取降级策略(web_fetch → firecrawl → curl)
- 新增:自动缓存机制(references/fetched/,7 天有效期)
- 新增:诊断决策树(references/diagnostic-tree.md)
- 优化:版本同步改为手动触发,不再每次回答前执行
- 新增:无法拉取时的兜底说明
v1.1.0
- 优化触发条件:增加主条件+排除场景结构
- 提升激活准确性,防止误触发其他专业技能场景
热门AI工具
相关专题
AionClaw专题整理AI智能体与电脑自动化相关功能使用教程,涵盖安装部署、AI任务执行、Skills技能、文件处理、浏览器控制、电脑操作、持久记忆、聊天工具连接以及办公、编程和内容创作等功能,帮助用户快速掌握AionClaw的实际使用方法。
0
2026.09.20
PHP中文网特设OpenClaw免费大模型专区,提供详尽调用指南。涵盖免费API申请、模型配置及本地部署教程,助您零成本畅享AI智能体验。无论是新手入门还是进阶应用,这里都有实用干货,轻松跨越创作门槛,开启高效智能办公新方式。
79
2026.06.29
本专题专为零基础用户设计,带你从环境搭建到实战应用,系统掌握开源AI Agent OpenClaw。内容涵盖Node.js/Docker安装、API配置、Skills技能扩展及多平台集成,通过整理文件、自动化办公等真实案例,助你快速上手。无论你是想提升效率的职场人还是技术爱好者,都能在此找到从入门到精通的完整路径,打造专属的本地化AI助手。
302
2026.05.06
《OpenClawAI硬件指南最新版》合集聚焦AI硬件入门与进阶,从核心组件解析到实战搭建,系统讲解算力配置、设备选型与优化方案。内容通俗易懂,适合开发者与科技爱好者快速掌握AI硬件要点,构建高效稳定的智能计算环境。
308
2026.03.20
围绕龙虾OpenClawAI使用中的安全风险,本合集系统梳理常见漏洞与隐患,提供实用防护方法与最新安全指南,帮助用户在稳定运行的同时规避风险,提升整体使用安全性与体验。
89
2026.03.20
OpenClawAI Skills 是 OpenClaw 智能体的核心功能模块,用于定义和管理 AI 可执行的具体能力,如查询天气、发送消息、操作文件等。通过技能系统,用户可灵活扩展智能体功能,实现高度定制化的自动化任务。
338
2026.03.20
《OpenClawAI初学者教程:如何使用和设置》是一套面向新手的入门指南,涵盖环境搭建、基础配置、模型加载及简单推理操作。通过本教程,你将快速掌握OpenClawAI的核心功能,轻松开启AI开发之旅。
61
2026.03.19
本合集涵盖2026最新版OpenClaw(小龙虾)本地部署全流程,适用于Windows系统,包含环境配置、模型接入、Web界面启动及飞书/Telegram/QQ等多平台对接。无论你是小白还是开发者,10分钟内即可完成安装,快速体验AI智能体“长手干活”的强大能力!
101
2026.03.19
《OpenClaw如何卸载?OpenClawAI小龙虾安全卸载最新指南》为您提供详尽、安全的卸载步骤,帮助用户彻底移除OpenClaw及其相关组件。本指南针对Windows与macOS系统分别说明操作流程,涵盖停止后台进程、清除配置文件、删除残留数据等关键环节,确保无痕卸载,避免系统冲突或隐私泄露。无论您是因更换工具、解决兼容问题,还是出于安全考虑,本文都将助您高效、安心地完成卸载操作。请务必按照最新版本指引执行,以保障设备稳定与数据安
60
2026.03.19
热门下载
相关下载
精品课程
共1课时 | 178人学习
共0课时 | 0人学习
共1课时 | 229人学习