Openclaw Tavily Search.Bak

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's code and runtime instructions match its stated purpose (a simple wrapper for the Tavily search API) and request only the Tavily API key they need.

Purpose & Capability

Name/description declare a web search integration with Tavily; the included script posts queries to https://api.tavily.com/search and returns titles/URLs/snippets. Required inputs (TAVILY_API_KEY via env or ~/.openclaw/.env) align with that purpose.

Instruction Scope

SKILL.md instructs running the bundled Python script and documents the API key locations it reads. The script only reads the API key (env or ~/.openclaw/.env), sends a POST to the Tavily API, and formats the response; it does not attempt to read unrelated files or exfiltrate other environment variables.

Install Mechanism

No install spec; this is an instruction-only skill with a small, readable Python script that uses standard library modules (urllib). Nothing is downloaded or extracted during install.

Credentials

Only one secret is required (TAVILY_API_KEY), which is appropriate for a third-party search API integration. The script only accesses that key and no other credentials or config paths.

Persistence & Privilege

The skill is not always-enabled and does not request elevated persistence or modify other skills or system-wide settings. Autonomous invocation is allowed by default but not excessive here.

Assessment

This skill is coherent: it simply forwards your query and the provided TAVILY_API_KEY to Tavily's API and returns results. Before installing, confirm you trust the Tavily service and are comfortable sending queries and the API key to https://api.tavily.com. Verify the API key is stored only where you intend (environment variable or ~/.openclaw/.env). Note small inconsistencies in metadata (the _meta.json slug/owner/publishedAt look odd) — that does not change the code behavior but you may want to confirm the skill's source/author if provenance matters.

Tavily Search

Use the bundled script to search the web with Tavily.

Requirements

• Provide API key via either:
  • environment variable: TAVILY_API_KEY, or
  • ~/.openclaw/.env line: TAVILY_API_KEY=...

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.