OpenClaw In Docker：一键部署 AI Agent 容器化环境完整教程

OpenClaw 是 2026 年爆火的开源 AI Agent 项目，GitHub 星标超过 25 万，成为平台最受欢迎的开源项目。它是一个能够自主执行复杂任务的 AI 虚拟助理，支持文件操作、流程编排、浏览器自动化、多 IM 平台交互等功能。

OpenClaw In Docker 是 cncfstack 组织推出的容器化部署方案，提供了一个类似虚拟机的隔离环境，让你能够一键运行 OpenClaw 服务，并提供安全的用户登录与 HTTPS 访问能力。

一、项目介绍

1.1 什么是 OpenClaw

OpenClaw 是由奥地利退休程序员 Peter Steinberger 于 2025 年 11 月发起的开源 AI Agent 项目。与传统的对话式聊天机器人不同，OpenClaw 定位为可代替用户执行任务的自主 AI 数字员工。

1.2 什么是 OpenClaw In Docker

OpenClaw In Docker 是 cncfstack 组织为 OpenClaw 提供的容器化部署方案，主要特点：

• 类虚拟机隔离环境：基于 csvm 项目提供 systemd 系统服务
• 用户登录认证：基于 OpenResty+Lua 提供安全的用户登录功能
• HTTPS 强制访问：必须使用 HTTPS 访问，默认使用 OpenSSL 自签证书
• 预装基础服务：openclaw、openresty、docker、cron、systemd、ssh 等
• 预装开发工具：chromium、playwright 等浏览器自动化工具

二、核心特性

2.1 技术架构

OpenClaw In Docker 采用容器化技术，将 OpenClaw 及其依赖环境打包成完整的镜像。

2.2 安全机制

三、环境准备

3.1 系统要求

3.2 安装 Docker

# Ubuntu/Debian 系统
curl -fsSL https://get.docker.com | bash

# 启动 Docker 服务
systemctl start docker
systemctl enable docker

# 验证安装
docker --version
docker info

sudo usermod -aG docker $USER
newgrp docker

四、快速开始

4.1 拉取镜像

# 从 Docker Hub 拉取镜像
docker pull cncfstack/openclaw-in-docker:latest

# 或者从阿里云镜像仓库拉取（国内更快）
docker pull registry.cn-hangzhou.aliyuncs.com/cncfstack/openclaw-in-docker:latest

4.2 创建数据目录

# 创建数据持久化目录
mkdir -p /opt/openclaw/{data,logs,certs}
cd /opt/openclaw

# 设置权限
chmod -R 755 /opt/openclaw

4.3 启动容器

# 启动 OpenClaw 容器
docker run -d \
  --name openclaw \
  -p 8443:8443 \
  -v /opt/openclaw/data:/data \
  -v /opt/openclaw/logs:/var/log \
  -v /opt/openclaw/certs:/certs \
  -e OPENCLAW_ADMIN_PASSWORD=your_password \
  --restart unless-stopped \
  cncfstack/openclaw-in-docker:latest

五、详细配置

5.1 环境变量配置

5.2 Docker Compose 部署

version: '3.8'

services:
  openclaw:
    image: cncfstack/openclaw-in-docker:latest
    container_name: openclaw
    ports:
      - "8443:8443"
    volumes:
      - ./data:/data
      - ./logs:/var/log
      - ./certs:/certs
    environment:
      - OPENCLAW_ADMIN_PASSWORD=your_secure_password
      - OPENCLAW_DEBUG=false
    restart: unless-stopped
    networks:
      - openclaw_net

networks:
  openclaw_net:
    driver: bridge

使用 Docker Compose 启动：

docker-compose up -d

六、证书配置

6.1 使用自签名证书（默认）

容器启动时会自动生成自签名证书，适用于测试环境。

6.2 使用 Let's Encrypt 免费证书

# 安装 certbot
apt-get update && apt-get install -y certbot

# 申请证书
certbot certonly --standalone -d your-domain.com

# 复制证书到容器
docker cp /etc/letsencrypt/live/your-domain.com/fullchain.pem openclaw:/certs/server.crt
docker cp /etc/letsencrypt/live/your-domain.com/privkey.pem openclaw:/certs/server.key

# 重启容器
docker restart openclaw

七、容器管理

7.1 查看容器状态

# 查看容器运行状态
docker ps | grep openclaw

# 查看容器日志
docker logs -f openclaw

# 查看资源使用情况
docker stats openclaw

7.2 停止和启动

# 停止容器
docker stop openclaw

# 启动容器
docker start openclaw

# 重启容器
docker restart openclaw

7.3 进入容器

# 进入容器内部
docker exec -it openclaw bash

# 查看 OpenClaw 配置
cat /data/config.yaml

八、设备审批

首次从新设备访问 OpenClaw 时，需要在管理员后台进行设备审批。

九、版本升级

# 1. 拉取最新镜像
docker pull cncfstack/openclaw-in-docker:latest

# 2. 停止旧容器
docker stop openclaw
docker rm openclaw

# 3. 启动新容器（使用相同的参数）
docker run -d \
  --name openclaw \
  -p 8443:8443 \
  -v /opt/openclaw/data:/data \
  -v /opt/openclaw/logs:/var/log \
  -v /opt/openclaw/certs:/certs \
  -e OPENCLAW_ADMIN_PASSWORD=your_password \
  --restart unless-stopped \
  cncfstack/openclaw-in-docker:latest

十、常见问题

Q1: 无法访问 HTTPS 页面？

Q2: 忘记密码怎么办？

# 进入容器
docker exec -it openclaw bash

# 重置密码
python /app/reset_password.py

# 按提示设置新密码

Q3: 如何备份数据？

# 备份数据目录
tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz /opt/openclaw/data

# 定期备份（添加到 crontab）
0 2 * * * tar -czf /backup/openclaw-$(date +\%Y%m\%d).tar.gz /opt/openclaw/data

Q4: 容器占用资源过高？

cnbugsai

打赏 海报 链接