夜雨聆风学习资料网

ARTICLE · 1092967

保姆级教程:3步搞定阿里云服务器安装openclaw,照着做就行

保姆级教程:3步搞定阿里云服务器安装openclaw,照着做就行

3步搞定阿里云服务器安装openclaw,照着做就行

说句掏心窝子的话,我第一次折腾OpenClaw的时候,是在自己笔记本上搞的本地部署。光是Node.js版本冲突就卡了我一整个下午,环境变量配完一遍又一遍,最后跑起来还频繁崩溃。后来看数据才知道,国内67%的用户都因为本地部署太折腾直接放弃了。

其实完全没必要这么苦。阿里云服务器安装openclaw,真没你想的那么难,关键是找对方法。今天这篇,我把踩过的坑全给你踩平了,零基础3步搞定,照着做就行。

先说下整体思路,别一上来就懵。

整套流程就三步:第一步选对服务器和镜像,第二步配好API Key,第三步打开面板验证跑通。每一步我都给你写了具体操作和容易翻车的地方,别跳着看,按顺序来。

第一步:开机器,选对镜像省掉80%的活

登录阿里云控制台,创建一台轻量应用服务器。这里有个关键选择——系统镜像别选纯操作系统,直接选「OpenClaw专属应用镜像」。

我踩过这个坑,第一次我选了纯Ubuntu镜像,心想自己手动装更有掌控感。结果光是把Node.js 22和依赖环境捋顺就花了两小时,中间还遇到npm源超时、权限报错一堆破事。后来才发现阿里云2026年已经推出了预装好环境的专属镜像,开箱即用,连Node.js 22都给你装好了。

选镜像的操作路径:轻量应用服务器 → 创建服务器 → 镜像选择 → 应用镜像 → 找到OpenClaw。地域选离你近的就行,华东、华北都行,延迟差别不大。

配置方面,2核4G是起步线,跑OpenClaw够用。如果你后续要挂多个智能体或者处理量比较大,直接上4核8G会更稳。别在配置上抠搜,卡顿比多花一点预算更让人崩溃。

服务器创建完等个两三分钟,状态变成「运行中」就OK了。

第二步:配置API Key,这是跑起来的核心

服务器跑起来之后,OpenClaw要真正工作,必须接入大模型的API。这一步很多人卡住,其实就一件事:拿到你的API Key,填进配置文件。

先说怎么拿Key。打开百炼平台(阿里云的大模型服务平台),登录后进入API Key管理页面,创建一个新Key。复制保存好,这串东西只显示一次,丢了得重新生成。

我第一次操作的时候,Key复制完随手贴在记事本里,结果多复制了一个空格,填进去一直报401认证失败,排查了半小时才发现是多了个空格。所以跟你说,复制完先粘贴到纯文本里检查一下首尾有没有多余字符。

拿到Key之后,SSH连接到你的服务器。连接方式在阿里云控制台的「远程连接」里,点一下就能进终端,不需要额外装软件。

进终端后,找到OpenClaw的配置文件。专属镜像的路径一般在家目录下的openclaw文件夹里,有个.env文件。用vim或者nano打开,找到API_KEY那一行,把你的Key填进去。

填完保存退出,然后重启服务。命令就一行:systemctl restart openclaw。没报错就是成功了。

这里有个细节要注意:如果你用的是百炼以外的模型服务,比如其他兼容OpenAI接口的服务,配置文件里还要改一下API_BASE的地址。别只改了Key忘了改地址,不然请求会打到默认的百炼端点,返回的报错信息还不太明确,容易让人误以为是Key的问题。

第三步:打开WebUI面板,验证一切正常

API Key配好、服务重启完,就可以打开浏览器验证了。

在阿里云控制台找到你服务器的公网IP,然后浏览器输入:http://你的公网IP:端口。端口默认是3000,如果你没改过的话就是http://你的公网IP:3000。

页面打开后你会看到OpenClaw的WebUI界面。如果一切正常,左侧是对话区,右上角有模型选择和设置入口。

试试发一条消息,能收到回复就说明整个链路跑通了。

我第一次到这一步的时候,页面打开了但是发消息一直转圈没反应。排查后发现是安全组没放行3000端口。阿里云轻量服务器的防火墙默认只开了22和80等常用端口,3000得手动加。

操作路径:轻量应用服务器 → 防火墙 → 添加规则 → 端口填3000,协议TCP,允许访问。保存之后刷新页面再试,立刻就通了。这个坑我帮你踩过了,别再踩一遍。

如果你改了默认端口,防火墙那边也要同步改。别只改了配置文件忘了防火墙,这种低级错误我见过不下十次。

避坑专区:这几个问题90%的新手都会遇到

端口问题刚才说了,再补充几个高频坑。

第一个,SSH连接超时。很多人用本地终端连不上,大概率是本地网络的问题。先试阿里云控制台自带的远程连接,如果能连上说明服务器没问题,是你本地出口的限制。控制台的Web终端虽然体验一般,但排障够用。

第二个,服务启动后过一会自动停了。这种情况先看日志:journalctl -u openclaw --no-pager -n 50。常见的报错是内存不足,2G内存跑OpenClaw确实有点紧,加swap或者升配置二选一。我建议直接升到4G,加swap治标不治本,后续跑智能体还是会卡。

第三个,页面能打开但模型回复报错。先确认API Key有没有填对,再确认余额够不够。大模型API是按量计费的,Key没问题但账户没钱了也会报认证相关的错,报错信息容易误导人。

第四个,域名访问配置。如果你不想每次输IP加端口,想用域名访问,需要装Nginx做反向代理,再配个SSL证书。这块展开说篇幅太长,后面单独出一篇讲。先用IP访问把功能跑通,域名的事不急。

进阶技巧:让OpenClaw更好用的两个设置

跑通之后,有两个设置建议你第一时间调。

一个是系统提示词。WebUI的设置里可以配置默认的System Prompt,把你的常用指令模板写进去,每次新建对话自动带上,省得每次手动输入。

另一个是多模型切换。如果你除了百炼还接了其他模型,在配置文件里加好对应的API_BASE和API_KEY,WebUI里就能在下拉菜单里切换。不同任务用不同模型,效果差异很大,这个值得花时间摸索。

最后帮你捋一遍完整流程

开服务器选专属镜像 → 配API Key重启服务 → 开防火墙端口打开WebUI验证。就这三步,没有第四步。

我写这篇之前特意让一个完全没接触过服务器的朋友按这个流程走了一遍,从零到跑通花了25分钟。其中15分钟是在等服务器创建和看防火墙怎么加规则,真正动手操作的时间不到10分钟。

阿里云服务器安装openclaw这件事,难的不是技术,是信息差。知道选专属镜像、知道要开防火墙端口、知道Key别多空格,剩下的就是点几下鼠标的事。

觉得这篇有用的朋友,先收藏备用,下次部署的时候直接翻出来照着走。也欢迎点赞鼓励一下,我后面还会出OpenClaw域名配置和多模型接入的教程,关注了就不会错过。

阿里云服务器安装openclaw

openclaw使用教程

阿里云一键部署openclaw

相关学习资料