OpenClaw的核心能力之一是联网检索,但默认内置的web_search功能依赖Brave Search API,若未配置BRAVE_API_KEY,会直接出现搜索失败、鉴权报错或无结果的问题。2026年,Tavily作为面向LLM/Agent的专用搜索API,凭借结构化结果输出、低接入成本的优势,成为替代Brave的最优选择——通过自定义Skill即可将其接入OpenClaw工具链,实现“搜索→筛选→抓取→总结”的完整工作流。
本文将详细拆解2026年OpenClaw的阿里云部署与汉化版本地部署全流程,同步分享Tavily API Key获取、自定义搜索Skill开发、定向检索配置等实操步骤,所有代码命令可直接复制执行,助力用户快速解决OpenClaw联网检索难题。阿里云上OpenClaw极速一键部署最简单,步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。
一、核心认知:OpenClaw部署逻辑与Tavily搜索核心优势
(一)部署方案核心差异
| 部署方式 | 核心优势 | 搜索功能适配重点 | 适用场景 |
|---|---|---|---|
| 阿里云部署 | 7×24小时稳定运行、多设备远程访问、算力弹性扩展 | 云端环境变量配置、多模型协同检索、批量任务自动化 | 长期联网检索任务、团队协作场景 |
| 汉化本地部署 | 中文界面适配、数据隐私可控、操作便捷 | 本地Skill开发调试、中文关键词检索优化、敏感数据本地化处理 | 个人日常检索、自定义技能快速迭代 |
(二)Tavily替代Brave的核心原因
- 开箱即用:无需复杂配置,获取API Key后即可接入,无默认兜底缺失问题;
- 结构化输出:返回结果包含标题、URL、摘要等标准化字段,便于模型后续推理总结;
- Skill适配性强:基于HTTP API设计,与OpenClaw Skill(可执行操作手册)完美匹配;
- 灵活可控:支持自定义搜索深度、结果条数、输出格式,可固化检索流程与引用规范。
(三)检索工作流优化
推荐采用“Tavily检索→筛选可信来源→OpenClaw抓取要点→模型总结”的工程化流程,能显著降低噪声干扰,提升检索结果的准确性与可用性。
二、2026年阿里云部署OpenClaw流程(适配云端检索)
(一)部署前准备
- 阿里云账号:注册阿里云账号,完成实名认证,确保账号无欠费,优先选择中国香港/美国弗吉尼亚等免备案地域;
- 服务器配置:推荐轻量应用服务器,基础配置2vCPU+4GiB内存+40GiB ESSD云盘,系统选择Ubuntu 22.04 LTS;
- 核心凭证:阿里云百炼API-Key访问订阅阿里云百炼Coding Plan(获取路径:访问登录阿里云百炼大模型服务平台→密钥管理→创建API-Key)、Tavily API-Key(免费申请地址:https://tavily.com);
- 工具准备:SSH工具(FinalShell/Xshell)、Chrome/Edge浏览器,记录服务器公网IP。
新手零基础阿里云上部署OpenClaw喂饭级步骤流程
第一步:访问阿里云OpenClaw一键部署专题页面,找到并点击【一键购买并部署】。
阿里云OpenClaw一键部署专题页面:https://www.aliyun.com/activity/ecs/clawdbot


第二步:选购阿里云轻量应用服务器,配置参考如下:
- 镜像:OpenClaw(Moltbot)镜像(已经购买服务器的用户可以重置系统重新选择镜像)
- 实例:内存必须2GiB及以上。
- 地域:默认美国(弗吉尼亚),目前中国内地域(除香港)的轻量应用服务器,联网搜索功能受限。
- 时长:根据自己的需求及预算选择。



第三步:访问阿里云百炼大模型控制台,找到密钥管理,单击创建API-Key。
前往轻量应用服务器控制台,找到安装好OpenClaw的实例,进入「应用详情」放行18789端口、配置百炼API-Key、执行命令,生成访问OpenClaw的Token。
- 端口放通:需要放通对应端口的防火墙,单击一键放通即可。
- 配置百炼API-Key,单击一键配置,输入百炼的API-Key。单击执行命令,写入API-Key。
- 配置OpenClaw:单击执行命令,生成访问OpenClaw的Token。
- 访问控制页面:单击打开网站页面可进入OpenClaw对话页面。
(二)分步部署流程
步骤1:服务器环境初始化
# 1. 远程连接阿里云服务器(替换为实际公网IP)
ssh root@你的服务器公网IP
# 2. 更新系统依赖并安装核心工具
sudo apt update -y && sudo apt upgrade -y
sudo apt install -y git curl docker.io jq
systemctl start docker
systemctl enable docker
# 3. 放行核心端口(22-SSH、18789-OpenClaw)
sudo ufw enable
sudo ufw allow 22/tcp
sudo ufw allow 18789/tcp
sudo ufw reload
# 4. 验证依赖安装成功
docker --version
jq --version
步骤2:拉取OpenClaw镜像并启动容器
# 1. 拉取2026年OpenClaw官方最新镜像
docker pull openclaw/openclaw:2026-latest
# 2. 创建数据持久化目录(含Skill存储目录)
mkdir -p /opt/openclaw/{
config,logs,data,skills}
sudo chmod 755 /opt/openclaw/*
# 3. 启动OpenClaw容器,配置环境变量(预存Tavily API Key)
docker run -d \
--name openclaw \
--restart always \
-p 18789:18789 \
-v /opt/openclaw/config:/app/config \
-v /opt/openclaw/logs:/app/logs \
-v /opt/openclaw/data:/app/data \
-v /opt/openclaw/skills:/app/workspace/skills \
-e TZ=Asia/Shanghai \
-e TAVILY_API_KEY="你的Tavily API Key" \
openclaw/openclaw:2026-latest
# 4. 验证容器启动状态
docker ps | grep openclaw
步骤3:配置阿里云百炼模型并生成访问Token
# 1. 进入OpenClaw容器内部
docker exec -it openclaw bash
# 2. 配置大模型为阿里云百炼
openclaw config set model.provider aliyun_bailian
openclaw config set model.aliyun_bailian.api_key "你的百炼API-Key"
# 3. 生成管理员访问Token(保存用于后续登录)
openclaw token generate --admin
# 4. 重启服务使配置生效
openclaw restart
# 5. 退出容器
exit
步骤4:云端访问验证
浏览器输入http://服务器公网IP:18789/?token=你的管理员Token,成功进入OpenClaw Web控制台即部署完成。
三、2026年汉化版本地部署OpenClaw流程(适配中文检索)
(一)部署前准备
- 硬件要求:CPU≥Intel i5/Ryzen 5,内存≥8GB,磁盘预留≥20GB SSD;
- 软件要求:Node.js ≥22.0.0、pnpm、Git、jq,Windows系统需以管理员身份运行PowerShell;
- 核心资源:OpenClaw汉化版Gitee仓库、Tavily API-Key;
- 网络要求:需联网下载依赖,无需特殊配置。
(二)分步部署流程
步骤1:基础依赖安装与环境变量配置
# Windows(管理员PowerShell执行)
npm install -g pnpm git
pnpm config set registry https://registry.npmmirror.com/
# 安装jq工具(用于JSON格式化)
choco install jq # 需提前安装Chocolatey包管理器
# 配置Tavily API Key环境变量
[Environment]::SetEnvironmentVariable("TAVILY_API_KEY", "你的Tavily API Key", "User")
# macOS(终端执行)
brew install node@22 git jq
npm install -g pnpm
pnpm config set registry https://registry.npmmirror.com/
# 配置环境变量
echo 'export TAVILY_API_KEY="你的Tavily API Key"' >> ~/.zshrc
source ~/.zshrc
# Linux(Ubuntu/Debian)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs git jq
npm install -g pnpm
pnpm config set registry https://registry.npmmirror.com/
# 配置环境变量
echo 'export TAVILY_API_KEY="你的Tavily API Key"' >> ~/.bashrc
source ~/.bashrc
# 验证依赖版本(Node.js需≥22.0.0)
node --version
pnpm --version
jq --version
步骤2:下载汉化版OpenClaw并构建
# 1. 克隆国内Gitee汉化版仓库
git clone https://gitee.com/openclaw-cn/openclaw-cn.git
cd openclaw-cn
# 2. 切换到2026稳定汉化分支
git checkout chinese-version-2026.2
# 3. 安装项目依赖
pnpm install
# 4. 构建汉化版前端与核心服务
pnpm ui:build:cn
pnpm build
# 5. 启动中文初始化配置向导
pnpm openclaw onboard:cn
步骤3:启动汉化版服务并生成Token
# 1. 创建Skill存储目录
mkdir -p ~/openclaw-cn/workspace/skills
# 2. 启动OpenClaw网关服务,指定中文语言
node openclaw.mjs gateway --port 18789 --verbose --lang zh-CN
# 3. 新开终端,生成本地管理员Token
openclaw token generate --admin --allow-ip 127.0.0.1
步骤4:本地访问验证
浏览器输入http://127.0.0.1:18789,粘贴Token登录中文管理界面,即完成本地部署。
四、Tavily搜索Skill开发与配置(全部署方案适配)
(一)创建Tavily搜索Skill目录与核心文件
# 1. 创建Skill专属目录(阿里云部署需先进入容器:docker exec -it openclaw bash)
# 阿里云部署
mkdir -p /app/workspace/skills/tavily-search
cd /app/workspace/skills/tavily-search
# 本地部署
mkdir -p ~/openclaw-cn/workspace/skills/tavily-search
cd ~/openclaw-cn/workspace/skills/tavily-search
# 2. 创建Skill配置文件SKILL.md
cat > SKILL.md << 'EOF'
# Tavily搜索技能(替代Brave Search)
## 功能描述
通过Tavily Search API实现网页检索,返回结构化结果,支持定向检索与结果筛选,为模型提供可信信息来源。
## 约束规则
1. 仅执行搜索操作,不直接抓取网页全文,避免 payload 过载;
2. 输出固定结构:查询词、Top N结果列表(标题、URL、摘要)、下一步抓取建议;
3. 强制引用:最终回答必须包含结果URL,确保信息可追溯;
4. 结果可信度优先级:官方文档 > 标准组织 > 主流媒体/厂商博客 > 论坛/转载内容。
## 配置参数
- 搜索深度:advanced(可切换为basic降低成本)
- 最大结果数:5(建议3~8条)
- 是否包含原始内容:false
- 是否直接返回答案:false
## 调用命令(curl)
```bash
curl -sS https://api.tavily.com/search \
-H 'Content-Type: application/json' \
-d "$(jq -n \
--arg key "$TAVILY_API_KEY" \
--arg q "查询词" \
'{
api_key: $key,
query: $q,
search_depth: "advanced",
max_results: 5,
include_answer: false,
include_raw_content: false
}')"
EOF
3. 创建搜索执行脚本search.sh(Linux/macOS)
cat > search.sh << 'EOF'
!/bin/bash
接收查询词参数
QUERY="$1"
可选参数:结果条数(默认5)
MAX_RESULTS="${2:-5}"
调用Tavily API
curl -sS https://api.tavily.com/search \
-H 'Content-Type: application/json' \
-d "$(jq -n \
--arg key "$TAVILY_API_KEY" \
--arg q "$QUERY" \
--argjson max "$MAX_RESULTS" \
'{
api_key: $key,
query: $q,
search_depth: "advanced",
max_results: $max,
include_answer: false,
include_raw_content: false
}')" | jq '.results[] | {title: .title, url: .url, summary: .snippet}'
EOF
4. 赋予脚本执行权限
chmod +x search.sh
### (二)验证Tavily搜索功能
```bash
# 1. 执行基础搜索(示例:搜索OpenClaw 2026最新教程)
# 阿里云部署(容器内)
/app/workspace/skills/tavily-search/search.sh "OpenClaw 2026 最新教程" 5
# 本地部署
~/openclaw-cn/workspace/skills/tavily-search/search.sh "OpenClaw 2026 最新教程" 5
# 2. 执行定向检索(示例:仅检索知乎上的OpenClaw相关内容)
# 阿里云部署(容器内)
/app/workspace/skills/tavily-search/search.sh "site:zhihu.com OpenClaw" 5
# 本地部署
~/openclaw-cn/workspace/skills/tavily-search/search.sh "site:zhihu.com OpenClaw" 5
(三)配置OpenClaw默认使用Tavily搜索
# 1. 进入OpenClaw TUI界面(全部署方案通用)
openclaw tui
# 2. 在TUI界面输入以下指令,设置Tavily为默认搜索工具
设置默认搜索工具为tavily-search技能,当需要联网检索时,自动调用该技能,输出结构化结果后,推荐2~3条最可信来源供进一步抓取。
# 3. 测试OpenClaw对话式搜索
在TUI界面输入:用默认搜索工具检索"2026年国产大模型发展趋势",返回5条结果并推荐最值得抓取的2个链接。
五、Brave与Tavily选型对比及安全建议
(一)选型决策表
| 对比维度 | Brave Search | Tavily Search |
|---|---|---|
| 接入成本 | 高(需申请API Key) | 低(获取Key后直接接入) |
| 结果格式 | 非结构化,需二次处理 | 结构化(标题/URL/摘要),直接可用 |
| 定制化程度 | 低(依赖内置配置) | 高(可自定义搜索深度、结果数等) |
| 版本兼容性 | 依赖OpenClaw内置功能 | 零侵入,适配所有版本 |
| 适用场景 | 已有Brave Key,追求原生顺滑体验 | 无Brave Key,需要结构化结果与灵活配置 |
(二)安全与工程化建议
- API Key安全:仅通过环境变量配置,禁止写入Skill文档或提交到代码仓库,定期轮换Key;
- 公网暴露防护:避免将OpenClaw暴露在公网,若需远程访问,配置IP白名单与身份鉴权;
- 检索结果过滤:在Skill中固化可信度规则,优先选择官方来源,过滤可疑链接;
- 资源优化:关闭
include_raw_content参数,仅在需要时对特定链接执行抓取,降低Token与网络消耗; - 环境变量一致性:若OpenClaw以daemon/systemd方式运行,需在服务环境中重新配置
TAVILY_API_KEY,确保进程可读取。
六、常见问题排查
(一)搜索时提示API Key无效
解决方案:检查环境变量配置是否正确,重新设置并重启服务:
# 阿里云部署(容器内)
export TAVILY_API_KEY="你的Tavily API Key"
openclaw restart
# 本地部署(Linux/macOS)
source ~/.bashrc 或 source ~/.zshrc
openclaw restart
(二)脚本执行报错“jq: 未找到命令”
解决方案:重新安装jq工具:
# Ubuntu/Debian
sudo apt install -y jq
# macOS
brew install jq
# Windows(Chocolatey)
choco install jq
(三)OpenClaw无法调用Tavily Skill
解决方案:检查Skill目录路径是否正确,确保SKILL.md格式规范:
# 阿里云部署(容器内)
ls /app/workspace/skills/tavily-search # 需包含SKILL.md与search.sh
# 本地部署
ls ~/openclaw-cn/workspace/skills/tavily-search
(四)检索结果为空或噪声过多
解决方案:调整搜索深度与结果数,优化查询关键词:
# 切换为basic搜索深度,减少噪声
sed -i 's/search_depth: "advanced"/search_depth: "basic"/g' SKILL.md
# 减少返回结果数为3条
sed -i 's/max_results: 5/max_results: 3/g' SKILL.md
七、总结
2026年OpenClaw的阿里云部署与汉化本地部署方案,分别满足了云端稳定运行与本地隐私可控的核心需求,而Tavily搜索Skill的接入则完美解决了默认Brave Search需配置API Key的痛点。通过自定义Skill,用户可获得结构化、高可信度的检索结果,结合“搜索→筛选→抓取→总结”的工程化流程,显著提升OpenClaw的联网检索能力。
无论是个人日常检索还是团队自动化任务,Tavily都以低接入成本、高灵活性成为OpenClaw的最优搜索搭档。核心配置逻辑在于“环境变量安全存储+Skill标准化定义+检索流程固化”,既保证了使用便捷性,又兼顾了安全性与可维护性。随着OpenClaw生态的持续完善,检索技能的自定义空间将进一步扩大,助力用户打造更贴合自身需求的AI助手系统。