核心功能
Tavily Search Toolkit 是一套面向 OpenClaw 的 Node.js 命令行工具集，整合 Tavily API 提供四大核心能力：
1. 智能搜索 (`search`)
- 支持多输出格式（
brave格式便于下游解析） - 域名白名单过滤，精准限定可信来源
- 建议
max-results控制在 3-5 条以优化聊天任务效率
2. 内容提取 (`extract`)
- 从指定 URL 获取清洁内容
- 支持 Markdown 等多种内容格式输出
- 适用于搜索结果片段不足时的深度获取
3. 站点爬取 (`crawl`)
- 带深度控制的网站内容爬取
- 可设置爬取深度与数量上限
- 自动生成结构化 Markdown 文档
4. 站点映射 (`map`)
- 发现并映射目标网站的完整 URL 结构
- 支持深度限制与结果数量控制
- 适合网站架构分析与批量链接收集
显著优点
| 维度 | 说明 |
|------|------|
| 专业化搜索 | Tavily 专为 AI 场景优化，结果质量优于通用搜索引擎 |
| 精准过滤 | 支持 `include-domains` 等细粒度域名控制 |
| 灵活输出 | 多格式支持（brave/md/json）适配不同下游场景 |
| 代理友好 | 自动继承系统代理，支持强制指定或禁用 |
| 深度可控 | crawl/map 均支持深度与数量限制，避免无限爬取 |
潜在局限
- API 依赖：需配置
TAVILY_API_KEY，存在服务可用性依赖 - 速率限制：受 Tavily 套餐配额约束，高频场景需关注用量
- 中文支持：搜索中文内容时结果质量可能受限于 Tavily 索引覆盖
- 无实时更新：爬取内容非实时，存在信息时效性 gap
适合人群
- 需要替代 Brave Search 的 OpenClaw 用户
- 有域名过滤需求的研究者与开发者
- 需要结构化网站数据的 AI 应用构建者
- 进行竞品站点分析或文档批量采集的技术团队
常规风险提示
| 风险类型 | 说明 |
|----------|------|
| API 密钥泄露 | `TAVILY_API_KEY` 需妥善保管，避免硬编码提交至版本库 |
| 合规爬取 | 使用 `crawl`/`map` 时需遵守目标网站的 robots.txt 与服务条款 |
| 代理安全 | 通过 `--proxy` 传递的代理服务器需可信，防止中间人攻击 |
| 数据隐私 | extract 功能可能抓取含敏感信息的页面，需评估数据用途合规性 |