Docker 安装

前置条件

Docker — 从 docker.com 安装
Docker Compose（可选，推荐）

验证 Docker 已安装：

docker --version
# 期望输出：Docker version 24.x 或更高

快速启动

拉取并运行

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

使用 Docker Compose（推荐）

创建 docker-compose.yml 文件：

version: '3.8'

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    ports:
      - "18789:18789"
    volumes:
      - openclaw-data:/root/.openclaw
    environment:
      - OPENCLAW_HOME=/root/.openclaw
    restart: unless-stopped

volumes:
  openclaw-data:

启动服务：

docker compose up -d

配置

挂载配置文件

使用自定义配置时，挂载你的配置文件：

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  -v ./openclaw.json:/root/.openclaw/openclaw.json \
  openclaw/openclaw:latest

环境变量

变量	默认值	说明
`OPENCLAW_HOME`	`/root/.openclaw`	主目录
`OPENCLAW_STATE_DIR`	`$OPENCLAW_HOME/state`	状态目录
`OPENCLAW_CONFIG_PATH`	`$OPENCLAW_HOME/openclaw.json`	配置文件路径

容器管理

# 查看日志
docker logs -f openclaw

# 停止容器
docker stop openclaw

# 重启容器
docker restart openclaw

# 删除容器
docker rm -f openclaw

更新

# 拉取最新镜像
docker pull openclaw/openclaw:latest

# 重新创建容器
docker compose down
docker compose up -d

数据持久化

~/.openclaw 卷存储了：

配置文件（openclaw.json）
会话数据
记忆存储
渠道凭证

始终挂载此卷以在容器重启之间保持数据。

故障排除

容器立即退出

检查日志：

docker logs openclaw

端口冲突

更改主机端口映射：

docker run -d -p 18790:18789 openclaw/openclaw:latest

权限问题

确保挂载的卷具有正确的权限：

chmod -R 755 ~/.openclaw

下一步

快速开始 — 完整的设置指南
Windows 安装 — Windows 原生安装
macOS 安装 — macOS 原生安装
AI 模型集成 — 连接你的 AI 模型

Docker 安装

On this page