Tavily Search & Extract

Tavily-powered web search with modes optimized for crypto/finance research and spiritual growth content.

Requirements

Required: TAVILY_API_KEY

This skill requires a Tavily API key. Set it before using:

# Option 1: Environment variable
export TAVILY_API_KEY='tvly-...'

# Option 2: In ~/.openclaw/.env
TAVILY_API_KEY=tvly-...

Get your free API key at: https://tavily.com

Commands

General Search (default)

python3 ~/.openclaw/skills/tavily/scripts/tavily.py --query "..."

News Mode — recent articles, time-filtered

python3 ~/.openclaw/skills/tavily/scripts/tavily.py --mode news --query "Bitcoin ETF" --days 7
python3 ~/.openclaw/skills/tavily/scripts/tavily.py --mode news --query "Fed rate decision" --days 1 --preset finance

Research Mode — deep search with answer summary

python3 ~/.openclaw/skills/tavily/scripts/tavily.py --mode research --query "Solana ecosystem overview"
python3 ~/.openclaw/skills/tavily/scripts/tavily.py --mode research --query "DeFi yield strategies 2025" --preset crypto

Extract Mode — fetch full content from URL(s)

python3 ~/.openclaw/skills/tavily/scripts/tavily.py --extract https://example.com/whitepaper.pdf
python3 ~/.openclaw/skills/tavily/scripts/tavily.py --extract https://url1.com https://url2.com

Options

| Option | Values | Default | Notes | |---|---|---|---| | --mode | general, news, research | general | Sets search strategy | | --query | string | — | Search query | | --preset | crypto, finance, spiritual | none | Domain whitelist preset | | --days | integer | 7 (news), — (others) | Filter results to last N days | | --max-results | 1–10 | 5 (general/news), 8 (research) | Number of results | | --lang | zh-TW, en, both | both | Language preference hint | | --format | md, json, brief | md | Output format | | --extract | URL(s) | — | Extract full content from URLs |

Domain Presets

crypto: coindesk.com, cointelegraph.com, decrypt.co, messari.io, defillama.com, theblock.co, cryptobriefing.com, binance.com/research, bitcoin.com, coinmarketcap.com, coingecko.com, delphi.digital

finance: bloomberg.com, reuters.com, ft.com, wsj.com, cnbc.com, marketwatch.com, investing.com, seekingalpha.com, tradingview.com, coinmarketcap.com

spiritual: gaia.com, mindvalley.com, chopra.com, spiritualityhealth.com, lionsroar.com, tricycle.org, sounds-true.com

Behavior Notes

• research mode automatically enables --include-answer (Tavily AI summary)
• research mode uses search_depth=advanced
• brief format returns titles + URLs only (fast scanning)
• --extract is independent of --mode and --query
• Always present results to the user in 繁體中文; keep original titles/URLs intact
• For whitepapers or long documents, use --extract to get full content, then summarize key points in Traditional Chinese