KiloClaw 集成 Brave Search API：为你的 AI Agent 赋予实时联网搜索能力

2026-09-12 23:54:24作者：翟萌耘Ralph

本指南以 KiloClaw 官方文档中关于 Brave Search 集成的说明为核心，完整讲解如何获取 BSA 密钥并让 KiloClaw Agent 具备实时联网搜索、市场调研与事实核查能力。读完本文，你将掌握 Brave Search API 密钥的完整申请流程、KiloClaw 工具集成体系，以及如何通过密钥托管（1Password / Additional Secret）安全地启用该能力。

为什么需要给 Agent 接入 Brave Search

KiloClaw 是 Kilo 托管的 OpenClaw）。KiloClaw 内置的"完整工具配置"（full tool profile）默认赋予 Agent 文件系统操作、Shell 执行、网络搜索、浏览器自动化、消息、记忆、子 Agent 等能力。

然而，大语言模型的训练数据存在时效性截止点。要让 Agent 获取超出训练数据范围的最新信息——例如今日的新闻、实时股价、最新的竞品动态——就必须接入实时搜索能力。Brave Search Integration 正是为此设计的官方集成：通过 Brave Search API，KiloClaw Agent 可以：

获取最新信息：抓取训练数据截止日期之后发生的新闻与事件；
执行市场调研：实时对比产品、价格与行业动态；
事实核查：验证回答中的关键事实，降低幻觉风险。

这一集成的官方定位与其余第三方工具并列，记录在 KiloClaw Tools 集成索引中，属于"从凭证管理到网络搜索再到金融交易"的扩展工具集的一部分。

前提条件：理解 BSA 密钥

接入 Brave Search 的第一步，是获取一个 BSA（Brave Search API）密钥，它来自 Brave 开发者门户。该密钥通常以 BSA 前缀开头，是调用 Brave Search API 的凭证。

在开始之前，你需要明确两点事实：

Brave Search API 需要付费订阅——文档明确说明它不提供免费方案，请根据你的实际调用量选择订阅计划；
该密钥由你（用户）自行持有与配置——与 KiloClaw 平台托管的模型 API Key 不同，第三方工具集成通常需要你提供自己的密钥。

获取 Brave Search API 密钥（官方四步流程）

以下步骤完整复刻自 brave-search.md，是启用该集成的必经之路。

1. 访问 Brave Search Dashboard

打开 Brave 开发者门户（api.search.brave.com），登录已有账户，或先注册一个开发者账户。

2. 选择订阅计划

Brave Search API 要求付费订阅。根据你的预期调用量（请求频率、并发需求）选择合适的套餐。如果后续发现配额不足，可在门户中升级计划。

3. 创建 API Key

账户激活后，进入 API Keys 区域，点击 "Create New Key" 生成新的密钥。

4. 立即复制并妥善保存密钥

新生成的密钥通常以 BSA 前缀开头。务必立即复制——出于安全考虑，门户可能不会再次完整展示该密钥。建议将密钥存入密码管理器，或直接放入 KiloClaw 的密钥托管体系（见下文）。

把 BSA 密钥交给 KiloClaw Agent

拿到 BSA 密钥后，还需要将它安全地配置到 KiloClaw 实例中，Agent 才能在运行时调用 Brave Search API。KiloClaw 的第三方工具配置遵循设置其他服务中总结的两类模式——有 CLI 与 仅有 API。Brave Search 属于"仅有 API"的典型场景，官方给出的配置路径有两种：

方案 A：通过 1Password 托管凭证（推荐）

先完成 1Password 集成：创建专用保险库、生成 Service Account Token、在 KiloClaw 中激活集成；
将 BSA 密钥存入 KiloClaw 的 1Password 保险库；
在 KiloClaw Dashboard（app.kilo.ai/claw/settings）→ Danger Zone → Edit Files → workspace 文件夹 → TOOLS.md 末尾追加描述，让 Agent 知道该工具的调用方式与凭证位置，格式如下：

TOOL is 1 SENTENCE DESCRIPTION. You have access to it via the API. API documentation is at URL OF API DOCUMENTATION. Credentials are in 1Password under TOOL NAME.

方案 B：通过 Additional Secret 注入环境变量

如果你尚未配置 1Password CLI，可以在 KiloClaw Dashboard 将 BSA 密钥添加为 Additional Secret，并指定：

配置路径：skills.entries.<TOOL_NAME>.apiKey
环境变量名：<TOOL_NAME>_API_KEY

这样 Agent 即可在运行时通过环境变量读取密钥调用 Brave Search API。

让搜索能力更稳定、更省 Token

接入只是第一步。由于 Agent 每次使用新工具时都要现场阅读文档，首次调用难免摸索。官方建议在使用过程中引导 Agent 持续沉淀，以提升可靠性并降低 Token 消耗（详见 other-tools.md 的 "Improving performance" 一节）：

将常用调用模式回写到 TOOLS.md；
把高频用法提炼成 skill（技能），下次直接复用；
为 CLI 或 API 编写 Python / JavaScript 包装器，封装你惯用的调用方式。

对 Brave Search 而言，例如可以将"搜索 → 提取前 N 条结果 → 摘要"整理为一个固定技能，避免每次从零开始。

安全与使用建议

密钥只进不出：无论采用 1Password 还是 Additional Secret 方案，BSA 密钥都应通过托管体系注入，避免以明文形式出现在对话或文件中；
按需升级订阅：先评估日常搜索量再选择 Brave 订阅档位，避免浪费或配额耗尽；
结合默认工具配置：KiloClaw 新实例默认启用 full 工具配置，本身已包含网络搜索与无头浏览器等能力，Brave Search 集成适合对搜索质量、实时性有更高要求的场景。