用Docker部署OpenClaw，一分钟搞定！

手把手教你一键部署OpenClaw（Clawdbot）。

程序员沐心

3035人浏览 · 2026-02-21 21:51:07

程序员沐心 · 2026-02-21 21:51:07 发布

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

简介

OpenClaw 这款 AI 代理平台功能挺猛的，要是想省事，直接用 Docker 部署是最快的，环境分分钟就能搭好。这就手把手教大伙儿怎么用 Docker 把它跑起来，顺便聊聊碰到问题该咋调试。

前置要求

Docker 引擎版本得在 20.10 以上。
Docker Compose 版本不能低于 v2.0.0。
内存最好别太抠，空闲个 4GB 比较稳。
硬盘空间留个 10GB 出来备用。
网得通畅，不然拉镜像能急死人。
手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

快速部署

1. 创建项目目录

先搞个专门的文件夹放这项目，然后切进去：

mkdir openclaw-docker && cd openclaw-docker

2. 创建Docker Compose文件

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！
整一个名叫 docker-compose.yml 的配置文件：

version: '3.8'

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    ports:
      - "3000:3000"
    volumes:
      - ./data:/app/data
      - ./config:/app/config
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - NODE_ENV=production
      - TZ=UTC
    restart: unless-stopped
    networks:
      - openclaw-net

networks:
  openclaw-net:
    driver: bridge

3. 启动服务

敲一行命令，让它在后台跑起来：

docker-compose up -d

4. 检查服务状态

看一眼服务是不是真的活了：

docker-compose ps

配置详解

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

环境变量

NODE_ENV: 设定跑的是开发环境还是生产环境 (development/production)。
TZ: 这一块是设时区的，比如 Asia/Shanghai。
OPENCLAW_PORT: 服务对外开口的端口，默认是 3000。
OPENCLAW_HOST: 绑定的 IP 地址，默认 0.0.0.0 全开放。

数据卷说明

/app/data: 这里面存的是工作数据和它的“记忆”。
/app/config: 专门放配置文件的地方。
/var/run/docker.sock: 这个是为了让容器能跟外面的宿主机 Docker 通信，属于核心通道。

端口映射

容器里面的 3000 端口 → 对应宿主机的 3000 端口。
如果宿主机端口被占了，你自己看着改就行。

调试方法

1. 查看实时日志

盯着日志看它到底在干啥：

docker logs -f openclaw

2. 进入容器调试

直接钻进容器肚子里去排查：

docker exec -it openclaw bash

3. 查看容器资源使用情况

瞅瞅它到底吃了多少 CPU 和内存：

docker stats openclaw

4. 重启服务

遇事不决重启试试：

docker-compose restart openclaw

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

5. 更新镜像

想升级到最新版，就把镜像拉一下再重启：

docker-compose pull
docker-compose up -d

6. 检查配置文件

进到容器里头，看看配置文件长啥样：

cat /app/config/config.json

常见问题

Q: 网页界面怎么打不开？

A: 先看看防火墙挡没挡，端口映射对不对，再用 docker-compose ps 确认下服务是不是挂了。

Q: 容器死活启动不了？

A: 赶紧查详细日志 docker logs openclaw，多半是配置文件写错了或者权限没给够。
手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

Q: 内存爆了咋办？

A: 去 docker-compose.yml 里面给它加个紧箍咒，限制一下资源消耗：

deploy:
  resources:
    limits:
      memory: 4G
    reservations:
      memory: 1G

Q: 数据怎么丢了？

A: 挂载路径得写对啊，平时没事多把 /app/data 目录备份一下，有备无患。

维护命令

停止服务

彻底把服务关停：

docker-compose down

重新加载配置

改了配置想强制刷新一下：

docker-compose up -d --force-recreate

清理未使用的镜像

把那些没用的镜像垃圾清一清：

docker system prune -f

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

备份数据

把数据打包带走：

tar -czvf openclaw-backup-$(date +%Y%m%d).tar.gz ./data/

恢复数据

把备份包解压回去：

tar -xzvf openclaw-backup-[date].tar.gz -C ./

扩展配置

使用自定义配置文件

如果你想玩点高级的，用自己的配置文件：

version: '3.8'

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    ports:
      - "3000:3000"
    volumes:
      - ./data:/app/data
      - ./config:/app/config
      - ./custom-config.json:/app/config.json:ro
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - NODE_ENV=production
      - TZ=Asia/Shanghai
      - OPENCLAW_PORT=3000
    restart: unless-stopped
    networks:
      - openclaw-net
    depends_on:
      - redis
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

  redis:
    image: redis:alpine
    container_name: openclaw-redis
    volumes:
      - redis_data:/data
    restart: unless-stopped
    networks:
      - openclaw-net

volumes:
  redis_data:

networks:
  openclaw-net:
    driver: bridge