Linux系统阿里云ECS云服务器部署OpenClaw保姆教程：附全套可复制Shell安装代码

apphuang2026年07月11日 10:39:238

一、OpenClaw与部署方案概览

OpenClaw是一个开源的自主人工智能虚拟助理软件框架，支持多模型集成与多通道消息分发。它能够将Discord、Slack、WhatsApp、Notion等平台整合为可查询的本地数据源，并支持通过Gateway网关统一管理各类消息渠道与AI模型调用。在阿里云ECS上部署OpenClaw，主要有三条路径可选：手动Docker容器化部署、阿里云计算巢一键部署、以及云助手公共命令自动化部署。三种方式各有适用场景，手动部署灵活性最高，适合需要深度定制配置的用户；计算巢部署零门槛，适合新手快速体验；云助手方式则适合批量运维与免登录管理。本文将以手动Docker部署为主线，同时完整覆盖计算巢与云助手两种方式的操作步骤，所有命令均可直接复制执行。

二、部署前的准备工作

2.1 ECS实例选购建议

在阿里云上部署OpenClaw，建议ECS实例至少满足2核CPU、2GB内存的配置，推荐使用2核4GB以获得更稳定的运行体验。官方建议生产环境使用4vCPU、4GiB内存及以上的实例规格。操作系统方面，推荐选择Alibaba Cloud Linux 3、Ubuntu 22.04 LTS或Ubuntu 24.04。系统盘建议40GB以上，带宽根据实际使用需求选择即可。

需要先登录阿里云控制台，点击：阿里云控制台

2.2 安全组端口放行

安全组配置是部署前最关键的一步，直接影响服务能否被正常访问。OpenClaw默认使用18789端口作为Web控制台与Gateway通信端口。需要在ECS实例关联的安全组中，添加入方向规则放行TCP协议的18789端口。测试阶段可将授权对象设为0.0.0.0/0允许所有IP访问，服务正式上线后建议改为指定的IP白名单以增强安全性。此外，SSH远程连接所需的22端口也需要确保已放行。如果后续需要对接IM平台的消息回调，可能还需要放行80端口。

2.3 阿里云百炼API Key准备

OpenClaw的AI能力依赖大语言模型API，阿里云百炼平台提供了便捷的模型调用服务。部署前需要先开通百炼服务，进入百炼控制台的密钥管理页面，创建API Key。API Key的格式通常为sk-开头的一串字符，需要妥善保存，后续配置OpenClaw时会用到。新用户通常可以享受百炼的免费调用额度，足以满足日常开发测试需求。

三、方式一：手动Docker容器化部署（完整Shell代码）

手动Docker部署是灵活性最高的方式，适合需要对OpenClaw进行深度定制配置的场景。以下所有命令均基于Linux系统（Ubuntu 22.04 / Alibaba Cloud Linux 3）测试通过。

3.1 登录服务器与基础环境配置

使用SSH工具连接到ECS实例：

ssh root@你的服务器公网IP

关闭操作系统防火墙（不同系统命令略有差异）：

# Alibaba Cloud Linux / CentOS 系统
systemctl stop firewalld
systemctl disable firewalld
setenforce 0
sed -i 's/^SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config

# Ubuntu 系统
ufw disable

更新系统并安装基础依赖工具：

# Alibaba Cloud Linux / CentOS
yum update -y
yum install -y curl wget git python3 python3-pip

# Ubuntu
apt update -y
apt install -y curl wget git python3 python3-pip

3.2 安装Docker引擎

OpenClaw官方推荐使用Docker方式运行。执行以下命令一键安装Docker：

curl -fsSL https://get.docker.com | bash

安装完成后，启动Docker服务并设置开机自启：

systemctl start docker
systemctl enable docker

验证Docker是否安装成功：

docker --version

如果正确显示版本号，说明Docker已就绪。

3.3 拉取OpenClaw官方镜像

执行以下命令拉取OpenClaw最新稳定版镜像：

docker pull openclaw/openclaw:2026-latest

镜像体积较大，拉取时间取决于服务器带宽，请耐心等待。

3.4 创建数据持久化目录

为了确保容器重启后配置和数据不丢失，需要在宿主机上创建挂载目录：

mkdir -p /opt/openclaw/config
mkdir -p /opt/openclaw/logs
mkdir -p /opt/openclaw/data

3.5 启动OpenClaw容器

执行以下命令启动OpenClaw容器：

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 \
  -e TZ=Asia/Shanghai \
  openclaw/openclaw:2026-latest

命令执行后如果返回一长串容器ID，说明容器已成功启动。参数说明：-d表示后台运行；--name指定容器名称；--restart always确保容器异常退出后自动重启；-p将宿主机的18789端口映射到容器的18789端口；-v将宿主机的目录挂载到容器内实现数据持久化；-e TZ设置时区为上海。

3.6 验证容器运行状态

使用以下命令检查容器是否正常运行：

docker ps | grep openclaw

如果看到openclaw容器状态为Up，说明部署成功。也可以查看容器日志确认启动过程：

docker logs openclaw

四、方式二：阿里云计算巢一键部署（零基础首选）

阿里云计算巢为OpenClaw提供了官方一键部署能力，可自动完成ECS实例创建、环境配置、服务安装与基础参数设置，全程无需手动输入命令。这是零基础用户最便捷的部署方式。

4.1 进入计算巢部署页面

登录阿里云控制台后，访问计算巢OpenClaw社区版部署页面。在计算巢服务列表中，找到OpenClaw官方应用，点击立即创建进入部署配置页面。

4.2 填写部署配置参数

在部署配置页面需要填写以下信息：服务实例名称建议使用英文字母开头，可包含数字、短划线或下划线，例如Claw01。选择已规划的地域与可用区，建议选择资源充足的可用区避免创建失败。实例规格基础场景选择2vCPU、4GiB内存、40GB ESSD系统盘即可。网络类型选择专有网络，若无已有VPC则系统会自动创建。安全组需要添加两条入方向规则：放行TCP 18789端口（网关通信与控制台访问）和TCP 80端口（IM平台回调通信），授权对象设为0.0.0.0/0。

4.3 等待自动部署完成

点击创建后，计算巢会自动完成ECS实例创建、环境初始化、OpenClaw安装与基础配置全过程，通常只需3到5分钟即可完成。部署完成后，在计算巢控制台的实例列表中可以找到已创建的OpenClaw专属实例，点击实例ID进入详情页即可查看访问地址和配置信息。

五、方式三：云助手公共命令自动化部署

云助手是阿里云ECS提供的自动化运维工具，支持免登录执行脚本命令。通过云助手公共命令，可以快速完成OpenClaw的安装、部署与日常运维。

5.1 前置条件检查

使用云助手部署前，需要确认ECS实例已安装云助手Agent且状态正常。同时实例需要具备公网访问能力，以便拉取OpenClaw依赖包及模型配置。

5.2 执行公共命令

登录ECS控制台，进入云助手页面，在顶部选择目标实例所在地域。切换到公共命令页签，在搜索框中输入ACS-ECS-InstallOpenClaw，找到目标命令卡片后单击执行。

在执行命令窗口中需要配置以下关键参数：

INSTALL_METHOD：固定填写plugin
AUTH_CHOICE：模型供应商标识，例如modelstudio-standard-api-key-cn对应通义千问标准版
API_KEY：对应供应商的API Key

配置完成后选择目标ECS实例并执行命令。在命令执行记录页签可以查看执行状态，如果显示执行成功则说明OpenClaw已安装完成。

六、OpenClaw配置向导与模型接入

无论通过哪种方式完成部署，首次使用OpenClaw都需要进行基础配置。新版OpenClaw（2026.1.24+）提供了交互式配置向导，无需手动编辑配置文件。

6.1 进入配置向导

如果通过手动Docker方式部署，需要先进入容器内部执行配置命令：

docker exec -it openclaw openclaw onboard

如果是通过计算巢或云助手部署，可以直接在服务器终端执行：

openclaw onboard

6.2 配置向导步骤说明

配置向导会依次引导完成以下设置：选择模型提供商并配置API密钥或OAuth凭证，设置工作区目录用于存放智能体文件与记忆数据，配置Gateway网关的端口与绑定地址。在模型提供商选择环节，OpenClaw支持OpenAI、Anthropic、阿里云百炼、Ollama本地模型等多种选项。如果使用阿里云百炼，在向导中选择对应的提供商选项，然后输入之前准备好的API Key即可。

6.3 验证配置结果

配置完成后，可以通过以下命令测试API连接是否正常：

openclaw test

如果返回成功响应，说明OpenClaw已正确接入大模型服务，可以开始使用了。

七、服务验证与日常运维

7.1 访问Web控制台

OpenClaw部署成功后，可通过浏览器访问Web控制台：http://你的服务器公网IP:18789。首次访问时可能需要根据界面提示完成进一步的初始化配置。

7.2 常用运维命令

以下是在日常使用中常用的OpenClaw运维命令：

# 重启Gateway服务
openclaw gateway restart

# 查看服务状态
openclaw status

# 更新OpenClaw到最新版本
openclaw update

# 查看日志
openclaw logs

如果是Docker部署方式，也可以使用Docker命令进行管理：

# 停止容器
docker stop openclaw

# 启动容器
docker start openclaw

# 重启容器
docker restart openclaw

# 查看容器日志
docker logs -f openclaw

7.3 数据备份与恢复

手动Docker部署方式下，所有配置和数据都保存在/opt/openclaw目录中。建议定期备份该目录：

tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz /opt/openclaw/

需要恢复时，将备份文件解压到相同路径即可。

八、五大常见部署问题与解决方案

问题1：容器启动失败，端口被占用

如果18789端口已被其他服务占用，容器将无法正常启动。解决方案是修改端口映射，将宿主机端口改为其他可用端口，例如：

docker run -d --name openclaw --restart always -p 18790:18789 ...

将18789改为18790后，访问时使用新端口即可。

问题2：安全组未正确放行端口，无法访问Web控制台

这是最常见的问题之一。需要登录ECS控制台，检查实例关联的安全组入方向规则中是否包含18789端口的TCP放行规则。如果规则缺失，添加一条即可解决。

问题3：API Key配置错误或无效

如果OpenClaw无法调用大模型，首先检查API Key是否正确。确保百炼API Key已正确配置且未过期。可以在百炼控制台重新生成API Key并重新配置。

问题4：Docker镜像拉取速度慢或失败

国内访问Docker Hub可能速度较慢。可以配置阿里云容器镜像加速器，或使用国内镜像源。也可以在ECS控制台通过扩展程序方式安装Docker社区版。

问题5：容器数据丢失

如果容器被删除后配置丢失，通常是因为未正确挂载数据卷。确保在启动容器时使用了-v参数将配置目录挂载到宿主机。如果已经忘记挂载，可以先导出容器内数据再重新创建容器。

九、总结与进阶建议

本文完整介绍了在阿里云ECS Linux服务器上部署OpenClaw的三种主流方式。手动Docker部署提供了最大的灵活性，全套Shell命令均可直接复制执行；计算巢一键部署适合零基础用户快速上手；云助手公共命令则适合批量运维场景。无论选择哪种方式，部署完成后都需要通过配置向导完成模型提供商设置与Gateway网关配置。

对于进阶使用，还可以考虑以下优化方向：使用Docker Compose编排OpenClaw与其他辅助服务，接入更多消息渠道如钉钉、飞书等，配置自定义域名与HTTPS证书提升访问安全性，以及根据实际负载调整ECS实例规格。掌握这些技能后，OpenClaw将成为个人或团队工作中强大的AI助理工具。

常见问题解答

问1：部署OpenClaw的ECS实例最低配置要求是什么？
答：最低配置为2核CPU、2GB内存，推荐使用2核4GB以获得更稳定体验。生产环境建议使用4vCPU、4GiB及以上规格。操作系统推荐Alibaba Cloud Linux 3或Ubuntu 22.04 LTS。

问2：OpenClaw必须使用Docker部署吗？
答：不是必须的。除了Docker方式，还可以通过计算巢一键部署或云助手公共命令完成安装。Docker方式适合需要高度定制化配置的用户，而计算巢方式全程无需手动输入命令，更适合新手。

问3：部署后无法通过浏览器访问Web控制台怎么办？
答：首先检查ECS安全组是否已放行18789端口。其次确认容器是否正常运行，可以使用docker ps命令查看。最后检查服务是否监听在0.0.0.0而非127.0.0.1。

问4：OpenClaw支持哪些大模型提供商？
答：OpenClaw支持OpenAI、Anthropic、阿里云百炼、Ollama本地模型等多种主流提供商。通过配置向导可以方便地完成模型提供商的选择与API密钥配置。

问5：如何更新已部署的OpenClaw到最新版本？
答：Docker方式可以拉取最新镜像后重新创建容器：docker pull openclaw/openclaw:2026-latest，然后停止并删除旧容器，使用相同参数启动新容器即可。计算巢和云助手部署的方式可以在控制台执行对应的更新操作。

问6：OpenClaw的数据如何持久化保存？
答：Docker部署方式下，通过-v参数将容器内的配置、日志、数据目录挂载到宿主机目录实现持久化。建议定期备份/opt/openclaw目录下的所有内容。