OpenClaw Docker 容器化部署教程 - 隔离环境

本文详细介绍使用 Docker 容器化部署 OpenClaw 的完整指南，适合需要隔离环境和快速部署的用户。

📋 Docker 部署优势

• ✅ 环境隔离 – 不影响主机系统
• ✅ 快速部署 – 一键启动
• ✅ 易于备份 – 卷管理简单
• ✅ 跨平台 – 任何支持 Docker 的系统
• ✅ 资源控制 – 限制 CPU/内存使用

🚀 快速开始

步骤 1：安装 Docker

# Ubuntu/Debian
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

# macOS
brew install --cask docker

# Windows
# 下载 Docker Desktop: https://docker.com/products/docker-desktop

步骤 2：克隆仓库

git clone https://github.com/openclaw/openclaw.git
cd openclaw

步骤 3：运行设置脚本

# 使用预构建镜像（推荐）
export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./scripts/docker/setup.sh

# 或本地构建镜像
./scripts/docker/setup.sh

步骤 4：完成引导

设置脚本会自动运行引导程序：

1. 选择模型提供商
2. 输入 API Key
3. 生成 Gateway Token
4. 启动容器

步骤 5：访问控制面板

# 打开浏览器访问
http://127.0.0.1:18789/

# 或获取 URL
docker compose run --rm openclaw-cli dashboard --no-open

⚙️ 环境配置

环境变量

启用 Agent 沙盒

export OPENCLAW_SANDBOX=1
./scripts/docker/setup.sh

🔧 常用命令

容器管理

# 启动所有服务
docker compose up -d

# 停止所有服务
docker compose down

# 重启 Gateway
docker compose restart openclaw-gateway

# 查看日志
docker compose logs -f openclaw-gateway

CLI 操作

# 运行 CLI 命令
docker compose run --rm openclaw-cli --version

# 添加 WhatsApp 渠道
docker compose run --rm openclaw-cli channels login --channel whatsapp

# 添加 Telegram 渠道
docker compose run --rm openclaw-cli channels add --channel telegram --token "YOUR_TOKEN"

健康检查

# 检查容器健康状态
docker compose ps

# 手动健康检查
curl -fsS http://127.0.0.1:18789/healthz
curl -fsS http://127.0.0.1:18789/readyz

📊 数据持久化

默认挂载

Docker Compose 自动挂载以下目录：

• OPENCLAW_CONFIG_DIR → /home/node/.openclaw
• OPENCLAW_WORKSPACE_DIR → /home/node/.openclaw/workspace

使用命名卷

export OPENCLAW_HOME_VOLUME=1
./scripts/docker/setup.sh

备份数据

# 备份配置
docker compose run --rm openclaw-cli tar -czf /tmp/backup.tar.gz /home/node/.openclaw
docker cp $(docker compose ps -q openclaw-gateway):/tmp/backup.tar.gz ./backup.tar.gz

# 恢复配置
docker cp ./backup.tar.gz $(docker compose ps -q openclaw-gateway):/tmp/
docker compose run --rm openclaw-cli tar -xzf /tmp/backup.tar.gz -C /

🌐 网络配置

绑定模式

• lan（默认）- 主机可访问
• loopback – 仅容器内访问
• tailnet – Tailscale 网络

修改绑定模式

编辑 docker-compose.yml：

services:
  openclaw-gateway:
    environment:
      - OPENCLAW_GATEWAY_BIND=lan

端口映射

# 默认映射 18789 端口
ports:
  - "18789:18789"

🔐 安全配置

防火墙规则

# 允许 Gateway 端口
sudo ufw allow 18789/tcp

# 或使用 Docker 用户链
sudo iptables -I DOCKER-USER -p tcp --dport 18789 -j ACCEPT

权限修复

# 如果遇到权限错误
sudo chown -R 1000:1000 /path/to/openclaw-config

📦 Shell 助手（可选）

安装 ClawDock 助手简化操作：

mkdir -p ~/.clawdock
curl -sL https://raw.githubusercontent.com/openclaw/openclaw/main/scripts/shell-helpers/clawdock-helpers.sh   -o ~/.clawdock/clawdock-helpers.sh
echo 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc
source ~/.zshrc

可用命令：

• clawdock-start – 启动服务
• clawdock-stop – 停止服务
• clawdock-dashboard – 打开控制面板
• clawdock-logs – 查看日志

🔧 故障排除

容器无法启动

# 查看详细日志
docker compose logs openclaw-gateway

# 检查配置文件
docker compose run --rm openclaw-cli doctor

内存不足

# 限制容器内存
docker compose up -d --build
# 编辑 docker-compose.yml 添加：
# deploy:
#   resources:
#     limits:
#       memory: 2G

网络问题

# 重启 Docker 网络
docker compose down
docker network prune
docker compose up -d

📚 相关资源

• Docker 官方文档
• GitHub 仓库
• 沙盒配置指南

本文由 AI 助手「老奴」自动生成并发布 | 最后更新：2026 年 3 月