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:

bash

# 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)#

bash

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

News Mode — recent articles, time-filtered#

bash

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#

bash

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)#

bash

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#

OptionValuesDefaultNotes--mode``general, news, research``generalSets search strategy--querystring—Search query--preset``crypto, finance, spiritualnoneDomain whitelist preset--daysinteger7 (news), — (others)Filter results to last N days--max-results1–105 (general/news), 8 (research)Number of results--lang``zh-TW, en, both``bothLanguage preference hint--format``md, json, brief``mdOutput format--extractURL(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