生成模型：gpt-5.4 (openai/gpt-5.4) Token 消耗：输入 ~17k tokens，输出 ~4.2k tokens（估算，本节）
如果你准备把 OpenClaw 稳定跑在服务器上，Docker 基本是最省心的方案。原因很简单：环境一致、迁移方便、升级清楚，回滚也不至于手忙脚乱。尤其是在中国大陆环境里，镜像源、依赖安装、系统包差异都可能影响结果，容器化能帮你把这些问题压小很多。
这一节不深挖源码，只从部署视角看三件事：Dockerfile 在干嘛、docker-compose.yml 怎么配、生产环境还要补哪些安全和持久化设置。
8.3.1 先理解 Dockerfile：它不是魔法，就是一套可重复安装脚本
从部署角度看，OpenClaw 的 Dockerfile 有几个关键动作：
把它简化以后，大概可以理解成这样：
FROM node:22-bookworm
RUN corepack enable
WORKDIR /app
COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./
RUN pnpm install --frozen-lockfile
COPY . .
RUN pnpm build && pnpm ui:build
ENV NODE_ENV=production
USER node
CMD ["node", "openclaw.mjs", "gateway", "--allow-unconfigured"]
这里有几个点值得你记住。
很多人看到 Docker 第一反应就是追求镜像小，想换成 Alpine。但 OpenClaw 这类项目常常依赖更完整的系统库和原生模块，bookworm 这类 Debian 基础镜像更稳。镜像大一点，换来的是构建少踩坑，这笔账通常划算。
这是 Docker 层缓存最经典的用法。只要 package.json 和锁文件没变，重新构建时就不必重新安装所有依赖。你改了几行业务配置，不需要每次都把整个依赖树重下一遍。
这不是“高级玩法”，而是生产环境基本常识。容器不是绝对安全边界，但把服务放到普通用户下运行，至少能减少很多低级风险。
8.3.2 在中国大陆构建镜像时要注意什么
Docker 在国内最容易卡的，往往不是容器本身，而是拉基础镜像、拉 npm 包、安装系统依赖。你如果直接用默认源，构建速度可能非常难看。
不同云厂商都提供镜像加速器，通常可以把 Docker 的 daemon.json 配成这样：
重启 Docker：
如果你有额外系统依赖，也可以通过构建参数传进去：
8.3.3 docker-compose.yml 怎么看
很多人第一次看 Compose 文件，会觉得条目很多。其实你就盯住这几块：镜像、端口、环境变量、卷挂载、重启策略。
一个适合生产起步的示例可以写成这样：
这个文件里，最重要的是下面几项。
restart: unless-stopped
服务器重启后，容器会自动拉起来。对长期运行服务来说，这项很有用。
127.0.0.1:8945:8945
这表示只把端口绑定到本机回环地址，而不是直接暴露到公网。生产环境更推荐让 Nginx 反代到它，而不是让外网直接打容器端口。
把敏感配置放到独立文件里，别全塞进 Compose 里。这样你换环境也更清楚。
这项特别重要。没有卷挂载，容器一删，很多状态就没了。
8.3.4 环境变量怎么配才不乱
OpenClaw 的生产配置最好拆成三层：
env.production：密钥、Token、Secret。
一个 env.production 示例：
启动前先检查有没有漏变量：
正式环境里，建议不要把 .env 提交到仓库；也不要把真正的生产密钥放进镜像里。镜像应该是可复制的，密钥应该是运行时注入的。
8.3.5 哪些目录一定要做持久化
OpenClaw 不是那种“纯 stateless”的服务。至少下面几类数据，建议挂卷保留：
一个更完整的挂载示例：
为什么这一步重要？因为你后面升级镜像、替换主机、回滚版本，都要靠这些数据活下来。没有持久化，容器升级一次，配置和状态可能就重新开始了。
8.3.6 Docker Sandbox 为什么值得单独讲
OpenClaw 里有一类很敏感的能力：工具执行。尤其是 Bash、文件系统、浏览器自动化这类东西，一旦你允许 Agent 直接操作系统环境，安全问题就不能只靠“我相信模型不会乱来”。
Docker sandbox 的思路，就是把高风险执行面关进更小的隔离空间里。你可以把它理解成一层额外保险。
当然，它不是银弹。你把 docker.sock 整个暴露给容器，安全边界还是会被拉薄。所以生产里要看清楚：你到底是为了方便，还是为了真的隔离。
8.3.7 一个更接近生产的 Compose 样板
这里多了三样很有价值的东西：
8.3.8 常用命令别只记一个 up -d
下面这些命令，生产环境里都很常用：
如果你要升级版本，一个比较稳的习惯是：
先更新，再盯日志，不要更新完就走。
最后给你一份非常实用的检查清单。上线前，逐项过一遍：
Compose 文件里没有把内部端口直接暴露到公网。
所有 Secret 都通过环境变量注入，没有硬编码进镜像。
Sandbox 策略已开启，或者你清楚知道自己为什么没开。
如果你愿意再多做一步，建议加上备份：
别等故障发生以后才想起要备份。那时候通常已经晚了。
Docker 部署 OpenClaw 的核心，不在于把容器跑起来，而在于把镜像构建、环境变量、卷挂载、反向代理和 sandbox 一起收拾干净。Dockerfile 解决的是“怎么稳定打包”，Compose 解决的是“怎么长期运行”，生产配置解决的是“出了问题还能不能稳住”。在中国大陆环境下，再额外把镜像源、备案和跨境模型链路考虑进去，这套部署才算真的能用。