Docker 部署 OpenClaw：智谱 AI 本地执行引擎集成指南

重要提示：使用 docker compose 命令时，必须将 -d 参数放在 up 命令之后，即 docker compose up -d，否则会报错。

三、部署 OpenClaw（智谱 AI 版）

1. 创建部署目录

bash

mkdir -p /opt/openclaw && cd /opt/openclaw

2. 创建 docker-compose.yml 文件

yaml

version: '3.8'

services:
 openclaw:
  # 使用镜像源加速拉取
  image: alpine/openclaw:latest
  restart: unless-stopped
  ports:
  - "18789:18789"
  environment:
  # 设置模型提供商为自定义
  - MODEL_PROVIDER=custom

  # 智谱 AI API Key（从智谱开放平台获取）
  - CUSTOM_API_KEY=your_zhipu_api_key

  # 智谱 AI 的 Base URL
  - CUSTOM_BASE_URL=https://open.bigmodel.cn/api/paas/v4

  # 使用的模型 ID（如 glm-4, glm-4-6b, glm-4-air）
  - CUSTOM_MODEL_ID=glm-4
  volumes:
  - ./data:/app/data
  - ./config:/app/config

替换说明：请将 your_zhipu_api_key 替换为你的智谱 AI API Key。

3. 获取智谱 AI API Key

1. 访问智谱开放平台 (https://bigmodel.cn/)
2. 登录后点击右上角用户头像 → "API 密钥"
3. 点击 "新建 API 密钥"，复制生成的 Key（格式通常为 xxxx.yyyy）

4. 启动服务

bash

# 启动 OpenClaw 服务（后台运行）
docker compose up -d

# 查看服务状态
docker compose ps

# 查看启动日志
docker compose logs -f

四、验证与访问

1. 获取 Token（用于访问 Web 界面）：

docker compose exec openclaw openclaw token generate --admin

1. 访问控制台： 在浏览器中打开 http://<你的服务器 IP>:18789/?token=<生成的 Token>
2. 验证 AI 功能： 在控制台发送一条消息，如 "你好"，应能收到智谱 AI 的回复。

五、常见问题解决

1. 镜像拉取失败

• 原因：网络问题导致无法访问 Docker Hub
• 解决：确保已正确配置 /etc/docker/daemon.json 中的国内镜像源

2. 智谱 AI 连接失败

• 原因：API Key 错误或 Base URL 不正确
• 解决：
  1. 确认 API Key 正确无误
  2. 检查 CUSTOM_BASE_URL 是否为 https://open.bigmodel.cn/api/paas/v4
  3. 确认 CUSTOM_MODEL_ID 与智谱平台开通的模型一致

3. 端口占用

• 原因：18789 端口被其他服务占用
• 解决：修改 docker-compose.yml 中的端口映射，如 - "18790:18789"

六、进阶配置

1. 使用 GLM-5 模型

yaml

environment:
 - CUSTOM_MODEL_ID=glm-5

2. 配置 Nginx 反向代理（生产环境推荐）

nginx

server {
 listen 443 ssl;
 server_name your-domain.com;

 ssl_certificate /etc/nginx/ssl/cert.pem;
 ssl_certificate_key /etc/nginx/ssl/key.pem;

 location / {
  proxy_pass http://localhost:18789;
  proxy_set_header Host $host;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header X-Forwarded-Proto $scheme;
 }
}

七、总结

通过本文，你已成功使用 Docker 在本地部署了 OpenClaw，并配置了智谱 AI 作为模型提供商。OpenClaw 作为一款本地运行的 AI 执行引擎，能够让你在保证数据隐私的同时，享受强大的 AI 任务执行能力。

核心要点：使用国内镜像加速 Docker 安装，解决网络问题通过环境变量配置智谱 AI，实现无缝对接通过 Docker 容器化部署，确保环境隔离与安全性