---

name: tavily description: Use Tavily web search/discovery to find URLs/sources, do lead research, gather up-to-date links, or produce a cited summary from web results. metadata: {"openclaw":{"requires":{"env":["TAVILY_API_KEY"]},"primaryEnv":"TAVILY_API_KEY"}}

Tavily

Use the bundled CLI to run Tavily searches from the terminal and collect sources fast.

Quick start (CLI)

The scripts require TAVILY_API_KEY in the environment (sent as Authorization: Bearer ...).

export TAVILY_API_KEY="..."
node skills/tavily/scripts/tavily_search.js --query "best rust http client" --max_results 5

• JSON response is printed to stdout.
• A simple URL list is printed to stderr by default.

Common patterns

Get URLs only

export TAVILY_API_KEY="..."
node skills/tavily/scripts/tavily_search.js --query "OpenTelemetry collector config" --urls-only

Restrict to (or exclude) specific domains

export TAVILY_API_KEY="..."
node skills/tavily/scripts/tavily_search.js \
  --query "oauth device code flow" \
  --include_domains oauth.net,datatracker.ietf.org \
  --exclude_domains medium.com

Notes

• The bundled CLI supports a subset of Tavily’s request fields (query, max_results, include_domains, exclude_domains).
• For API field notes and more examples, read: references/tavily-api.md.
• Wrapper script (optional): scripts/tavily_search.sh.