OpenClaw部署教程:华为云服务器+百炼API,1分钟跑通AI代理
2026/9/8 19:42:55 网站建设 项目流程

先回答一个很多人实际遇到的困惑:网上聊OpenClaw的人很多,但教程写得太散了,要么只讲原理不给步骤,要么给了一堆命令但跑不通。我自己第一次部署也折腾了快两个小时,卡在各种小细节上——Node版本不对、APIKey填错位置、baseURL少了个尾巴、装上之后不知道怎么确认它真的活了。后来在华为云上反复试了几次,把流程理顺之后发现,真正要动手的步骤就那么几步。这篇文章就把完整流程写清楚,从华为云服务器准备、百炼平台APIKey获取,到OpenClaw安装、模型接入、后台守护,一次讲透。

先说结论:只要服务器和APIKey提前备好,从执行安装命令到OpenClaw正常应答,确实可以在1分钟内跑通。下文所有命令我都按当前主流版本实测过,你照着操作就行。

1. 先别急着装:OpenClaw解决什么问题,以及为什么必须上云

1.1 一句话理解OpenClaw:能动手干活的AI代理,而不是聊天框

很多第一次接触OpenClaw的朋友,容易把它和ChatGPT、通义千问这类对话机器人搞混。插一句我在实际测试中的理解:OpenClaw本身不提供大模型能力,它是一个"代理框架",负责调度各种工具,核心差异在于它可以直接执行命令、读写文件、调用外部接口,再配合一个大模型的推理能力,形成一个"感知—决策—行动"的闭环。

打个比方:普通聊天机器人像一个只会给建议的顾问,你问它"帮我整理一下当前目录的文件",它只会告诉你该用什么命令,然后让你自己复制粘贴去执行;OpenClaw则像一个真的会动手的助理,你吩咐完之后,它会自己调用Shell工具去查看目录、分析文件内容、按你的要求处理,然后把结果汇报给你。它的价值就在这个"动手"上——这也是为什么很多人叫它"AI Agent框架"而不是"聊天机器人"。

1.2 为什么我建议把它部署在云服务器而不是自己电脑上

第一次尝试OpenClaw,大多数人会在自己电脑上装。我之前也这么干过,然后很快就发现几个现实问题:笔记本一合上,服务就断了,任何定时任务、消息响应全部失效;即使不关电脑,家里的宽带IP不固定,后续接入IM机器人、Webhook这类场景时很不好配置;另外,本地电脑运行AI代理会持续占用CPU和内存,风扇呼呼转,办公的时候体验很糟。

转去云服务器之后,这些问题一次性全解决了。以华为云为例,买一台最基础的2核4G弹性云服务器,跑OpenClaw加操作系统,资源完全够用。它有固定的公网IP,只要服务器不欠费,服务就是7x24小时在线,你在任何地方通过终端访问它,晚上睡觉时它照样能处理任务。至于为什么是华为云而不是别家,我的判断就三条:新用户活动价便宜,国内访问稳定,控制台自带CloudShell,不用在本地装额外的SSH工具也能登录服务器。服务器厂商跟大模型平台本来就是两回事,你完全可以用华为云的服务器去接任何一家大模型的API,本文就是用华为云服务器接阿里云百炼平台的大模型接口。

2. 部署前准备:华为云服务器、百炼APIKey和环境检查

2.1 华为云ECS选购:选什么规格、开哪些端口

登录华为云控制台,搜索"弹性云服务器ECS",进入购买页。新手最容易在镜像、规格这些选项上纠结,我直接给你一套经过验证的配置组合:

配置项推荐选择说明
计费模式按需计费先按小时付费练手,跑通后再转包年包月省钱
区域离你最近的城市节点例如你在华南就选广州,延迟低一些
镜像Ubuntu 22.04 LTS比CentOS包管理更省心,后续装Node.js少踩坑
规格2核4G跑OpenClaw+模型调用足够,1核2G会比较紧张
登录凭证设置root密码别用密钥,新手用密码登录最直观
安全组入方向放行22、300022是SSH登录用,3000是OpenClaw管理界面备用

这里重点说下安全组。安全组相当于云服务器的防火墙,很多人部署完了发现服务有问题,排查半天,最后发现是安全组没放行端口。入方向规则里至少要把22端口(SSH远程登录)和3000端口放行,如果你后续还会给OpenClaw配Web面板或API服务,再把80和443也加上。只放行你用得到的端口就好,别图省事全部放开,安全习惯要养好。

购买完成后,云服务器会给一个公网IP。下面所有操作都需要用到这个IP,建议直接复制保存到备忘录。

2.2 百炼平台APIKey:从注册到拿到密钥的完整路径

OpenClaw本身没有大模型能力,你必须给它接一个大模型的API才能让它"思考"。国内使用,我最推荐的还是阿里云百炼平台。百炼上能直接用通义千问的qwen系列和DeepSeek系列模型,接口兼容OpenAI格式,OpenClaw原生支持,不需要额外写适配层。

获取APIKey的完整流程:

  1. 用阿里云账号登录百炼控制台。没有账号就先用手机号注册,需要实名认证,提前准备好身份证信息。
  2. 进入控制台后,找到"API-KEY"管理页面。通常在右上角头像下拉菜单或左侧菜单里能找到。
  3. 点击"创建API-KEY",系统会生成一串以sk-开头的字符串。
  4. 立刻复制保存。这串Key只在创建时完整显示一次,关掉页面再想看就只能删了重建。

同时记下百炼的baseURL(接口地址):

https://dashscope.aliyuncs.com/compatible-mode/v1

这个地址末尾的/v1非常关键,OpenClaw和很多AI工具都按照OpenAI的/v1接口规范去拼接地址,漏掉末尾的/v1,请求会直接404。APIKey就是你的调用凭证,相当于银行卡密码,谁拿到它就能用它调用模型产生费用,务必不要写进博客、GitHub仓库或者聊天对话里。

2.3 服务器登录后的第一轮检查

准备工作做完了,下一步是登录服务器。这里我不推荐本地再装一个Xshell之类的工具,华为云控制台自带的CloudShell足够用了——浏览器里就能打开终端,免去了本地配置SSH客户端的功夫。

登录之后,先确认三件事:

whoami node -v npm -v

第一条确认当前是root用户(华为云默认是);后面两条确认Node.js和npm是否已安装。OpenClaw是Node.js生态的项目,对运行时版本有要求,最好在Node 20以上。如果node -v报错或版本低于18,先不用继续往下看,直接跳到下一节把Node环境装好再回来。

3. 实操部署:两条命令装好OpenClaw

3.1 装Node.js:版本对了,后面才不折腾

如果你检查完发现没装Node,或者版本太老,用下面这套命令装最新LTS版本。注意这套命令针对Ubuntu系统,CentOS请自行去找对应的安装方式:

curl -fsSL https://deb.nodesource.com/setup_20.x | bash - apt-get install -y nodejs

第一条命令是把NodeSource的软件源添加进系统,第二条是安装。整个过程大概几十秒到一两分钟,取决于服务器带宽。装完再验证一次:

node -v npm -v

看到v20.x.x这样的输出就说明环境正常了。

3.2 npm安装OpenClaw:网络慢就切镜像源

Node环境就绪后,调用npm全局安装OpenClaw:

npm install -g openclaw

就这么一条命令。因为OpenClaw依赖的包数量不少,首次安装可能耗时稍长。如果你发现进度条很慢或者直接卡住,大概率是npm默认源在国内访问不畅,先切到国内镜像源再装:

npm config set registry https://registry.npmmirror.com

再重新执行安装命令。镜像源只影响下载速度,不影响OpenClaw本身的功能,可以放心用。装完之后验证一下:

openclaw --version

能输出版本号,说明主程序已经装好。到这里,其实你已经完成了整个部署流程最核心的一步,从执行安装命令到验证通过,确实用不了1分钟。

3.3 首次启动:交互面板里该怎么选

OpenClaw安装好之后,直接在服务器上运行:

openclaw

首次启动会进入一个交互式引导面板,类似打字机的效果,让你配置基础选项。因为不同版本界面会有些差异,我重点说下几个关键选项的选择思路:

  • 渠道/Channel:这是OpenClaw连接外部世界的通道。第一次跑通,选Terminal(终端)就够了,先让服务跑起来再说。微信、Telegram这类IM渠道可以后续再加。
  • 模型提供商/Provider:选OpenAI兼容模式(或者叫"自定义API")。我们把百炼当作一个OpenAI兼容的接口接入,所以选这个最匹配。
  • 模型名称/Model:填百炼上的具体模型名,比如qwen-plus。这个字段千万别乱填,模型名不对,后面调用必然报错。

引导完成之后,OpenClaw会进入一个带输入框的交互面板,看起来像一个终端版的聊天界面。到这里程序已经跑起来了,但如果你用的是百炼的APIKey,还差最关键的一步——把APIKey和baseURL告诉OpenClaw。IS第4节做的事。

4. 接入百炼大模型:APIKey、baseURL和模型选择

4.1 环境变量写入:OPENAI_API_KEY和OPENAI_BASE_URL缺一不可

OpenClaw默认是按OpenAI官方的API地址来请求的,也就是https://api.openai.com/v1。我们在国内用百炼,需要把它的请求地址改到百炼的兼容接口,同时把APIKey换成自己的。

在OpenClaw中,这两项通过环境变量管理。直接在终端里用命令设置:

openclaw env set OPENAI_API_KEY sk-你的百炼APIKey openclaw env set OPENAI_BASE_URL https://dashscope.aliyuncs.com/compatible-mode/v1

第一条命令把APIKey写进OpenClaw的配置,第二条把接口地址重定向到百炼。这两个变量缺一个都不行:不写APIKey,鉴权过不了;不改baseURL,请求会发到OpenAI官方海外地址,本地网络大概率超时。

设置完后重启OpenClaw(先Ctrl+C停掉,再重新运行openclaw),配置才会重新加载。

4.2 模型选择:qwen-plus、qwen-max、deepseek怎么选

百炼平台上可选的模型很多,我在实际使用中的经验是:

模型适合场景特点
qwen-turbo高频、简单任务便宜、响应快
qwen-plus日常对话、工具调用、绝大多数场景性价比最高,我主力用它
qwen-max复杂推理、代码生成、长文本效果最好,价格也最高
deepseek-v3系列需要DeepSeek风格回复时在百炼上也能直接调用

如果你不确定选哪个,先从qwen-plus开始。它能力均衡,OpenClaw这种工具调用密集型场景下表现稳定,不容易因为模型太弱导致Agent执行任务时逻辑混乱。后面跑熟了,再用/model命令在会话中随时切换模型对比效果。

4.3 配置生效检查:改完环境变量,怎么判断接没接通

重启OpenClaw进入交互面板后,先不要急着安排任务,做一次最基础的连通性测试。在输入框里输入:

hey openclaw

这是OpenClaw的唤醒词。如果安装配置正常,它会自动进入监听状态。接着输入:

你好,简单介绍一下你自己

如果模型接入成功,OpenClaw会基于qwen或deepseek的能力生成一段自我介绍,并显示在面板上。如果你看到的是超时、404、401类的报错,按5.3小节的排查表逐项检查,八成是baseURL末尾漏了/v1,或者APIKey多了个空格。

5. 部署完的收尾:验证运行、后台常驻与排错

5.1 完整链路验证:让OpenClaw动手做第一个任务

连通性测试通过后,做一次真正的"动手"测试。在交互面板里输入:

hey openclaw,看看当前目录下有哪些文件,列出来

这句话会触发OpenClaw的完整工作链路:它先让模型理解你的意图,然后调用Shell工具执行ls命令(工具调用),再把命令结果返回给模型整理成人类可读的回复(结果摘要),最后输出到面板。看到它能正确列出目录内容,并且回复里带了对文件的分析说明,说明整条链路完全跑通了。

我再多做一个更强的测试——让它执行一个"有副作用"的操作,比如创建文件:

hey openclaw,在 /tmp 目录下创建一个叫 test.txt 的文件,内容写"hello"

执行完用cat /tmp/test.txt确认文件确实存在。这一步能验证OpenClaw不只是"嘴上说说",而是真的在调用工具操作服务器。

5.2 让OpenClaw在服务器上稳定常驻:nohup和systemd两种保活方案

在交互面板里跑着的OpenClaw,一旦终端断开、SSH会话结束,进程就会跟着退出。所以部署的最后一步,是让它脱离当前终端,作为后台服务长期运行。

想尽快跑起来,用nohup最简单的方案:

nohup openclaw > /root/openclaw.log 2>&1 &

这条命令的意思是让OpenClaw在后台运行,日志统一写到/root/openclaw.log里,就算关掉SSH窗口它也不会停。

更正规的方案是注册成systemd服务,好处是开机自启、崩溃自动重启。创建服务文件:

vim /etc/systemd/system/openclaw.service

写入以下内容:

[Unit] Description=OpenClaw AI Agent After=network.target [Service] Type=simple User=root WorkingDirectory=/root/.openclaw ExecStart=/usr/bin/openclaw Restart=on-failure RestartSec=10 [Install] WantedBy=multi-user.target

注意ExecStart的路径。可以用which openclaw命令查一下实际路径,不同安装方式可能路径不一样,填错了服务会启动失败。保存后依次执行:

systemctl daemon-reload systemctl enable openclaw systemctl start openclaw

查看运行状态:

systemctl status openclaw

显示active (running)就说明服务常驻成功。以后这台华为云服务器里的OpenClaw就会一直在线,断电重启也会自动拉起。

5.3 高频报错:新手必踩的5个坑和处理办法

我在反复部署和帮朋友排查的过程中,把这几个最常见的坑汇总成了一张表,遇到问题直接对着查:

症状根因解决办法
openclaw: command not foundnpm全局bin目录没加到PATH重开终端,或执行export PATH=$PATH:$(npm prefix -g)/bin
请求超时/连接失败baseURL没设置或指向海外地址执行openclaw env set OPENAI_BASE_URL https://dashscope.aliyuncs.com/compatible-mode/v1
返回404baseURL末尾漏了/v1确认baseURL以/compatible-mode/v1结尾
返回401/InvalidApiKeyAPIKey复制多了空格或已过期重新执行openclaw env set OPENAI_API_KEY,注意去空格
报model not found模型名写错,通道里没有对应模型到百炼控制台确认模型名称,再使用/model切换

还有一个升级场景容易踩:旧版本OpenClaw升级后,可能提示legacy exec approvals exist at /root/.openclaw/exec-approvals.json这类信息。这说明你本地有一份旧格式的执行审批配置,系统在等你迁移。按提示运行:

openclaw migrate

它会自动把旧配置转换成新格式。手动删除这个文件也行,但会丢失你之前设置过的所有命令审批规则,所以建议还是乖乖执行迁移命令。

最后提醒一点:APIKey是花钱的,百炼控制台里有消费额度设置,建议给自己设一个每月消费上限,比如50块钱,到达阈值就停止计费。毕竟AI代理跑起来之后,它自动执行任务产生的token消耗会比手动聊天快得多,这一步别省。

我自己的实际体会是,OpenClaw这类AI代理框架最值钱的用法,不是拿它当高级聊天机器人,而是把那些重复性的、需要"看一眼-想一想-动一下"的工作交给它。部署只是第一步,跑通之后可以慢慢扩展渠道、接自定义工具、配定时任务,让这个数字员工真正干起活来。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询