这是一份为您精心准备的 2026 年阿里云 OpenClaw (原 Clawdbot) 详细安装部署教程。
本教程基于 阿里云轻量应用服务器 (Simple Application Server),这是目前性价比最高、最适合个人和中小团队部署机器人框架的方案。我们将采用 Docker 容器化部署 方式,相比传统手动安装,它具有环境隔离、一键迁移、永不冲突的优势。
📋 准备工作 (5 分钟)
在开始之前,请准备好以下“三要素”:
阿里云账号:已实名认证。
阿里云百炼 API Key (大脑):
访问 阿里云百炼控制台。
点击左侧 “API-KEY 管理” -> “创建新的 API-KEY”。
复制
sk-开头的字符串,保存好。机器人平台凭证 (手脚):
🚀 第一阶段:购买与初始化服务器
1. 购买轻量应用服务器
产品选择:搜索 “轻量应用服务器” (不要买成 ECS,那个配置复杂且贵)。
镜像选择:务必选择
Docker或Ubuntu 22.04。推荐:直接选 Docker 镜像(如
Docker 24.x on Ubuntu 22.04),系统预装了 Docker,省去安装步骤。备选:如果只有 Ubuntu,后续我们会手动安装 Docker。
套餐选择:2核 CPU / 2GB 内存 / 40GB SSD / 30Mbps 带宽。
价格:新用户特惠约 ¥68 - ¥99 元/年。
密码设置:设置
root登录密码 (截图保存!)。
2. 远程连接服务器
进入阿里云控制台 -> 轻量服务器列表 -> 点击实例卡片。
点击 “远程连接”。
输入用户名
root和密码登录。看到
root@...:~#表示成功。
(如果您购买的是 Ubuntu 镜像而非 Docker 镜像,请先执行以下命令安装 Docker):
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun systemctl enable docker && systemctl start docker
🛠️ 第二阶段:获取 OpenClaw 与配置
1. 创建项目目录
mkdir -p /opt/openclaw cd /opt/openclaw
2. 获取配置文件
OpenClaw 通常通过 .env 文件或 docker-compose.yml 进行配置。我们直接创建一个标准的 docker-compose.yml 文件,它包含了所有启动参数。
nano docker-compose.yml
3. 填入配置内容 (关键步骤)
将以下内容复制并粘贴到编辑器中。请务必修改 environment 部分为您自己的 Key!
version: '3' services: openclaw: # 注意:此处镜像地址需替换为 OpenClaw 官方最新的 Docker 镜像地址 # 如果官方未提供 Docker 镜像,请参考文末的"无 Docker 镜像替代方案" image: registry.cn-hangzhou.aliyuncs.com/openclaw/openclaw:latest container_name: openclaw-bot restart: always network_mode: "host" # 使用主机网络模式,方便处理回调端口 environment: # --- 核心大模型配置 --- - DASHSCOPE_API_KEY=sk-你的真实百炼Key在这里 - MODEL_NAME=qwen-plus # 推荐 qwen-plus,省钱可用 qwen-turbo # --- 钉钉机器人配置 --- - DINGTALK_APP_KEY=你的钉钉AppKey - DINGTALK_APP_SECRET=你的钉钉AppSecret # - DINGTALK_CLIENT_ID=... (如有) # - DINGTALK_CLIENT_SECRET=... (如有) # --- 网络配置 --- - HOST=0.0.0.0 - PORT=8080 # 容器内端口,因使用了 host 模式,直接映射到服务器 8080 # --- 日志级别 --- - LOG_LEVEL=INFO volumes: # 挂载日志目录,方便查看 - ./logs:/app/logs # 如果有本地知识库或数据,也可以挂载 # - ./data:/app/data
保存:按
Ctrl + O->Enter。退出:按
Ctrl + X。
⚠️ 重要提示:关于 Docker 镜像
如果 OpenClaw 官方尚未发布正式的 Docker 镜像,或者您找不到上述镜像地址,请使用 “无 Docker 镜像替代方案” (见文末附录),直接运行 Python 脚本。以下步骤假设镜像存在或您已自行构建。
4. 开放防火墙端口
保持终端不动,打开浏览器回到阿里云 轻量应用服务器详情页。
点击左侧菜单 “防火墙”。
点击 “添加规则”:
端口:
8080(与配置文件中PORT一致)协议:
TCP备注:
OpenClaw Webhook点击 确定。
🏃 第三阶段:启动与验证
1. 启动容器
在终端执行:
docker compose up -d
-d表示后台运行。如果提示
command not found,尝试使用旧版命令docker-compose up -d。
2. 查看运行状态
docker compose ps
如果
STATE显示Up,说明启动成功。如果显示
Exited或Restarting,说明配置有误,请查看日志。
3. 查看实时日志 (调试神器)
docker compose logs -f
观察是否有
Server started on http://0.0.0.0:8080字样。如果有报错(如
InvalidApiKey,Connection refused),根据日志修改docker-compose.yml并重启 (docker compose up -d)。
🧪 第四阶段:对接机器人平台
获取公网 IP:
在阿里云服务器详情页找到 公网 IP (例如47.100.xx.xx)。配置回调地址:
注意:IP 换您的,端口换您配置的 (8080),路径
/callback需根据 OpenClaw 实际文档确认(有的是/dingtalk,/webhook)。登录 钉钉开放平台 -> 您的应用 -> 事件订阅。
回调地址填写:
http://47.100.xx.xx:8080/callback加密密钥:如果配置文件里没配,这里留空;如果配了,两边必须一致。
点击 “保存” 或 “验证”。
测试对话:
验证通过后,在钉钉群里
@机器人发送:“你好”。观察 Docker 日志,应该能看到收到消息和回复的记录。
🔧 常用运维命令
停止服务:
docker compose down重启服务:
docker compose restart更新版本:
docker compose pull # 拉取最新镜像 docker compose up -d # 重新创建容器
查看日志:
docker compose logs -f
📎 附录:无 Docker 镜像替代方案 (Python 直跑)
如果找不到现成的 Docker 镜像,请按以下步骤手动运行 Python 代码(同样高效):
安装 Python 环境:
apt update && apt install -y python3 python3-pip git
下载代码:
cd /opt git clone https://github.com/OpenClawTeam/openclaw.git cd openclaw
安装依赖:
pip3 install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
配置 .env:
nano .env # (填入与上文 Docker 环境变量相同的内容)
安装 PM2 (进程守护):
npm install -g pm2
启动服务:
pm2 start main.py --name openclaw --interpreter python3 pm2 save pm2 startup
(按提示复制最后一行命令执行,实现开机自启)
💡 2026 年特别提示
HTTPS 升级:如果未来钉钉/飞书强制要求 HTTPS,您可以购买一个域名解析到服务器,然后使用
Nginx Proxy Manager(也是一个 Docker 容器) 来反向代理 8080 端口并自动申请免费 SSL 证书。成本优化:轻量服务器新用户优惠仅限首年。次年续费会涨价,建议关注双11活动,或者在首年结束时迁移数据到新账号。
数据备份:定期使用阿里云控制台的 “快照” 功能备份整个服务器磁盘,防止误操作导致数据丢失。
祝您部署顺利,早日拥有您的 24 小时 AI 智能员工!