1. 为什么 OpenClaw 联网查资料总卡在“工具调用”这一步OpenClaw 装好之后很多人第一反应是让它“自己去网上查点东西”。结果发现它推理挺顺但一到联网环节就掉链子要么 web_search 报 401要么 web_fetch 抓回来一堆乱码要么 Brave 的 Key 填了但工具根本没被调用。问题往往不在模型而在工具调用链路里的 API 通道配置是分散的——搜索走一套 Key抓取走另一套出口模型请求又走第三套任何一环没对齐Agent 就退化成“只会思考的本地劳动力”。这篇聚焦一个具体场景OpenClaw 跑在 Docker 里通过 web_search 找链接、web_fetch 读正文底层搜索用 Brave模型与工具调用的统一出口走 TaoToken。目标很明确——给你一份能直接复制的 config.toml 与 settings.json 骨架再演示一次完整的“搜索 → 抓取 → 模型总结”验证动作让联网检索流程稳定跑通。适合谁看已经在 Docker 里跑起 OpenClaw、想让 Agent 具备自主查资料能力、但被多套 Key 和多份配置文件绕晕的人。下面所有配置都按“可复制、可验证、可排障”来写不讨论哪种方案最优只把路铺平。2. 前置准备TaoToken 作为统一 API 通道OpenClaw 的联网能力拆开看是三层模型推理、web_search 搜索、web_fetch 抓取。传统做法是每层配一个供应商Key 散落在 .env、openclaw.json、环境变量里改一处忘一处。我试过把模型和工具调用的出口统一收敛到 TaoToken好处是只需要维护一份 KeyBase URL 指向同一个网关排查问题时不用在多个后台之间跳。TaoToken 在这里扮演的是统一 API 通道的角色模型对话、工具调用请求都从同一个入口出去配置项从“三套”压成“一套”。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 这个不加 UTM直接填进配置。你需要先拿到两样东西一是 TaoToken 的 API Key。登录后进控制台在 API Keys 页面新建一个复制出来形如sk-xxxxxxxx。这个 Key 同时用于模型请求和工具调用通道。二是 Brave Search 的 API Key。Brave 有免费额度每月 2000 次查询注册在 brave.com/search/api。注意它注册时要绑卡国内部分信用卡会失败换一张能过验证的即可。拿到后是一串BSA...开头的 Key。提示Brave Key 只负责“搜索”这一层模型和抓取不走它。别把两个 Key 填反这是后面 401 报错最常见的来源。拿到两个 Key 后先确认 Docker 容器能正常访问外网再往下配。容器内可以用curl -I https://taotoken.net/api测一下连通性返回 200 或 401 都说明网络通返回超时才是网络问题。3. 可复制配置config.toml 与 settings.json 骨架OpenClaw 的配置分两处config.toml管工具与搜索settings.json或 openclaw.json管模型与浏览器。下面给的是最小可用骨架字段名按你实际版本微调但结构可以直接抄。先看config.toml重点是 web_search 和 web_fetch 两段[web_search] enabled true provider brave api_key BSA你的BraveKey endpoint https://api.search.brave.com/res/v1/web/search country CN search_lang zh-hans count 8 [web_fetch] enabled true timeout_ms 15000 max_bytes 2000000 user_agent Mozilla/5.0 (compatible; OpenClaw/1.0) convert markdown [api] base_url https://taotoken.net/api api_key sk-你的TaoTokenKey几个参数说明count 8控制单次返回链接数太大容易触发限流convert markdown让 web_fetch 把 HTML 转成 markdown模型读起来更省 tokenmax_bytes防止抓到超大页面把上下文撑爆。再看settings.json模型和工具通道都指向 TaoToken{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, name: gpt-4o-mini }, tools: { web_search: { enabled: true }, web_fetch: { enabled: true } }, browser: { enabled: false } }这里browser.enabled先关掉。如果你只想让 Agent“读资料”而不是“操作网页”web_search web_fetch 这套内置能力就够了不用碰 Playwright 那套 600MB 的浏览器镜像省事也省磁盘。注意baseUrl结尾不要带/v1OpenClaw 会自己拼路径。带了会变成/v1/v1/chat/completions直接 404。改完配置后重启容器docker restart openclaw docker logs -f openclaw | grep -i web_search\|web_fetch日志里出现web_search tool registered和web_fetch tool registered说明工具已加载。4. 验证请求跑一次完整的搜索抓取动作配置对不对跑一次就知道。分三步验证每步都能单独定位问题。第一步单独测 web_search。在 OpenClaw 对话里发一句用 web_search 搜索 OpenClaw docker 配置返回前 3 条结果的标题和 URL正常返回应该是三条带标题和链接的列表。如果报 401是 Brave Key 问题如果报超时是容器网络问题如果模型说“我没有这个工具”是 config.toml 里enabled false或没重启。第二步单独测 web_fetch。拿上一步返回的任意一个 URL用 web_fetch 抓取 https://example.com 并总结前 200 字成功的话会返回页面正文的 markdown 摘要。如果返回空或乱码检查convert参数和user_agent有些站点会拦截默认 UA。第三步串起来跑完整链路帮我查一下 OpenClaw 最新的 docker 安装文档先搜索再抓取正文最后用三句话总结这一步会触发模型连续调用 web_search → web_fetch → 模型总结。观察日志里的调用顺序docker logs -f openclaw | grep -E tool_call|web_search|web_fetch理想输出是tool_call: web_search→tool_call: web_fetch→model_response。如果只看到 web_search 没有 web_fetch说明模型没把搜索结果里的 URL 传给抓取工具通常是提示词里没明确“抓取正文”补一句即可。实测下来整条链路跑通后从提问到拿到总结大约 8–15 秒取决于目标页面大小。如果超过 30 秒多半是 web_fetch 卡在某个大页面上调小max_bytes或加timeout_ms。5. 本篇常见错排查报错一web_search 返回 401 Unauthorized。九成是 Brave Key 填错或没生效。检查 config.toml 里api_key是否以BSA开头有没有多余空格。改完必须重启容器热加载不一定生效。报错二web_fetch 返回空内容或convert failed。目标页面可能是纯 JS 渲染的web_fetch 只抓静态 HTML拿不到动态内容。这种情况要么换一个静态页面源要么启用 browser 那套方案。另外max_bytes设太小也会截断先调到 2000000 试。报错三模型说“工具不存在”。检查 settings.json 里tools.web_search.enabled是否为 true以及 config.toml 和 settings.json 是否被同一进程读取。有些版本两处都要开只开一处不生效。报错四cdpHost 127.0.0.1 连不上。这是启用 browser 后才会遇到的。Gateway 容器连浏览器容器时浏览器返回的 CDP 地址是它自己内部的 127.0.0.1对 Gateway 来说指向自己自然连不上。解决办法是把浏览器镜像启动参数里的--remote-debugging-address127.0.0.1改成0.0.0.0重新构建或者用network_mode: host让两个容器共享宿主机网络。不过如果你只用 web_search web_fetch这段可以完全跳过。报错五token 不匹配。检查 .env、settings.json、Web UI 登录 token 三处是否一致。改 Key 后旧 token 会失效重新登录一次。排障时优先看日志docker logs里的tool_call和error行能定位到具体哪一层断了。接入相关的完整字段说明可以对照接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。6. 把通道收拢让 Agent 稳定联网回到最初的问题OpenClaw 联网查资料卡住本质是工具调用链路上的 API 通道太分散。把模型请求、web_search、web_fetch 的出口统一到 TaoToken 一个 Base URLKey 从三份压成一份排查时只需要看一个地方。Brave 只管搜索这一层职责清晰出问题也好定位。配置骨架上面已经给全复制改 Key 就能用。验证动作按“单独测搜索 → 单独测抓取 → 串起来跑”三步走哪步断了一眼能看出来。如果你后面要让 Agent 长期跑编码任务或做多步自动化可以考虑 Coding Plan 那套更完整的通道方案https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。只是想先验证模型和工具能不能通用模型对话页面快速试一把就行https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 。最后留一个实用习惯每次改完配置先docker restart再跑一次三步验证别直接上复杂任务。配置这东西单点通了再串联比一上来就端到端调试省一半时间。
