OpenClaw 中 web_search web_fetch 最佳实践速查表摘要本文帮助读者明确 OpenClaw 网络搜索工具和不同搜索技能的的职责边界理解“先搜索、再抓取、后总结”的最佳实践并能更稳定地在 OpenClaw 中使用tavily-search与web_fetch完成网络信息搜索任务。主要内容包括解决 OpenClaw 中web_search、tavily-search、web_fetch、原生 provider 与扩展 skill 容易混淆的问题、网络搜索能力分层说明、OpenClaw 原生搜索 provider 与 Tavily/Firecrawl 扩展 skill 的区别、标准工作流、提示词模板、命令行验证、常见误区与排障方法。导读如果你还没有为 OpenClaw 安装 Tavily-Search 、Agent-Reach 或平替的搜索技能先阅读以下文章Tavily-Search 安装 TODOAgent Reach 安装与 OpenClaw 网络搜索能力扩展指南目录一、核心结论二、OpenClaw 2026.3.13 的搜索能力层次三、从使用者视角理解整体结构四、一句话理解关系五、web_search、原生 provider、扩展 skill、web_fetch的关系六、推荐的理解模型七、最推荐的使用分工八、标准工作流九、什么时候优先用tavily-search十、什么时候优先用web_fetch十一、OpenClaw 中推荐的标准流程十二、最常用的对话提示词模板十三、命令行直测速查十四、在对话中怎么更稳定触发正确流程十五、常见误区十六、推荐默认策略十七、排障速查十八、术语表十九、一句话总结一、核心结论在 OpenClaw 里最容易混淆的几个概念是web_searchtavily-searchweb_fetch原生搜索 provider扩展 skill最准确、最实用的理解方式是**web_search**统一的网页搜索能力接口/抽象能力**web_fetch**统一的网页读取/抓取能力接口原生 providerOpenClaw 直接支持配置的搜索后端扩展 skill用户手动安装后接入的额外搜索/抓取能力**tavily-search**属于扩展 skill不是 OpenClaw 2026.3.13 当前配置向导里的原生 provider一句话记忆搜索负责找抓取负责读原生 provider 是 OpenClaw 自带接线Tavily / Firecrawl 是后装扩展能力。二、OpenClaw 2026.3.13 的搜索能力层次1原生可配置的 web search provider在 OpenClaw 2026.3.13 版本中配置向导当前原生支持以下搜索 providerBrave Search# 需要 API Key有免费额度但需要绑定信用卡Gemini (Google Search)# 需要 API Key依赖 Google 服务国内需代理Grok (xAI)# 需要 API Key国内访问限制多文档较少Kimi (Moonshot)# 需要 API Key中文理解优秀国际内容覆盖可能较弱Perplexity Search# 需要 API Key国内需代理OpenClaw 配置导向提示如下◆ Choose web search provider │ ● Brave Search (Structured results · country/language/time filters) │ ○ Gemini (Google Search) │ ○ Grok (xAI) │ ○ Kimi (Moonshot) │ ○ Perplexity Search这些属于OpenClaw 原生支持用户可在配置时直接选择是web_search能力的默认后端候选2需要用户自行安装和配置的 skill以下能力不是当前版本配置向导里原生可选的web_search provider而是需要用户自行安装FirecrawlTavily它们属于扩展 skill需要手动安装需要单独配置 API key 或依赖安装后可以补充搜索、抓取或 AI 优化检索能力所以Brave / Gemini / Grok / Kimi / Perplexity 是原生 providerFirecrawl / Tavily 是额外安装的扩展 skill。三、从使用者视角理解整体结构OpenClaw 的统一能力接口能力来源原生 providerBrave / Gemini / Grok / Kimi / Perplexity扩展 skillTavily / Firecrawl web_search搜索关键词 / 找来源 / 找链接 web_fetch打开页面 / 抓取正文 / 读取细节四、一句话理解关系web_search和web_fetch是 OpenClaw / agent 提供给你的统一能力接口像“遥控器”Brave、Gemini、Grok、Kimi、Perplexity 是 OpenClaw 原生支持的搜索 provider像内置频道”Tavily、Firecrawl 是用户后装的扩展 skill像“额外加装的频道模块”你配置了哪个 provider 或安装了哪个 skillagent 就更可能通过对应能力去完成搜索或抓取。五、web_search、原生 provider、扩展 skill、web_fetch的关系1web_search是能力层web_search说的是“网页搜索”这件事本身不一定绑定某一个具体产品名。它可以由以下两类来源来实现原生 provider扩展 skill2原生 provider 是 OpenClaw 内建支持的后端在 OpenClaw 2026.3.13 中以下属于原生 providerBrave SearchGeminiGrokKimiPerplexity Search这些更接近安装时可直接选配置体验更原生默认就是 OpenClaw 官方接入的搜索后端3Tavily / Firecrawl 属于扩展 skill它们不是当前版本配置向导里直接列出的原生 provider而是用户单独安装手动配置作为扩展能力接入 OpenClaw所以tavily-search不是当前版本原生web_search provider列表的一员但它依然可以提供高质量网页搜索能力在实际使用中它可以充当web_search的一种补充实现4web_fetch是网页读取能力web_fetch的职责通常是打开具体 URL读取页面内容抓取正文提取细节所以它不负责“找页面”而负责“读页面”。六、推荐的理解模型模型 1能力层web_search找来源web_fetch读来源模型 2实现层原生 providerBrave / Gemini / Grok / Kimi / Perplexity扩展 skillTavily / Firecrawl模型 3具体环境中的最佳实践假定当前额外安装了tavily-searchagent-reach而web_fetch是当前 agent 已可用的 tool。所以你当前更适合的工作流是先用tavily-search搜索再用web_fetch阅读必要时用agent-reach协调多步任务如何安装tavily-searchTODO有空补上安装实践记录 如何安装agent-reach Agent Reach 安装与 OpenClaw 网络搜索能力扩展指南七、最推荐的使用分工tavily-search负责什么适合找最新资料找新闻找论文入口找官方文档入口找多个候选来源为后续精读做召回web_fetch负责什么适合已经有 URL已经知道要读哪个页面读取正文抓取细节提取发布日期、作者、版本号、参数说明核对页面中是否真的写了某句话agent-reach负责什么适合协调多步任务提高外部能力被调用的概率强化“先搜索、再阅读、再总结”的工作流降低模型直接凭已有知识回答的概率八、标准工作流工作流 A你没有 URL用tavily-search搜索获取候选来源选择最相关来源用web_fetch读取工作流 B你已有 URL直接用web_fetch读取工作流 C复杂多步任务用agent-reach协调任务先搜索再阅读最后总结九、什么时候优先用tavily-search适合你还没有具体网址你要查“最新”“最近”“本周”“本月”你需要候选来源列表你要找新闻、论文、公告、文档入口你不确定先读哪个页面典型任务最近一周 AI 新闻某个框架最近更新了什么某个 API 的官方文档入口某个研究方向最近有哪些论文十、什么时候优先用web_fetch适合你已经有 URL你只想读某个页面你需要正文你需要页面细节你要提取参数、版本号、发布日期等信息典型任务阅读官方文档页面总结新闻正文提取博客文章要点查看 release note 里的变更项十一、OpenClaw 中推荐的标准流程有没有用户问题是否已有明确 URL直接用 web_fetch先用 web_search 能力搜索在你当前环境里可由原生 provider 或 tavily-search 实现得到候选来源 / 链接再用 web_fetch 读取十二、最常用的对话提示词模板1搜索后再读取先使用 tavily-search 搜索这个主题列出 5 个最相关来源再使用 web_fetch 打开最相关的 1 个页面并总结。主题multimodal RAG 最新论文2只搜索不精读使用 tavily-search 搜索最近一周关于 OpenAI 模型发布的新闻只给我来源列表和一句话摘要。3官方来源优先使用 tavily-search 搜索 Kubernetes Ingress 官方文档优先官方来源再用 web_fetch 打开最相关页面并总结。4搜索新闻先用 tavily-search 搜索最近一周 AI agent 相关新闻再给我按时间排序的摘要。5搜索论文先使用 tavily-search 搜索 multimodal RAG 相关论文优先 arXiv 和官方论文页面再使用 web_fetch 阅读最相关页面并总结。6多步任务协同这是一个多步任务。请通过 agent-reach 协调当前可用能力不要直接凭已有知识回答。先使用 tavily-search 搜索高质量来源再使用 web_fetch 阅读最相关页面最后给出带来源的结论。主题最近一个月关于 AI agent memory 的研究进展。十三、命令行直测速查下面这些命令用于直接测试tavily-searchskill 本体。基础搜索# 作用执行最基础的一次 Tavily 搜索。# 语法node 脚本路径 查询词# 规则# - 查询词建议放在双引号中# - 适合快速验证插件和 API key 是否生效node~/.openclaw/skills/liang-tavily-search/scripts/search.mjspython async patterns指定结果数量# 作用控制返回结果数。# 语法node 脚本路径 查询词 -n 数量# 规则# - 常见范围 1 到 20# - 数量越多召回越广但噪声可能增加node~/.openclaw/skills/liang-tavily-search/scripts/search.mjsReact hooks tutorial-n10指定搜索深度# 作用调整搜索深度在速度和相关性之间取平衡。# 语法node 脚本路径 查询词 --depth 模式# 规则# - 可选值ultra-fast、fast、basic、advanced# - basic 最通用# - advanced 适合研究型任务node~/.openclaw/skills/liang-tavily-search/scripts/search.mjsmachine learning evaluation benchmarks--depthadvanced搜索新闻# 作用把搜索主题切换为新闻类。# 语法node 脚本路径 查询词 --topic news# 规则# - 适合最新事件、产品发布、政策变化# - 如果不是新闻类查询建议用默认 generalnode~/.openclaw/skills/liang-tavily-search/scripts/search.mjsAI regulation Europe--topicnews限定时间范围# 作用限制搜索结果的时间范围。# 语法node 脚本路径 查询词 --time-range 范围# 规则# - 可选值day、week、month、year# - 适合“最近一周”“最近一个月”这类查询node~/.openclaw/skills/liang-tavily-search/scripts/search.mjsOpenAI API updates--topicnews --time-range week限定域名# 作用只保留指定域名结果。# 语法node 脚本路径 查询词 --include-domains 域名列表# 规则# - 多个域名通常用逗号分隔# - 适合官方文档、论文站点、可信来源筛选node~/.openclaw/skills/liang-tavily-search/scripts/search.mjsPython asyncio gather--include-domains docs.python.org排除域名# 作用排除某些不想要的域名。# 语法node 脚本路径 查询词 --exclude-domains 域名列表# 规则# - 多个域名通常用逗号分隔# - 适合过滤低质量或无关站点node~/.openclaw/skills/liang-tavily-search/scripts/search.mjsLLM benchmarks--exclude-domains pinterest.com,reddit.com输出 JSON# 作用输出原始 JSON方便调试和脚本二次处理。# 语法node 脚本路径 查询词 --json# 规则# - 适合程序消费# - 不适合纯人工阅读node~/.openclaw/skills/liang-tavily-search/scripts/search.mjsvector database comparison--json返回更完整内容# 作用尝试返回更完整的页面内容而不只是摘要片段。# 语法node 脚本路径 查询词 --raw-content# 规则# - 输出会更长# - 更适合研究和离线分析node~/.openclaw/skills/liang-tavily-search/scripts/search.mjsmultimodal RAG survey--raw-content多参数组合# 作用组合数量、主题、时间范围、域名过滤等参数。# 语法# node 脚本路径 查询词 -n 数量 --topic 主题 --time-range 范围 --include-domains 域名列表# 规则# - 参数越明确结果通常越稳定# - 适合研究型和高价值查询node~/.openclaw/skills/liang-tavily-search/scripts/search.mjsmultimodal RAG papers-n8--topicgeneral --time-range year --include-domains arxiv.org,acm.org十四、在对话中怎么更稳定触发正确流程推荐写法 1明确步骤先使用 tavily-search 搜索高质量来源再使用 web_fetch 阅读最相关页面最后总结。推荐写法 2强调不要直接回答不要直接凭已有知识回答。先使用 tavily-search 搜索再使用 web_fetch 阅读来源然后给出结论。推荐写法 3强调这是最新信息这是一个需要最新信息的问题。请先使用 tavily-search 搜索最近一周相关资料再使用 web_fetch 阅读最相关页面。推荐写法 4强调官方来源先使用 tavily-search 搜索优先官方来源再使用 web_fetch 打开最相关页面并提取关键信息。推荐写法 5加入agent-reach强化多步协同请通过 agent-reach 协调当前可用能力不要直接回答。先使用 tavily-search 搜索高质量来源再使用 web_fetch 阅读关键页面最后输出带来源的总结。十五、常见误区误区 1把web_search当成固定插件名web_search往往是“网页搜索能力”的泛称不一定是某个具体 skill 名。误区 2把原生 provider 和扩展 skill 混为一谈Brave / Gemini / Grok / Kimi / Perplexity 是 OpenClaw 原生 providerTavily / Firecrawl 是用户自行安装的扩展 skill误区 3把web_fetch当成搜索工具web_fetch一般负责“打开页面”不是“找页面”。误区 4以为装了tavily-search就不需要web_fetchtavily-search更适合召回来源web_fetch更适合精读页面。两者配合效果最好。误区 5以为 provider、skill、tool 是同一层provider底层服务来源skill扩展能力封装方式tool / interfaceagent 暴露给你的能力入口误区 6以为agent-reach是搜索工具agent-reach更适合作为多步任务协调层而不是单独的搜索引擎替代品。十六、推荐默认策略如果没有 URL先用tavily-search如果有 URL直接用web_fetch如果问题涉及最新信息先用tavily-search必要时限定时间范围如果需要精读先tavily-search后web_fetch如果需要官方来源先用tavily-search找官方页面再用web_fetch读如果任务是多步研究加入agent-reach协调“搜索 → 阅读 → 总结”十七、排障速查情况 1脚本报TAVILY_API_KEY not set说明当前 shell 没拿到环境变量。# 作用检查当前 shell 是否已经有 TAVILY_API_KEY。# 语法echo $TAVILY_API_KEY# 规则# - 有输出表示变量已生效# - 空输出表示变量未生效echo$TAVILY_API_KEY情况 2tavily-search已安装但对话里没触发通常不是安装失败而是提示词不够明确。建议直接这样写不要直接回答。先使用 tavily-search 搜索再使用 web_fetch 阅读来源最后给出结论。情况 3旧会话行为异常新开一个会话再试避免旧上下文干扰工具选择。情况 4想确认 skill 本体是否可用# 作用绕过会话层直接测试 tavily-search skill 脚本本体。# 语法node 脚本路径 查询词# 规则# - 这是最稳的插件可用性验证方法node~/.openclaw/skills/liang-tavily-search/scripts/search.mjslatest papers on multimodal RAG情况 5复杂任务总是只用一个工具尝试在提示词中显式加入这是一个多步任务。请通过 agent-reach 协调当前可用能力先搜索再阅读最后总结。十八、术语表web_search网页搜索能力的抽象接口重点是“找来源”。web_fetch网页读取能力接口重点是“读页面”。provider底层搜索/能力提供方例如BraveGeminiGrokKimiPerplexityskill额外安装的扩展能力封装例如TavilyFirecrawlagent-reachtavily-search基于 Tavily 的扩展搜索 skill可用于补充或增强web_search能力。agent-reach用于协调多步任务、强化外部能力调用的 skill不是传统搜索引擎替代品。十九、一句话总结**web_search**搜索能力的抽象接口原生 providerBrave / Gemini / Grok / Kimi / Perplexity扩展 skillTavily / Firecrawl / agent-reach**web_fetch**网页读取与抓取能力最佳实践是先用搜索能力找来源你当前常用tavily-search再用web_fetch读来源复杂任务再用agent-reach协调。
OpenClaw 中 web_search + web_fetch 最佳实践速查表
发布时间：2026/6/18 20:15:38
OpenClaw 中 web_search web_fetch 最佳实践速查表摘要本文帮助读者明确 OpenClaw 网络搜索工具和不同搜索技能的的职责边界理解“先搜索、再抓取、后总结”的最佳实践并能更稳定地在 OpenClaw 中使用tavily-search与web_fetch完成网络信息搜索任务。主要内容包括解决 OpenClaw 中web_search、tavily-search、web_fetch、原生 provider 与扩展 skill 容易混淆的问题、网络搜索能力分层说明、OpenClaw 原生搜索 provider 与 Tavily/Firecrawl 扩展 skill 的区别、标准工作流、提示词模板、命令行验证、常见误区与排障方法。导读如果你还没有为 OpenClaw 安装 Tavily-Search 、Agent-Reach 或平替的搜索技能先阅读以下文章Tavily-Search 安装 TODOAgent Reach 安装与 OpenClaw 网络搜索能力扩展指南目录一、核心结论二、OpenClaw 2026.3.13 的搜索能力层次三、从使用者视角理解整体结构四、一句话理解关系五、web_search、原生 provider、扩展 skill、web_fetch的关系六、推荐的理解模型七、最推荐的使用分工八、标准工作流九、什么时候优先用tavily-search十、什么时候优先用web_fetch十一、OpenClaw 中推荐的标准流程十二、最常用的对话提示词模板十三、命令行直测速查十四、在对话中怎么更稳定触发正确流程十五、常见误区十六、推荐默认策略十七、排障速查十八、术语表十九、一句话总结一、核心结论在 OpenClaw 里最容易混淆的几个概念是web_searchtavily-searchweb_fetch原生搜索 provider扩展 skill最准确、最实用的理解方式是**web_search**统一的网页搜索能力接口/抽象能力**web_fetch**统一的网页读取/抓取能力接口原生 providerOpenClaw 直接支持配置的搜索后端扩展 skill用户手动安装后接入的额外搜索/抓取能力**tavily-search**属于扩展 skill不是 OpenClaw 2026.3.13 当前配置向导里的原生 provider一句话记忆搜索负责找抓取负责读原生 provider 是 OpenClaw 自带接线Tavily / Firecrawl 是后装扩展能力。二、OpenClaw 2026.3.13 的搜索能力层次1原生可配置的 web search provider在 OpenClaw 2026.3.13 版本中配置向导当前原生支持以下搜索 providerBrave Search# 需要 API Key有免费额度但需要绑定信用卡Gemini (Google Search)# 需要 API Key依赖 Google 服务国内需代理Grok (xAI)# 需要 API Key国内访问限制多文档较少Kimi (Moonshot)# 需要 API Key中文理解优秀国际内容覆盖可能较弱Perplexity Search# 需要 API Key国内需代理OpenClaw 配置导向提示如下◆ Choose web search provider │ ● Brave Search (Structured results · country/language/time filters) │ ○ Gemini (Google Search) │ ○ Grok (xAI) │ ○ Kimi (Moonshot) │ ○ Perplexity Search这些属于OpenClaw 原生支持用户可在配置时直接选择是web_search能力的默认后端候选2需要用户自行安装和配置的 skill以下能力不是当前版本配置向导里原生可选的web_search provider而是需要用户自行安装FirecrawlTavily它们属于扩展 skill需要手动安装需要单独配置 API key 或依赖安装后可以补充搜索、抓取或 AI 优化检索能力所以Brave / Gemini / Grok / Kimi / Perplexity 是原生 providerFirecrawl / Tavily 是额外安装的扩展 skill。三、从使用者视角理解整体结构OpenClaw 的统一能力接口能力来源原生 providerBrave / Gemini / Grok / Kimi / Perplexity扩展 skillTavily / Firecrawl web_search搜索关键词 / 找来源 / 找链接 web_fetch打开页面 / 抓取正文 / 读取细节四、一句话理解关系web_search和web_fetch是 OpenClaw / agent 提供给你的统一能力接口像“遥控器”Brave、Gemini、Grok、Kimi、Perplexity 是 OpenClaw 原生支持的搜索 provider像内置频道”Tavily、Firecrawl 是用户后装的扩展 skill像“额外加装的频道模块”你配置了哪个 provider 或安装了哪个 skillagent 就更可能通过对应能力去完成搜索或抓取。五、web_search、原生 provider、扩展 skill、web_fetch的关系1web_search是能力层web_search说的是“网页搜索”这件事本身不一定绑定某一个具体产品名。它可以由以下两类来源来实现原生 provider扩展 skill2原生 provider 是 OpenClaw 内建支持的后端在 OpenClaw 2026.3.13 中以下属于原生 providerBrave SearchGeminiGrokKimiPerplexity Search这些更接近安装时可直接选配置体验更原生默认就是 OpenClaw 官方接入的搜索后端3Tavily / Firecrawl 属于扩展 skill它们不是当前版本配置向导里直接列出的原生 provider而是用户单独安装手动配置作为扩展能力接入 OpenClaw所以tavily-search不是当前版本原生web_search provider列表的一员但它依然可以提供高质量网页搜索能力在实际使用中它可以充当web_search的一种补充实现4web_fetch是网页读取能力web_fetch的职责通常是打开具体 URL读取页面内容抓取正文提取细节所以它不负责“找页面”而负责“读页面”。六、推荐的理解模型模型 1能力层web_search找来源web_fetch读来源模型 2实现层原生 providerBrave / Gemini / Grok / Kimi / Perplexity扩展 skillTavily / Firecrawl模型 3具体环境中的最佳实践假定当前额外安装了tavily-searchagent-reach而web_fetch是当前 agent 已可用的 tool。所以你当前更适合的工作流是先用tavily-search搜索再用web_fetch阅读必要时用agent-reach协调多步任务如何安装tavily-searchTODO有空补上安装实践记录 如何安装agent-reach Agent Reach 安装与 OpenClaw 网络搜索能力扩展指南七、最推荐的使用分工tavily-search负责什么适合找最新资料找新闻找论文入口找官方文档入口找多个候选来源为后续精读做召回web_fetch负责什么适合已经有 URL已经知道要读哪个页面读取正文抓取细节提取发布日期、作者、版本号、参数说明核对页面中是否真的写了某句话agent-reach负责什么适合协调多步任务提高外部能力被调用的概率强化“先搜索、再阅读、再总结”的工作流降低模型直接凭已有知识回答的概率八、标准工作流工作流 A你没有 URL用tavily-search搜索获取候选来源选择最相关来源用web_fetch读取工作流 B你已有 URL直接用web_fetch读取工作流 C复杂多步任务用agent-reach协调任务先搜索再阅读最后总结九、什么时候优先用tavily-search适合你还没有具体网址你要查“最新”“最近”“本周”“本月”你需要候选来源列表你要找新闻、论文、公告、文档入口你不确定先读哪个页面典型任务最近一周 AI 新闻某个框架最近更新了什么某个 API 的官方文档入口某个研究方向最近有哪些论文十、什么时候优先用web_fetch适合你已经有 URL你只想读某个页面你需要正文你需要页面细节你要提取参数、版本号、发布日期等信息典型任务阅读官方文档页面总结新闻正文提取博客文章要点查看 release note 里的变更项十一、OpenClaw 中推荐的标准流程有没有用户问题是否已有明确 URL直接用 web_fetch先用 web_search 能力搜索在你当前环境里可由原生 provider 或 tavily-search 实现得到候选来源 / 链接再用 web_fetch 读取十二、最常用的对话提示词模板1搜索后再读取先使用 tavily-search 搜索这个主题列出 5 个最相关来源再使用 web_fetch 打开最相关的 1 个页面并总结。主题multimodal RAG 最新论文2只搜索不精读使用 tavily-search 搜索最近一周关于 OpenAI 模型发布的新闻只给我来源列表和一句话摘要。3官方来源优先使用 tavily-search 搜索 Kubernetes Ingress 官方文档优先官方来源再用 web_fetch 打开最相关页面并总结。4搜索新闻先用 tavily-search 搜索最近一周 AI agent 相关新闻再给我按时间排序的摘要。5搜索论文先使用 tavily-search 搜索 multimodal RAG 相关论文优先 arXiv 和官方论文页面再使用 web_fetch 阅读最相关页面并总结。6多步任务协同这是一个多步任务。请通过 agent-reach 协调当前可用能力不要直接凭已有知识回答。先使用 tavily-search 搜索高质量来源再使用 web_fetch 阅读最相关页面最后给出带来源的结论。主题最近一个月关于 AI agent memory 的研究进展。十三、命令行直测速查下面这些命令用于直接测试tavily-searchskill 本体。基础搜索# 作用执行最基础的一次 Tavily 搜索。# 语法node 脚本路径 查询词# 规则# - 查询词建议放在双引号中# - 适合快速验证插件和 API key 是否生效node~/.openclaw/skills/liang-tavily-search/scripts/search.mjspython async patterns指定结果数量# 作用控制返回结果数。# 语法node 脚本路径 查询词 -n 数量# 规则# - 常见范围 1 到 20# - 数量越多召回越广但噪声可能增加node~/.openclaw/skills/liang-tavily-search/scripts/search.mjsReact hooks tutorial-n10指定搜索深度# 作用调整搜索深度在速度和相关性之间取平衡。# 语法node 脚本路径 查询词 --depth 模式# 规则# - 可选值ultra-fast、fast、basic、advanced# - basic 最通用# - advanced 适合研究型任务node~/.openclaw/skills/liang-tavily-search/scripts/search.mjsmachine learning evaluation benchmarks--depthadvanced搜索新闻# 作用把搜索主题切换为新闻类。# 语法node 脚本路径 查询词 --topic news# 规则# - 适合最新事件、产品发布、政策变化# - 如果不是新闻类查询建议用默认 generalnode~/.openclaw/skills/liang-tavily-search/scripts/search.mjsAI regulation Europe--topicnews限定时间范围# 作用限制搜索结果的时间范围。# 语法node 脚本路径 查询词 --time-range 范围# 规则# - 可选值day、week、month、year# - 适合“最近一周”“最近一个月”这类查询node~/.openclaw/skills/liang-tavily-search/scripts/search.mjsOpenAI API updates--topicnews --time-range week限定域名# 作用只保留指定域名结果。# 语法node 脚本路径 查询词 --include-domains 域名列表# 规则# - 多个域名通常用逗号分隔# - 适合官方文档、论文站点、可信来源筛选node~/.openclaw/skills/liang-tavily-search/scripts/search.mjsPython asyncio gather--include-domains docs.python.org排除域名# 作用排除某些不想要的域名。# 语法node 脚本路径 查询词 --exclude-domains 域名列表# 规则# - 多个域名通常用逗号分隔# - 适合过滤低质量或无关站点node~/.openclaw/skills/liang-tavily-search/scripts/search.mjsLLM benchmarks--exclude-domains pinterest.com,reddit.com输出 JSON# 作用输出原始 JSON方便调试和脚本二次处理。# 语法node 脚本路径 查询词 --json# 规则# - 适合程序消费# - 不适合纯人工阅读node~/.openclaw/skills/liang-tavily-search/scripts/search.mjsvector database comparison--json返回更完整内容# 作用尝试返回更完整的页面内容而不只是摘要片段。# 语法node 脚本路径 查询词 --raw-content# 规则# - 输出会更长# - 更适合研究和离线分析node~/.openclaw/skills/liang-tavily-search/scripts/search.mjsmultimodal RAG survey--raw-content多参数组合# 作用组合数量、主题、时间范围、域名过滤等参数。# 语法# node 脚本路径 查询词 -n 数量 --topic 主题 --time-range 范围 --include-domains 域名列表# 规则# - 参数越明确结果通常越稳定# - 适合研究型和高价值查询node~/.openclaw/skills/liang-tavily-search/scripts/search.mjsmultimodal RAG papers-n8--topicgeneral --time-range year --include-domains arxiv.org,acm.org十四、在对话中怎么更稳定触发正确流程推荐写法 1明确步骤先使用 tavily-search 搜索高质量来源再使用 web_fetch 阅读最相关页面最后总结。推荐写法 2强调不要直接回答不要直接凭已有知识回答。先使用 tavily-search 搜索再使用 web_fetch 阅读来源然后给出结论。推荐写法 3强调这是最新信息这是一个需要最新信息的问题。请先使用 tavily-search 搜索最近一周相关资料再使用 web_fetch 阅读最相关页面。推荐写法 4强调官方来源先使用 tavily-search 搜索优先官方来源再使用 web_fetch 打开最相关页面并提取关键信息。推荐写法 5加入agent-reach强化多步协同请通过 agent-reach 协调当前可用能力不要直接回答。先使用 tavily-search 搜索高质量来源再使用 web_fetch 阅读关键页面最后输出带来源的总结。十五、常见误区误区 1把web_search当成固定插件名web_search往往是“网页搜索能力”的泛称不一定是某个具体 skill 名。误区 2把原生 provider 和扩展 skill 混为一谈Brave / Gemini / Grok / Kimi / Perplexity 是 OpenClaw 原生 providerTavily / Firecrawl 是用户自行安装的扩展 skill误区 3把web_fetch当成搜索工具web_fetch一般负责“打开页面”不是“找页面”。误区 4以为装了tavily-search就不需要web_fetchtavily-search更适合召回来源web_fetch更适合精读页面。两者配合效果最好。误区 5以为 provider、skill、tool 是同一层provider底层服务来源skill扩展能力封装方式tool / interfaceagent 暴露给你的能力入口误区 6以为agent-reach是搜索工具agent-reach更适合作为多步任务协调层而不是单独的搜索引擎替代品。十六、推荐默认策略如果没有 URL先用tavily-search如果有 URL直接用web_fetch如果问题涉及最新信息先用tavily-search必要时限定时间范围如果需要精读先tavily-search后web_fetch如果需要官方来源先用tavily-search找官方页面再用web_fetch读如果任务是多步研究加入agent-reach协调“搜索 → 阅读 → 总结”十七、排障速查情况 1脚本报TAVILY_API_KEY not set说明当前 shell 没拿到环境变量。# 作用检查当前 shell 是否已经有 TAVILY_API_KEY。# 语法echo $TAVILY_API_KEY# 规则# - 有输出表示变量已生效# - 空输出表示变量未生效echo$TAVILY_API_KEY情况 2tavily-search已安装但对话里没触发通常不是安装失败而是提示词不够明确。建议直接这样写不要直接回答。先使用 tavily-search 搜索再使用 web_fetch 阅读来源最后给出结论。情况 3旧会话行为异常新开一个会话再试避免旧上下文干扰工具选择。情况 4想确认 skill 本体是否可用# 作用绕过会话层直接测试 tavily-search skill 脚本本体。# 语法node 脚本路径 查询词# 规则# - 这是最稳的插件可用性验证方法node~/.openclaw/skills/liang-tavily-search/scripts/search.mjslatest papers on multimodal RAG情况 5复杂任务总是只用一个工具尝试在提示词中显式加入这是一个多步任务。请通过 agent-reach 协调当前可用能力先搜索再阅读最后总结。十八、术语表web_search网页搜索能力的抽象接口重点是“找来源”。web_fetch网页读取能力接口重点是“读页面”。provider底层搜索/能力提供方例如BraveGeminiGrokKimiPerplexityskill额外安装的扩展能力封装例如TavilyFirecrawlagent-reachtavily-search基于 Tavily 的扩展搜索 skill可用于补充或增强web_search能力。agent-reach用于协调多步任务、强化外部能力调用的 skill不是传统搜索引擎替代品。十九、一句话总结**web_search**搜索能力的抽象接口原生 providerBrave / Gemini / Grok / Kimi / Perplexity扩展 skillTavily / Firecrawl / agent-reach**web_fetch**网页读取与抓取能力最佳实践是先用搜索能力找来源你当前常用tavily-search再用web_fetch读来源复杂任务再用agent-reach协调。
