Skip to main content

配置网页搜索能力

为什么要配置网页搜索能力​

OpenClaw的本地模型虽然强大，但它们的知识是静态的，只包含训练时的数据。这意味着：

  • ❌ 无法回答最新的新闻和事件
  • ❌ 不知道今天天气如何
  • ❌ 无法查询信息
  • ❌ 不能获取最新的技术文档

通过配置网页搜索能力，OpenClaw可以：

  • ✅ 实时搜索互联网信息
  • ✅ 获取最新的新闻和资讯
  • ✅ 查询实时数据（天气、股票等）
  • ✅ 访问最新的技术文档和教程
  • ✅ 进行深度研究和事实核查

这节我们将来配置一下OpenClaw的网页搜索能力。OpenClaw支持多种搜索引擎，默认的web_search使用的是BraveAPI。但是截至本教程发布时期，BraveAPI取消了免费方案，所以这里我们使用Tavily Web Search替代

Tavily Web Search 是一个专为AI智能体优化的搜索引擎，提供结构化的搜索结果。

准备工作​

在开始之前，请确保：

  1. ✅ OpenClaw已经安装并正常运行
  2. ✅ 已经配置好至少一个模型（Ollama或云端模型）
  3. ✅ 有网络连接
  4. ✅ 有一个可用的邮箱（用于注册Tavily）

第一步：获取Tavily API密钥​

Tavily是一个提供免费额度的AI优化搜索引擎，每月免费1000次搜索，足够日常使用。（政策可能变化，具体额度以实际为准）

1.1 访问Tavily官网​

在浏览器中打开：https://tavily.com

访问Tavily官网

1.2 注册账号​

点击页面上的"Sign Up"或"注册"按钮：

image-20260310205926352

填写注册信息：

  • 邮箱地址 ：填写您的真实邮箱
  • Code ：图形验证码

点击"Continue"创建账号。

1.3 验证邮箱​

Tavily会发送一封验证邮件到您的邮箱。打开邮箱，找到来自Tavily的邮件，点击验证链接。验证成功后，会自动跳转到Tavily控制台。

1.4 获取API密钥​

登录后，进入API Keys页面：

image-20260310210402296

您会看到一个API密钥，格式类似：

tvly-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

⚠️ 重要提示 ：

  • 请妥善保管这个密钥，不要泄露给他人
  • 不要将密钥提交到代码仓库或公开平台

复制这个API密钥，我们稍后会用到。

image-20260310210643258

第二步：安装Tavily Web Search技能​

OpenClaw使用ClawHub来管理技能，我们可以直接通过和OpenClaw对话的方式来安装这个插件

2.1 打开终端​

在Jetson设备上打开终端。（JetosnNano需要进入到docker中），确保有终端开启了openclaw gateway

2.2 安装技能​

在安装技能之前，我们需要先登录一下ClawHub，这是一个开源的OpenClaw的技能的发布中心，您可以理解为手机上的【应用市场】

如果不登录，那么在下载的时候可能会遇到限速的情况

我们打开终端 ，输入

xxxxxxxxxx npm i -g clawhub

然后打开 ClawHub 官网 https://clawhub.ai/ ，点击以使用 Github 登录（需要先登录 Github ，这里不做演示，为了避免您的网络无法登录Github的情况，我们出厂镜像里面已经提前下好了这个Skill，您可以直接看 第三步：配置API密钥）

image-20260310215246202

跳转到授权页面，点击授权

image-20260310215313331

点击自己的用户名，点击设置

image-20260310215334012

下拉到 API tokens ，点击 Create token

image-20260310215430372

复制生成出的 Token ，下面要用

image-20260310215453992

接下来在服务器运行以下命令，将你刚刚复制的Token替换，注意 -- token 后面是有空格的

xxxxxxxxxx clawhub login --token 你的Token

可以看到登录成功了

image-20260310215817395

接下来，我们要安装tavily-web-search这个Skill，安装方法有很多，这里我们用比较通用的一种方式，在终端输入

xxxxxxxxxx npx clawhub@latest install tavily-search

如果出现了✖ Rate limit exceeded，说明您上一步登录步骤有误，请重新登录一下

2.3 验证安装​

查看已安装的技能列表：

xxxxxxxxxx npx clawhub@latest list

image-20260311100958972

您应该能在列表中看到tavily-web-search。

第三步：配置API密钥​

现在我们需要将Tavily API密钥配置到OpenClaw中。

3.1 方法一：临时的通过环境变量配置​

在终端中设置环境变量：

xxxxxxxxxx export TAVILY_API_KEY = tvly-your-api-key-here

注意 ：将tvly-your-api-key-here替换为您在第一步获取的真实API密钥。

3.2 方法二：使环境变量永久生效​

如果您希望每次启动终端时自动设置API密钥，可以将其添加到Shell配置文件中。

对于使用Bash的用户：​

xxxxxxxxxx echo 'export TAVILY_API_KEY=tvly-your-api-key-here' >> ~/.bashrc source ~/.bashrc

3.3 重启生效​

重启OpenClaw Gateway使配置生效 ：

xxxxxxxxxx openclaw gateway restart

第四步：测试网页搜索功能​

现在让我们测试一下网页搜索是否正常工作。

4.1 使用TUI测试​

在终端中启动TUI：

xxxxxxxxxx openclaw tui

image-20260311170619242

4.2 测试基础搜索​

在TUI中输入一个需要最新信息的问题，比如：

xxxxxxxxxx 帮我看看今天有什么重要新闻？

image-20260311170722651

OpenClaw会：

  1. 识别需要搜索最新信息
  2. 调用Tavily API进行搜索
  3. 获取搜索结果
  4. 基于搜索结果回答您的问题

高级使用技巧​

技巧1：限定搜索来源​

如果您只想搜索特定网站的内容：

xxxxxxxxxx 只在知乎上搜索：如何学习Python 只在MDN文档中搜索：CSS Flexbox用法

image-20260311171033053

技巧2：获取原始内容​

如果您需要获取网页的完整内容：

xxxxxxxxxx 提取这个页面的完整内容并总结：[https://www.yahboom.com/study/K230]

image-20260311171351907

常见问题​

问题1：搜索提示API密钥无效​

错误信息：

xxxxxxxxxx Error: Invalid API key

可能原因：

  1. API密钥输入错误
  2. 环境变量未正确设置
  3. API密钥已过期

解决方案：

  1. 检查API密钥是否正确复制：

xxxxxxxxxx echo $TAVILY_API_KEY 2. 重新设置环境变量：

xxxxxxxxxx export TAVILY_API_KEY = tvly-your-api-key-here 3. 如果密钥已过期，登录Tavily官网重新获取

问题2：搜索没有结果​

症状： 发送搜索请求后，AI回复"无法找到相关信息"

可能原因：

  1. 网络连接问题
  2. Tavily服务暂时不可用
  3. 搜索关键词太模糊

解决方案：

  1. 检查网络连接：

xxxxxxxxxx ping tavily.com 2. 尝试更具体的搜索关键词 3. 稍后再试

问题3：搜索速度很慢​

症状： 搜索请求需要很长时间才返回结果

可能原因：

  1. 使用了深度搜索模式
  2. 网络延迟较高
  3. Tavily服务器负载高

解决方案：

  1. 使用快速搜索模式：

xxxxxxxxxx 快速搜索：[您的问题] 2. 检查网络速度：

xxxxxxxxxx curl -o /dev/null -s -w "%{time_total}\n" https://tavily.com 3. 如果持续慢，可以尝试更换网络环境

问题4：额度用完了​

错误信息：

xxxxxxxxxx Error: API quota exceeded

可能原因： 免费额度（每月1000次）已用完

解决方案：

  1. 登录Tavily控制台查看使用情况
  2. 等待下个月额度重置

问题5：技能安装失败​

错误信息：

xxxxxxxxxx Error: Failed to install skill

可能原因：

  1. 网络连接问题
  2. npm版本过旧
  3. 权限不足（没有登录导致被限速）

解决方案：

  1. 检查网络连接
  2. 更新npm：

xxxxxxxxxx npm install -g npm @latest 3. 使用sudo权限安装（如果需要）：

xxxxxxxxxx sudo npx clawhub@latest install tavily-web-search

问题6：提示找不到key​

症状：

image-20260326171351117

解决方案： 主动告诉OpenClawTUI自己的API密钥

在OpenClawTUI里面说：“This is my tavily key: tvlxxxxxxxxxxxxxxxxxx”

image-20260326171351128

搜索模式对比​

模式速度覆盖范围适用场景示例
基础模式1-2秒良好快速查询事实、简单搜索"今天天气如何？"
高级模式5-10秒出色复杂研究、全面回答"对比两种技术的优缺点"
新闻模式2-3秒最近7天时事热点、突发新闻"最近有什么科技新闻？"

最佳实践​

1. 合理使用搜索额度​

  • ✅ 优先使用快速搜索模式
  • ✅ 避免重复搜索相同内容
  • ✅ 利用AI的记忆能力，避免重复查询
  • ❌ 不要频繁测试搜索功能

2. 优化搜索关键词​

  • ✅ 使用具体、明确的问题
  • ✅ 包含关键信息（时间、地点、对象）
  • ✅ 使用自然语言描述需求
  • ❌ 避免过于模糊的查询

3. 验证搜索结果​

  • ✅ 对重要信息进行交叉验证
  • ✅ 检查搜索结果的来源可靠性
  • ✅ 注意信息的时效性
  • ❌ 不要完全依赖单一来源

4. 结合本地知识​

  • ✅ 对于静态知识，优先使用本地模型
  • ✅ 对于动态信息，使用网页搜索
  • ✅ 结合两者获得最佳答案
  • ❌ 不要所有问题都使用搜索

进阶配置​

配置1：调整搜索深度​

在OpenClaw配置文件中，可以调整搜索的默认深度：

xxxxxxxxxx { "skills" : { "entries" : { "tavily-web-search" : { "enabled" : true , "apiKey" : "tvly-your-api-key-here" , "config" : { "searchDepth" : "basic" , "maxResults" : 10 , "includeAnswer" : true , "includeRawContent" : false } } } } }

配置说明：

  • searchDepth: basic（基础）或 advanced（高级）
  • maxResults: 返回的最大结果数（1-10）
  • includeAnswer: 是否包含AI生成的答案摘要
  • includeRawContent: 是否包含原始页面内容

配置2：设置域名过滤​

如果您只想搜索特定网站的内容：

xxxxxxxxxx { "skills" : { "entries" : { "tavily-web-search" : { "enabled" : true , "apiKey" : "tvly-your-api-key-here" , "config" : { "includeDomains" : [ "github.com" , "stackoverflow.com" ], "excludeDomains" : [ "ads.example.com" ] } } } } }

配置3：配置新闻模式​

设置默认使用新闻模式：

xxxxxxxxxx { "skills" : { "entries" : { "tavily-web-search" : { "enabled" : true , "apiKey" : "tvly-your-api-key-here" , "config" : { "searchDepth" : "basic" , "topic" : "news" , "days" : 7 } } } } }

配置说明：

  • topic: general（通用）或 news（新闻）
  • days: 新闻搜索的天数范围（1-30）

实用场景示例​

场景1：学习新技术​

xxxxxxxxxx 搜索最新的React教程，适合初学者的

OpenClaw：

  • 搜索最新的React入门教程
  • 从多个来源筛选适合初学者的内容
  • 提供教程链接和简要说明
  • 给出学习建议

场景2：购物决策​

xxxxxxxxxx 搜索iPhone 15和iPhone 15 Pro的详细对比，包括价格和性能

OpenClaw：

  • 搜索最新的产品对比信息
  • 汇总价格、性能、功能差异
  • 提供购买建议
  • 给出官方购买链接

场景3：旅行规划​

xxxxxxxxxx 搜索北京到上海的交通方式对比，包括时间、价格和舒适度

OpenClaw：

  • 搜索最新的交通信息
  • 对比飞机、高铁、汽车等方式
  • 提供价格和时间参考
  • 给出推荐方案

场景4：健康咨询​

xxxxxxxxxx 搜索关于缓解失眠的自然方法，基于权威医学网站

OpenClaw：

  • 搜索权威医学网站的信息
  • 提供科学验证的方法
  • 给出注意事项
  • 建议咨询专业医生

场景5：编程问题​

您：

xxxxxxxxxx 搜索Python中如何实现异步编程，包含代码示例

OpenClaw：

  • 搜索最新的编程教程
  • 提供详细的代码示例
  • 解释关键概念
  • 给出最佳实践建议

安全与隐私​

数据隐私​

Tavily的隐私政策：

  • ✅ 零数据留存：搜索数据不会被永久存储
  • ✅ SOC 2认证：符合国际安全标准
  • ✅ 提示注入防护：防止恶意查询
  • ✅ 不记录个人身份信息

安全建议​

  1. 保护API密钥

    • 不要在公开代码中包含密钥
    • 定期更换密钥
    • 使用环境变量或密钥管理器

  2. 验证搜索结果

    • 检查信息来源的可靠性
    • 对重要信息进行交叉验证
    • 注意信息的时效性

  3. 合理使用

    • 遵守Tavily的使用条款
    • 不要滥用搜索功能
    • 尊重网站的内容政策

最后​

恭喜！您已经成功配置了网页搜索能力，OpenClaw现在可以访问实时互联网信息了！

接下来您可以：

  • 📖 继续学习其他技能配置
  • 🎮 探索更多实用场景
  • 🔧 深入学习OpenClaw的高级功能
  • 💡 发挥创意，创造更多应用

提示 ：如果遇到问题，可以随时运行 openclaw doctor 进行诊断，或者访问 Tavily官方文档 获取更多帮助。