概述
web_search 是 OpenClaw 的网页搜索工具，支持多个搜索提供商，结果按查询缓存 15 分钟。同时提供 x_search（X/Twitter 帖子搜索）和 web_fetch（轻量 URL 抓取）。
核心功能
- 支持 12 个搜索提供商：Brave、DuckDuckGo、Exa、Firecrawl、Gemini、Grok、Kimi、MiniMax、Ollama、Perplexity、SearXNG、Tavily
- 自动检测可用提供商（按优先级顺序）
x_search：通过 xAI 搜索 X 平台帖子，支持句柄过滤、日期范围、图片/视频理解- 原生 OpenAI/Codex web search 集成（当无托管提供商时自动启用）
- 结果缓存 15 分钟（可配置）
提供商对比
| 提供商 | 结果类型 | API Key | 特点 |
|---|---|---|---|
| Brave | 结构化摘要 | BRAVE_API_KEY | 支持 llm-context 模式 |
| DuckDuckGo | 结构化摘要 | 无需 | 实验性，HTML 解析 |
| Exa | 结构化+提取 | EXA_API_KEY | 神经搜索+内容提取 |
| Gemini | AI 合成+引用 | GEMINI_API_KEY | Google Search grounding |
| Grok | AI 合成+引用 | XAI_API_KEY | xAI web grounding |
| Kimi | AI 合成+引用 | KIMI_API_KEY | Moonshot web search |
| Perplexity | 结构化摘要 | PERPLEXITY_API_KEY | 支持域名过滤 |
| SearXNG | 结构化摘要 | 无需 | 自托管元搜索 |
| Tavily | 结构化摘要 | TAVILY_API_KEY | 支持深度搜索 |
配置/使用
{
tools: {
web: {
search: {
enabled: true,
provider: "brave", // 省略则自动检测
maxResults: 5,
timeoutSeconds: 30,
cacheTtlMinutes: 15,
},
},
},
}自动检测优先级：Brave(10) → MiniMax(15) → Gemini(20) → Grok(30) → Kimi(40) → Perplexity(50) → Firecrawl(60) → Exa(65) → Tavily(70) → DuckDuckGo(100) → Ollama(110) → SearXNG(200)
相关页面
- concepts/tool-web-fetch — web_fetch 工具，HTTP 抓取与内容提取
- concepts/tool-brave-search — Brave Search 配置详情
- concepts/tool-exa-search — Exa 神经搜索
- concepts/tool-perplexity-search — Perplexity 搜索
- concepts/tool-firecrawl — Firecrawl 搜索与抓取