介绍如何在 Ubuntu 系统上通过 Docker 部署本地 AI 执行引擎 OpenClaw，并配置智谱 AI 作为模型提供商。内容包括环境准备、Docker 安装及镜像加速配置、服务启动、Token 获取及常见问题解决，确保数据隐私安全的同时实现任务自动化执行。
OpenClaw 是一款本地运行、可自托管的 AI 执行引擎，主打从建议到执行的能力跃迁。它并非被动响应的聊天机器人，而是能通过自然语言指令，自主规划并完成全流程任务的数字员工。与传统对话式 AI 工具不同，OpenClaw 的核心定位是本地优先，所有用户数据默认存储于用户自有设备，实现数据主权与隐私安全。
核心优势：跨平台支持、本地模型部署、安全隔离、场景适配、部署便捷
# 更新系统并安装必要工具
sudo apt update && sudo apt upgrade -y
sudo apt install -y ca-certificates curl gnupg lsb-release
# 添加 Docker 官方 GPG 密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
# 添加 Docker 仓库
echo "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
# 安装 Docker
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
# 配置镜像加速（请根据实际网络环境配置国内镜像源）
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
"registry-mirrors": [
"https://docker.m.daocloud.io"
]
}
EOF
# 重启 Docker 服务
sudo systemctl daemon-reload
sudo systemctl restart docker
# 验证安装
docker --version
docker compose version
重要提示：使用
docker compose命令时，必须将-d参数放在up命令之后，即docker compose up -d，否则会报错。
mkdir -p /opt/openclaw && cd /opt/openclaw
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。
xxxx.yyyy）# 启动 OpenClaw 服务（后台运行）
docker compose up -d
# 查看服务状态
docker compose ps
# 查看启动日志
docker compose logs -f
docker compose exec openclaw openclaw token generate --admin
http://<你的服务器 IP>:18789/?token=<生成的 Token>/etc/docker/daemon.json 中的国内镜像源CUSTOM_BASE_URL 是否为 https://open.bigmodel.cn/api/paas/v4CUSTOM_MODEL_ID 与智谱平台开通的模型一致docker-compose.yml 中的端口映射，如 - "18790:18789"environment:
- CUSTOM_MODEL_ID=glm-5
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 容器化部署，确保环境隔离与安全性
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online