能否提供2026年阿里云OpenClaw(Clawdbot)的详细安装步骤

阿里云服务器

这是一份为您精心准备的 2026 年阿里云 OpenClaw (原 Clawdbot) 详细安装部署教程

本教程基于 阿里云轻量应用服务器 (Simple Application Server),这是目前性价比最高、最适合个人和中小团队部署机器人框架的方案。我们将采用 Docker 容器化部署 方式,相比传统手动安装,它具有环境隔离、一键迁移、永不冲突的优势。


📋 准备工作 (5 分钟)

在开始之前,请准备好以下“三要素”:

  1. 阿里云账号:已实名认证。

  2. 阿里云百炼 API Key (大脑):

    • 访问 阿里云百炼控制台

    • 点击左侧 “API-KEY 管理” -> “创建新的 API-KEY”

    • 复制 sk- 开头的字符串,保存好。

  3. 机器人平台凭证 (手脚):

    • 钉钉钉钉开放平台 创建应用,获取 AppKey, AppSecret

    • 飞书飞书开放平台 创建应用,获取 App ID, App Secret

    • (本教程以钉钉为例,飞书只需替换配置项)


🚀 第一阶段:购买与初始化服务器

1. 购买轻量应用服务器

  • 产品选择:搜索 “轻量应用服务器” (不要买成 ECS,那个配置复杂且贵)。

  • 镜像选择务必选择 DockerUbuntu 22.04

    • 推荐:直接选 Docker 镜像(如 Docker 24.x on Ubuntu 22.04),系统预装了 Docker,省去安装步骤。

    • 备选:如果只有 Ubuntu,后续我们会手动安装 Docker。

  • 套餐选择2核 CPU / 2GB 内存 / 40GB SSD / 30Mbps 带宽

    • 价格:新用户特惠约 ¥68 - ¥99 元/年

  • 密码设置:设置 root 登录密码 (截图保存!)。

2. 远程连接服务器

  1. 进入阿里云控制台 -> 轻量服务器列表 -> 点击实例卡片。

  2. 点击 “远程连接”

  3. 输入用户名 root 和密码登录。

  4. 看到 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. 开放防火墙端口

  1. 保持终端不动,打开浏览器回到阿里云 轻量应用服务器详情页

  2. 点击左侧菜单 “防火墙”

  3. 点击 “添加规则”

    • 端口8080 (与配置文件中 PORT 一致)

    • 协议TCP

    • 备注OpenClaw Webhook

    • 点击 确定


🏃 第三阶段:启动与验证

1. 启动容器

在终端执行:

docker compose up -d
  • -d 表示后台运行。

  • 如果提示 command not found,尝试使用旧版命令 docker-compose up -d

2. 查看运行状态

docker compose ps
  • 如果 STATE 显示 Up,说明启动成功。

  • 如果显示 ExitedRestarting,说明配置有误,请查看日志。

3. 查看实时日志 (调试神器)

docker compose logs -f
  • 观察是否有 Server started on http://0.0.0.0:8080 字样。

  • 如果有报错(如 InvalidApiKey, Connection refused),根据日志修改 docker-compose.yml 并重启 (docker compose up -d)。


🧪 第四阶段:对接机器人平台

  1. 获取公网 IP
    在阿里云服务器详情页找到 公网 IP (例如 47.100.xx.xx)。

  2. 配置回调地址

    • 注意:IP 换您的,端口换您配置的 (8080),路径 /callback 需根据 OpenClaw 实际文档确认(有的是 /dingtalk, /webhook)。

    • 登录 钉钉开放平台 -> 您的应用 -> 事件订阅

    • 回调地址填写:http://47.100.xx.xx:8080/callback

    • 加密密钥:如果配置文件里没配,这里留空;如果配了,两边必须一致。

    • 点击 “保存”“验证”

  3. 测试对话

    • 验证通过后,在钉钉群里 @机器人 发送:“你好”。

    • 观察 Docker 日志,应该能看到收到消息和回复的记录。


🔧 常用运维命令

  • 停止服务docker compose down

  • 重启服务docker compose restart

  • 更新版本

    docker compose pull  # 拉取最新镜像
    docker compose up -d # 重新创建容器
  • 查看日志docker compose logs -f


📎 附录:无 Docker 镜像替代方案 (Python 直跑)

如果找不到现成的 Docker 镜像,请按以下步骤手动运行 Python 代码(同样高效):

  1. 安装 Python 环境

    apt update && apt install -y python3 python3-pip git
  2. 下载代码

    cd /opt
    git clone https://github.com/OpenClawTeam/openclaw.git
    cd openclaw
  3. 安装依赖

    pip3 install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
  4. 配置 .env

    nano .env
    # (填入与上文 Docker 环境变量相同的内容)
  5. 安装 PM2 (进程守护)

    npm install -g pm2
  6. 启动服务

    pm2 start main.py --name openclaw --interpreter python3
    pm2 save
    pm2 startup

    (按提示复制最后一行命令执行,实现开机自启)


💡 2026 年特别提示

  • HTTPS 升级:如果未来钉钉/飞书强制要求 HTTPS,您可以购买一个域名解析到服务器,然后使用 Nginx Proxy Manager (也是一个 Docker 容器) 来反向代理 8080 端口并自动申请免费 SSL 证书。

  • 成本优化:轻量服务器新用户优惠仅限首年。次年续费会涨价,建议关注双11活动,或者在首年结束时迁移数据到新账号。

  • 数据备份:定期使用阿里云控制台的 “快照” 功能备份整个服务器磁盘,防止误操作导致数据丢失。

祝您部署顺利,早日拥有您的 24 小时 AI 智能员工!