联网搜索功能如何配置？

配置OpenClaw的联网搜索功能，你可以选择多种方案。以下是主流配置方法的详细步骤。

联网搜索的重要性

联网搜索是OpenClaw的核心功能之一，它使AI助手能够获取实时信息、最新资讯和网络资料，极大扩展了回答的准确性和时效性。

配置前准备

1. 确认OpenClaw版本：确保使用2026.2.26及以上版本（Linux/MacOS）或2026.3.2及以上版本（Windows）
2. Node.js版本：必须使用Node.js 22或更高版本
3. 网关状态：确保OpenClaw网关正在运行 openclaw gateway status

方案一：Brave Search（官方推荐，国际用户首选）

1. 获取API Key

• 访问Brave Search API官网：https://brave.com/zh/search/api/
• 注册账号并申请API Key（需要国际信用卡，如Visa/Mastercard）
• 每月免费1000次搜索额度，超出后按量计费

2. 配置OpenClaw

1. # 方法A：使用配置命令
2. openclaw config set tools.web.search.provider brave
3. openclaw config set tools.web.search.apiKey "你的Brave_API_Key"
5. # 方法B：编辑配置文件
6. # 打开 ~/.openclaw/openclaw.json，在"tools"部分添加：
7. # "tools": {
8. # "web": {
9. # "search": {
10. # "provider": "brave",
11. # "apiKey": "你的API_Key"
12. # }
13. # }
14. # }

3. 重启服务

1. openclaw gateway restart

方案二：Tavily Search（免费额度，无需信用卡）

1. 获取API Key

• 访问Tavily官网：https://tavily.com
• 注册账号并登录控制台：https://app.tavily.com/home
• 申请API Key，每月有免费调用额度

2. 安装Tavily插件

1. # 安装插件
2. openclaw plugins install openclaw-tavily
4. # 或通过GitHub安装技能
5. openclaw skill install https://github.com/tavily-ai/skills

3. 配置环境变量

1. # 设置环境变量
2. export TAVILY_API_KEY="你的Tavily_API_Key"
4. # 或添加到配置文件
5. # 在 ~/.openclaw/openclaw.json 的"env"部分添加：
6. # "env": {
7. # "TAVILY_API_KEY": "你的API_Key"
8. # }

4. 重启服务

1. openclaw gateway restart

方案三：百度搜索（国内用户，中文内容优化）

1. 获取API Key

• 访问百度智能云：https://console.bce.baidu.com/iam/#/iam/apikey/list
• 登录百度账号，创建API Key
• 开通百度AI搜索服务（BDSE）

2. 安装百度搜索技能

1. # 通过ClawHub安装（推荐）
2. clawhub skill install baidu-search
4. # 或手动安装
5. cd ~/.openclaw/workspace/skills
6. git clone https://github.com/openclaw/skill-baidu-search.git baidu-search

3. 配置API Key

1. # 设置环境变量
2. export BAIDU_API_KEY="你的百度API_Key"
4. # 或编辑配置文件，在"env"部分添加：
5. # "BAIDU_API_KEY": "bce-v3/你的API_Key"

方案四：智谱GLM搜索（完全免费，国内可用）

1. 获取API Key

• 访问智谱AI开放平台：https://open.bigmodel.cn/usercenter/proj-mgmt/apikeys
• 注册账号并创建API Key
• 智谱提供免费API额度，适合个人使用

2. 创建GLM搜索技能

1. # 在OpenClaw的skills目录下创建glm-web-search
2. mkdir -p ~/.openclaw/workspace/skills/glm-web-search
3. cd ~/.openclaw/workspace/skills/glm-web-search
5. # 创建必要的文件结构
6. # _meta.json、SKILL.md、scripts/search.mjs

3. 配置环境变量

1. export ZHIPU_API_KEY="你的智谱API_Key"

通用配置步骤

1. 关闭内置搜索工具（如果使用第三方方案）

1. # 禁用内置的web_search工具
2. openclaw config set tools.web.search.enabled false

2. 配置搜索优先级

在 ~/.openclaw/workspace/Agents.md 中添加：

1. ## 联网搜索优先级
2. 1. **Brave Search**（`web_search` 工具）— 首选，速度快、质量高
3. 2. **Tavily Search**（`search` skill）— Brave 额度用完后切换
4. 3. **Multi-Search-Engine Skill**（`web_fetch` 拼 URL）— 最终兜底，无 API 限制
5. 原则：能用 Brave 就不用 Tavily，能用 Tavily 就不用 multi-search-engine

3. 重启并验证

1. # 重启网关
2. openclaw gateway restart
4. # 查看插件状态
5. openclaw plugins info
7. # 测试搜索功能
8. openclaw gateway test

验证配置成功

1. 直接测试API

1. # 测试Tavily API
2. curl -s https://api.tavily.com/search -H 'content-type: application/json' -d "{\"api_key\":\"$TAVILY_API_KEY\",\"query\":\"OpenAI\"}"
4. # 检查环境变量
5. echo "$TAVILY_API_KEY"

2. 对话测试

在聊天窗口中输入：

• “用web_search查看今日AI热点”
• “帮我搜索Python异步编程教程”
• “查一下最新的科技新闻”

3. 查看日志

1. openclaw logs --tail 50 --verbose

成功时会看到类似 web_search invoked 或 tavily_search completed 的日志。

故障排查

问题1：提示”API Key无效”

• 检查API Key是否复制完整，无多余空格
• 确认服务已开通并生效
• 检查是否达到API调用上限
• 重启OpenClaw服务重试

问题2：触发的是内置web_search而不是第三方搜索

• 明确在对话中指定使用哪个搜索，如”用tavily_search查一下…”
• 禁用内置搜索工具：openclaw config set tools.web.search.enabled false

问题3：搜索结果不准确

• 使用更具体的关键词
• 尝试多次搜索不同表述
• 在prompt中明确要求AI分析和总结

问题4：变量配置不生效

• 检查配置文件路径：~/.openclaw/openclaw.json
• 确认修改后已重启网关
• 使用 openclaw config get 验证当前配置

最佳实践建议

1. 多方案结合：配置多个搜索提供商，设置优先级链
2. 额度管理：监控各平台的用量，避免超额收费
3. 国内用户：优先选择智谱GLM或百度搜索，访问更稳定
4. 安全防护：对于付费服务（如Brave），设置每月额度上限
5. 技能更新：定期更新搜索技能版本 clawhub skill update

按照以上步骤，你可以成功为OpenClaw配置联网搜索功能。根据你的网络环境和需求，选择最适合的搜索方案。配置过程中如遇到问题，可查看OpenClaw日志获取详细错误信息。

© 本文著作权归作者所有。转载请联系授权，禁止商用。

🔗 系列文章

1. openclaw能做什么？