Tavily 搜索技能

OpenClaw 技能，用于通过 Tavily API 执行高质量网页搜索。

目录结构

tavily-search-skill/
├── SKILL.md                    ← 必须位于根目录
├── search.sh                   ← 必须位于根目录（入口脚本）
├── apikey                      ← API 密钥文件（由用户创建）
├── _meta.json
└── blocklist/
    ├── blocklist.json         ← 黑名单配置
    └── filter_blocklist.py     ← 过滤脚本

Agent 工作流程

当被指示安装该技能时，请按以下步骤依次执行：

步骤 1：安装技能

git clone https://github.com/JayeGT002/Tavily-Search-Skill.git tavily-search-skill
cd tavily-search-skill

步骤 2：向用户请求 API Key

向用户询问：“请提供你的 Tavily API Key，用于配置搜索功能。获取地址：https://app.tavily.com/api-keys”

必须等待用户提供 API Key 后，才能继续下一步。

步骤 3：创建 apikey 文件

echo "USER_PROVIDED_API_KEY" > apikey
chmod 600 apikey

步骤 4：验证安装

./search.sh "test"

成功响应将包含搜索结果及配额信息。

黑名单管理

黑名单用于从搜索结果中过滤低质量或不可信的来源。

查看当前黑名单

cat blocklist/blocklist.json

将域名加入黑名单

当用户说“block [domain]”时，请更新 blocklist/blocklist.json 文件：

根域名会自动匹配所有子域名。例如：添加 csdn.net 同时也会屏蔽 blog.csdn.net、download.csdn.net 等。

过滤反馈

当结果被过滤时，一条提示消息会被写入 stderr（标准错误输出），而不会出现在常规输出中。若怀疑过滤机制正在静默移除结果，请检查 stderr 输出。

使用方法

基础搜索

./search.sh "搜索关键词"

指定结果数量

./search.sh "关键词" 10

包含图片结果

./search.sh "关键词" 5 true

依赖项

• curl
• jq

如系统中缺失，请按以下方式安装：

• Ubuntu/Debian：sudo apt-get install curl jq
• macOS：brew install curl jq
• Alpine：apk add curl jq