第3章 Docker 一键部署 OpenClaw
全程对标 OpenClaw 官方文档、步骤可直接复制执行，双系统全覆盖：Windows 家庭版/专业版、Linux（Ubuntu 22.04+），承接上一章环境准备，零基础也能一次性部署成功第2章：OpenClaw 安装部署准备工作
前言
上一章我们做完了硬件、系统、NVM、Node 环境全部前置检查，这一章直接上最简单、最省心、最不容易翻车的方案：👉Docker 容器化部署 OpenClaw
为什么优先推荐 Docker 部署？
➡️不用折腾本地复杂依赖、不用纠结系统环境冲突，契合官方“低门槛部署”理念；
➡️跨系统统一命令，Windows / Linux 操作逻辑基本一致；
➡️一键拉取镜像、一键启动、一键卸载，隔离性极强，官方推荐新手优先选择；
➡️完全贴合 OpenClaw 官方推荐部署方式，兼容性最稳，后续升级更便捷。
一、前置必看（双系统通用，严格对标官方要求）
➡️提前安装 Docker Desktop（Windows）/ Docker Engine（Linux），版本需符合官方最低要求（Docker ≥ 20.10+）；
➡️关闭本地 18789 端口占用（OpenClaw 默认核心端口，官方固定配置，不可随意修改）；
➡️全程使用管理员/root 权限执行，避免权限报错（官方明确要求，否则无法正常启动容器）；
二、Windows 系统 Docker 部署教程（官方适配版）
1、Windows 前置环境（严格对照官方系统要求）
➡️系统要求：Win10 / Win11 64位（官方最低要求，32位系统不支持）；
➡️家庭版：提前装好 WSL2（上一章有完整安装指令，官方明确家庭版需通过 WSL2 运行 Docker）；
➡️专业/企业版：可选用 Hyper-V 模式运行 Docker（官方推荐，适配性更优）；
➡️关键检查：Docker Desktop 正常启动，底部显示“Docker Desktop running”即为服务正常。
2、拉取 OpenClaw 官方镜像（官方指定镜像地址）
打开 PowerShell（管理员模式），直接复制执行：
docker pull openclaw/openclaw:latest
自动拉取官方最新稳定镜像，无需手动选版本，官方默认推荐 latest 版本；
国内下载慢可配置 Docker 镜像加速源（官方未强制要求，属于优化建议，不影响部署）。
3、一键启动容器（核心命令，完全对照官方文档）
docker run -d \--name openclaw \-p 18789:18789 \-v openclaw-data:/app/data \--restart always \openclaw/openclaw:latest
-p 18789:18789：映射本地端口，与官方默认端口保持一致，浏览器直接访问即可；-v：持久化存储，官方推荐配置，卸载容器后配置、数据不丢失；--restart always：开机自启，官方建议长期使用时配置，无需手动重启服务。
4、访问 & 验证是否部署成功（官方标准验证方式）
浏览器打开地址（官方指定访问地址）：http://localhost:18789
✅ 正常加载出 OpenClaw 后台界面 = 部署完成（与官方验证标准一致）
5、Windows 常用运维命令
查看运行状态
三、Linux 系统 Docker 部署教程
适配系统：Ubuntu 22.04 LTS（官方重点适配版本）、Ubuntu 20.04 LTS（兼容版本），主流服务端版本均适用
1、Linux 前置依赖（官方推荐安装步骤）
未安装 Docker 环境则复制执行以下命令（官方标准安装流程，无多余步骤）：
sudo apt updatesudo apt install docker.io -ysudo systemctl start dockersudo systemctl enable docker
2、拉取官方镜像（与 Windows 一致，官方统一镜像）
sudo docker pull openclaw/openclaw:latest
3、放行防火墙关键端口（必做，官方明确要求）
服务器必须开放 18789 端口，否则外部无法访问（官方部署必做步骤）：
sudo ufw allow 18789/tcpsudo ufw reload
4、启动 OpenClaw 容器（与 Windows 核心命令一致，官方统一配置）
sudo docker run -d \--name openclaw \-p 18789:18789 \-v openclaw-data:/app/data \--restart always \openclaw/openclaw:latest
5、访问测试（官方标准访问方式）
本地访问（服务器本地操作）：http://localhost:18789
服务器访问（外部访问）：http://服务器IP:18789（需确保云服务器安全组放行 18789 端口，官方补充提示）
6、Linux 常用运维指令
查看容器日志
sudo docker logs openclaw
进入容器内部调试
sudo docker exec -it openclaw bash
彻底卸载清空数据
sudo docker rm -f openclaw && sudo docker volume rm openclaw-data
四、双系统通用常见报错排查
❗18789 端口被占用官方解决方案：关闭本地冲突软件，或修改映射端口（格式：-p 自定义端口:18789），确保容器端口与官方默认一致。
❗Docker 启动失败Windows：检查 WSL2 / Hyper-V 是否正常（官方排查优先级）；Linux：检查 docker 服务状态systemctl status docker，按提示修复服务。
❗页面打不开、空白官方排查顺序：优先检查防火墙、云服务器安全组是否放行 18789 端口，再检查容器是否正常运行（docker ps 查看）。
❗镜像拉取超时官方优化建议：配置国内 Docker 镜像加速，解决下载慢、超时问题，不影响部署兼容性。
五、本章小结（贴合官方部署理念，无偏离）
Docker 是 OpenClaw 官方优选部署方案，低配置、低门槛、零环境冲突，新手优先选择；
Windows 依靠 WSL2 / Hyper-V 运行 Docker，家庭版、专业版均完全适配，符合官方系统要求；
Linux 服务端部署更适合长期挂机、稳定运行，官方重点适配 Ubuntu 22.04 LTS 版本；
统一端口、统一容器命令，后续升级、迁移、重装都极度方便，契合官方部署逻辑。
下一章预告
下一章我们讲解：本地ollama/npm部署 OpenClaw 全过程，适合需要二次开发、插件深度改造、自定义功能的进阶玩家，搭配上一章配置的 NVM 环境，全程手把手配置，完全对照官方源码部署文档。
💡 合集专属福利
回复关键词「OpenClaw准备」，就能领取：工具官方链接、安装步骤截图、报错速查表，省得大家到处找资源～
关注「AI+科研院」，免费领福利，后续教程持续更新，陪大家一起搞定OpenClaw！
夜雨聆风
