Docker 部署 OpenClaw 本地 AI 引擎及智谱 AI 配置指南

注意：使用 docker compose 命令时，务必将 -d 参数放在 up 之后，即 docker compose up -d，否则可能报错。

部署 OpenClaw（智谱 AI 版）

创建部署目录

首先建立工作目录并进入其中：

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

编写 docker-compose.yml 文件

接下来创建配置文件。这里需要特别注意环境变量，我们将模型提供商设为自定义，以便接入智谱 AI。

version: '3.8'

services:
  openclaw:
    # 使用轩辕镜像源加速拉取
    image: docker.xuanyuan.run/alpine/openclaw:latest
    restart: unless-stopped
    ports:
      - "18789:18789"
    environment:
      # 设置模型提供商为自定义
      - MODEL_PROVIDER=custom
      
      # 智谱 AI API Key（需替换为你的实际 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。

获取智谱 AI API Key

1. 访问智谱开放平台。
2. 登录后点击右上角用户头像，选择'API 密钥'。
3. 点击'新建 API 密钥'，复制生成的 Key（格式通常为 xxxx.yyyy）。

启动服务

准备好后，即可启动容器：

# 后台启动 OpenClaw 服务
docker compose up -d

# 查看服务状态
docker compose ps

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

验证与访问

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

   docker compose exec openclaw openclaw token generate --admin
   

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

常见问题解决

• 镜像拉取失败：通常因网络问题导致无法访问 Docker Hub。请确保 /etc/docker/daemon.json 中的国内镜像源配置正确且网络通畅。
• 智谱 AI 连接失败：检查 API Key 是否正确，确认 CUSTOM_BASE_URL 为 https://open.bigmodel.cn/api/paas/v4，并核实 CUSTOM_MODEL_ID 与智谱平台开通的模型一致。
• 端口占用：若 18789 端口被占用，可修改 docker-compose.yml 中的端口映射，例如改为 - "18790:18789"。

进阶配置

切换模型版本

如需使用 GLM-5 模型，只需修改环境变量中的模型 ID：

environment:
  - CUSTOM_MODEL_ID=glm-5

Nginx 反向代理（生产环境推荐）

为了更安全的访问方式，建议配置 Nginx 进行反向代理并启用 HTTPS：

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 作为模型后端。这种架构既保证了数据隐私与安全，又提供了强大的任务执行能力。后续可根据实际需求调整模型版本或增加反向代理等安全措施。