openclaw-tavily

Tavily AI search and content extraction plugin for OpenClaw.

What It Does

Adds two tools to OpenClaw:

• tavily_search — AI-powered web search with answer summaries
• tavily_extract — Clean content extraction from URLs

Both tools use 1Password for secure API key storage (no plaintext keys in config).

Features

• Search modes: basic (fast, 1 credit) or advanced (thorough, 2 credits)
• Topic filtering: general, news, or finance
• Domain control: Include or exclude specific domains
• Answer summaries: AI-generated answer from search results
• Multi-URL extraction: Extract clean content from multiple URLs in one call

Install

npm install
npm run build

Set Up Tavily

1. Store Tavily API key in 1Password:

   op item create \
     --category="API Credential" \
     --title="Tavily API" \
     --vault="Agent Secrets" \
     'api key[password]=tvly-YOUR_KEY_HERE'

2. Add to OpenClaw: Copy dist/ to ~/.openclaw/extensions/openclaw-tavily/

3. Enable in openclaw.json:

   {
     "plugins": {
       "entries": {
         "openclaw-tavily": {
           "enabled": true
         }
       }
     }
   }

Usage

Search

await tavily_search({
  query: "latest AI regulation news",
  search_depth: "advanced",
  topic: "news",
  max_results: 10
})

Extract

await tavily_extract({
  urls: [
    "https://example.com/article1",
    "https://example.com/article2"
  ]
})

How It Works

• 1Password SDK: Secure credential resolution via op://Agent Secrets/Tavily API/api key
• Tavily API: Search at https://api.tavily.com/search, extract at /extract
• MCP-compatible: Returns tool results in MCP format

Why 1Password Integration?

No more API keys in config files. The Tavily API key is stored in 1Password's "Agent Secrets" vault and resolved at runtime via the 1Password SDK.

Status

Active/Deployed — Running in Lēsa's OpenClaw environment.

Author

Built by Lēsa / WIP.computer 🏴‍☠️

License

MIT. Built by Parker Todd Brooks, Lēsa, Claude Code, and Codex.