用途：为 AI 智能体提供实时联网搜索能力，适合获取实时新闻、核实事实或收集研究资料；在常规搜索引擎返回内容过于冗长时，可用它综合答案、限定域名或控制结果深度。不适合访问内部数据或离线已有资料即可满足的场景。
主要能力：答案综合，可将搜索结果自动汇总为连贯回复；域名过滤，用 include_domains 限定来源（如 wikipedia.org），用 exclude_domains 排除指定站点；深度控制，用 max_results（1-10）控制结果数量，数值越大细节越多；面向 AI 优化，可通过 API 集成，并支持 search、ai 等元数据标签。
使用方式：需先申请 Tavily API key，并设置为环境变量 $TAVILY_API_KEY。REST 端点为 https://api.tavily.com/search。示例 curl： curl -H "Content-Type: application/json" -H "X-Api-Key: $TAVILY_API_KEY" https://api.tavily.com/search -d '{"query": "latest AI news", "max_results": 3}' Python 可参考：import requests；api_key = os.environ.get('TAVILY_API_KEY')；response = requests.post('https://api.tavily.com/search', headers={'X-Api-Key': api_key}, json={'query': 'climate change effects', 'include_domains': ['nytimes.com']})；results = response.json()['results']。常用参数包括 query（必填字符串）、max_results（1-10）、include_domains、exclude_domains。
集成方式：在 OpenClaw 智能体配置中引用技能 ID "tavily-web-search"，例如 tools: ["tavily-web-search"]；YAML 示例： tools:
- id: tavily-web-search config: api_key_env: TAVILY_API_KEY default_params: max_results: 3 调用前应检查密钥是否可用，缺失时提示用户。
限制与错误处理：常见错误有 401（密钥无效）、429（超出速率限制）、400（参数错误）。可先检查状态码再解析；401 时提示设置 $TAVILY_API_KEY，429 时采用指数退避（如等待 5 秒重试），并提前校验 query 非空。依赖外部 Tavily API，费率、配额与价格等资料暂未提供。