OpenClaw 电脑联网配置笔记（Tavily 插件版）

1. 目标

让 OpenClaw 在云电脑可联网搜索，使用 Tavily 插件（openclaw-tavily）。

2. 官网与官方地址

• Tavily 官网: https://tavily.com
• Tavily 控制台（申请/管理 API Key）: https://app.tavily.com
• Tavily API 文档: https://docs.tavily.com
• openclaw-tavily（npm）: https://www.npmjs.com/package/openclaw-tavily
• openclaw-tavily（GitHub）: https://github.com/framix-team/openclaw-tavily

3. 最短安装步骤（云电脑终端执行）

1. 安装插件

openclaw plugins install openclaw-tavily

2. 设置环境变量（注意大小写）

export TAVILY_API_KEY="tvly-dev-你的完整key"

3. 重启网关

openclaw gateway restart

4. 查看插件状态

openclaw plugins info openclaw-tavily

4. 联网验证（最关键）

1. 检查变量是否存在

echo "$TAVILY_API_KEY"

2. 直接请求 Tavily API（成功会返回 JSON 结果）

curl -s https://api.tavily.com/search -H 'content-type: application/json' -d "{\"api_key\":\"$TAVILY_API_KEY\",\"query\":\"OpenAI\"}"

5. 常见报错与处理

1. Unauthorized: missing or invalid API key

• 常见原因: key 写错（尤其大小写），或 key 已失效。
• 处理: 去 Tavily 控制台重新生成 key，再 export 并重启 gateway。

2. 明明装了 Tavily，仍提示缺 Brave key

• 原因: 触发的是内置 web_search（Brave），不是 tavily_search。
• 处理: 在对话里明确要求调用 tavily_search。

3. 变量写法错误

• 错误示例: 把 "TAVILY_API_KEY" 当字面量传入 JSON。
• 正确示例: 使用 "$TAVILY_API_KEY" 让 shell 展开变量值。

6. 持久化（避免重启丢失）

如果是手动启动 shell，会话可写入 ~/.zshrc：

echo 'export TAVILY_API_KEY="tvly-dev-你的完整key"' >> ~/.zshrc
source ~/.zshrc

如果使用 systemd/docker 管理 openclaw gateway，把变量写入对应服务配置并重启服务。