---
title: "Web Search"
sidebarTitle: "Web Search"
summary: "web_search, x_search, and web_fetch -- search the web, search X posts, or fetch page content"
read_when:
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
- You want to enable or configure web_search
- You want to enable or configure x_search
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
- You need to choose a search provider
- You want to understand auto-detection and provider fallback
---
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
# Web Search
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
The `web_search` tool searches the web using your configured provider and
returns results. Results are cached by query for 15 minutes (configurable).
OpenClaw also includes `x_search` for X (formerly Twitter) posts and
`web_fetch` for lightweight URL fetching. In this phase, `web_fetch` stays
local while `web_search` and `x_search` can use xAI Responses under the hood.
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
< Info >
`web_search` is a lightweight HTTP tool, not browser automation. For
JS-heavy sites or logins, use the [Web Browser ](/tools/browser ). For
fetching a specific URL, use [Web Fetch ](/tools/web-fetch ).
< / Info >
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
## Quick start
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
< Steps >
< Step title = "Choose a provider" >
Pick a provider and complete any required setup. Some providers are
key-free, while others use API keys. See the provider pages below for
details.
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
< / Step >
< Step title = "Configure" >
```bash
openclaw configure --section web
```
This stores the provider and any needed credential. You can also set an env
var (for example `BRAVE_API_KEY` ) and skip this step for API-backed
providers.
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
< / Step >
< Step title = "Use it" >
The agent can now call `web_search` :
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
```javascript
await web_search({ query: "OpenClaw plugin SDK" });
```
For X posts, use:
```javascript
await x_search({ query: "dinner recipes" });
```
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
< / Step >
< / Steps >
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
## Choosing a provider
< CardGroup cols = {2} >
< Card title = "Brave Search" icon = "shield" href = "/tools/brave-search" >
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
Structured results with snippets. Supports `llm-context` mode, country/language filters. Free tier available.
< / Card >
< Card title = "DuckDuckGo" icon = "bird" href = "/tools/duckduckgo-search" >
Key-free fallback. No API key needed. Unofficial HTML-based integration.
< / Card >
< Card title = "Exa" icon = "brain" href = "/tools/exa-search" >
Neural + keyword search with content extraction (highlights, text, summaries).
< / Card >
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
< Card title = "Firecrawl" icon = "flame" href = "/tools/firecrawl" >
Structured results. Best paired with `firecrawl_search` and `firecrawl_scrape` for deep extraction.
< / Card >
< Card title = "Gemini" icon = "sparkles" href = "/tools/gemini-search" >
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
AI-synthesized answers with citations via Google Search grounding.
< / Card >
< Card title = "Grok" icon = "zap" href = "/tools/grok-search" >
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
AI-synthesized answers with citations via xAI web grounding.
< / Card >
< Card title = "Kimi" icon = "moon" href = "/tools/kimi-search" >
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
AI-synthesized answers with citations via Moonshot web search.
< / Card >
feat(tools): add MiniMax as bundled web search provider
Add native MiniMax Search integration via their Coding Plan search API
(POST /v1/coding_plan/search). This brings MiniMax in line with Brave,
Kimi, Grok, Gemini, and other providers that already have bundled web
search support.
- Implement WebSearchProviderPlugin with caching, credential resolution,
and trusted endpoint wrapping
- Support both global (api.minimax.io) and CN (api.minimaxi.com)
endpoints, inferred from explicit region config, model provider base
URL, or minimax-portal OAuth base URL
- Prefer MINIMAX_CODE_PLAN_KEY over MINIMAX_API_KEY in credential
fallback, matching existing repo precedence
- Accept SecretRef objects for webSearch.apiKey (type: [string, object])
- Register in bundled registry, provider-id compat map, and fast-path
plugin id list with full alignment test coverage
- Add unit tests for endpoint/region resolution and edge cases
Closes #47927
Related #11399
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
8 months ago
< Card title = "MiniMax Search" icon = "globe" href = "/tools/minimax-search" >
Structured results via the MiniMax Coding Plan search API.
< / Card >
< Card title = "Ollama Web Search" icon = "globe" href = "/tools/ollama-search" >
Key-free search via your configured Ollama host. Requires `ollama signin` .
< / Card >
< Card title = "Perplexity" icon = "search" href = "/tools/perplexity-search" >
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
Structured results with content extraction controls and domain filtering.
< / Card >
< Card title = "SearXNG" icon = "server" href = "/tools/searxng-search" >
Self-hosted meta-search. No API key needed. Aggregates Google, Bing, DuckDuckGo, and more.
< / Card >
< Card title = "Tavily" icon = "globe" href = "/tools/tavily" >
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
Structured results with search depth, topic filtering, and `tavily_extract` for URL extraction.
< / Card >
< / CardGroup >
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
### Provider comparison
| Provider | Result style | Filters | API key |
| ----------------------------------------- | -------------------------- | ------------------------------------------------ | -------------------------------------------------------------------------------- |
| [Brave ](/tools/brave-search ) | Structured snippets | Country, language, time, `llm-context` mode | `BRAVE_API_KEY` |
| [DuckDuckGo ](/tools/duckduckgo-search ) | Structured snippets | -- | None (key-free) |
| [Exa ](/tools/exa-search ) | Structured + extracted | Neural/keyword mode, date, content extraction | `EXA_API_KEY` |
| [Firecrawl ](/tools/firecrawl ) | Structured snippets | Via `firecrawl_search` tool | `FIRECRAWL_API_KEY` |
| [Gemini ](/tools/gemini-search ) | AI-synthesized + citations | -- | `GEMINI_API_KEY` |
| [Grok ](/tools/grok-search ) | AI-synthesized + citations | -- | `XAI_API_KEY` |
| [Kimi ](/tools/kimi-search ) | AI-synthesized + citations | -- | `KIMI_API_KEY` / `MOONSHOT_API_KEY` |
feat(tools): add MiniMax as bundled web search provider
Add native MiniMax Search integration via their Coding Plan search API
(POST /v1/coding_plan/search). This brings MiniMax in line with Brave,
Kimi, Grok, Gemini, and other providers that already have bundled web
search support.
- Implement WebSearchProviderPlugin with caching, credential resolution,
and trusted endpoint wrapping
- Support both global (api.minimax.io) and CN (api.minimaxi.com)
endpoints, inferred from explicit region config, model provider base
URL, or minimax-portal OAuth base URL
- Prefer MINIMAX_CODE_PLAN_KEY over MINIMAX_API_KEY in credential
fallback, matching existing repo precedence
- Accept SecretRef objects for webSearch.apiKey (type: [string, object])
- Register in bundled registry, provider-id compat map, and fast-path
plugin id list with full alignment test coverage
- Add unit tests for endpoint/region resolution and edge cases
Closes #47927
Related #11399
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
8 months ago
| [MiniMax Search ](/tools/minimax-search ) | Structured snippets | Region (`global` / `cn` ) | `MINIMAX_CODE_PLAN_KEY` / `MINIMAX_CODING_API_KEY` |
| [Ollama Web Search ](/tools/ollama-search ) | Structured snippets | -- | None by default; `ollama signin` required, can reuse Ollama provider bearer auth |
| [Perplexity ](/tools/perplexity-search ) | Structured snippets | Country, language, time, domains, content limits | `PERPLEXITY_API_KEY` / `OPENROUTER_API_KEY` |
| [SearXNG ](/tools/searxng-search ) | Structured snippets | Categories, language | None (self-hosted) |
| [Tavily ](/tools/tavily ) | Structured snippets | Via `tavily_search` tool | `TAVILY_API_KEY` |
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
## Auto-detection
## Native Codex web search
Codex-capable models can optionally use the provider-native Responses `web_search` tool instead of OpenClaw's managed `web_search` function.
- Configure it under `tools.web.search.openaiCodex`
- It only activates for Codex-capable models (`openai-codex/*` or providers using `api: "openai-codex-responses"` )
- Managed `web_search` still applies to non-Codex models
- `mode: "cached"` is the default and recommended setting
- `tools.web.search.enabled: false` disables both managed and native search
```json5
{
tools: {
web: {
search: {
enabled: true,
openaiCodex: {
enabled: true,
mode: "cached",
allowedDomains: ["example.com"],
contextSize: "high",
userLocation: {
country: "US",
city: "New York",
timezone: "America/New_York",
},
},
},
},
},
}
```
If native Codex search is enabled but the current model is not Codex-capable, OpenClaw keeps the normal managed `web_search` behavior.
## Setting up web search
Provider lists in docs and setup flows are alphabetical. Auto-detection keeps a
separate precedence order.
If no `provider` is set, OpenClaw checks providers in this order and uses the
first one that is ready:
API-backed providers first:
1. **Brave** -- `BRAVE_API_KEY` or `plugins.entries.brave.config.webSearch.apiKey` (order 10)
feat(tools): add MiniMax as bundled web search provider
Add native MiniMax Search integration via their Coding Plan search API
(POST /v1/coding_plan/search). This brings MiniMax in line with Brave,
Kimi, Grok, Gemini, and other providers that already have bundled web
search support.
- Implement WebSearchProviderPlugin with caching, credential resolution,
and trusted endpoint wrapping
- Support both global (api.minimax.io) and CN (api.minimaxi.com)
endpoints, inferred from explicit region config, model provider base
URL, or minimax-portal OAuth base URL
- Prefer MINIMAX_CODE_PLAN_KEY over MINIMAX_API_KEY in credential
fallback, matching existing repo precedence
- Accept SecretRef objects for webSearch.apiKey (type: [string, object])
- Register in bundled registry, provider-id compat map, and fast-path
plugin id list with full alignment test coverage
- Add unit tests for endpoint/region resolution and edge cases
Closes #47927
Related #11399
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
8 months ago
2. **MiniMax Search** -- `MINIMAX_CODE_PLAN_KEY` / `MINIMAX_CODING_API_KEY` or `plugins.entries.minimax.config.webSearch.apiKey` (order 15)
3. **Gemini** -- `GEMINI_API_KEY` or `plugins.entries.google.config.webSearch.apiKey` (order 20)
4. **Grok** -- `XAI_API_KEY` or `plugins.entries.xai.config.webSearch.apiKey` (order 30)
5. **Kimi** -- `KIMI_API_KEY` / `MOONSHOT_API_KEY` or `plugins.entries.moonshot.config.webSearch.apiKey` (order 40)
6. **Perplexity** -- `PERPLEXITY_API_KEY` / `OPENROUTER_API_KEY` or `plugins.entries.perplexity.config.webSearch.apiKey` (order 50)
7. **Firecrawl** -- `FIRECRAWL_API_KEY` or `plugins.entries.firecrawl.config.webSearch.apiKey` (order 60)
8. **Exa** -- `EXA_API_KEY` or `plugins.entries.exa.config.webSearch.apiKey` (order 65)
9. **Tavily** -- `TAVILY_API_KEY` or `plugins.entries.tavily.config.webSearch.apiKey` (order 70)
Key-free fallbacks after that:
feat(tools): add MiniMax as bundled web search provider
Add native MiniMax Search integration via their Coding Plan search API
(POST /v1/coding_plan/search). This brings MiniMax in line with Brave,
Kimi, Grok, Gemini, and other providers that already have bundled web
search support.
- Implement WebSearchProviderPlugin with caching, credential resolution,
and trusted endpoint wrapping
- Support both global (api.minimax.io) and CN (api.minimaxi.com)
endpoints, inferred from explicit region config, model provider base
URL, or minimax-portal OAuth base URL
- Prefer MINIMAX_CODE_PLAN_KEY over MINIMAX_API_KEY in credential
fallback, matching existing repo precedence
- Accept SecretRef objects for webSearch.apiKey (type: [string, object])
- Register in bundled registry, provider-id compat map, and fast-path
plugin id list with full alignment test coverage
- Add unit tests for endpoint/region resolution and edge cases
Closes #47927
Related #11399
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
8 months ago
10. **DuckDuckGo** -- key-free HTML fallback with no account or API key (order 100)
11. **Ollama Web Search** -- key-free fallback via your configured Ollama host; requires Ollama to be reachable and signed in with `ollama signin` and can reuse Ollama provider bearer auth if the host needs it (order 110)
12. **SearXNG** -- `SEARXNG_BASE_URL` or `plugins.entries.searxng.config.webSearch.baseUrl` (order 200)
If no provider is detected, it falls back to Brave (you will get a missing-key
error prompting you to configure one).
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
< Note >
All provider key fields support SecretRef objects. In auto-detect mode,
OpenClaw resolves only the selected provider key -- non-selected SecretRefs
stay inactive.
< / Note >
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
## Config
```json5
{
tools: {
web: {
search: {
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
enabled: true, // default: true
provider: "brave", // or omit for auto-detection
maxResults: 5,
timeoutSeconds: 30,
cacheTtlMinutes: 15,
},
},
},
}
```
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
Provider-specific config (API keys, base URLs, modes) lives under
`plugins.entries.<plugin>.config.webSearch.*` . See the provider pages for
examples.
`web_fetch` fallback provider selection is separate:
- choose it with `tools.web.fetch.provider`
- or omit that field and let OpenClaw auto-detect the first ready web-fetch
provider from available credentials
- today the bundled web-fetch provider is Firecrawl, configured under
`plugins.entries.firecrawl.config.webFetch.*`
When you choose **Kimi** during `openclaw onboard` or
`openclaw configure --section web` , OpenClaw can also ask for:
- the Moonshot API region (`https://api.moonshot.ai/v1` or `https://api.moonshot.cn/v1` )
- the default Kimi web-search model (defaults to `kimi-k2.5` )
For `x_search` , configure `plugins.entries.xai.config.xSearch.*` . It uses the
same `XAI_API_KEY` fallback as Grok web search.
Legacy `tools.web.x_search.*` config is auto-migrated by `openclaw doctor --fix` .
When you choose Grok during `openclaw onboard` or `openclaw configure --section web` ,
OpenClaw can also offer optional `x_search` setup with the same key.
This is a separate follow-up step inside the Grok path, not a separate top-level
web-search provider choice. If you pick another provider, OpenClaw does not
show the `x_search` prompt.
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
### Storing API keys
< Tabs >
< Tab title = "Config file" >
Run `openclaw configure --section web` or set the key directly:
```json5
{
plugins: {
entries: {
brave: {
config: {
webSearch: {
apiKey: "YOUR_KEY", // pragma: allowlist secret
},
},
},
},
},
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
}
```
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
< / Tab >
< Tab title = "Environment variable" >
Set the provider env var in the Gateway process environment:
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
```bash
export BRAVE_API_KEY="YOUR_KEY"
```
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
For a gateway install, put it in `~/.openclaw/.env` .
See [Env vars ](/help/faq#env-vars-and-env-loading ).
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
< / Tab >
< / Tabs >
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
## Tool parameters
| Parameter | Description |
| --------------------- | ----------------------------------------------------- |
| `query` | Search query (required) |
| `count` | Results to return (1-10, default: 5) |
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
| `country` | 2-letter ISO country code (e.g. "US", "DE") |
| `language` | ISO 639-1 language code (e.g. "en", "de") |
| `search_lang` | Search-language code (Brave only) |
| `freshness` | Time filter: `day` , `week` , `month` , or `year` |
| `date_after` | Results after this date (YYYY-MM-DD) |
| `date_before` | Results before this date (YYYY-MM-DD) |
| `ui_lang` | UI language code (Brave only) |
| `domain_filter` | Domain allowlist/denylist array (Perplexity only) |
| `max_tokens` | Total content budget, default 25000 (Perplexity only) |
| `max_tokens_per_page` | Per-page token limit, default 2048 (Perplexity only) |
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
< Warning >
Not all parameters work with all providers. Brave `llm-context` mode
rejects `ui_lang` , `freshness` , `date_after` , and `date_before` .
Gemini, Grok, and Kimi return one synthesized answer with citations. They
accept `count` for shared-tool compatibility, but it does not change the
grounded answer shape.
Perplexity behaves the same way when you use the Sonar/OpenRouter
compatibility path (`plugins.entries.perplexity.config.webSearch.baseUrl` /
`model` or `OPENROUTER_API_KEY` ).
SearXNG accepts `http://` only for trusted private-network or loopback hosts;
public SearXNG endpoints must use `https://` .
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
Firecrawl and Tavily only support `query` and `count` through `web_search`
-- use their dedicated tools for advanced options.
< / Warning >
## x_search
`x_search` queries X (formerly Twitter) posts using xAI and returns
AI-synthesized answers with citations. It accepts natural-language queries and
optional structured filters. OpenClaw only enables the built-in xAI `x_search`
tool on the request that serves this tool call.
< Note >
xAI documents `x_search` as supporting keyword search, semantic search, user
search, and thread fetch. For per-post engagement stats such as reposts,
replies, bookmarks, or views, prefer a targeted lookup for the exact post URL
or status ID. Broad keyword searches may find the right post but return less
complete per-post metadata. A good pattern is: locate the post first, then
run a second `x_search` query focused on that exact post.
< / Note >
### x_search config
```json5
{
plugins: {
entries: {
xai: {
config: {
xSearch: {
enabled: true,
model: "grok-4-1-fast-non-reasoning",
inlineCitations: false,
maxTurns: 2,
timeoutSeconds: 30,
cacheTtlMinutes: 15,
},
webSearch: {
apiKey: "xai-...", // optional if XAI_API_KEY is set
},
},
},
},
},
}
```
### x_search parameters
| Parameter | Description |
| ---------------------------- | ------------------------------------------------------ |
| `query` | Search query (required) |
| `allowed_x_handles` | Restrict results to specific X handles |
| `excluded_x_handles` | Exclude specific X handles |
| `from_date` | Only include posts on or after this date (YYYY-MM-DD) |
| `to_date` | Only include posts on or before this date (YYYY-MM-DD) |
| `enable_image_understanding` | Let xAI inspect images attached to matching posts |
| `enable_video_understanding` | Let xAI inspect videos attached to matching posts |
### x_search example
```javascript
await x_search({
query: "dinner recipes",
allowed_x_handles: ["nytfood"],
from_date: "2026-03-01",
});
```
```javascript
// Per-post stats: use the exact status URL or status ID when possible
await x_search({
query: "https://x.com/huntharo/status/1905678901234567890",
});
```
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
## Examples
```javascript
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
// Basic search
await web_search({ query: "OpenClaw plugin SDK" });
// German-specific search
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
await web_search({ query: "TV online schauen", country: "DE", language: "de" });
// Recent results (past week)
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
await web_search({ query: "AI developments", freshness: "week" });
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
// Date range
await web_search({
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
query: "climate research",
date_after: "2024-01-01",
date_before: "2024-06-30",
});
// Domain filtering (Perplexity only)
await web_search({
query: "product reviews",
domain_filter: ["-reddit.com", "-pinterest.com"],
});
```
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
## Tool profiles
If you use tool profiles or allowlists, add `web_search` , `x_search` , or `group:web` :
```json5
{
tools: {
allow: ["web_search", "x_search"],
// or: allow: ["group:web"] (includes web_search, x_search, and web_fetch)
},
}
```
docs(tools): restructure web tools IA and rewrite web.md
Navigation restructure:
- "Browser" group -> "Web Browser"
- New "Web Tools" group containing Web Fetch, Web Search, and all
7 search provider sub-pages
- Other tools (btw, diffs, etc.) stay at top level
New page:
- tools/web-fetch.md: dedicated web_fetch reference with Steps,
config, Firecrawl fallback, limits
Rewritten page:
- tools/web.md: now "Web Search" -- focused search overview with
Steps quick-start, CardGroup provider picker, Tabs for key storage,
provider comparison table, auto-detection, parameters, examples.
Removed all inline provider setup (lives in sub-pages) and web_fetch
content (now in dedicated page).
Final sidebar:
Tools
├── Web Browser (browser, login, troubleshooting)
├── Web Tools
│ ├── Web Fetch
│ ├── Web Search
│ └── Brave / Firecrawl / Gemini / Grok / Kimi / Perplexity / Tavily
├── btw, diffs, exec, ...
8 months ago
## Related
- [Web Fetch ](/tools/web-fetch ) -- fetch a URL and extract readable content
- [Web Browser ](/tools/browser ) -- full browser automation for JS-heavy sites
- [Grok Search ](/tools/grok-search ) -- Grok as the `web_search` provider
- [Ollama Web Search ](/tools/ollama-search ) -- key-free web search through your Ollama host