ClawPilot

简体中文

English

简体中文

English

Appearance

联网搜索配置教程 ​

如果你在配置 Brave 联网搜索时遇到不会操作的地方，可以先使用微信扫一扫加入微信群咨询。

使用微信扫一扫进群

这篇教程只解决一件事：把 ClawPilot 里的 Brave 联网搜索配好。

如果你拿不准选哪个 provider，当前 App 里默认最推荐的也是 Brave。第一次配置时，先把这条链路跑通最省心。

最短路径 ​

如果你只想尽快用起来，直接按这个顺序操作：

  1. 打开 https://api-dashboard.search.brave.com/
  2. 登录 Brave 控制台
  3. 订阅 Search 计划
  4. 在 API Keys 页面复制你的 Brave API Key
  5. 回到 ClawPilot：设置 -> 联网搜索设置
  6. 进入你当前正在使用的 Gateway
  7. 打开 允许 OpenClaw 联网搜索
  8. 选择 Brave
  9. 粘贴 API Key
  10. 模式先保持 网页结果
  11. 点击保存
  12. 回到聊天页发送：帮我查一下今天最重要的 AI 新闻，并附上来源链接。

下面把这条路径拆开说清楚。

一、先去 Brave 申请 API Key ​

操作顺序很简单：

  1. 登录 Brave 控制台
  2. 找到 Plans 或 Subscriptions
  3. 订阅 Search 计划
  4. 打开 API Keys
  5. 创建一个新的 Key，或者复制已经存在的 Key

说明：我在 2026-03-17 核对 Brave 官方 Quickstart 与定价页时，官方主文档展示的是 Search 计划，免费层显示每月 $5 的 API credits。
如果你在旧文章里看到 Data for AI、2,000 free queries/month 之类旧文案，以你当前控制台看到的页面为准。

拿到 Key 以后先不要关页面，直接回 ClawPilot 粘贴就行。

Brave 官方认证文档写的是 X-Subscription-Token。你在 ClawPilot App 里不需要手动填写这个请求头，只需要把 API Key 粘贴进设置页即可。

二、回到 ClawPilot App 配置 ​

拿到 Brave Key 后，回到 App：

设置 -> 联网搜索设置

然后按下面顺序操作。

1) 打开联网搜索 ​

先把顶部的 允许 OpenClaw 联网搜索 打开。

2) 搜索方式选 Brave ​

当前 App 支持的联网搜索 provider 是：

  • Brave
  • Gemini
  • Grok
  • Kimi
  • Perplexity

这里没有 OpenAI 选项。也就是说，当前 App 并不支持把 OpenAI 直接作为“联网搜索 provider”来配置。

3) 把 Brave API Key 粘贴进去 ​

在 把密钥贴到这里 输入框里直接粘贴你刚拿到的 Brave Key。

保存规则和常见误区如下：

  • 第一次启用 Brave 时，Key 是必填的。
  • 如果服务器上已经保存过 Brave Key，这次输入框可以不重填，保存时会沿用旧 Key。
  • 如果你刚从别的 provider 切换到 Brave，那这次必须重新粘贴 Brave 的 Key。
  • 如果你只是把联网搜索开关关掉，Key 不是必填。

4) Brave 搜索模式怎么选 ​

当前 App 里有两个选项：

  • 网页结果
  • LLM Context

建议这样选：

  • 大多数情况下先用 网页结果
  • 只有你明确需要更长的网页正文上下文时，再切到 LLM Context

5) 这页实际上只需要填什么 ​

基于当前 App 的实现，Brave 这条链路真正需要你关心的只有 4 项：

  1. 打开 允许 OpenClaw 联网搜索
  2. 搜索方式选择 Brave
  3. 粘贴 API Key
  4. 视情况选择 Brave 搜索模式

这一页不需要你额外填写 baseUrl、自定义 endpoint、搜索引擎 ID、OpenAI 模型名或其他请求头。

如果你之前已经在服务器上保存过 Brave Key，这次输入框看起来可能仍然像空白，但这不代表配置丢了。当前 App 会把服务器返回的脱敏值隐藏起来；只有你准备更换新 Key 时，才需要重新粘贴。

三、保存后怎么验证 ​

保存完成后，直接回到聊天页，发一条最容易判断的测试消息，例如：

text
帮我查一下今天最重要的 AI 新闻，并附上来源链接。

如果联网搜索已经生效，你通常会看到这些信号：

  • 回复内容明显引用了最新网页信息
  • 回复里带有来源链接或站点名称
  • 同类问题比“纯模型记忆回答”更贴近当天内容

四、最常见的失败点 ​

1) 没选 Gateway ​

这页的设置不是全局设置，而是写回“当前选中的那台 Gateway”。如果你没有先选 Gateway，页面就算打开了，也无法正常保存。

2) Gateway 没连上 ​

如果目标 Gateway 当前没连接，这页保存时通常会直接失败。先回服务器配置页确认连接状态，再回来保存。

3) 切换到 Brave 后没有填 Key ​

如果你本来用的是别的 provider，这次刚切到 Brave，那 Brave Key 就必须重新填。否则保存会被拦下来。

4) 看起来没 Key，其实服务器里已经有 ​

这页为了避免把服务端脱敏值直接展示出来，输入框可能看起来像空白。只要服务器之前已经配置过，留空保存通常仍会沿用旧 Key。

5) 保存成功了，但聊天里还是不能搜索 ​

这通常不是 Brave Key 的问题，而是服务器策略还没放开。最典型的情况是：

  • 服务器 profile 默认没有开放联网搜索
  • 服务器的 tools.deny 明确禁用了 web_search

6) Brave 控制台能登录，但请求还是失败 ​

优先检查这几项：

  • 你复制的是否是当前有效的 API Key
  • Brave 控制台里对应计划是否已订阅成功
  • 免费 credits 是否已经耗尽
  • 是否误把旧教程里的旧套餐名称当成当前有效入口

资料来源 ​

核对日期：2026-03-17

Last updated:

ClawPilot

Copyright © 2026 ClawPilot