OpenClaw 配置 Brave Search API 完整教程

OpenClaw 是一个强大的 AI 助手框架，其中的 web_search 工具可以让你直接在对话中搜索网络信息。这个工具使用的是 Brave Search API。本文将详细介绍如何获取 API 密钥并完成配置。

一、什么是 Brave Search API

Brave Search API 是由 Brave 浏览器团队提供的搜索服务 API，具有以下特点：

独立索引：Brave 拥有自己的网络索引，不依赖 Google 或 Bing

隐私友好：不追踪用户搜索历史

免费额度：每月 2500 次免费查询

全球覆盖：支持多个国家和地区

在 OpenClaw 中配置后，你可以直接说"帮我搜索 XXX"就能获取网络信息，无需手动打开浏览器。

二、获取 Brave Search API 密钥

2.1 注册账号

访问 Brave Search API 官网：https://brave.com/search/api/

点击页面上的 "Get API Key" 或 "Sign Up" 按钮注册账号。你需要提供：

有效的电子邮箱地址

设置密码

验证邮箱（会发送确认邮件）

2.2 选择套餐

Brave 提供以下套餐：

Free（免费）：每月 2500 次查询，适合个人使用

Base：每月 50000 次查询，$15/月

Pro：每月 500000 次查询，$150/月

对于个人用户，免费套餐完全够用。

2.3 创建 API Key

登录控制台后：

进入 "API Keys" 页面

点击 "Create API Key"

给密钥起个名字（比如 "OpenClaw"）

复制生成的密钥，格式类似：BSAxxxxxxxxxxxxxxxxxxxxxx

重要：API Key 只显示一次，请务必妥善保存！如果丢失需要重新生成。

三、配置 OpenClaw

OpenClaw 支持多种配置方式，推荐使用第一种。

3.1 方式一：使用 openclaw configure 命令（推荐）

这是最简单安全的方式，OpenClaw 会自动帮你处理配置文件的存储。

openclaw configure --section web

执行后会进入交互模式：

? Enter your Brave Search API key: [输入你的 API Key]

输入密钥后按回车，配置会自动保存到 OpenClaw 的配置文件中。

3.2 方式二：手动编辑配置文件

找到 OpenClaw 的配置文件 openclaw.json，通常位于：

~/.openclaw/openclaw.json

添加或修改 env 部分：

{
  "env": {
    "BRAVE_API_KEY": "BSAxxxxxxxxxxxxxxxxxxxxxx"
  },
  "gateway": {
    "bind": "loopback"
  }
}

保存后重启 Gateway 使配置生效：

openclaw gateway restart

3.3 方式三：环境变量（适合 Docker/服务器部署）

如果你使用 Docker 或在服务器上运行，可以直接设置环境变量：

export BRAVE_API_KEY=BSAxxxxxxxxxxxxxxxxxxxxxx

或者在 Docker Compose 中：

services:
  openclaw:
    environment:
      - BRAVE_API_KEY=BSAxxxxxxxxxxxxxxxxxxxxxx

四、验证配置

配置完成后，需要重启 Gateway 使配置生效：

openclaw gateway restart

然后在 OpenClaw 中测试搜索功能：

帮我搜索一下今天的科技新闻

如果配置正确，你会看到搜索结果返回。也可以测试带参数的搜索：

帮我搜索 Python 教程，只要中文结果

五、web_search 工具参数详解

OpenClaw 的 web_search 工具支持多个参数：

六、常见问题与解决方案

6.1 错误：missing_brave_api_key

原因：API Key 未配置或配置未生效

解决方案：

检查配置文件是否正确保存

确认已重启 Gateway

检查环境变量是否设置正确

6.2 错误：quota exceeded

原因：免费额度已用完

解决方案：

等待下个月重置（每月 1 号）

升级到付费套餐

减少不必要的搜索请求

6.3 搜索结果不准确

优化方法：

指定 country 参数获取本地区域结果

指定 language 参数获取特定语言结果

使用 freshness 参数筛选最新内容

优化搜索关键词，更具体明确

6.4 Gateway 启动失败

可能原因：配置文件 JSON 格式错误

解决方案：

# 使用 jq 验证 JSON 格式
cat ~/.openclaw/openclaw.json | jq .

如果有语法错误，jq 会提示具体位置。

七、安全建议

不要泄露 API Key：不要提交到 Git 仓库或公开分享

定期检查用量：登录 Brave 控制台查看使用量

使用密钥管理：生产环境建议使用密钥管理服务

备份配置：定期备份 openclaw.json 配置文件

八、总结

配置 Brave Search API 后，OpenClaw 就具备了实时搜索网络信息的能力。这对于以下场景非常有用：

查询最新新闻和资讯

搜索技术文档和解决方案

获取实时数据和信息

研究竞争对手和市场动态

整个配置过程只需几分钟，但能大大提升 OpenClaw 的实用性。如果你在配置过程中遇到问题，欢迎在评论区留言讨论！

cnbugsai

打赏 海报 链接