← 首页

阿里云教程

阿里云部署 OpenClaw 完整指南

手把手教你在阿里云 ECS 上部署 OpenClaw AI 智能体 — 从购买服务器到容器运行,覆盖安全组配置、Docker 镜像加速、国内模型接入和常见问题排查。

为什么选阿里云部署 OpenClaw?

阿里云是国内最大的云服务商,也是部署 OpenClaw 的热门选择。相比其他云平台,阿里云在以下方面具有明显优势:

  • 国内最大云服务商 — 市场份额第一,文档完善,社区资源丰富。遇到问题容易找到解决方案,中文支持好,工单响应快。
  • 低延迟 — 国内多个数据中心(杭州、上海、深圳、北京等),用户访问延迟极低。特别适合需要实时对话的 AI 智能体场景。
  • Docker 镜像加速 — 阿里云容器镜像服务提供免费的 Docker 镜像加速器,拉取镜像速度远超直连。其他云平台需要额外配置。
  • 学生优惠 — 阿里云"开发者计划"和学生认证用户可以以极低价格获取 ECS 实例,适合预算有限的个人开发者。
  • 生态丰富 — 阿里百炼(通义千问 API)、对象存储 OSS、CDN 加速、日志服务等产品可与 OpenClaw 配合使用。

阿里云推荐配置

方案配置价格适合场景
轻量应用服务器2核2G / 50GB SSD约 30-50 元/月个人使用,低成本入门
ECS 通用型 (ecs.g7)2核4G / 40GB ESSD约 80-120 元/月多用户、稳定性要求高
ECS 突发性能型 (ecs.t6)2核4G / 40GB SSD约 50-70 元/月间歇使用,性价比高

地域选择建议

  • 华东1(杭州) — 阿里云核心机房,资源充足,推荐首选
  • 华南1(深圳) — 适合南方用户,延迟低
  • 华北2(北京) — 适合北方用户
  • 华东2(上海) — 适合长三角地区

系统镜像推荐:Ubuntu 22.04 LTS。稳定、Docker 支持好、社区教程多。CentOS 7 已停止维护,不推荐。

阿里云部署步骤详解

1. 购买阿里云 ECS 实例

登录阿里云控制台,进入 ECS 云服务器页面,选择"轻量应用服务器"或"ECS 通用型"。推荐配置:2核2G 起步(轻量型约 30-50 元/月),2核4G 更稳定。地域选择华东1(杭州)或华南1(深圳)等国内节点。系统镜像选择 Ubuntu 22.04 LTS。

2. 配置安全组规则

在 ECS 控制台找到"安全组",添加入方向规则:开放 TCP 443 端口(HTTPS 访问)、TCP 18789 端口(OpenClaw Gateway)。如需 SSH 远程管理,确保 22 端口已开放(默认已开)。安全组是阿里云的防火墙,不开端口外部无法访问。

3. SSH 连接服务器

使用终端工具连接服务器:ssh root@你的服务器公网IP。首次登录建议修改 root 密码,创建普通用户并配置 SSH 密钥登录以提高安全性。

4. 安装 Docker

执行 sudo apt update && sudo apt install -y docker.io docker-compose-plugin && sudo systemctl enable --now docker。安装完成后执行 docker --version 验证。将当前用户加入 docker 组:sudo usermod -aG docker $USER,重新登录终端生效。

5. 配置 Docker 镜像加速器

阿里云提供免费的 Docker 镜像加速服务。登录阿里云容器镜像服务控制台(cr.console.aliyun.com),获取你的专属加速地址,将其配置到 /etc/docker/daemon.json 的 registry-mirrors 字段中,然后重启 Docker。这一步能大幅提升镜像拉取速度。

6. 拉取 OpenClaw 镜像

执行 docker pull ghcr.io/openclaw/openclaw:latest 拉取最新稳定版镜像(约 500MB)。配置了加速器后速度会快很多。如果仍然很慢,可以在能访问 ghcr.io 的机器上 docker save 导出,再 scp 传到阿里云服务器 docker load 导入。

7. 创建配置文件

执行 mkdir -p ~/.openclaw/credentials && chmod 777 ~/.openclaw && chmod 777 ~/.openclaw/credentials。然后创建 ~/.openclaw/openclaw.json 配置文件,填入模型 API 密钥、聊天渠道(Telegram/Discord)、Gateway 认证 Token 等配置项。详细配置说明参见 Docker 部署教程。

8. 启动容器

执行 docker run -d --name openclaw -p 18789:18789 -v ~/.openclaw:/home/node/.openclaw --memory=2g --memory-swap=3g --restart unless-stopped ghcr.io/openclaw/openclaw:latest node openclaw.mjs gateway --allow-unconfigured。然后用 docker logs openclaw -f 查看日志确认启动成功。

9. 配置域名和 HTTPS(可选)

如果需要通过域名访问,可以安装 Caddy 反向代理(sudo apt install caddy),配置 Caddyfile 将域名指向 localhost:18789,Caddy 会自动申请 SSL 证书。注意:使用国内域名需要完成 ICP 备案。如果仅个人使用,可以直接通过 IP:18789 访问,跳过此步。

预计耗时:首次部署约 40-60 分钟(含购买服务器和配置安全组)。有 Linux 经验的用户 15-20 分钟可完成。

安全组配置详解

安全组是阿里云 ECS 的虚拟防火墙,必须正确配置端口才能让外部访问 OpenClaw。以下是需要开放的端口:

端口协议用途是否必须
22TCPSSH 远程管理是(默认已开)
443TCPHTTPS 访问配置域名时需要
80TCPHTTP 访问(Caddy 自动跳转 HTTPS)配置域名时需要
18789TCPOpenClaw Gateway 端口不用域名时必须

在阿里云控制台操作:ECS 实例详情 → 安全组 → 配置规则 → 手动添加 → 入方向 → 填写端口范围和授权对象(0.0.0.0/0 表示允许所有 IP)。

配置阿里云 Docker 镜像加速器

阿里云提供免费的 Docker 镜像加速服务,这是阿里云部署的独特优势。配置后拉取 Docker 镜像的速度可以提升数倍。

  1. 登录 阿里云容器镜像服务控制台
  2. 在"镜像工具"→"镜像加速器"页面,复制你的专属加速地址(格式:https://xxxxx.mirror.aliyuncs.com)
  3. 在服务器上配置:
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<EOF
{
  "registry-mirrors": [
    "https://你的ID.mirror.aliyuncs.com"
  ]
}
EOF

sudo systemctl daemon-reload
sudo systemctl restart docker

注意:阿里云镜像加速器主要加速 Docker Hub 镜像。对于 ghcr.io(GitHub Container Registry)的加速支持可能有限。如果拉取 OpenClaw 镜像仍然很慢,可以使用导出/导入方案(见下文)。

阿里云特有优势

阿里百炼 API(通义千问)

在阿里云上部署 OpenClaw,可以直接使用阿里百炼提供的通义千问 API,国内直连无需代理。在 OpenClaw 配置文件中设置模型提供商为通义千问,填入百炼 API 密钥即可。通义千问支持 Qwen-Max、Qwen-Plus、Qwen-Turbo 等多个模型,性能对标 GPT-4。

对象存储 OSS

如果 OpenClaw 智能体需要处理文件(如图片生成、文档分析),可以配合阿里云 OSS 存储。OSS 与 ECS 同地域内网互通,速度快且免流量费。

安全组精细化控制

阿里云安全组支持按 IP 段、端口范围、协议精细化控制访问权限。相比直接配置 iptables 防火墙,安全组通过 Web 控制台操作更直观、更不容易出错。可以针对 OpenClaw 的 18789 端口设置只允许特定 IP 访问,提高安全性。

云监控和告警

阿里云云监控可以自动监测 ECS 实例的 CPU、内存、磁盘使用率,在异常时通过短信或钉钉告警。搭配 OpenClaw 容器的健康检查,可以第一时间发现问题。

网络注意事项(重要)

在国内阿里云服务器上运行 OpenClaw,需要特别注意 AI 模型 API 的访问问题:

需要代理才能访问的 API

  • OpenAI(GPT-4、GPT-4o 等)
  • Anthropic(Claude 系列)
  • Google(Gemini 系列)

这些海外 API 在国内服务器上无法直接访问。解决方案请参考 API 代理配置指南

国内直连的模型(推荐)

  • DeepSeek — 性能强劲,API 价格低,国内直连速度快
  • 通义千问(Qwen) — 阿里百炼提供,阿里云内网互通延迟极低
  • Kimi(Moonshot) — 擅长长文本处理,API 稳定
  • 智谱 GLM — 清华系开源模型,中文理解能力强

使用国内模型无需代理,是阿里云部署的最佳搭配。详细的模型配置方法参见 模型配置指南

OpenRouter 中转

OpenRouter 提供统一 API 接口,一个密钥访问所有主流模型。部分地区可以直连,但稳定性取决于网络环境。适合需要同时使用国内外模型的用户。

阿里云自建 vs OpenClaw Launch 对比

阿里云自建给你完全的控制权,但需要投入时间和运维精力。OpenClaw Launch 提供"交钥匙"托管方案:

阿里云自建OpenClaw Launch
月费用30-50 元/月(ECS)+ 时间成本$3/月(约 22 元),支持支付宝
部署时间40-60 分钟(首次)10 秒
运维需求需自行维护服务器、更新镜像、监控零运维,全自动
配置方式手写 JSON 配置文件(容易出错)可视化编辑器,点选即可
海外 API 访问需自行配置代理海外服务器,直连所有 API
SSL / HTTPS需手动配置 + 域名备案自动处理
升级维护手动拉取新镜像、重建容器自动更新
数据控制完全自主(数据在你的服务器)托管在我们的服务器
适合人群有 Linux 经验、想完全掌控数据希望快速上手、不想管运维

常见问题排查

安全组没开端口

症状:浏览器访问 IP:18789 超时,无法打开。
原因:阿里云安全组默认只开放 22 端口(SSH),其他端口需要手动添加。
解决:在 ECS 控制台的安全组配置中,添加入方向规则,开放 18789 端口(或 443 端口,如果使用了反向代理)。

Docker 权限问题

症状:执行 docker 命令提示 permission denied
原因:当前用户不在 docker 用户组中。
解决:执行 sudo usermod -aG docker $USER,然后重新登录终端。或者在 docker 命令前加 sudo

镜像拉取慢或超时

症状:docker pull 很慢或报错 timeout
原因:国内直连 ghcr.io 速度不稳定。
解决:配置阿里云 Docker 镜像加速器(见上文)。如果仍然慢,可以用导出/导入方案:

# 在能快速访问 ghcr.io 的机器上
docker pull ghcr.io/openclaw/openclaw:latest
docker save ghcr.io/openclaw/openclaw:latest -o openclaw.tar

# 传输到阿里云 ECS
scp openclaw.tar root@你的ECS-IP:~/

# 在 ECS 上导入
docker load -i openclaw.tar

域名备案要求

症状:域名解析到阿里云 ECS 后,访问提示"未备案"。
原因:中国大陆的服务器绑定域名必须完成 ICP 备案。
解决:在阿里云 ICP 备案系统提交备案申请(一般需要 5-15 个工作日)。如果不想备案,可以:(1) 直接用 IP 访问,不绑定域名;(2) 使用中国香港地域的 ECS,无需备案。

容器 OOM 被 Kill

症状:docker logs 显示 Killed 或容器自动退出。
原因:内存不足。OpenClaw 在 512MB 内存下会 OOM。
解决:确保启动容器时使用 --memory=2g --memory-swap=3g,且 ECS 实例至少有 2GB 内存。

常见问题解答(FAQ)

阿里云 ECS 部署 OpenClaw 需要备案吗?

如果只用 IP 地址访问(不绑定域名),不需要备案。如果要绑定域名,在中国大陆地域的服务器必须完成 ICP 备案。香港地域的 ECS 不需要备案。

最低配置要求是什么?

最低要求 2核2G 内存。1G 内存的实例可能导致 OpenClaw 容器 OOM 崩溃。推荐 2核4G 以获得更稳定的体验。磁盘至少需要 5GB 可用空间(Docker 镜像约 500MB + 系统开销)。

有学生优惠吗?

阿里云为学生和开发者提供优惠。通过阿里云"开发者计划"或"学生认证",可以以低至几元/月的价格获取 ECS 实例。具体优惠政策可在阿里云官网查看最新活动。

能用通义千问(Qwen)吗?

可以。在阿里百炼平台申请 API 密钥,然后在 OpenClaw 配置文件中添加通义千问作为模型提供商。阿里云 ECS 与百炼 API 同在阿里云内网,延迟极低。这是阿里云部署 OpenClaw 的独特优势之一。

相比 OpenClaw Launch,阿里云自建有什么优势?

阿里云自建的主要优势是数据完全在你的服务器上、可以接入国内模型(通义千问等)、国内用户访问延迟更低。但需要自行运维服务器、配置安全组、处理 Docker 和网络问题。如果你不需要这些,OpenClaw Launch 提供更简单的方案:$3/月,10 秒部署,零运维。

Docker 部署的详细配置文件怎么写?

配置文件的完整说明请参考 Docker 部署教程,其中包含 openclaw.json 的每个字段解释和示例。

不想折腾阿里云?

跳过服务器购买、安全组配置、Docker 安装,10 秒部署你的 OpenClaw AI 智能体。无需运维、直连所有海外 API。

一键部署