OpenClaw

Give OpenClaw, the self-hosted gateway that connects WhatsApp, Telegram, Discord, iMessage, and other chat apps to AI agents, live web search and content extraction across every connected channel.

Get a Tavily API key

Get a free key from the Tavily dashboard.

Set Tavily as your search provider

Run the setup wizard and select Tavily when prompted for a search provider:

openclaw configure --section web

Or configure it yourself:

{
  "plugins": {
    "entries": {
      "tavily": {
        "enabled": true,
        "config": {
          "webSearch": {
            "apiKey": "tvly-YOUR_API_KEY"
          }
        }
      }
    }
  },
  "tools": {
    "web": {
      "search": {
        "provider": "tavily"
      }
    }
  }
}

export TAVILY_API_KEY="tvly-YOUR_API_KEY"

You can also put TAVILY_API_KEY in ~/.openclaw/.env. If it’s set and no other search provider key is configured, OpenClaw selects Tavily automatically.

Try it

Open the Control UI, or message your agent from any connected chat app:

openclaw dashboard

Search the web for this week's most important AI announcements and cite the sources.

Watch the setup

OpenClaw onboarding with Tavily as the web search provider

What you get

Tool	Use it for
`web_search`	OpenClaw’s built-in search, routed through Tavily. Takes only a `query` and a result `count`.
`tavily_search`	Search with Tavily controls: depth, topic, recency, domain filters, and AI-generated answers.
`tavily_extract`	Clean content from one or more URLs.

Tavily tool parameters

tavily_search

Parameter	Description
`query`	Search query (keep under 1500 characters)
`search_depth`	`basic` (default, fast) or `advanced` (highest relevance)
`topic`	`general` (default), `news`, or `finance`
`max_results`	Number of results, 1–20 (default: 5)
`include_answer`	Include an AI-generated answer summary
`time_range`	Filter by recency: `day`, `week`, `month`, or `year`
`include_domains`	Array of domains to restrict results to
`exclude_domains`	Array of domains to exclude

tavily_extract

Parameter	Description
`urls`	Array of URLs to extract (1–20 per request)
`query`	Rerank extracted chunks by relevance to this query
`extract_depth`	`basic` (default) or `advanced` (for JS-heavy pages)
`chunks_per_source`	Chunks per URL, 1–5 (requires `query`)
`include_images`	Include image URLs in results

Example prompts

Research the latest developments in solid-state batteries and summarize them with sources.

Summarize this article: https://example.com/article

Every morning, send me the top news about our competitors from the last day, with links.

Get started

Coding agents

API keys & credits

Best practices

Help

What you get

Example prompts

Learn more

​What you get

​Example prompts

​Learn more

What you get

Example prompts

Learn more