它负责找
你给一个问题，它去搜网页，挑出相关结果。
Tools 导读
Brave Search 接入：先拿 API Key，再选搜索模式
这一页教你如何将 Brave Search 配成 web_search 工具。核心两步：去 Brave 后台申请 Search 计划并拿到 API Key，然后在配置里填好 apiKey 并选择 mode（普通网页搜索或 LLM 上下文模式）。注意：新配置路径是 plugins.entries.brave.config.webSearch，旧路径 tools.web.search.apiKey 虽然还能用但已不推荐。
先讲这一页到底在解决什么
Brave Search 接入：先拿 API Key，再选搜索模式
这一页教你如何将 Brave Search 配成 web_search 工具。核心两步：去 Brave 后台申请 Search 计划并拿到 API Key，然后在配置里填好 apiKey 并选择 mode（普通网页搜索或 LLM 上下文模式）。注意：新配置路径是 plugins.entries.brave.config.webSearch，旧路径 tools.web.search.apiKey 虽然还能用但已不推荐。
第一站
🌐 Brave 先干的事，其实就是“帮你把网页世界先扫一遍”
官方一开头就把角色说得很清楚：Brave 不是浏览器控制，也不是网页抓取器，它是网页搜索提供商。
它负责带方向
不是只丢一堆链接，而是尽量把搜索结果整理得更有用。
它不是浏览器
不点网页，不开标签页，不替你操作网页界面。
先记一句
Brave 是“搜网页”，不是“看网页”。
第二站
🔑 API key 像门口工牌，没有它就进不了搜索服务台
官方把拿 key 的动作写得很直接。这个流程的本质就是：先注册，再开 Search 计划，再拿 key。
1. 先开账号
像先去办一张 Brave Search 的服务卡。
2. 选 Search 计划
像在门口选你要进哪一条服务通道。官方现在把 Search 计划当正式入口。
3. 拿 API key
BRAVE_API_KEY 像工牌。没有它，OpenClaw 就没法跟 Brave 搜索服务打招呼。
4. 放进配置
你可以写进 config，也可以放在 Gateway 环境变量里。效果一样，都是给它看门牌。
第三站
🛠 配置那段 JSON，翻成人话就是“给网页搜索换成 Brave”
官方给的配置例子很典型：插件里放 key，网页搜索里选 provider。两层意思都很简单。
plugins.entries.brave.config.webSearch.apiKey像把工牌放到 Brave 自己的抽屉里。以后系统知道去哪里找它。
tools.web.search.provider: \"brave\"像在总搜索按钮上贴一张便签：“以后默认搜网页，就叫 Brave 出场。”
maxResults: 5像告诉它：“这次别拖太多条，先给我 5 条够看的线索。”
timeoutSeconds: 30像给找路员一个时间沙漏。太久没结果，就先停。
第四站
🎚 Brave 的参数，像给找路员下的几个小口令
这一页里最有用的地方，是那些把搜索范围缩小的参数。它们不是装饰，是为了让结果更像你要的东西。
query
你真正想问的问题。必须有，不然不知道往哪找。
count
要几条结果。像告诉它：先捡几样回来就行。
country / language
像告诉它先去哪一片街区、看哪种语言的牌子。
freshness / 日期范围
像告诉它只看新消息，还是按日期门牌去找。
freshness: \"week\"像说：“只要最近一周的线索。”
date_after / date_before像拿一把时间尺，圈出某一段区间。
ui_lang像告诉它，界面提示要用哪种语言给你看。
📌 一句话
Brave 的参数，就是把“搜大海”收成“搜某个街区、某段时间、某种语言”。
第五站
💡 Brave 这页真正想提醒你的，不只是能搜，而是搜的时候别乱花
官方在 Notes 里提了计划、额度、缓存和权利问题。这些听起来像商店说明，其实是在告诉你怎么用得稳。
💳 预算别忘了看
Search 计划每月有免费额度，但超了就会变成真的花钱。
🧊 缓存像冰箱
搜索结果会缓存一段时间。意思是同样的问题别总去重新翻，省力也省钱。
📚 权利要分清
搜索结果能不能拿去训练或存储，不是随便想当然，要看方案和条款。
🎈 最后收住
Brave 这页说到底，就是给 OpenClaw 一把稳一点的网页搜索手电，还附了时间、地区和语言这些小旋钮。