OpenClaw Docker部署需先验证基础环境：执行docker --version和docker ps确认Docker已安装且守护进程运行，若权限错误则需加入docker组；再用docker compose version检查Compose插件；内存不低于4GB、磁盘不少于8GB，并确保对/var/run/docker.sock有读写权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw Docker部署需要先确认本地系统已具备运行容器化AI代理服务的基础能力，否则后续所有命令都会失败或报错。
检查Docker是否已安装并正常运行
执行 docker --version，若输出类似 Docker version 26.1.4, build xxxxxxx 的内容，说明Docker已安装；若提示 command not found，需先安装Docker。
再运行 docker ps，如果返回一个空表格（即列出容器列表但无运行中容器），说明Docker守护进程正在运行；【如果报错 Permission denied】，大概率是当前用户未加入 docker 用户组，需执行 sudo usermod -aG docker $USER 并重新登录终端生效。
验证Docker Compose是否可用
OpenClaw官方推荐使用 Docker Compose v2 进行服务编排，执行 docker compose version（注意是 compose 而非 -compose）。
若提示 Command "compose" not found，说明 Compose 插件未安装。Ubuntu/Debian 系统可直接通过 sudo apt install docker-compose-plugin 补全；CentOS/RHEL 用户请参考 Docker 官方文档下载二进制包手动安装。
完整的工作区安全套件：检测未授权修改，扫描提示注入模式，自动响应应对措施——快照恢复、技能隔离、Git回滚和自动保护扫描。智能体工作区的完整安装后安全层。
确认系统资源与权限配置
第一步：内存至少 4GB，【低于 3GB 会导致容器启动后立即 OOM 被杀】；可通过 free -h 查看可用内存。
第二步：磁盘剩余空间不少于 8GB，因为 OpenClaw 运行时会拉取 runtime 镜像、缓存模型元数据、保存工作区文件；执行 df -h / 查看根分区容量。
第三步：确保当前用户对 /var/run/docker.sock 有读写权限——这是 OpenClaw 容器内调用宿主机 Docker 的关键通道，权限缺失将导致沙箱无法创建子容器。
网络与镜像源准备
方法一：直连官方镜像仓库
确保能访问 docker.all-hands.dev 和 ghcr.io，OpenClaw 的核心镜像（如 all-hands-ai/runtime 和 all-hands-ai/openhands）均托管在这两个地址。
方法二：配置国内镜像加速（可选但推荐）
编辑 /etc/docker/daemon.json，添加如下内容后重启 Docker：{"registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"]}。这能显著加快镜像拉取速度，尤其在首次部署时。
