Docker安装OpenClaw：使用智谱AI的完整指南（国内镜像加速版）

一、项目介绍

OpenClaw是一款本地运行、可自托管的AI执行引擎，主打"从给建议到做事情"的能力跃迁——它并非被动响应的聊天机器人，而是能通过自然语言指令，自主规划并完成全流程任务的"数字员工"。与传统对话式AI工具不同，OpenClaw的核心定位是本地优先，所有用户数据默认存储于用户自有设备，彻底实现数据主权与隐私安全自主。

核心优势：跨平台支持、本地模型部署、安全隔离、场景适配、部署便捷

二、环境准备

1. 系统要求

• 操作系统：Ubuntu 20.04+/Debian 11+（推荐）
• 内存：最低2GB，推荐4GB以上
• 硬盘：至少500MB可用空间
• 网络：稳定联网（用于下载依赖，调用云端AI需联网）

2. 安装Docker（国内镜像加速版）

bash

1# 更新系统并安装必要工具
2sudo apt update && sudo apt upgrade -y
3sudo apt install -y ca-certificates curl gnupg lsb-release
4
5# 添加Docker官方GPG密钥
6curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg –dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
7
8# 添加Docker仓库
9echo "deb [arch=$(dpkg –print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
10
11# 安装Docker
12sudo apt update
13sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
14
15# 配置国内镜像加速（轩辕镜像）
16sudo mkdir -p /etc/docker
17sudo tee /etc/docker/daemon.json <<-'EOF'
18{
19 "registry-mirrors": [
20 "https://docker.xuanyuan.run",
21 "https://docker.m.daocloud.io"
22 ]
23}
24EOF
25
26# 重启Docker服务
27sudo systemctl daemon-reload
28sudo systemctl restart docker
29
30# 验证安装
31docker –version
32docker compose version

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

三、部署OpenClaw（智谱AI版）

1. 创建部署目录

bash

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

2. 创建docker-compose.yml文件

yaml

1version: '3.8'
2
3services:
4 openclaw:
5 # 使用轩辕镜像源加速拉取
6 image: docker.xuanyuan.run/alpine/openclaw:latest
7 restart: unless-stopped
8 ports:
9 – "18789:18789"
10 environment:
11 # 设置模型提供商为自定义
12 – MODEL_PROVIDER=custom
13
14 # 智谱AI API Key（从智谱开放平台获取）
15 – CUSTOM_API_KEY=your_zhipu_api_key
16
17 # 智谱AI的Base URL
18 – CUSTOM_BASE_URL=https://open.bigmodel.cn/api/paas/v4
19
20 # 使用的模型ID（如glm-4, glm-4-6b, glm-4-air）
21 – CUSTOM_MODEL_ID=glm-4
22 volumes:
23 – ./data:/app/data
24 – ./config:/app/config

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

3. 获取智谱AI API Key

4. 启动服务

bash

1# 启动OpenClaw服务（后台运行）
2docker compose up -d
3
4# 查看服务状态
5docker compose ps
6
7# 查看启动日志
8docker compose logs -f

四、验证与访问

1docker compose exec openclaw openclaw token generate –admin

五、常见问题解决

1. 镜像拉取失败

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

2. 智谱AI连接失败

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

3. 端口占用

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

六、进阶配置

1. 使用GLM-5模型

yaml

1environment:
2 – CUSTOM_MODEL_ID=glm-5

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

nginx

1server {
2 listen 443 ssl;
3 server_name your-domain.com;
4
5 ssl_certificate /etc/nginx/ssl/cert.pem;
6 ssl_certificate_key /etc/nginx/ssl/key.pem;
7
8 location / {
9 proxy_pass http://localhost:18789;
10 proxy_set_header Host $host;
11 proxy_set_header X-Real-IP $remote_addr;
12 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
13 proxy_set_header X-Forwarded-Proto $scheme;
14 }
15}

七、总结

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

核心要点：