阿里云CentOS上如何使用Docker部署OpenClaw并接入百炼大模型实用指南

作者：袖梨 2026-08-26

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“阿里云CentOS上如何采用Docker部署OpenClaw并接入百炼大……”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。

1. 环境准备
- 1.1 安装Docker和Docker Compose
- 1.2 设置Docker镜像加速I器（可选，国内建议）
- 1.3 开放阿里云安全组端口
2. 部署OpenClaw
- 2.1 新建项目目录
- 2.2 编写docker-compose.yml
- 2.3 新建设置目录并设置权限
- 2.4 编写openclaw.json设置文件
- 2.5 启动服务
- 2.6 查看日志确认启动成功
3. 访问与采用
- 3.1 Web界面访问
- 3.2 选择模型
- 3.3 验证模型调用
4. 常用问题解决
- 4.1 访问时提示“origin not allowed”
- 4.2 模型调用失败，提示“Unknown model”
5. 更新OpenClaw

理解这一步时，其实现在好多云厂商都出了 OpenClaw 的一键镜像，点几下就能跑起来。但我手里正好有台阿里云的虚拟机闲着也是闲着，打算在自己服务器上搭一下。而且我也不想让 AI 助手一直挂在本地的电脑上，占资源也不安全。至于大模型，我选了阿里云百炼，新用户还能领几千万的免费额度，对我这种自己玩玩的来说，够用一阵子。

1. 环境准备

1.1 安装Docker和Docker Compose

# 安装Docker
sudo yum install -y docker
sudo systemctl start docker
sudo systemctl enable docker
# 安装Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

1.2 设置Docker镜像加速I器（可选，国内建议）

sudo cat > /etc/docker/daemon.json << 'EOF'
{
  "registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

1.3 开放阿里云安全组端口

登录阿里云控制台，进入ECS实例的安全组，添加入方向规则：

端口：28789 //这个端口默认是18789，因为我之前部署过，所以换个新端口
协议：TCP
授权对象：0.0.0.0/0（或你的本地IP）

2. 部署OpenClaw

2.1 新建项目目录

mkdir ~/openclaw && cd ~/openclaw

2.2 编写docker-compose.yml

version: '3.8'
services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw
    ports:
      - "28789:18789"
    volumes:
      - ./openclaw-data:/home/node/.openclaw
    user: "1000:1000"
    restart: unless-stopped

2.3 新建设置目录并设置权限

mkdir -p openclaw-data
sudo chown -R 1000:1000 openclaw-data

2.4 编写openclaw.json设置文件

在openclaw-data/目录下新建openclaw.json：

cat > openclaw-data/openclaw.json << 'EOF'
{
  "gateway": {
    "bind": "lan",
    "port": 18789,
    "mode": "local",
    "auth": {
      "mode": "token",
      "token": "your-strong-token-here"
    },
    "controlUi": {
      "allowedOrigins": ["http://你的服务器公网IP:28789"],
      "dangerouslyDisableDeviceAuth": true
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "aliyun_bailian": {
        "api": "openai-completions",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "sk-你的阿里云百炼API-KEY",
        "models": [
          { "id": "qwen-max", "name": "通义千问 Max" },
          { "id": "qwen-plus", "name": "通义千问 Plus" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": "aliyun_bailian/qwen-max",
      "models": {
        "aliyun_bailian/qwen-max": {},
        "aliyun_bailian/qwen-plus": {}
      }
    }
  }
}
EOF

重要替换：

将your-strong-token-here改为你自己的强密码。
将你的服务器公网IP替换为阿里云ECS的公网IP。
将sk-你的阿里云百炼API-KEY替换为你在阿里云百炼控制台拿到的真实API Key。

2.5 启动服务

docker compose up -d

2.6 查看日志确认启动成功

docker logs openclaw --tail 50

出现类似[gateway] ready的日志即表示成功。

3. 访问与采用

3.1 Web界面访问

浏览器打开：（链接已移除）

结合项目来看，系统会提示输入Token，输入你在openclaw.json中设置的token值。

3.2 选择模型

从实现思路看，登录后，在聊天界面的模型下拉菜单中，选择aliyun_bailian/qwen-max或aliyun_bailian/qwen-plus，即可开始对话。

3.3 验证模型调用

发送消息，查看结果。

4. 常用问题解决

4.1 访问时提示“origin not allowed”

现象：浏览器访问时显示origin not allowed，WebSocket连接被拒绝。

解决方法：

确保openclaw.json中gateway.controlUi.allowedOrigins包含了你的完整访问地址（比如["（链接已移除）]）。
同时设置"dangerouslyDisableDeviceAuth": true（测试环境可用，生产环境建议设置HTTPS）。
修改后重启容器：docker compose restart。

4.2 模型调用失败，提示“Unknown model”

现象：日志中出现Unknown model: xxx。