[智能体-620]：OpenClaw 工具链配置实战：Web-Search 与 Web-Fetch 写入 TOOLS.md 的完整骨架

1. 为什么你的 OpenClaw 智能体总是“搜得到、读不懂”如果你正在给 OpenClaw 智能体接联网能力大概率遇到过这种场景模型能返回一串搜索结果标题摘要看着都对但让它基于这些内容做判断时回答就开始飘——要么把两条不相干的新闻拼在一起要么引用了一个根本不存在的数字。问题不在模型本身而在于你只给了它 Web-Search 的摘要没给它 Web-Fetch 的原文。Web-Search 和 Web-Fetch 是 OpenClaw 工具体系里最容易混淆的一对工具。前者输入自然语言查询词交给搜索引擎做全网检索输出的是标题、摘要、URL 列表本质是“发现资源”后者输入一个确定的 URL访问页面、清洗广告导航、提取正文转成 Markdown再送进模型上下文本质是“精读页面”。一个负责广域探索一个负责深度挖掘顺序不能反职责不能混。这篇内容面向需要把这两个工具写进 TOOLS.md 的开发者。我会给出一份可直接复制的配置骨架包含调用顺序约束、权限边界、并发上限和验证动作确保工具注册后能被智能体正确调用。你不需要先理解 OpenClaw 的全部架构只要跟着把 TOOLS.md 写对再跑一次验证请求就能看到 Search 找链接、Fetch 读原文、模型做决策的完整链路。2. 前置准备TaoToken 接入与 OpenClaw 工具链的关系OpenClaw 的工具体系本身不绑定某一家模型服务它通过统一的 API 层调用大模型。我实测下来用 TaoToken 作为模型接入层比较省事因为它同时提供 OpenAI 兼容接口和 Anthropic 兼容接口OpenClaw 里配置 base_url 和 api_key 就能跑通不用为不同模型改两套代码。你需要先拿到一个可用的 API Key。打开 https://taotoken.net/api-keys 登录后创建一个 Key复制保存。注意这个 Key 只在创建时完整显示一次后面配置进 OpenClaw 的 config 或环境变量里。TaoToken 的 API 根地址是 https://taotoken.net/api 不带任何查询参数。OpenClaw 的模型配置里通常填这个作为 base_url再拼上 /v1/chat/completions 或 /v1/messages 这样的路径。如果你用的是 Claude 系列模型做智能体主脑走 Anthropic 兼容格式会更顺具体路径参考 https://taotoken.net/doc 里的接入说明。这里要区分两件事模型接入是“智能体的大脑”Web-Search 和 Web-Fetch 是“智能体的手”。TOOLS.md 管的是手的动作规范不负责模型鉴权。但两者必须同时配好否则工具注册了也调不动因为模型请求本身会失败。建议先把模型对话跑通确认 Key 和 base_url 没问题再写 TOOLS.md。你可以用 https://taotoken.net/chat 快速验证模型是否正常响应确认后再进入工具配置环节。3. 可复制的 TOOLS.md 配置骨架TOOLS.md 是 OpenClaw 读取工具规则的入口文件它不定义工具的实现代码而是用自然语言加结构化约束告诉智能体什么情况下用哪个工具、调用顺序是什么、权限归谁、并发上限多少。下面这份骨架可以直接复制到你的项目根目录按实际业务改工具名和阈值。# TOOLS.md - Web-Search 与 Web-Fetch 调用规范 ## 1. 工具清单 ### 1.1 Web-Search - 入参query自然语言搜索词 - 输出候选网页列表含 title、snippet、url - 定位发现资源、缩小信息范围 - 适用不知道准确来源、查实时资讯、探索性调研 ### 1.2 Web-Fetch - 入参url单个精准链接 - 输出清洗后的正文 Markdown - 定位精读指定页面、深度提取 - 适用研读官网文档、政策原文、技术手册、提取表格 ## 2. 调用顺序约束 2.1 必须优先执行 Web-Search 获取候选 URL再按需调用 Web-Fetch 精读。 2.2 禁止无目的批量 Fetch禁止跳过 Search 直接猜测 URL 并 Fetch。 2.3 单次任务中Web-Fetch 最多同时处理 3 个网页防止上下文过载。 2.4 Search 返回结果后模型需先筛选高价值链接再决定 Fetch 哪些。 ## 3. 权限约束 3.1 仅主 Agent 可调用联网工具。 3.2 子 Agent 只能提出联网需求由主 Agent 代为执行。 3.3 内网地址、需要登录鉴权的页面禁止调用 Web-Search 和 Web-Fetch。 ## 4. 结果处理约束 4.1 Web-Search 的摘要仅用于筛选链接不得直接作为最终结论依据。 4.2 Web-Fetch 的正文作为上下文送入模型分析、总结、提炼。 4.3 精读后形成的长期业务知识由 MemoryEditor 写入 MEMORY.md。 4.4 已写入 MEMORY.md 的内容后续任务不必重复联网查询。 ## 5. 异常处理 5.1 Fetch 返回空正文或 403/404 时标记该 URL 失败不重试超过 1 次。 5.2 Search 无结果时允许改写 query 重试一次仍无结果则终止联网。 5.3 页面为 JS 动态渲染导致正文为空时记录限制不强行解析。这份骨架的关键在于第 2 节和第 3 节。调用顺序约束防止模型“先 Fetch 再 Search”这种反逻辑操作权限约束防止子 Agent 乱开联网口子导致 Token 失控。第 4 节把 Search 摘要和 Fetch 正文的用途分开避免模型拿摘要当结论。第 5 节是排障兜底后面会展开。写进 TOOLS.md 后OpenClaw 在组装系统提示时会读取这个文件把规则注入模型上下文。你不需要改工具的实现代码规则层就能约束行为。4. 验证请求确认工具注册后可被正确调用配置写完不代表生效必须跑一次验证请求。我通常用一个“先 Search 再 Fetch”的复合任务来测因为单步调用测不出顺序约束是否生效。在 OpenClaw 的对话入口或 API 调用里发一条这样的指令请查询 OpenClaw 官方文档中关于工具注册的说明。 要求先用 Web-Search 找到候选链接筛选后最多 Fetch 2 个页面 基于 Fetch 到的正文总结工具注册的三个关键步骤。观察返回结果里是否出现这些信号第一模型先输出了搜索动作和候选 URL 列表第二模型明确说了“筛选后选择以下链接进行精读”第三Fetch 结果里有正文片段而不是只有标题第四最终总结基于正文而非摘要。如果模型直接开始编造步骤没有调用 Search说明 TOOLS.md 没被读取检查文件路径和 OpenClaw 的配置项是否指向了它。如果模型调用了 Search 但没 Fetch检查第 2.1 条约束是否写得太弱可以改成“必须执行 Fetch 后才能给出结论”。验证通过后你可以再测一次权限约束让子 Agent 发起联网请求看它是否被主 Agent 拦截。这一步能确认第 3 节的权限规则真正生效。5. 本篇常见错排查5.1 Fetch 返回空正文最常见的原因是目标页面是 JS 动态渲染。Web-Fetch 只能抓静态 HTML遇到 React、Vue 这类前端渲染的页面拉下来的 HTML 里没有正文。排查方法用 curl 直接拉一次页面看返回的 HTML 里有没有实际内容。如果没有说明这个页面不适合 Fetch换静态文档源或官方 API。5.2 Search 有结果但 Fetch 全部 403部分站点对非浏览器请求做了拦截。Web-Fetch 的请求头如果没带 User-Agent 或 Referer容易被拒。检查 OpenClaw 的 Fetch 工具配置里是否允许自定义请求头。如果站点有公开 API 或 RSS优先走 API不要硬抓页面。5.3 模型跳过 Search 直接 Fetch这是 TOOLS.md 约束不够硬导致的。把第 2.1 条从“必须优先执行”改成“禁止在未执行 Web-Search 的情况下调用 Web-Fetch”并在系统提示里重复一次。模型对“禁止”类指令的遵循度通常高于“必须”类。5.4 Token 消耗异常高检查第 2.3 条的并发上限是否生效。如果模型一次 Fetch 了 5 个以上页面上下文会被正文塞满后续推理变慢且容易丢重点。把上限压到 3并在 Fetch 后加一步“正文摘要压缩”只保留与任务相关的段落。5.5 子 Agent 绕过权限调用联网确认 TOOLS.md 第 3 节是否被主 Agent 的调度逻辑读取。有些 OpenClaw 版本需要把权限规则同时写进主 Agent 的 system prompt 和 TOOLS.md双写才生效。另外检查子 Agent 的工具白名单里是否误放了 Web-Search。6. 把联网能力接进长期编码与 Agent 工作流Web-Search 和 Web-Fetch 配好之后真正的价值在于把它们嵌进长期运行的 Agent 工作流。比如你让 OpenClaw 持续跟踪某个技术栈的更新Search 负责发现新文档Fetch 负责精读变更日志MemoryEditor 把结论写进 MEMORY.md后续任务直接读记忆不再重复联网。这条链路跑顺了Token 消耗会明显下降。如果你要跑的是长时间编码任务或常驻 Agent建议用 Coding Plan 这类按周期计费的方案比按次调用更划算配置入口在 https://taotoken.net/coding-plan 。模型对话的快速验证走 https://taotoken.net/chat API Key 管理在 https://taotoken.net/api-keys 接入细节和路径说明看 https://taotoken.net/doc 。Claude Code 相关的 Anthropic 兼容配置参考 https://taotoken.net/claude-code 。最后提醒一个实操细节TOOLS.md 改完后OpenClaw 可能需要重启或重新加载配置才会生效。我踩过的坑是改完文件直接发请求结果模型还在用旧规则排查了半天才发现是缓存。每次改完 TOOLS.md先重启一次再验证能省很多时间。