用 Docker 部署 OpenClaw：完整安装指南（2026）

你想让 AI Agent 全天候运行。不是在你合上盖子就休眠的笔记本上，不是在 Windows 决定更新时就重启的机器上。你想要它始终在线、始终就绪、始终工作。

Docker 让这变得极其简单。一个配置文件，一条命令，你的 OpenClaw Agent 就在一个隔离的容器中运行——可以部署到任何地方：你的 VPS、家庭服务器，甚至树莓派。

本指南从零开始带你用 Docker 部署 OpenClaw。不需要 Docker 经验。

为什么用 Docker 部署 OpenClaw？

你可以直接用 npm install -g openclaw 在系统上安装 OpenClaw。测试没问题。但对于生产环境——Agent 持续运行、处理真实任务、需要在服务器重启后存活——Docker 提供了三个原生安装没有的优势：

隔离性 — OpenClaw Agent 在自己的容器中运行，有自己的依赖。不会与服务器上的其他软件冲突。

可复现性 — 整个配置定义在一个 docker-compose.yml 文件中。迁移到新服务器？复制文件，运行一条命令，搞定。

轻松更新 — 拉取最新镜像，重启容器。没有依赖地狱，没有升级故障。

前置条件

开始之前，你需要：

一台服务器或电脑 — 任何 Linux 机器都行。推荐 Ubuntu 22.04+。$5/月的 VPS 就够了。
安装 Docker — 下面会介绍。
AI 模型 API 密钥 — OpenAI、Anthropic 或 Google。或者用 Ollama 运行免费本地模型。

在 Ubuntu/Debian 上安装 Docker：

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

登出再登入，然后验证：

docker --version
docker compose version

Docker Compose 配置（分步教程）

第 1 步：创建项目目录

mkdir ~/openclaw && cd ~/openclaw

第 2 步：创建 docker-compose.yml

version: '3.8'
services:
  openclaw:
    image: openclawai/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - ./workspace:/root/.openclaw
      - ./data:/data
    env_file:
      - .env

第 3 步：创建 .env 文件

添加你的 API 密钥（不要提交到 git）：

OPENCLAW_MODEL=anthropic/claude-sonnet-4-20250514
ANTHROPIC_API_KEY=sk-ant-your-key-here

第 4 步：初始化工作区

mkdir -p workspace data
docker compose run --rm openclaw openclaw init

第 5 步：启动 OpenClaw

docker compose up -d

搞定。查看日志：

docker compose logs -f openclaw

使用 Ollama 运行免费本地模型

不想付 API 费用？在 Docker Compose 中同时运行 Ollama：

version: '3.8'
services:
  openclaw:
    image: openclawai/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - ./workspace:/root/.openclaw
      - ./data:/data
    env_file:
      - .env
    depends_on:
      - ollama

  ollama:
    image: ollama/ollama:latest
    container_name: ollama
    restart: unless-stopped
    volumes:
      - ollama_data:/root/.ollama
    ports:
      - "11434:11434"

volumes:
  ollama_data:

更新 .env：

OPENCLAW_MODEL=ollama/llama3.1
OLLAMA_HOST=http://ollama:11434

启动后拉取模型：

docker compose exec ollama ollama pull llama3.1

现在你的 Agent 完全在自己的硬件上运行——零 API 成本，完全隐私。

常用 Docker 命令

docker compose up -d                          # 启动
docker compose down                            # 停止
docker compose logs -f openclaw                # 查看日志
docker compose restart                         # 配置更改后重启
docker compose pull && docker compose up -d    # 更新到最新版
docker compose exec openclaw bash              # 进入容器
docker stats openclaw                          # 查看资源使用

故障排除

容器无法启动？ — 检查 docker compose logs openclaw，查看是否缺少 API 密钥或端口冲突。

Agent 没有响应？ — 验证容器正在运行：docker compose ps，检查日志中的 API 错误。

磁盘空间不足？ — 运行 docker system prune -a。

工作区更改未持久化？ — 确保卷正确挂载。workspace/ 目录应包含你的 AGENTS.md、SOUL.md 等。

常见问题

OpenClaw 在 Docker 中需要多少内存？

OpenClaw 本身需要约 512MB。加上 Ollama 运行 7B 模型，计划 8GB 总内存。仅 API 模式（无本地模型）在 1GB 上运行良好。

如何在 Docker 中更新 OpenClaw？

docker compose pull
docker compose up -d

你的工作区数据通过更新持久化，因为它存储在挂载的卷中。

Docker 是 OpenClaw 必需的吗？

不是。你可以直接用 npm install -g openclaw 安装。Docker 推荐用于生产部署，因为隔离性和易于更新。

想要托管 VPS 方案？在 Hostinger VPS 上安装 OpenClaw。

OpenClaw 新手？如何构建 AI Agent。

需要技能？OpenClaw 技能指南。