OpenClaw教程（五）—— 为AI助手添加翅膀（网络能力）：Brave Search 与浏览器配置实战

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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_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里如果同时存在环境变量和文件内 KeyOpenClaw 一般以文件内配置优先。想用环境变量就先把文件里的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 [archamd64] 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-size1920,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 美元左右既不影响日常使用又能彻底锁死免费。