“OpenClaw 部署到阿里云”这个话题,最近后台被问爆了。不少人看到标题里“3分钟”就开始怀疑,我也一样,所以特意拿了一台全新的阿里云 ECS 实测了一遍,把从买机器到接入百炼 API Key 的完整过程都记录下来。先给结论:OpenClaw 的核心部署动作确实可以很快,但前提是你把服务器环境、安全组规则、密钥配置这几件“前置小事”处理干净。这篇教程会从零开始,把每一步的为什么讲清楚,保证你照着做一遍能跑通,之后换服务器、换模型也能自己搞定。
文章适合两类人:一是想用云服务器跑 AI 代理工具,让 OpenClaw 24 小时在线干活的开发者;二是刚接触代理框架,想用阿里云百炼上的通义千问系列模型快速试水的新手。不管你是哪类,都建议按顺序读,尤其别跳过第 2 节的服务器初始化部分,很多后面报的错,根子都在前面这些不起眼的设置上。
1. 部署前要想清楚的三件事
1.1 为什么推荐“阿里云 + OpenClaw”这个组合
OpenClaw 是一个开源的代理执行框架,简单说,它就是用大模型驱动的小助手,你在终端里给它一个任务,它会自己拆解步骤、调用工具、执行命令,然后把结果反馈回来。和 codex 这类工具定位比较接近,但 OpenClaw 更强调整合和长任务执行,装好之后可以把它当成一个“能在服务器里干活的下属”。
为什么要把这套东西放在阿里云上?最直接的原因是:代理工具要在本地跑也能跑,但一旦你电脑关机、休眠、断网,任务就中断了。放在云服务器上,等于给 OpenClaw 找了个全天候的“工位”。再加上阿里云百炼平台提供了稳定的模型接口,OpenClaw 通过兼容 OpenAI 格式的接口就能调用通义千问系列模型,链路是通顺的。我实测下来,用百炼的 qwen-plus 模型跑常规任务,响应速度和稳定性都不错,成本也比单独去买海外模型接口划算不少。
当然,本地部署也有它的价值,比如调试阶段、想用本地 Ollama 模型或者有特殊隐私需求的场景。但从长期稳定运行的角度看,云服务器几乎是绕不开的选择。
1.2 服务器配置怎么选才不浪费钱
很多朋友第一次买服务器,恨不得直接上最贵的配置。其实 OpenClaw 这类工具的压力点主要在网络请求和命令执行上,对 CPU 和内存的要求没有想象中高。我自己的经验是,2 核 2G 的 ECS 实例跑一个 OpenClaw 服务绰绰有余,哪怕接飞书机器人、做定时任务,也不会卡。如果你打算让它处理特别大的文件或者跑本地模型,那再考虑升到 2 核 4G。
系统镜像方面,推荐 Ubuntu 22.04 或 Ubuntu 24.04。OpenClaw 的官方安装脚本对 Debian 系列的兼容性最好,踩坑最少。地域选择上,选离你日常管理最近的城市就行,注意如果你想用百炼的公网网关,ECS 地域和百炼地域不同也没关系,走公网接口都能通。
带宽也别买太高,按量计费的 3M 到 5M 足够用。代理工具大部分时间是在等模型的响应,真正消耗带宽的场景不多。测试阶段的流量极小,后面如果要传大文件再加也行。
1.3 动手之前,先把这几样东西准备好
- 阿里云账号,完成实名认证。这个不用多说,没有账号连服务器都买不了。
- 百炼平台的 API Key。后面专门有一节讲怎么申请,你先知道这玩意儿是 OpenClaw 和模型对话用的“钥匙”,别随手乱丢。
- SSH 终端。Windows 可以用自带的 PowerShell 或 Windows Terminal,macOS 和 Linux 直接用系统终端就行。
- 一个可用的模型名称。百炼上最常用的就是 qwen-plus、qwen-max、qwen-turbo,我建议新手先用 qwen-plus,性价比最均衡。
如果你手头已经有一台服务器,那直接跳到第 2 节的初始化部分。如果你还是白纸一张,从买机器开始跟我走。
2. 阿里云 ECS 环境准备与初始化
2.1 购买 ECS 实例的实操建议
流程很简单:登录阿里云控制台,进入云服务器 ECS 页面,点“创建实例”。关键在选项上:
- 计费方式:测试用选“按量付费”,跑长期任务选“包年包月”,便宜很多。
- 地域:选靠近你的区域,比如华东、华北,平时 SSH 连接延迟会低一些。
- 实例规格:按上一节的思路,2 核 2G 起步就够。如果你预算充足,2 核 4G 更舒服,主要是防止未来装更多插件后内存吃紧。
- 镜像:选 Ubuntu 24.04 64 位,不要选带桌面版的,纯命令行版占用最少。
- 登录凭证:设置 root 密码,或者绑定一张密钥对。密钥对安全性更高,但新手容易搞丢,建议先用密码,之后熟悉了再换密钥。
买完之后,实例的“公网 IP”是你的主要操作入口,记下它。
2.2 安全组放行:这个小细节能省一晚上的排查时间
很多新手部署完发现连不上服务器,或者服务起来了但外部访问不到,八成是安全组没配好。阿里云默认的安全组策略比较严格,你需要在控制台找到“安全组”配置,在入方向规则里放行:
| 端口 | 用途 | 建议 |
|---|---|---|
| 22 | SSH 远程连接 | 必须放行,否则连不上机器 |
| 8080 | OpenClaw 管理/Web 接口(如需要) | 按需放行 |
| 443 | HTTPS 服务 | 按需放行 |
| 80 | HTTP 服务 | 按需放行 |
提示:安全组不是防火墙,它是在虚拟网络层面做过滤。如果你后面通过命令行重装了防火墙软件,要保证安全组和系统防火墙的设置方向一致,否则也会出现端口不通的情况。
2.3 连接服务器:放心,一点不复杂
假设你的公网 IP 是1.2.3.4,在终端里输入:
ssh root@1.2.3.4第一次连接会提示你确认主机指纹,输入yes回车。接着输入你刚才设置的 root 密码,就进去了。看到类似root@xxxx:~#的提示符,说明你成功登上了服务器。
这里有个实操心得:root 用户虽然方便,但权限过大容易出安全事故。如果你打算长期跑 OpenClaw,建议创建一个普通用户来跑,比如:
adduser claw usermod -aG sudo claw su - claw用普通用户日常操作,遇到需要管理员权限时再用sudo,对自己也是一个保护。有些代理任务会让模型执行命令,哪怕模型被误导了,普通用户的权限范围也会小很多。
3. OpenClaw 快速部署实操
3.1 最速路径:官方一键脚本安装
进入服务器后,先更新一下系统包,避免老旧的索引导致下载失败:
sudo apt update && sudo apt upgrade -y然后执行官方的一键安装命令:
curl -fsSL https://get.openclaw.sh | bash这个脚本会自动检查系统依赖、下载 OpenClaw 核心程序、完成基础初始化。整个等待过程取决于你服务器的网络状况,一般在几分钟内完成。看到输出里出现OpenClaw installed successfully或者类似字样,就说明装好了。
脚本装完后,验证一下命令是否可用:
openclaw --version如果提示command not found,别慌。大多数情况是因为安装目录没有加到 PATH 里。这时候你只需要手动导出一下环境变量,或者重新登录一次 shell 让配置生效。如果你用的是普通用户,记得加sudo或用 root 身份执行安装脚本。
3.2 稳妥路径:手工分步安装(备选方案)
一键脚本虽然快,但有时候会有网络代理、系统版本不兼容之类的小问题。如果你想更可控,或者想弄清楚 OpenClaw 到底装到了哪里,可以走手工安装路线:
# 安装基础依赖 sudo apt install -y git curl build-essential # 安装 Node.js 20+(建议用官方源或 nvm) curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs # 克隆 OpenClaw 仓库 git clone https://github.com/openclaw/openclaw.git ~/openclaw cd ~/openclaw # 安装依赖并构建 npm install npm run build # 全局链接命令 sudo npm link手工装的核心逻辑是:把依赖装好、把代码拉下来、构建产物、把命令软链到全局。遇到哪一步报错就针对性解决。和官方一键脚本相比,手工安装能让你更清楚每一步做了什么,排错时也更有底。
3.3 首次启动:初始化配置与权限确认
装好之后,先别急着接 API Key,直接跑一次初始化:
openclaw init这个命令会帮你创建默认的.openclaw目录,里面会生成配置文件、workspace 工作目录和日志目录。注意观察输出,如果系统提示:
legacy exec approvals exist at /root/.openclaw/exec-approvals.json这说明之前有旧版本的授权记录被检测到了。这不算错误,直接按提示选择保留或重置就行。我自己的习惯是先重置,因为旧授权里可能记录了不信任的命令,重置后能够重新选择。
初始化后会让你设置工作目录。默认的是~/.openclaw/workspace,建议保持默认,方便后续统一管理。这个 workspace 就是 OpenClaw 执行命令和存放文件的“工作台”。
首次启动服务,可以用:
openclaw serve看到类似Server started on port 8080的日志时,说明核心服务已经跑起来了。先别急着关,我们要去接入模型了。
4. 接入阿里云百炼 API Key,让 OpenClaw 开始工作
4.1 百炼平台申请 API Key
打开阿里云百炼控制台(阿里云主页搜“百炼”就能找到),进入“API Key 管理”页面。如果还没开通服务,先点击开通,通常需要实名认证,过程很快。
开通后,点“创建 API Key”,会生成一串以sk-开头的密钥。这个就是你要拿给 OpenClaw 用的“身份令牌”。注意这串密钥只显示一次,记得复制到安全的地方。
百炼平台不仅能看余额和用量,还能选择不同模型。OpenClaw 接入时通过的是兼容 OpenAI 的接口地址:
https://dashscope.aliyuncs.com/compatible-mode/v1这个地址相当于模型接口的“网关”,你不需要关心它具体连接的是哪台服务器,只要把 OpenClaw 的 Base URL 指向它,然后填上 API Key 即可。
4.2 把 API Key 写入 OpenClaw 配置
OpenClaw 的配置文件在~/.openclaw/openclaw.json(或config.yaml,取决于版本)。我们需要在里面设置模型提供方。打开文件,找到类似model的配置段,填上:
{ "provider": "openai-compatible", "base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1", "api_key": "sk-你的百炼密钥", "model": "qwen-plus" }如果你不想把密钥明文写在配置文件里,更推荐用环境变量:
export OPENCLAW_API_KEY="sk-你的百炼密钥" export OPENCLAW_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"然后启动 OpenClaw 时,它就会自动读取环境变量。这样即便配置目录被误传到公共仓库,也不会泄露密钥,这点至关重要。
注意:如果你是 Windows 本机跑 OpenClaw,环境变量用
setx命令或者在 PowerShell 里用$env:OPENCLAW_API_KEY="sk-xxx"设置。但setx对环境变量的改动是持久的,改完要重开终端才能生效。
4.3 跑通第一个任务:验证整条链路
配置完成后,重启 OpenClaw 服务,让配置生效。然后在终端里开一个新的会话,用交互模式测试:
openclaw chat进入对话界面后,输入一句简单的任务,比如:
帮我创建一个 hello.py 文件,内容是打印当前的日期时间,然后运行它。OpenClaw 会调用百炼模型分析这个指令,然后自动在工作目录里创建文件、执行命令、返回结果。如果你看到类似“任务完成”的反馈,并且hello.py确实生成并运行了,就说明你整个链路已经打通:OpenClaw 成功通过百炼 API Key 调用模型,并且模型的指令被正确执行。
这一步是整个部署的“灵魂验证”。如果这儿跑通了,后面接飞书、做定时任务、加自定义 Skill,都只是在成熟体系上叠加功能而已。
5. 常见问题与排查实录
5.1 Windows 安装 OpenClaw 的经典报错
标题里 3 分钟部署主要针对云服务器,但很多朋友喜欢先在 Windows 上做开发测试,踩坑往往比云服务器还多。最常见的一个报错是:
openclaw : 无法将“openclaw”项识别为 cmdlet、函数、脚本文件或可运行程序的名称这句话翻译过来就是:系统找不到 openclaw 命令。原因基本就两个:一是安装过程中断或没成功;二是安装路径没有加进 PATH。解决方案很简单,打开 PowerShell 手动设置一下 PATH:
$env:PATH += ";C:\Users\你的用户名\.openclaw\bin" openclaw --version如果这样能识别,说明生效了,但只在当前窗口有效。要把 PATH 写死在系统里,用setx PATH或者图形界面的“环境变量”设置界面都比较稳。
另外,PowerShell 的执行策略有时会把安装脚本拦下来,报一串红色错误。你可以先查一下策略:
Get-ExecutionPolicy如果结果是Restricted,临时改成RemoteSigned再执行:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned跑完安装脚本后,可以改回Restricted,保持系统默认安全策略。
5.2 遗留授权文件导致启动卡住
前面提到过legacy exec approvals exist at /root/.openclaw/exec-approvals.json这个提示。有些版本会直接卡住等你确认,有些版本会静默忽略,但这可能导致旧授权规则失效,或反过来保留了不该保留的高危命令白名单。
我的建议是:首次部署遇到这个提示,直接按y重置。日常使用中如果发现某个命令执行时总停下来问你是否批准,可以去这个 JSON 文件里手动检查授权项,把信得过的命令加进去,比如ls、pwd、node、python3,把明显可疑的删掉。注意违规的全局授权文件如果包含敏感命令,影响面比较大,宁可多确认一次,也不要图省事直接全放行。
5.3 调用百炼模型报错:超时、鉴权失败、模型不存在
接入百炼之后最常遇到的三类问题,我把排查思路列成了一张表:
| 错误现象 | 直接原因 | 解决思路 |
|---|---|---|
TimeoutError/Connection timed out | 服务器访问百炼公网接口超时 | 检查 ECS 出方向安全组是否放行 443 端口;确认 Base URL 是否填对 |
Unauthorized/Invalid API Key | 密钥格式或权限问题 | 重新检查sk-开头的密钥是否复制完整;去百炼控制台确认密钥是否被禁用 |
Model not found | 模型名填写错误 | 百炼平台查看当前账号可用的模型名,比如qwen-plus、qwen-max,填错一个字符都会报错 |
超时问题还要特别注意“内网 vs 公网”的区别。如果你的 ECS 和百炼不在同一区域,甚至你只是想在本地开发时对接百炼,都必须走公网网关,也就是dashscope.aliyuncs.com,不要在配置文件里尝试写内网地址。
另外,有朋友给我留言问能不能用百炼的“自定义中转站”,如果你是在 OpenClaw 的配置里把 Base URL 指向了自己搭建的中转服务,那其实就两步:确认中转服务本身稳定,再确认中转服务返回的格式兼容 OpenAI 的/v1/chat/completions接口。OpenClaw 对接口兼容性要求不低,所以我更推荐直接用官方百炼网关,少一层中间环节,排查起来也简单。
6. 部署后的几个实用小经验
整个流程跑通之后,你会发现 OpenClaw 能做的事情远超“聊天机器人”。它可以在后台按计划任务执行脚本、可以把结果推送到飞书群、可以编排复杂的命令序列。只要你给它足够的执行权限和清晰的指令,它的工作方式更像一个“实习生”,而不是一个“问答窗口”。
有一个技巧我想重点分享:OpenClaw 的命令授权机制建议不要一刀切全允许。在默认配置里,很多命令在执行前会弹确认框,这其实是它的安全设计。你可以提前把高频命令写入授权清单,减少日常打断;但对于删除、写入系统目录、修改权限这类高风险命令,保持每次询问的状态,能让模型被恶意指令诱导时多一道刹车。
在服务器上长期运行的话,建议用 systemd 把 OpenClaw 注册成开机自启的服务,这样服务器重启后,OpenClaw 会自动拉起来,不用每次手动进入终端启动。网上有现成的 unit 文件模板,改一下路径和用户就好,20 分钟能搞定。这个操作虽然不在“3分钟”的范畴里,但对稳定运行的价值极大。
最后再分享一个真实经历:我第一次部署时,把 API Key 明文写进了配置文件,后来为了调试把整个.openclaw目录打包发给了朋友,结果立刻意识到密钥可能泄露。好在百炼控制台支持一键作废旧 Key 再生成新的,两分钟就处理掉了。所以密钥管理永远是第一位的事,环境变量不嫌麻烦,代码仓库宁可少放配置,也不要存 Key。
我个人的体会是,OpenClaw 这类工具真正的门槛从来不是安装,而是你怎么设计它的工作流。装好它只是第一步,把它调教成一个顺手、安全、能持续干活的“数字员工”,才是持续的乐趣所在。希望这篇教程能帮你把第一脚踢开,之后的路,就看你给它安排什么活儿了。