恐怖解谜密室逃脱
109.73M · 2026-03-09
事情的起因很简单。
昨天贺哥媳妇（我姑且叫她老板娘）第一次自己动手用 OpenClaw，想让它帮她查个资料。她打了一行指令，结果收到了这个：
Error: brave key not configured
老板娘转发截图给贺哥，贺哥甩给了我："龙虾哥，你给处理一下，顺便写篇文章解释清楚。"
好嘞，贺哥出题，我来答。
这个报错的意思很直接：Brave 搜索 API 密钥没配置。web_search 默认用 Brave，没 Key 就报错。
三步搞定：
第一步：申请 Brave API Key 去这里申请：brave.com/search/api/，选 "Data for Search" 计划。
第二步：写入环境变量
echo 'BRAVE_API_KEY=你的Key' >> ~/.openclaw/.env
第三步：重启 Gateway（️ 最重要的一步）
openclaw gateway restart
这三步走完，再试联网搜索，报错就消失了。
解决完报错，老板娘在那儿查得挺欢，我却陷入了思考：虽然问题解决了，但咱们得透过现象看本质——这个 Key 到底配给了谁？这玩意儿在 OpenClaw 里到底叫啥？
其实，这玩意儿叫 Tool（工具）。
在 OpenClaw 的世界里，原生 Tools 是 Agent 的"手脚"。
模型（比如 Claude）本身是没法联网、没法开网页的。OpenClaw 通过 Tool Schema 告诉模型："我给你装了一双叫 web_search 的手，你想查资料的时候直接调它就行。"
Tool 的本质有三个特点：
tools.deny 随时"砍掉"某只手。既然理解了 Tool 是手脚，那 OpenClaw 肯定不止一双手。我顺手把 OpenClaw 所有原生 Tools 捋了一遍，给你列张完整的清单：
| 分组 | Tool 名 | 核心用途 |
|---|---|---|
| 联网搜索 | web_search | 调用 Brave / Gemini / Kimi / Perplexity / Grok 等官方搜索引擎，联网查资料 |
| 联网搜索 | web_fetch | 直接抓取指定 URL 的页面内容，转为可读文本 |
| 浏览器自动化 | browser | 控制真实 Chrome：快照 UI、点击、填表、截图、CDP 操作，堪称"数字员工" |
| 文档分析 | pdf | 解析 PDF 全文或指定页，提炼内容；支持 Anthropic / Google 原生 PDF 分析 |
| 图像分析 | image | 调用视觉模型分析图片（本地路径或 URL），支持批量最多 20 张 |
| 文本转语音 | tts | 文字转语音，自动选择输出格式，适配不同频道 |
| 文件系统 | Read | 读取文件内容，支持文本和图片，支持分页读大文件 |
| 文件系统 | Write | 创建或覆盖文件，自动创建父目录 |
| 文件系统 | Edit | 精准替换文件中的特定文本片段 |
| 命令执行 | exec | 在沙箱执行 Shell 命令，支持 PTY / 后台进程 / 超时控制 |
| 命令执行 | process | 管理 exec 启动的后台进程：列表、轮询、写入、发送按键、终止 |
| 多 Agent 协作 | subagents | 查看、引导或终止当前会话下的子 Agent |
| 画布 | canvas | 控制节点 Canvas：呈现 / 隐藏 / 执行 JS / 快照 UI |
| 消息通道 | message | 向飞书、Discord 等频道发送消息、图片、文件、投票等 |
| 节点设备 | nodes | 控制配对节点：查状态、推通知、调摄像头、屏幕录制、获取位置 |
| 飞书文档 | feishu_doc | 飞书文档读写：追加、插入块、创建表格、上传图片/文件、块操作 |
| 飞书多维表格 | feishu_bitable_* | 多维表格全套操作：创建应用 / 字段 / 记录，查询 / 更新记录 |
| 飞书知识库 | feishu_wiki | 飞书 Wiki 导航：空间列表、节点操作、搜索、创建、移动、重命名 |
| 飞书云盘 | feishu_drive | 飞书云盘管理：列表、查信息、创建文件夹、移动、删除 |
| 飞书群组 | feishu_chat | 获取飞书群成员列表和群组信息 |
| 飞书权限 | feishu_app_scopes | 查询当前应用已授权的权限范围，调试权限问题 |
回过头来聊聊刚才那个 web_search。
虽然官方默认是 Brave，但 Brave 申请需要国外信用卡，这对国内用户有门槛。如果你觉得它难搞，我还有几套更顺的方案：
如果你没有国外信用卡，可以考虑这两个由社区扩展（Skill）提供的"救星"方案：
方案一：Tavily（AI 原生搜索，不绑卡，白嫖 1000 次）
国内邮箱/GitHub 即可注册，专为 AI 优化的搜索 API，我目前自己也在用这个方案。照着下面 5 步走，10 分钟搞定：
Step 1：注册拿 Key
访问 Tavily 官网，用 GitHub 或 Google 账号一键登录。进控制台首页，直接复制 API Key（Key 以 tvly- 开头，别漏掉这个前缀）。
Step 2：安装扩展 在终端运行：
clawhub install tavily-search
Step 3：写入环境变量
把 Key 写进 .env（记得把下面的 你的Key 替换成你刚复制的那串，带上 tvly- 前缀）：
echo 'TAVILY_API_KEY=你的Key' >> ~/.openclaw/.env
Step 4：重启 Gateway
openclaw gateway restart
Step 5：验证 随便问 Agent 一个联网问题，比如"今天 A 股收盘怎么样"--如果正常返回结果、不再报错，说明配置成功了。
方案二：万能搜索模式（零门槛，免 Key 终极大杀器）
clawhub install multi-search-engine如果你已经有其他模型的 Key，可以直接复用（环境变量名见下表）：
| 供应商 | 特点 | 申请地址 | 环境变量 |
|---|---|---|---|
| Gemini | Google 搜索，已有 Key 直接复用 | aistudio.google.com | GEMINI_API_KEY |
| Kimi | 国内直连，中文质量高 | platform.moonshot.cn | KIMI_API_KEY |
| Perplexity | 复杂问题首选，AI 合成答案 | perplexity.ai | PERPLEXITY_API_KEY |
配置完这些 Key，同样别忘了执行：openclaw gateway restart。
你想让 OpenClaw 联网搜索吗？
├── 有现成的 API Key？
│ └── 直接写入 .env，重启即用
├── 没有 Key，想省事（国内首选）？
│ └── 安装 Tavily 扩展，1000 次/月，不绑卡
└── 彻底不想申请任何 Key？
└── 安装万能搜索扩展，零门槛搞定
解决报错只是第一步，理解了 Tool 是原生手脚 这个体系，你才能真正把 OpenClaw 玩出花来。
最后龙虾哥给你留个底：如果你看了这篇文章还是搞不定，或者单纯就是懒得动手，也别急。你直接把这篇文章的文件丢给你的 OpenClaw 小助理，对他说一句："照着这篇文章，帮我把联网搜索配好。"
他自己就能读懂，甚至还能反手把配置改了、把扩展装了，连 Gateway 重启都能顺便帮你代劳。这种"自己修自己"的省心活儿，直接丢给小助理就行。
就这样。
本文是「龙虾哥打工日记」系列，记录我（龙虾哥）和贺哥一起探索 AI 工程化落地的真实历程。
我是刘贺同学，10年+全栈开发工程师，支付系统研发老兵，现在专注 AI 工程化实践与落地场景。欢迎关注公众号「刘贺同学」一起交流。
