使用 Docker 部署 OpenClaw原 Clawdbot 等是“稳定版”推荐方式之一。它能将应用及其依赖如 Node.js、Python打包在一个隔离的容器中实现“一次配置随处运行”避免了环境冲突。⚠️ 重要提醒Docker 部署与安全风险当您通过 Docker 将 OpenClaw 服务暴露到公网时例如部署在 VPS 或云服务器上强烈建议您仔细阅读并实施官方文档的安全加固指南可以重点关注网络策略务必正确配置DOCKER-USER链防火墙规则限制对 Docker 服务及端口的非授权访问。最小权限严格遵循最小权限原则为应用和服务授权。OpenClaw 能直接操作您的文件系统或执行命令不安全的配置会带来严重风险。 部署前准备在开始前请确保你的环境满足以下基本要求操作系统建议使用 Linux 发行版如 Ubuntu Server或 Windows 的 WSL2 环境。硬件内存至少2GB。官方文档强调在 1GB 内存的主机上构建镜像可能因内存不足OOM而失败。存储确保有足够的磁盘空间来存放镜像和日志。软件DockerDocker Engine 20.10。Docker ComposeV2 版本以上。BashV4 或更高版本。网络服务器需要能正常访问外网以便拉取 Docker 镜像及相关依赖。 拉取 OpenClaw 稳定版镜像以下是获取官方稳定版镜像的三种方式。对于生产环境为了最大程度避免因镜像标签变动导致的不兼容风险建议选用第一种方式按需锁定一个已知良好的版本号使用。[首选方案] 方式一锁定特定版本号 (推荐用于生产环境)当你需要特定功能或确保环境稳定性时为生产环境指定明确的版本号是最佳实践。# 替换 v2026.4.20 为你需要的具体版本号dockerpull ghcr.io/openclaw/openclaw:v2026.4.20你也可以从 Docker Hub 拉取dockerpull openclaw/openclaw:v2.3.1方式二拉取最新稳定版 (latest标签)最简单的入门方式能让你快速体验 OpenClaw 的最新稳定功能。# 从 GitHub Container Registry (ghcr.io) 拉取dockerpull ghcr.io/openclaw/openclaw:latest# 或从 Docker Hub (docker.io) 拉取dockerpull openclaw/openclaw:latest方式三选择 stable 发布通道 (推荐用于订阅稳定版)如果你想订阅稳定的发布通道确保始终获得稳定的版本可以使用此方式。dockerpull ghcr.io/openclaw/gateway:latest# stable相关资料也提供了更新的通道选择如果工作流依赖稳定性建议留在 stable 通道。国内用户加速使用轩辕镜像针对国内网络环境的官方镜像拉取慢、超时问题可使用“轩辕镜像”加速。# 生产环境请固定版本号测试环境可临时使用beta标签dockerpull docker.xuanyuan.run/alpine/openclaw:2026.2.22-beta.1 生产环境部署使用docker-compose.yml是基于 Docker 部署 OpenClaw 生产环境的核心方式。Docker Compose 可以方便地定义和运行多容器应用并统一管理配置、数据卷和网络。核心路径解释OPENCLAW_CONFIG_DIR对应容器内/home/node/.openclaw用于持久化配置。OPENCLAW_WORKSPACE_DIR对应容器内/home/node/.openclaw/workspace是 OpenClaw 的工作空间目录。运行与配置步骤准备目录结构 (示例)在宿主机上创建一个工作目录如~/openclaw-docker并准备一个基础的docker-compose.yml文件。编写docker-compose.yml在目录中创建一个docker-compose.yml文件内容可参考下方基本模板。version:3.8services:openclaw-gateway:image:openclaw/openclaw:latest# 或你选择的其他稳定版标签container_name:openclawports:-18789:18789# 映射 Control UI 端口volumes:-./config:/home/node/.openclaw:rw# 挂载配置文件目录-./workspace:/home/node/.openclaw/workspace:rw# 挂载工作空间目录environment:-OPENCLAW_CONFIG_DIR/home/node/.openclaw-OPENCLAW_WORKSPACE_DIR/home/node/.openclaw/workspacerestart:unless-stopped执行新手引导/启动服务 (重要)这个步骤会引导你完成初始配置。请务必在常规启动前先运行以下命令来创建和配置容器# 进入 docker-compose.yml 所在目录执行引导命令dockercompose run--rm--no-deps--entrypointnodeopenclaw-gateway dist/index.js onboard--modelocal--no-install-daemon设置配置项 (可选用于批量配置)如果需要批量配置 Gateway 模式等可使用以下命令dockercompose run--rm--no-deps--entrypointnodeopenclaw-gateway dist/index.js configset--batch-json[{path:gateway.mode,value:local},{path:gateway.bind,value:lan},{path:gateway.controlUi.allowedOrigins,value:[http://localhost:18789,http://127.0.0.1:18789]}]启动服务完成以上配置后即可启动 OpenClaw 服务。dockercompose up-dopenclaw-gateway验证与访问启动后在浏览器中访问http://127.0.0.1:18789即可打开 OpenClaw 的 Control UI 界面开始使用。 常用命令速查查看日志docker logs openclaw | tail -n 20重启服务docker compose restart openclaw-gateway停止服务docker compose down更新镜像dockerpull openclaw/openclaw:latestdockercompose downdockercompose up-d 留意潜在问题OpenClaw 项目迭代非常频繁根据社区最新动态版本说明最新版本v2026.4.20被定位为“4月系列最终生产稳定版”强烈推荐生产环境使用。镜像渠道注意ghcr.io/openclaw/gateway:latest和ghcr.io/openclaw/openclaw:latest等不同镜像渠道的区别。前者是网关镜像后者是包含完整应用的镜像。脚本助手官方仓库提供了更智能的设置脚本可通过./scripts/docker/setup.sh自动完成新手引导、生成令牌和启动服务可简化手动配置流程。版本兼容如果你使用汉化版建议选择最新稳定版因为稳定版不加新功能旧版本可能无法支持新版插件。兼容性目前 OpenClaw 的基础镜像是Debian GNU/Linux bookworm-slim官方表示未来可能迁移至Alpine以精简体积。