Docker容器化部署是OpenClaw官方推荐的入门方式，隔离性强、命令统一、升级便捷，新手首选方案。

一、前置必看

• 提前安装Docker Desktop（Windows）或Docker Engine（Linux）
• 版本需符合官方最低要求：Docker ≥ 20.10+
• 关闭本地18789端口占用
• 全程使用管理员/root权限执行

二、Windows系统Docker部署

1. 前置环境检查

• 系统：Win10/Win11 64位
• 家庭版：提前装好WSL2
• 专业版/企业版：可选用Hyper-V模式
• 验证：Docker Desktop底部显示"Docker Desktop running"

2. 拉取OpenClaw官方镜像

docker pull openclaw/openclaw:latest

3. 一键启动容器

docker run -d `
  --name openclaw `
  -p 18789:18789 `
  -v openclaw-data:/app/data `
  --restart always `
  openclaw/openclaw:latest

参数说明：

参数	说明
-p 18789:18789	映射本地端口，浏览器直接访问
-v openclaw-data:/app/data	持久化存储，卸载容器后配置不丢失
--restart always	开机自启，无需手动重启

4. 访问验证

浏览器打开：http://localhost:18789

看到OpenClaw界面即部署成功。

三、Linux系统Docker部署

1. 安装Docker Engine

curl -fsSL https://get.docker.com | sh
sudo systemctl enable docker
sudo systemctl start docker

2. 拉取并启动

docker pull openclaw/openclaw:latest

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v openclaw-data:/app/data \
  --restart always \
  openclaw/openclaw:latest

3. 防火墙放行

sudo ufw allow 18789

四、常见问题排查

问题	解决方案
容器启动失败	检查18789端口是否被占用
拉取镜像超时	配置国内镜像加速源
权限拒绝	使用sudo或管理员权限
访问白屏	清除浏览器缓存或更换浏览器

五、卸载清理

# 停止并删除容器
docker stop openclaw
docker rm openclaw

# 删除镜像
docker rmi openclaw/openclaw:latest