一、项目介绍
OpenClaw 是一款本地运行、可自托管的 AI 执行引擎,主打从建议到执行的能力跃迁。它并非被动响应的聊天机器人,而是能通过自然语言指令,自主规划并完成全流程任务的数字员工。与传统对话式 AI 工具不同,OpenClaw 的核心定位是本地优先,所有用户数据默认存储于用户自有设备,实现数据主权与隐私安全。
核心优势:跨平台支持、本地模型部署、安全隔离、场景适配、部署便捷
二、环境准备
1. 系统要求
- 操作系统:Ubuntu 20.04+/Debian 11+(推荐)
介绍如何在 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