Tavily 搜索技能 🔍

用于通过 Tavily API 执行高质量网络搜索的 OpenClaw 技能。

功能

• 智能搜索- 调用 Tavily API 并返回结构化结果
• 实时配额管理- 每次搜索后自动更新配额
• 免费/付费配额区分- 分别显示免费和付费配额
• 付费模式切换- 在免费和付费配额优先级之间切换
• 全面的错误处理- 网络故障、配额不足等

使用方法

先决条件 ⚠️

需要环境变量（用户必须配置）：

export TAVILY_API_KEY="your_api_key"

获取 API 密钥：https://app.tavily.com/api-keys

⚠️ 注意：此技能要求用户提供自己的 Tavily API 密钥。

基础搜索

./search.sh "search query"

指定结果数量

./search.sh "query" 10

包含图片

./search.sh "query" 5 true

检查使用情况

./search.sh --usage

切换付费模式

./search.sh --toggle-paid-mode

检查状态

./search.sh --status

输出格式

结果以 JSON 格式输出：

{
  "query": "keyword",
  "results": [
    {
      "title": "Result Title",
      "url": "link",
      "content": "summary"
    }
  ],
  "quota_info": {
    "plan": "free",
    "total": 1000,
    "used": 15,
    "remaining": 985
  }
}

依赖项

• curl- HTTP 请求
• jq- JSON 处理

安装依赖项

Ubuntu/Debian：

sudo apt-get install curl jq

macOS：

brew install curl jq

限制

• 免费计划：每月 1000 次请求
• 每次搜索最多返回 20 条结果