Tools 导读

Exa 搜索接入:先拿 API Key,再配 provider

这一页教你把 Exa 的 neural / keyword / hybrid 搜索接到 OpenClaw 的 web_search 工具上。最优先做的是去 exa.ai 注册并拿到 API Key,然后要么设环境变量 EXA_API_KEY,要么在配置里填 apiKey。容易漏的是:配置里 provider 要写成 "exa",而且如果用了环境变量,配置里就别再写 apiKey,否则会冲突。

先讲这一页到底在解决什么

Exa 搜索接入:先拿 API Key,再配 provider

这一页教你把 Exa 的 neural / keyword / hybrid 搜索接到 OpenClaw 的 web_search 工具上。最优先做的是去 exa.ai 注册并拿到 API Key,然后要么设环境变量 EXA_API_KEY,要么在配置里填 apiKey。容易漏的是:配置里 provider 要写成 "exa",而且如果用了环境变量,配置里就别再写 apiKey,否则会冲突。

原文共 9 节,先看 Start Here 路径:/tools/exa-search 查看官方原文

第一站

📖 Exa 不是只给你一张地址单,它还会帮你先翻两页

官方一开头就把它的特色说得很明白:这是一个网页搜索提供商,但它自带内容抽取。

🔎

搜索

先帮你找相关网页。

✂️

抽取

再把网页里的重点内容抄出来。

🧠

神经 / 深搜

像换不同力度的找法。你想找“意思接近”的,还是“更认真更深”的,它都能切。

先记一句

Exa 是“找得到”,也“抄得出”。

第二站

🔑 API key 像借书证,先办卡再进馆

拿 Exa 的 key 很简单,先注册,再把 key 放进 Gateway 环境或者配置里。

1. 去 exa.ai 开账号

像先去图书馆办卡。

2. 拿 API key

EXA_API_KEY 就像借书证。系统看见它,才知道你能进门。

3. 放进环境变量或配置

你可以直接放在 Gateway 环境,也可以走 openclaw configure --section web

📌 一句话

Exa 上岗前,先把借书证办好。

第三站

🛠 配置那段 JSON,翻成人话就是“把网页搜索台接到 Exa”

官方给的配置和 Brave 很像:插件里放 key,web search 里选 provider。不同的是 Exa 还常常顺手带出内容抽取的能力。

tools.web.search.provider: \"exa\"

像在总搜索台挂牌:“以后搜网页,先叫 Exa。”

plugins.entries.exa.config.webSearch.apiKey

像把借书证放进 Exa 自己的抽屉。

EXA_API_KEY

像另一条备用通道。环境变量和配置都能喂给它。

⚠️ 官方提醒

如果你同时想用日期筛选和 freshness,二选一就行,别两套时间尺一起上。

第四站

🎚 Exa 的参数,像给读书小助手的不同任务单

Exa 真正好玩的地方,是它的搜索模式和内容抽取模式很多。你可以把它当成会读书的搜索员。

🧠

type: neural

像按意思找书,不只是按字面撞关键词。

type: fast

像先快翻一遍,适合速度优先。

🪜

type: deep

像认真往深里翻,查得更细。

🔁

deep-reasoning

像深搜以后还要再想一层,适合更复杂的问题。

count

像告诉它:别搬整间图书馆,先拿我需要的几本。

freshness

像只要最近新上架的书。

date_after / date_before

像拿日期尺子圈出时间盒子。

contents

像告诉它:“不只给我目录,还给我书里的摘录。”

第五站

📚 contents 这块,才是 Exa 真正像“读书助手”的地方

官方最值得记的一段,就是它可以同时给你全文、亮句和摘要。这样搜索结果不只是“去哪儿找”,而是“找到后先看什么”。

text

像把整页抄下来。内容最全,但也最长。

highlights

像只划重点句子,省你自己翻。

summary

像给你先念一段小抄,知道大意再决定要不要深看。

🧠 默认行为

如果你没写 contents,Exa 还会默认给高亮片段。意思就是它默认就不想只给你空目录。

第六站

🧯 这页最后的几个提醒,都是在告诉你“Exa 既快又深,但别把规则混了”

官方 Notes 里写得很实用。你只要记住几个小坑就行。

📦 最多 100 条

它能给很多结果,但不是无限。像借书也有上限。

⏳ 会缓存

结果默认缓存 15 分钟。重复问题别总让它重新跑。

🧰 先搜,后抽

你可以先用搜索找大方向,再用 contents 把内容拿细一点。

🎈 最后收住

Exa 像一个会先找路、再抄重点的读书小助手,特别适合想要更丰富网页内容的场景。