openclaw docker部署

OpenClaw Docker 部署(含 compose 示例)

满足“openclaw docker部署 / 本地部署”用户意图,提供容器化标准路径。

最后更新: 2026-03-11

  • 容器网络仅暴露必要端口
  • 敏感变量进入 .env
  • 上线前先压测和健康检查
openclaw docker部署openclaw docker composeopenclaw 本地部署

1. 为什么用 Docker

容器化更容易复制环境、团队协作和故障回滚。

  • 统一依赖与运行时
  • 支持快速回滚
  • 便于 CI/CD 自动化

2. compose 基础结构

官方 compose 关键服务是 `openclaw-gateway` 与 `openclaw-cli`。

官方 compose 关键片段(精简)

services:\n  openclaw-gateway:\n    image: ${OPENCLAW_IMAGE:-openclaw:local}\n    ports:\n      - \"${OPENCLAW_GATEWAY_PORT:-18789}:18789\"\n  openclaw-cli:\n    image: ${OPENCLAW_IMAGE:-openclaw:local}\n    network_mode: \"service:openclaw-gateway\"
  • 网关默认端口是 18789
  • 镜像变量使用 `OPENCLAW_IMAGE`
  • CLI 通过 `network_mode: service:openclaw-gateway` 共享网络

3. 部署后检查

先确认网关可用,再执行业务流。

  1. 访问 `http://127.0.0.1:18789/healthz`
  2. 执行 `docker compose run --rm openclaw-cli dashboard --no-open` 验证 CLI 到网关链路
  3. 观察网关日志是否有认证或配对错误

常见问题

docker 部署和直接部署哪个好?

团队协作和生产环境通常优先 Docker,单机实验可先直接部署。

容器能访问外网搜索吗?

可以,但需要正确设置网络策略与代理白名单。

参考来源