用途:OpenClaw(coollabsio/openclaw)是一个自托管、容器化的 AI 网关,把 WhatsApp、Telegram、Discord、Slack、Google Chat、Signal、iMessage、Microsoft Teams、Matrix、Zalo 等消息渠道的对话,路由到 Anthropic、OpenAI、Google Gemini、xAI Grok、Groq、Mistral、Cerebras、Venice、Moonshot、Kimi、MiniMax、AWS Bedrock、Ollama、GitHub Copilot 等模型提供方,并支持工具调用、会话隔离与浏览器自动化。
架构与端口:消息渠道 → OpenClaw 网关(内部 18789)→ LLM 提供方;外部经 nginx 反向代理(默认 8080,可用 PORT 调整)并启用 Basic Auth;浏览器 sidecar 的 Chrome CDP 端口为 9223,仅内部使用。
主要能力:多提供方 LLM 路由、多渠道接入、浏览器自动化 sidecar、健康检查与诊断(gateway health、openclaw doctor --fix、openclaw status --all、docker logs)。配置采用三层合并:JSON 配置 < 持久化状态 < 环境变量,环境变量优先级最高;API 密钥仅通过环境变量提供,不写入 JSON 配置。
使用方式:支持独立 Docker 与 Docker Compose(含浏览器 sidecar)部署,也支持 KASM 工作区(建议 2 核、4096 MB 内存、/data 持久化 profile)。最小部署命令示例:
docker run -d --name openclaw -p 8080:8080 -e ANTHROPIC_API_KEY=sk-ant-... -e AUTH_PASSWORD=changeme -e OPENCLAW_GATEWAY_BIND=loopback -e OPENCLAW_GATEWAY_TOKEN=$(openssl rand -hex 32) -v openclaw-data:/data coollabsio/openclaw:latest
随后访问 http://localhost:8080/ 进入面板。至少需一个模型提供方密钥、AUTH_PASSWORD 与 OPENCLAW_GATEWAY_BIND=loopback。
限制与注意:必须设置 OPENCLAW_GATEWAY_BIND=loopback,默认绑定会把网关暴露到公网(端口 18789,资料称 2026 年 2 月已知严重安全问题);不要省略 AUTH_PASSWORD;挂载卷前将目录属主设为 uid 1000(容器以非 root 用户 node 运行);WhatsApp 为整体覆盖模式,启用时需设置全部 WhatsApp 变量;容器内不安装运行时包,构建时通过 OPENCLAW_DOCKER_APT_PACKAGES 处理。资源最低 2 GB 内存、10 GB 磁盘,推荐 4 GB+ 与 20 GB+;架构需 amd64 或 arm64。资料基于 OpenClaw v2026.1.x 与 KASM 1.17.0(Ubuntu 22.04)测试,更多渠道与安全细节见其引用文档。