1. 为什么你的 OpenClaw 助手还停留在“本地聊天”
如果你已经跟着前几篇把 OpenClaw 跑起来，也调教出了自己的 AI 小助手，大概率会遇到一个很明显的瓶颈：它知道的东西，基本停留在训练数据截止的那一天。你问它“今天有什么新出的开源模型”，它要么含糊其辞，要么直接编一个看起来很像真的答案。本质上，它还是一个“你问它答”的聊天对象，只是语气更像人了一点。
要让它真正有用，得给它接上两样东西：一是联网搜索，让它能查到实时网页；二是浏览器能力，让它能打开具体页面、提取正文、甚至截图和点击。前者解决“信息从哪来”，后者解决“信息怎么读”。OpenClaw 内置了这两块能力，搜索默认走 Brave Search，浏览器则支持 Chrome、Brave、Edge、Chromium 这几个内核。
这篇就聚焦一件事：把 Brave Search 和浏览器这两条网络链路配通，并跑一次真实的联网搜索验证。我会给出可直接复制的config.toml骨架、Brave Search API Key 的填写位置，以及一次完整的搜索验证动作。适合已经在本地部署 OpenClaw、想让助手从“离线聊天”升级成“能查能读”的开发者。
2. 前置准备：Brave Search API Key 与 TaoToken 接入
2.1 Brave Search 的申请门槛
OpenClaw 默认的搜索提供方就是 Brave Search，属于内置工具，不需要额外装插件。但 Brave Search API 不是完全零门槛的：你需要去 Brave 的搜索 API 控制台创建一个账户，选择“搜索数据”计划，然后生成 API Key。这里有个现实问题——开通订阅需要绑定一张外币卡，会临时扣 1 美元做有效性验证，之后自动返还。
不过别被“订阅”吓到。Brave 每月有 5 美元的免费额度，你只要在控制台把使用额度上限设成小于 5 美元，就能稳定白嫖。我实测下来，日常搜索完全够用。如果你已经有 Brave Search 账号，直接生成 Key 就行；没有的话，这一步是绕不开的。
2.2 用 TaoToken 统一管理模型接入
搜索和浏览器解决的是“外部信息”，但助手本身的推理能力还是靠模型。如果你在多个模型之间切换，或者想用 Claude Code、Coding Plan 这类编码场景，建议把模型接入统一走 TaoToken。它的 API 地址是https://taotoken.net/api，官网在https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=。
这样做的好处是：搜索配置和模型配置解耦，你换模型不用动搜索那套东西。后面我会在config.toml里把这两块分开写，方便你对照。
3. 可复制配置：config.toml 骨架与 Brave Search 填写位置
3.1 用向导快速写入
最省事的方式是走 OpenClaw 自带的配置向导：
openclaw configure --section web按提示输入 Brave Search API Key，它会自动写进配置文件。如果你喜欢手动控制，直接改config.toml更直观。
3.2 手动配置骨架
下面是我实际用的config.toml骨架，搜索部分和模型部分分开，你按自己的 Key 替换即可：
# OpenClaw 网络能力配置骨架 [tools.web.search] provider = "brave" apiKey = "BRAVE_API_KEY_HERE" # 替换成你的 Brave Search API Key maxResults = 5 # 单次搜索返回条数，5 条够日常用 timeoutSeconds = 30 # 超时时间，网络慢可调到 60 # 模型接入（走 TaoToken，便于统一管理） [model] provider = "openai-compatible" baseUrl = "https://taotoken.net/api" apiKey = "YOUR_TAOTOKEN_KEY" # 在 TaoToken 控制台生成 model = "claude-sonnet" # 按你订阅的模型填几个参数说明一下：maxResults不建议开太大，5 到 8 条足够，太多反而让模型总结时抓不住重点；timeoutSeconds默认 30 秒，如果你本地网络到 Brave 的链路不稳，可以调到 60。apiKey也可以不写在文件里，改用环境变量BRAVE_API_KEY，在网关环境里设置，这样配置文件可以安全地提交到版本库。
注意：
config.toml里如果同时存在环境变量和文件内 Key，OpenClaw 一般以文件内配置优先。想用环境变量就先把文件里的apiKey留空或删掉。
3.3 浏览器能力的配置位置
浏览器这块在安装 OpenClaw 时通常已经自动配好了，它支持访问任意 URL、提取内容、截图、点击、输入、滚动。你不需要在config.toml里额外写浏览器路径，只要系统里装了受支持的浏览器内核即可。下一节我会给出安装和验证命令。
4. 验证请求：跑一次真实的联网搜索
4.1 安装浏览器内核
搜索能拿到摘要，但遇到需要登录的后台、动态加载的页面，就得靠浏览器。以 Ubuntu 为例，装 Chrome 并配好虚拟显示：
# 1. 添加 Google Chrome 仓库 wget -q -O - https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo apt-key add - sudo sh -c 'echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/google-chrome.list' # 2. 更新并安装 sudo apt update sudo apt install -y google-chrome-stable xvfb # 3. 启动虚拟显示（无头环境必需） export DISPLAY=:99 Xvfb :99 -screen 0 1920x1080x24 & # 4. 测试截图，确认浏览器可用 google-chrome-stable --headless --disable-gpu --no-sandbox \ --screenshot --window-size=1920,1080 https://cn.vuejs.org/跑完第 4 步，当前目录会生成一个screenshot.png，打开能看到 Vue 官网首页，说明浏览器链路通了。
4.2 发起一次联网搜索
配置写好后，重启 OpenClaw 网关，然后在对话里直接问：
OpenClaw 最新的热点内容有哪些？实测下来，它不会把一堆蓝色链接丢给你，而是先调用 Brave Search 拿到结果，再自己读完、总结，最后结合你的上下文给出判断。比如它会说“最近社区讨论集中在 X 和 Y，其中 X 的更新涉及 Z”，而不是干巴巴列五条 URL。这正是搜索引擎做不到的部分——搜索给原料，助手给成品。
4.3 验证浏览器读取
再让它读一个具体页面，比如：
帮我打开 https://cn.vuejs.org/ 并总结首页主要讲了什么如果浏览器配置正确，它会返回页面正文的摘要，而不是只报一个标题。到这一步，搜索和浏览器两条链路都验证完毕。
5. 本篇常见错排查
配置过程中最容易卡在几个地方，我按出现频率排一下。
沙箱错误：Chrome 在 root 或无特权容器里跑会报 sandbox 相关错误，加--no-sandbox参数即可。这也是上面命令里带它的原因。
显示错误：无头环境没有物理显示器，报cannot open display时，先export DISPLAY=:99，再确认Xvfb :99进程还在。进程挂了就重新起一个。
内存不足：Chrome 默认会吃不少内存，小内存机器上加--disable-gpu，必要时再配--single-process，但后者稳定性差，优先加内存。
权限问题：以 root 运行必须带--no-sandbox，否则直接拒绝启动。生产环境更推荐用非 root 用户加--no-sandbox的组合。
搜索返回空：先确认BRAVE_API_KEY是否写对、额度是否超限。Brave 控制台能看到当月用量，超过 5 美元免费额度会直接拒绝请求。另外timeoutSeconds太小也会导致偶发失败，调到 60 试试。
模型不响应搜索：如果搜索配好了但助手还是答“我不知道”，检查config.toml里[tools.web.search]的层级是否正确，以及网关是否重启加载了新配置。
6. 把网络能力接进你的日常编码流
搜索和浏览器配通之后，OpenClaw 才算真正“长了翅膀”。接下来你可以把它用在几个具体场景：查最新库的 API 变更、读某个 issue 的讨论、抓一个文档页面的配置示例。这些动作以前要你手动开浏览器、复制粘贴，现在一句话就能让它跑完。
如果你还没生成模型侧的 Key，可以去 TaoToken 控制台创建，地址是https://taotoken.net/api-keys，配合接入文档https://taotoken.net/doc一起看，能少踩不少坑。想先验证模型对话效果，直接开https://taotoken.net/model-chat试几句；长期做编码和 Agent 任务的话，Coding Plan 会更合适，入口在https://taotoken.net/coding-plan。搜索配置本身不依赖这些，但模型和搜索配合起来，助手才完整。
最后留一个我踩过的坑：Brave 的免费额度是按月重置的，但如果你在控制台没设上限，某个月调用量突然飙高，可能会产生小额扣费。进控制台把 usage limit 设成 4.5 美元左右，既不影响日常使用，又能彻底锁死免费。
