核心用法
Tavily Search Toolkit 是一个 Node.js CLI 工具，集成 Tavily API 提供四大核心功能：
- search：网页搜索，支持多输出格式（brave、markdown、json）和域名过滤
- extract：从指定 URL 提取干净内容，支持 markdown 格式输出
- crawl：站点爬取，可控制深度和数量限制
- map：站点 URL 发现与结构映射
配置简单，仅需设置 TAVILY_API_KEY 环境变量或写入 ~/.openclaw/.env 文件即可使用。
显著优点
1. 开箱即用：单文件 CLI 设计，无需复杂依赖安装
2. 格式灵活：支持 Brave-like 结构输出，便于下游解析
3. 代理友好：自动继承系统代理，支持强制指定或禁用
4. 免费额度：Tavily 提供免费 API 调用额度，降低使用门槛
5. 中文支持：支持中文搜索词和中文域名过滤
潜在缺点与局限性
- 依赖外部 Tavily 服务，存在 API 可用性风险
- 免费额度有限，高频使用需付费升级
- 爬取深度和结果数受 API 限制
- 无本地缓存机制，重复查询消耗额度
适合人群
- 需要实时联网搜索的 AI 应用开发者
- 构建 RAG 系统的工程师
- 需要快速获取网页内容的自动化工作流用户
- 希望替代传统搜索引擎 API 的轻量级用户
常规风险
- API Key 需妥善保管，避免泄露
- 爬取行为需遵守目标网站的 robots.txt 和使用条款
- 代理配置错误可能导致请求失败或安全隐患
- 依赖第三方服务，存在服务变更或终止风险