核心用法
Tavily Search Skill 是一个面向 OpenClaw 平台设计的专业搜索技能，通过调用 Tavily API 实现高质量网络信息检索。该技能采用 Shell 脚本封装，支持结构化 JSON 输出与实时配额监控。
基础调用方式：
./search.sh "搜索关键词"—— 基础搜索（默认 5 条结果）./search.sh "query" 10—— 指定返回数量（上限 20）./search.sh "query" 5 true—— 包含图片结果./search.sh --usage—— 查看用量统计./search.sh --toggle-paid-mode—— 切换付费/免费配额优先级./search.sh --status—— 查看服务状态
关键依赖： 用户必须自行配置 TAVILY_API_KEY 环境变量，技能本身不提供默认密钥。
显著优点
1. 结构化输出质量高：Tavily API 专为 AI 应用优化，返回结果包含标题、URL、摘要等完整字段，无需额外清洗
2. 实时配额透明化：每次搜索后自动更新并显示剩余配额，避免服务中断
3. 双模式配额管理：清晰区分免费额度（1000 次/月）与付费额度，支持手动切换优先级
4. 轻量无侵入：仅依赖 curl 与 jq，无复杂运行时环境要求
5. 错误处理完善：覆盖网络超时、配额耗尽、API 限流等常见异常场景
潜在缺点与局限性
- 强制性外部依赖：用户需自行注册 Tavily 账号并获取 API Key，使用门槛较高
- 免费额度有限：1000 次/月的免费配额对于高频场景（如自动化工作流）可能不足
- 结果数量硬上限：单次最多返回 20 条结果，深度检索需多次调用
- 无内置缓存机制：重复查询会消耗配额，未做本地结果缓存优化
- 平台绑定风险：Tavily 服务稳定性直接影响技能可用性，存在第三方依赖风险
适合人群
- 需要为 AI Agent 或自动化工作流集成高质量搜索能力的开发者
- 对搜索结果结构化程度有要求的技术用户
- 已有 Tavily 账号或愿意注册获取 API Key 的个人/团队
- 轻中度搜索需求场景（月均 <1000 次查询）
常规风险
- 密钥泄露风险：API Key 以环境变量形式管理，多用户环境下需确保隔离
- 配额误耗风险：
--toggle-paid-mode操作不可逆地切换扣费优先级，误操作可能导致意外扣费 - 服务可用性风险：Tavily API 服务中断或策略变更将直接导致技能失效
- 成本控制风险：超出免费额度后按付费计划计费，高频使用需监控用量