Tavily Search OpenClaw Skill

Web search using Tavily's LLM-optimized API. Returns relevant results with content snippets, scores, and metadata.

v1.0.1 Updated 2 mo ago

Installation

clawhub install liang-tavily-search

Requires npm i -g clawhub

View on ClawHub Download .zip

39.7k

Downloads

107

Stars

277

current installs

288 all-time

1

Versions

EU-Hosted Inference API

Power your OpenClaw skills with
the best open-source models.

Drop-in OpenAI-compatible API. No data leaves Europe.

Explore Inference API

GLM

GLM 5

$1.00 / $3.20

per M tokens

Kimi

Kimi K2.5

$0.60 / $2.80

per M tokens

MiniMax

MiniMax M2.5

$0.30 / $1.20

per M tokens

Qwen

Qwen3.5 122B

$0.40 / $3.00

per M tokens

Tavily Search

Search the web and get relevant results optimized for LLM consumption.

Authentication

Get your API key at https://tavily.com and add to your OpenClaw config:

            {
  "skills": {
    "entries": {
      "tavily-search": {
        "enabled": true,
        "apiKey": "tvly-YOUR_API_KEY_HERE"
      }
    }
  }
}
          

Or set the environment variable:

export TAVILY_API_KEY="tvly-YOUR_API_KEY_HERE"

Quick Start

Using the Script

            node {baseDir}/scripts/search.mjs "query"
node {baseDir}/scripts/search.mjs "query" -n 10
node {baseDir}/scripts/search.mjs "query" --deep
node {baseDir}/scripts/search.mjs "query" --topic news
          

Examples

            # Basic search
node {baseDir}/scripts/search.mjs "python async patterns"

# With more results
node {baseDir}/scripts/search.mjs "React hooks tutorial" -n 10

# Advanced search
node {baseDir}/scripts/search.mjs "machine learning" --deep

# News search
node {baseDir}/scripts/search.mjs "AI news" --topic news

# Domain-filtered search
node {baseDir}/scripts/search.mjs "Python docs" --include-domains docs.python.org
          

Options

Option	Description	Default
`-n <count>`	Number of results (1-20)	10
`--depth <mode>`	Search depth: `ultra-fast`, `fast`, `basic`, `advanced`	`basic`
`--topic <topic>`	Topic: `general` or `news`	`general`
`--time-range <range>`	Time range: `day`, `week`, `month`, `year`	-
`--include-domains <domains>`	Comma-separated domains to include	-
`--exclude-domains <domains>`	Comma-separated domains to exclude	-
`--raw-content`	Include full page content	false
`--json`	Output raw JSON	false

Search Depth

Depth	Latency	Relevance	Use Case
`ultra-fast`	Lowest	Lower	Real-time chat, autocomplete
`fast`	Low	Good	Need chunks but latency matters
`basic`	Medium	High	General-purpose, balanced
`advanced`	Higher	Highest	Precision matters, research

Tips

Keep queries under 400 characters - Think search query, not prompt
Break complex queries into sub-queries - Better results than one massive query
Use --include-domains to focus on trusted sources
Use --time-range for recent information
Filter by score (0-1) to get highest relevance results

Statistics

Downloads 39.7k

Stars 107

Current installs 277

All-time installs 288

Versions 1

Comments 0

Created Mar 2, 2026

Updated Mar 2, 2026

Author

Liang

@matthew77

Latest Changes

v1.0.1 · Mar 2, 2026

- Initial release of Tavily Search skill. - Enables web search through Tavily’s API, optimized for LLMs. - Supports result snippets, scores, metadata, and domain/topic filtering. - Provides flexible search depth options and time range filtering. - Authentication via environment variable or config file. - Includes command-line usage examples and documentation.

Quick Install

clawhub install liang-tavily-search

Related Skills

Other popular skills you might find useful.

Agent Browser

MaTriXy

Headless browser automation CLI optimized for AI agents with accessibility tree snapshots and ref-based element selection

99.8k 360 v0.1.0

Browser Use

shawn pana

Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs to navigate websites, interact with w...

38.4k 90 v2.0.1

Browser Automation

peytoncasper

Automate web browser interactions using natural language via CLI commands. Use when the user asks to browse websites, navigate web pages, extract data from websites, take screenshots, fill forms, click buttons, or interact with web applications.

38.1k 51 v1.0.1