执行步骤
- 先用官方 `docker-compose.yml` 启动，避免首版自定义编排导致排障复杂化。
- 上线前固定四项检查：容器健康、`ws://127.0.0.1:18789` 连通、Web UI 可访问、渠道回消息正常。
- 日志与配置必须落盘，确保升级失败时可回放与回滚。
- 每次升级保留可回滚镜像标签，不要直接覆盖 `latest`。
- 部署变更遵循单变量原则：一次只改镜像、配置或模型中的一项。
- 发布后跑 smoke checklist：消息收发、技能调用、关键任务执行、告警通道。
OpenClaw Docker 部署清单（含首次配置）
基于橙皮书部署章节，整理成可直接照抄的上线流程。
适用场景
本地已可用，准备上线到生产环境
预计阅读
10 分钟
完成结果
你会得到一个可回滚、可监控的上线版本
关键命令
docker compose up -d
docker ps | grep openclaw
curl http://127.0.0.1:3000常见风险
- 升级前不要跳过备份与回滚验证。
- 不要同时修改镜像、配置和模型策略。
高频失败案例
- 一次性改动过多变量，出问题后无法定位。
- 上线前没做回滚演练，故障恢复时间过长。
完成验收
- 线上可访问
- 关键链路可调用
- 日志无持续高危报错
官方入口
继续深入
先完成本页验收项，再看同分类文章，把流程串成完整闭环。