coollabsio/openclaw

解决的问题

在生产环境中运行 OpenClaw 代理网关比较繁琐：你需要反向代理、Web 界面、共享浏览器会话的方法、持久化存储以及安全的沙盒环境。本项目将所有这些功能打包到一个 Docker 镜像中，并提供 compose 文件，让你能够快速启动网关、配对浏览器或 Mac 应用，并在更新后保留数据。

工作原理

该镜像启动一个入口脚本，读取环境变量，写入 openclaw.json 配置文件，运行 doctor --fix，启动 nginx 作为 8080 端口的反向代理，并启动网关进程（内部监听 18789 端口）。nginx 处理 UI 和 WebSocket 的 HTTP 基本认证，并转发无需认证的 /healthz 请求。位于 /data 的持久化卷存储配置、聊天记录、已配对设备和工作区。通过 docker compose 可以启动一个可选的浏览器 sidecar (CDP + VNC)；它允许你登录需要 OAuth/2FA 的网站，网关通过 CDP 复用该会话。工具执行可以通过挂载主机 Docker 套接字进行沙盒化，以便网关创建同级容器；README 强调这会赋予容器主机 root 权限。

适用人群

任何想要自托管 OpenClaw AI 代理网关的人——无论是通过简单的 docker run 运行单个容器，还是使用包含浏览器 sidecar 和 webhooks 的完整 docker compose 设置，亦或是 Coolify 部署。它也适用于需要连接远程网关的 OpenClaw Mac 应用用户。

特性亮点

• 单容器 docker run 即可实现最小化设置；docker compose 增加了浏览器 sidecar 和 webhook 钩子。
• 带有基本认证、健康检查端点和可配置允许来源的 nginx 反向代理。
• 针对多种 AI 提供商（Anthropic, OpenAI, Gemini, DeepSeek 等）的环境变量配置，并支持自动选择主要模型。
• 持久化 /data 卷可在容器重建后保留凭据、配对信息、历史记录和工作区。
• 首次登录设备批准：通过 openclaw devices list 和 openclaw devices approve 批准浏览器或 Mac 应用。
• 可选的 Docker 套接字沙盒化以运行执行工具的同级容器，并附带关于安全影响的明确警告。
• 通过 GitHub Actions 自动构建镜像并发布新版本到 Docker Hub，以及在 Coolify 上简单的更新路径。