exa-search 技能

使用此技能通过 Exa AI 搜索引擎搜索网页、查找相似页面或获取页面内容——快速、神经化且具备证书感知能力。

该技能通过 Bash 调用原生 Rust 二进制文件 (bin/exa-search)。运行 install.sh 一次即可构建。

何时使用 / 何时不使用

✅ 使用场景：

• - 搜索网页上的文章、文档、代码仓库、论文、工具、人物、公司
• 查找最新新闻或公告（使用 livecrawl: fallback 或 always 获取最新内容）
• 无需浏览器自动化即可获取已知 URL 的全文
• 查找与参考 URL 相似的页面（竞品分析、替代工具）
• 任何非特定推文或视频的网页查找

❌ 不适用于：

• - 获取推文/X 帖子 → 使用 fxtwitter 技能（Exa 无法获取推文 URL）
• 下载视频/音频 → 使用 yt-dlp
• 抓取动态或 Cloudflare 保护的页面 → 使用 scrapling
• 本地文件/代码搜索 → 使用 rg、find 或 grep
• 查询结构化 API（GitHub、天气等）→ 使用专用技能
• 当查询已经是已知内容的直接 URL 时 → 优先使用 get_contents 操作

前提条件

• - 在 ~/.openclaw/workspace/.env 中设置 EXAAPIKEY（在 exa.ai 获取）
• 安装 Rust（rustup）——仅用于一次性构建
• 存在 bin/exa-search 二进制文件（运行 bash install.sh 构建）

操作

1. 搜索

bash
echo {query:你的查询内容,num_results:5} \
| EXAAPIKEY=$(grep -E ^EXAAPIKEY= ~/.openclaw/workspace/.env | cut -d= -f2 | tr -d ) \
~/.openclaw/workspace/skills/exa-search/bin/exa-search

完整参数：

json
{
query: rust 异步编程,
num_results: 5,
type: neural,
livecrawl: never,
include_domains: [github.com, docs.rs],
exclude_domains: [reddit.com],
startpublisheddate: 2025-01-01,
endpublisheddate: 2026-12-31,
category: 研究论文,
use_autoprompt: true,
text: { max_characters: 2000 },
highlights: { numsentences: 3, highlightsper_url: 2 },
summary: { query: 关键要点 }
}

type 选项： auto（默认）· neural · keyword

livecrawl 选项：

• - never — 最快（约 300-600ms），纯缓存索引。最适合参考资料、文档、课程。
• fallback — 使用缓存，未缓存时实时抓取。良好的默认选项。
• preferred — 优先实时抓取。较慢但更新鲜。
• always — 始终实时抓取。适用于突发新闻或快速变化的页面。

2. 查找相似

查找与给定 URL 相似的页面：

bash
echo {action:findsimilar,url:https://example.com,numresults:5} \
| EXAAPIKEY=$(grep -E ^EXAAPIKEY= ~/.openclaw/workspace/.env | cut -d= -f2 | tr -d ) \
~/.openclaw/workspace/skills/exa-search/bin/exa-search

参数： 与搜索相同的内容选项（text、highlights、summary、livecrawl）

3. 获取内容

获取一个或多个 URL 的完整内容：

bash
echo {action:getcontents,urls:[https://example.com,https://other.com],text:{maxcharacters:1000}} \
| EXAAPIKEY=$(grep -E ^EXAAPIKEY= ~/.openclaw/workspace/.env | cut -d= -f2 | tr -d ) \
~/.openclaw/workspace/skills/exa-search/bin/exa-search

输出格式

所有操作在标准输出返回 JSON：

json
{
ok: true,
action: search,
results: [
{
url: https://...,
title: ...,
score: 0.87,
author: ...,
published_date: 2026-01-15,
image: https://...,
favicon: https://...,
text: ...,
highlights: [...],
summary: ...
}
],
formatted: ## 标题\n...
}

错误时：
json
{ ok: false, error: ... }

formatted 字段是可直接使用的 Markdown 格式——可以直接发送给用户。

速度参考（相同查询，3 次运行）

峰值速度比 Exa MCP 快约 18.7 倍。

辅助：加载 API 密钥

bash
EXAAPIKEY=$(grep -E ^EXAAPIKEY= ~/.openclaw/workspace/.env | cut -d= -f2 | tr -d )

或在较长工作流顶部一次性导出：

bash
export EXAAPIKEY=$(grep -E ^EXAAPIKEY= ~/.openclaw/workspace/.env | cut -d= -f2 | tr -d )
echo {query:...} | ~/.openclaw/workspace/skills/exa-search/bin/exa-search

调用模式

bash
EXAAPIKEY=$(grep -E ^EXAAPIKEY= ~/.openclaw/workspace/.env | cut -d= -f2 | tr -d )
echo {query:...,num_results:5,livecrawl:never} \
| EXAAPIKEY=$EXAAPIKEY ~/.openclaw/workspace/skills/exa-search/bin/exa-search

输出中的 formatted 字段是可直接使用的 Markdown 格式——直接发送给用户。

模式选择（每次搜索都要慎重考虑）

默认推荐： livecrawl: never，type: neural——最快，适用于 80% 的搜索。

何时使用每个操作

search（默认）——用于从查询字符串中检索任何信息。

find_similar——当你有 URL 并想要更多类似内容时使用：相关文章、替代工具、相似仓库、竞品。
bash
echo {action:findsimilar,url:https://...,numresults:5,livecrawl:never} | EXAAPIKEY=$EXAAPIKEY ...

get_contents——当你有特定 URL 并需要其全文时使用：文档页面、博客文章、GitHub README、论文。当 URL 已知时比 search 更快。
bash
echo {action:getcontents,urls:[https://...],text:{maxcharacters:3000}} | EXAAPIKEY=$EXAAPIKEY ...

为研究任务丰富结果

在撰写报告、摘要或比较多个结果时——请求每个结果