Integration

Tavily Flex2Dmax

Name: Tavily Flex2Dmax
Rating: 3.5 (1 reviews)
Author: JPClaw12

By JPClaw12 ⭐ 1 stars 👁 14 views ▲ 0 votes

Tavily web tools plugin for OpenClaw with automatic API key rotation. When one API key hits rate limit (429), auto-switches to the next. For research and educational use only. Author: JPClawbot | Vibe coded by Claude Opus 4.5

GitHub

Install

npm install openclaw-tavily-flex2dmax

Configuration Example

{
  "plugins": {
    "entries": {
      "openclaw-tavily": {
        "enabled": true,
        "config": {
          "apiKey": "tvly-key1,tvly-key2,tvly-key3"
        }
      }
    }
  }
}

README

# Openclaw-Tavily-Flex2Dmax

**Tavily web tools plugin for [OpenClaw](https://github.com/openclaw/openclaw) with automatic API key rotation.**

When one API key hits its rate limit (HTTP 429), the plugin automatically rotates to the next key and retries — no downtime, no manual switching.

> **Disclaimer:** This tool is for **research and educational use only**. The author does not bear any responsibilities if someone abuses it.

## How It Works

```
.env:  TAVILY_API_KEY=tvly-key1,tvly-key2,tvly-key3
```

```
Request #1 → key1 ✓
Request #2 → key1 ✓
Request #3 → key1 → 429! → key2 ✓  (auto-rotated)
Request #4 → key2 ✓
Request #5 → key2 → 429! → key3 ✓  (auto-rotated)
...
```

The `KeyRotator` class handles all of this transparently. Every Tavily API call (search, extract, crawl, map, research) goes through the rotator.

## Features

| Tool | Description |
|------|-------------|
| `tavily_search` | Web search with AI answers, domain filtering, news support |
| `tavily_extract` | Extract clean markdown/text content from URLs |
| `tavily_crawl` | Crawl a website from a root URL, extract page content |
| `tavily_map` | Discover and list all URLs from a website |
| `tavily_research` | Deep agentic research with comprehensive reports |

**Plus:**
- Automatic API key rotation on rate limit (429)
- Support for unlimited number of keys (comma-separated)
- In-memory response caching
- Configurable search depth, timeout, and more

## Setup

### 1. Get API Keys

Sign up at [app.tavily.com](https://app.tavily.com) — free tier available.

### 2. Configure Keys

Create a `.env` file:

```env
# Single key works too
TAVILY_API_KEY=tvly-your-key-here

# Multiple keys — comma-separated, auto-rotates on rate limit
TAVILY_API_KEY=tvly-key1,tvly-key2,tvly-key3
```

Or configure via OpenClaw plugin config:

```json
{
  "plugins": {
    "entries": {
      "openclaw-tavily": {
        "enabled": true,
        "config": {
          "apiKey": "tvly-key1,tvly-key2,tvly-key3"
        }
      }
    }
  }
}
```

### 3. Install

```bash
npm install openclaw-tavily-flex2dmax
```

## Configuration Options

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| `apiKey` | string | `TAVILY_API_KEY` env | Comma-separated API keys |
| `searchDepth` | string | `"advanced"` | `"ultra-fast"`, `"fast"`, `"basic"`, or `"advanced"` |
| `maxResults` | number | `5` | Results per search (1-20) |
| `includeAnswer` | boolean/string | `true` | AI answer: `true`, `false`, `"basic"`, `"advanced"` |
| `includeRawContent` | boolean/string | `false` | Raw content: `true`, `false`, `"markdown"`, `"text"` |
| `timeoutSeconds` | number | `30` | Request timeout |
| `cacheTtlMinutes` | number | `15` | Cache duration (0 to disable) |

## Based On

This is a fork of [openclaw-tavily](https://github.com/framix-team/openclaw-tavily) by [Framix](https://framix.net), with the addition of the `KeyRotator` for automatic API key rotation.

## Author

**JPClawbot**

Vibe coded by **Claude Opus 4.5**

## License

MIT

---

## Star History

<a href="https://www.star-history.com/?repos=JPClaw12%2FOpenclaw-Tavily-Flex2Dmax&type=date&legend=top-left">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=JPClaw12/Openclaw-Tavily-Flex2Dmax&type=date&theme=dark&legend=top-left" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=JPClaw12/Openclaw-Tavily-Flex2Dmax&type=date&legend=top-left" />
   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=JPClaw12/Openclaw-Tavily-Flex2Dmax&type=date&legend=top-left" />
 </picture>
</a>

integration