Tavily 搜索技能配置¶

问题背景¶

在 OpenClaw 技能开发过程中发现 Brave Search API 存在不稳定性，需要寻找更可靠的搜索解决方案。

关键配置决策¶

决策者：Dad 提醒，bot 执行
时间：2026-03-12 上午

配置发现¶

Dad 指出不要使用 Brave API，Tavily API key 已在配置文件中可用：

~/.openclaw/workspace/skills/tavily/config.json

实施步骤¶

技能复制：将 tavily skill 从主工作区复制到 research workspace
配置验证：确认 API key 和配置文件正确性
功能测试：完成搜索能力测试并确认可用

技能管理经验¶

配置文件位置重要性¶

这次配置过程确认了 OpenClaw 技能管理的关键原则： - 技能可通过 workspace 下的技能目录接入 - 配置文件路径标准化对于技能复用至关重要 - API key 等敏感信息应集中管理

搜索能力优先级¶

确立了搜索类能力的技术选型原则： - 优先复用：复用已有 skill，而不是工作流中硬编码 - 可靠性优先：选择更稳定的 API 提供商 - 配置统一：通过标准配置文件管理 API 访问

技术影响¶

依赖检查策略¶

bot 在检查过程中发现了重要经验： - 需要区分"文档引用"与"真实工具配置" - TOOLS.md 中对 Brave/web_search 的引用多数是历史文档 - 不是所有文档中的技术引用都需要配置更新

后续影响¶

这次 Tavily 配置成功为后续技能开发奠定了基础： 1. 标准化路径：~/.openclaw/workspace/skills/{skill-name}/config.json 2. 复用策略：优先使用已验证的技能 3. 测试流程：配置 → 复制 → 测试 → 确认的标准流程

配置细节¶

技能目录结构¶

~/.openclaw/workspace/skills/
├── tavily/
│   ├── config.json
│   ├── search.js
│   └── README.md
└── other-skills/

使用方式¶

通过标准 OpenClaw 技能调用接口：

node skills/tavily/search.js "search query"

这种标准化的技能接入方式为后续 ClawCraft 技能工坊的可视化管理提供了技术基础。