核心用法
Tavily Search Skill 是一个基于 Shell 脚本的 OpenClaw 技能，用于调用 Tavily AI 搜索引擎 API。用户需自行配置 TAVILY_API_KEY 环境变量，通过 ./search.sh 执行搜索，支持自定义结果数量、图片返回、额度查询及付费模式切换。
主要命令：
- 基础搜索：
./search.sh "关键词" - 指定数量：
./search.sh "关键词" 10 - 包含图片：
./search.sh "关键词" 5 true - 额度管理：
--usage、--toggle-paid-mode、--status
显著优点
1. 结构化输出：返回标准 JSON，包含标题、链接、摘要及配额信息，便于程序解析
2. 额度透明化：实时显示免费/付费额度使用情况，避免超额风险
3. 灵活付费控制：支持手动切换付费模式，适应不同成本场景
4. 零依赖封装：仅需系统自带的 curl 和 jq，无需额外运行时
潜在局限
- 硬性依赖外部 API：服务可用性完全依赖 Tavily 平台稳定性
- 无本地缓存机制：重复搜索会消耗配额，无智能去重或缓存层
- Shell 环境限制：Windows 用户需额外配置 WSL 或 Git Bash
- 功能边界清晰：仅支持搜索，无网页内容抓取、深度分析等扩展能力
适合人群
- 需要为 AI Agent 集成实时网络搜索能力的开发者
- 对 API 成本敏感、需要精细化额度控制的小团队
- 偏好轻量级 Shell 工具而非 Python/Node 重依赖的技术用户
常规风险
- 密钥泄露风险：API Key 以环境变量形式存储，多用户服务器可能存在暴露隐患
- 额度突耗尽：免费版月限 1000 次，高频自动化任务易触发上限
- 网络单点故障：无重试机制，Tavily 服务中断时搜索功能完全失效
- 数据隐私：搜索查询需发送至第三方服务器，敏感信息存在外泄可能