Docker 安装

使用 Docker 部署 OpenClaw，适合服务器长期运行和环境隔离场景。

前置要求

• Docker 20.10+
• Docker Compose 2.0+（可选，推荐）

快速启动

从源码仓库一键启动：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
docker-compose up -d

这会自动拉取镜像、创建容器并在后台运行。

使用 Docker Compose（推荐）

如果你不想克隆整个仓库，可以手动创建 docker-compose.yml：

services:
  openclaw:
    image: ghcr.io/openclaw-ai/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "18789:18789"   # Gateway WebSocket
      - "3000:3000"     # Web UI 控制台
    volumes:
      - ~/.openclaw:/root/.openclaw    # 配置和状态
      - ~/openclaw/workspace:/workspace  # 工作空间
    environment:
      - NODE_ENV=production

启动：

docker compose up -d

查看日志：

docker compose logs -f openclaw

挂载目录说明

重要：正确挂载目录

挂载目录配置直接影响数据持久化和 Skill 运行，务必正确设置。

volumes:
  - ~/.openclaw:/root/.openclaw    # 配置、密钥、已安装的 Skills
  - ~/openclaw/workspace:/workspace  # 工作空间，Skill 运行的工作目录

宿主机路径	容器路径	说明
~/.openclaw	/root/.openclaw	存放配置文件、API Key、用户级 Skills、会话状态
~/openclaw/workspace	/workspace	工作空间，项目文件和项目级 Skills 放在这里

TIP

如果不挂载 ~/.openclaw，每次重建容器都会丢失配置和已安装的技能。

端口映射

端口	用途	说明
18789	Gateway WebSocket	核心通信端口，频道和客户端通过此端口连接
3000	Web UI	浏览器控制台，用于配置管理和会话监控

镜像变体

OpenClaw 提供多个 Docker 镜像变体，按需选择：

镜像标签	大小	说明
openclaw:latest	~500MB	标准镜像，包含所有功能
openclaw:slim	~200MB	精简镜像，不含浏览器引擎和媒体处理依赖
openclaw:sandbox	~600MB	沙箱镜像，Skill 执行在隔离环境中运行
openclaw:sandbox-browser	~1.2GB	沙箱 + 内置 Chromium，支持浏览器自动化

# 使用 sandbox-browser 变体
services:
  openclaw:
    image: ghcr.io/openclaw-ai/openclaw:sandbox-browser
    # ...

选择建议

• 个人使用、轻量部署：slim 镜像足够
• 需要浏览器自动化：选 sandbox-browser
• 生产环境：推荐 sandbox，Skill 在隔离沙箱中运行更安全

使用 docker run

docker run -d \
  --name openclaw \
  --restart unless-stopped \
  -p 18789:18789 \
  -p 3000:3000 \
  -v ~/.openclaw:/root/.openclaw \
  -v ~/openclaw/workspace:/workspace \
  ghcr.io/openclaw-ai/openclaw:latest

Podman 兼容

OpenClaw 完全兼容 Podman，无需修改即可使用：

# 使用 podman-compose
podman-compose up -d

# 或直接使用 podman
podman run -d \
  --name openclaw \
  --restart unless-stopped \
  -p 18789:18789 \
  -p 3000:3000 \
  -v ~/.openclaw:/root/.openclaw \
  -v ~/openclaw/workspace:/workspace \
  ghcr.io/openclaw-ai/openclaw:latest

访问 Web 控制台

启动后，浏览器访问：

http://localhost:3000/

Gateway WebSocket 地址：

ws://localhost:18789/

更新镜像

docker compose pull
docker compose up -d

ARM 设备

镜像同时支持 linux/amd64 和 linux/arm64，可直接在树莓派 4/5 或 Apple Silicon Mac 上运行。

下一步

• 引导式配置 --- 在容器内完成初始配置
• 5 分钟上手 --- 完成初始配置
• 频道配置 --- 连接聊天频道