OpenClaw Doc Finder

Polar Sponsor
爱发电 赞助
.NET 9.0

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)

用户问题 → 意图识别 → 诊断决策树(可选)→ 文档路由 → 本地片段 → 缓存命中 → 远程拉取 → 回答 → 记录速查

严格顺序,不得跳步:

  1. 意图识别:解析用户问题,判断属于哪个场景类别
  2. 诊断决策树(可选):如问题模糊("任务卡住"、"没有反应"),先用 references/diagnostic-tree.md 引导用户细化
  3. 文档路由:查 references/doc-index.md 定位目标文档列表
  4. 本地片段优先:检查 references/ 已有片段
  5. 缓存命中:检查 references/fetched/.md 是否已有缓存且未过期(7 天内)
  6. 远程拉取:本地/缓存均无 → 按"远程拉取规则"拉取,成功后自动缓存
  7. 版本检查:回答结尾检查 VERSION
  8. 记录速查:将问题与结论追加到 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. 提供手动查询链接

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

输出格式规范

回答必须包含:

  1. 文档标题 + 完整 URL(https://docs.openclaw.ai/)
  2. 关键命令(从文档中提取的 CLI 命令,用 ```bash 包裹)
  3. 配置片段(关键配置项示例)
  4. 版本提示(如已拉取最新内容,提醒技能版本)

当无法拉取时:

⚠️ 无法自动拉取文档。请手动查看:
- 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

  • 优化触发条件:增加主条件+排除场景结构
  • 提升激活准确性,防止误触发其他专业技能场景

相关专题

更多
AionClaw AI智能体与电脑自动化任务执行功能使用教程
AionClaw AI智能体与电脑自动化任务执行功能使用教程

AionClaw专题整理AI智能体与电脑自动化相关功能使用教程,涵盖安装部署、AI任务执行、Skills技能、文件处理、浏览器控制、电脑操作、持久记忆、聊天工具连接以及办公、编程和内容创作等功能,帮助用户快速掌握AionClaw的实际使用方法。

2026.09.20

0

15

OpenClaw免费大模型调用指南
OpenClaw免费大模型调用指南

PHP中文网特设OpenClaw免费大模型专区,提供详尽调用指南。涵盖免费API申请、模型配置及本地部署教程,助您零成本畅享AI智能体验。无论是新手入门还是进阶应用,这里都有实用干货,轻松跨越创作门槛,开启高效智能办公新方式。

2026.06.29

79

10

OpenClaw从新手到中级完整教程
OpenClaw从新手到中级完整教程

本专题专为零基础用户设计,带你从环境搭建到实战应用,系统掌握开源AI Agent OpenClaw。内容涵盖Node.js/Docker安装、API配置、Skills技能扩展及多平台集成,通过整理文件、自动化办公等真实案例,助你快速上手。无论你是想提升效率的职场人还是技术爱好者,都能在此找到从入门到精通的完整路径,打造专属的本地化AI助手。

2026.05.06

302

32

openclaw养虾硬件指南最新版
openclaw养虾硬件指南最新版

《OpenClawAI硬件指南最新版》合集聚焦AI硬件入门与进阶,从核心组件解析到实战搭建,系统讲解算力配置、设备选型与优化方案。内容通俗易懂,适合开发者与科技爱好者快速掌握AI硬件要点,构建高效稳定的智能计算环境。

2026.03.20

308

28

龙虾OpenClaw安全使用指南
龙虾OpenClaw安全使用指南

围绕龙虾OpenClawAI使用中的安全风险,本合集系统梳理常见漏洞与隐患,提供实用防护方法与最新安全指南,帮助用户在稳定运行的同时规避风险,提升整体使用安全性与体验。

2026.03.20

89

11

OpenClawAI技能系统基础介绍:OpenClawAISkills是什么
OpenClawAI技能系统基础介绍:OpenClawAISkills是什么

OpenClawAI Skills 是 OpenClaw 智能体的核心功能模块,用于定义和管理 AI 可执行的具体能力,如查询天气、发送消息、操作文件等。通过技能系统,用户可灵活扩展智能体功能,实现高度定制化的自动化任务。

2026.03.20

338

20

OpenClaw初学者教程:如何使用和设置
OpenClaw初学者教程:如何使用和设置

《OpenClawAI初学者教程:如何使用和设置》是一套面向新手的入门指南,涵盖环境搭建、基础配置、模型加载及简单推理操作。通过本教程,你将快速掌握OpenClawAI的核心功能,轻松开启AI开发之旅。

2026.03.19

61

13

OpenClaw安装部署教程
OpenClaw安装部署教程

本合集涵盖2026最新版OpenClaw(小龙虾)本地部署全流程,适用于Windows系统,包含环境配置、模型接入、Web界面启动及飞书/Telegram/QQ等多平台对接。无论你是小白还是开发者,10分钟内即可完成安装,快速体验AI智能体“长手干活”的强大能力!

2026.03.19

101

11

OpenClaw如何卸载
OpenClaw如何卸载

《OpenClaw如何卸载?OpenClawAI小龙虾安全卸载最新指南》为您提供详尽、安全的卸载步骤,帮助用户彻底移除OpenClaw及其相关组件。本指南针对Windows与macOS系统分别说明操作流程,涵盖停止后台进程、清除配置文件、删除残留数据等关键环节,确保无痕卸载,避免系统冲突或隐私泄露。无论您是因更换工具、解决兼容问题,还是出于安全考虑,本文都将助您高效、安心地完成卸载操作。请务必按照最新版本指引执行,以保障设备稳定与数据安

2026.03.19

60

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程