默认情况下,AI 模型的知识有截止日期,没法告诉你今天的新闻、最新价格或刚发布的文档。开启联网搜索之后,Bot 就能主动上网查资料,再结合 AI 的理解能力给你答复。

一、OpenClaw 的搜索方案

OpenClaw 通过集成 Brave Search API 来实现联网搜索。Brave Search 是一个独立的搜索引擎,有自己的索引,不依赖 Google 或 Bing。

搜索能力以 Skill 的形式存在,需要:

  1. 申请一个 Brave Search API Key(有免费额度)
  2. 安装搜索 Skill 或在配置里启用
  3. 配置 API Key

二、申请 Brave Search API Key

  1. 打开 Brave Search API 官网:
  1. 注册账号并创建一个新的 API Key
  2. 免费套餐每月有 2000 次免费查询,个人使用完全够用

三、在 OpenClaw 里启用搜索

方式一:通过 Control UI(推荐)

  1. 执行 openclaw dashboard 打开 Control UI
  2. 进入 Skills 管理页面
  3. 找到 Web Search 相关 Skill
  4. 在 API Key 输入框里填入你的 Brave API Key
  5. 保存,立即生效

方式二:手动编辑配置文件

~/.openclaw/openclaw.json 里添加:

json
 1{
 2  "skills": {
 3    "entries": {
 4      "web-search": {
 5        "enabled": true,
 6        "env": {
 7          "BRAVE_API_KEY": "你的APIKey"
 8        }
 9      }
10    }
11  }
12}

保存后 Gateway 自动热重载,无需重启。

四、使用方式

配置好之后,直接用自然语言问就行,不需要任何特殊指令:

text
1今天有什么科技新闻?
2帮我查一下 iPhone 17 的最新消息
3OpenAI 最近发布了什么?

Bot 会自动判断是否需要联网搜索,需要时调用搜索工具获取实时结果,再整理成回答。

如果想明确让它搜索:

text
1搜索一下:2026年3月最新的 AI 新闻

五、搜索结果的样子

Bot 调用搜索时,你会在 Control UI 或对话里看到工具调用的过程,类似:

text
1[调用工具: web_search]
2查询:AI news March 2026
3结果:找到 5 条相关结果...

然后 Bot 会基于搜索结果给出总结性回答,并通常附上来源链接。

六、控制搜索行为

如果你想限制 Bot 只搜特定域名,或排除某些网站,可以在 Skill 配置里设置:

json
 1{
 2  "skills": {
 3    "entries": {
 4      "web-search": {
 5        "enabled": true,
 6        "env": {
 7          "BRAVE_API_KEY": "你的key",
 8          "SEARCH_ALLOWED_DOMAINS": "github.com,docs.python.org",
 9          "SEARCH_BLOCKED_DOMAINS": "pinterest.com"
10        }
11      }
12    }
13  }
14}

七、常见问题

Bot 不主动搜索

有些模型比较保守,不太会主动调用工具。可以在提问时明确说"联网查一下"或"搜索最新的……“来触发。

API Key 额度用完了

Brave Search 免费套餐每月 2000 次,如果不够用可以升级到付费套餐。也可以在月初额度重置。

搜索结果不准确

搜索工具拿回来的是原始网页摘要,最终回答的质量也取决于模型。如果结果不够好,可以追问"能给我更详细的信息吗"或者换一个更强的模型。

下一篇:Heartbeat 定时任务——让 Bot 不用等你发消息,主动干活。