Tavily Search with Multi-Key

Web search via Tavily API (alternative to Brave). Use when the user asks to search the web / look up sources / find links and Brave web_search is unavailable...

Security Scan

The skill is internally consistent: it performs web searches by POSTing queries to api.tavily.com using a TAVILY_API_KEY (or rotating TAVILY_API_KEYS) and stores a small local index file; nothing in the code contradicts its stated purpose.

Purpose & Capability

The name/description match the included script and instructions (it calls Tavily's search API). Minor metadata mismatch: the registry metadata lists no required env vars, but SKILL.md and the script expect TAVILY_API_KEY or TAVILY_API_KEYS.

Instruction Scope

SKILL.md only instructs running the bundled Python script. The script's actions (reading keys, POSTing to Tavily, returning results) stay within the described search purpose and do not attempt to read unrelated user data.

Install Mechanism

No install spec; this is instruction-only plus an included script. No external downloads or installs are performed by the skill itself.

Credentials

The script requires TAVILY_API_KEY or TAVILY_API_KEYS (reasonable for a third-party search API). It will also read ~/.openclaw/.env (if present) and writes a small state file ~/.openclaw/.tavily-index to rotate keys — this local file access is proportionate but should be noted. The registry did not declare these env/config expectations.

Persistence & Privilege

always is false and the skill only writes its own state file under ~/.openclaw; it does not modify other skills or system-wide settings.

Assessment

This skill appears to do exactly what it says: send queries to a Tavily API using an API key and return results. Before installing, confirm you trust api.tavily.com and are comfortable providing an API key. Note the skill may read keys from ~/.openclaw/.env and will create/write ~/.openclaw/.tavily-index to rotate multiple keys — if you prefer not to store keys in your home directory, supply the key only as an environment variable or review/modify the script. Also verify the Tavily service's terms and limits (and consider using a key with limited scope/quota). The registry metadata not listing the required env vars is a minor but notable inconsistency; review the script yourself if you have security concerns.

Tavily Search

Use the bundled script to search the web with Tavily.

Requirements

• 多 key 轮询（推荐）：export TAVILY_API_KEYS="key1,key2,key3"
• 单 key 模式：
  • 环境变量：TAVILY_API_KEY=xxx
  • 或 ~/.openclaw/.env 文件：TAVILY_API_KEY=xxx

Commands

Run from the OpenClaw workspace:

# raw JSON (default)
python3 {baseDir}/scripts/tavily_search.py --query "..." --max-results 5

# include short answer (if available)
python3 {baseDir}/scripts/tavily_search.py --query "..." --max-results 5 --include-answer

# stable schema (closer to web_search): {query, results:[{title,url,snippet}], answer?}
python3 {baseDir}/scripts/tavily_search.py --query "..." --max-results 5 --format brave

# human-readable Markdown list
python3 {baseDir}/scripts/tavily_search.py --query "..." --max-results 5 --format md

Output

raw (default)

• JSON: query, optional answer, results: [{title,url,content}]

brave

• JSON: query, optional answer, results: [{title,url,snippet}]

md

• A compact Markdown list with title/url/snippet.

Notes

• Keep max-results small by default (3–5) to reduce token/reading load.
• Prefer returning URLs + snippets; fetch full pages only when needed.