本页内容
本页内容
集装箱
Docker 环境变量
scripts/docker/setup.sh 和网关容器的可选变量，以及构建内存调整。 Docker 指南的一部分。
环境变量
scripts/docker/setup.sh 接受的可选变量（对于网关容器，也可直接由 docker-compose.yml 接受）：
| 变量 | 用途 |
|---|---|
OPENCLAW_IMAGE |
使用远程镜像，而不是在本地构建 |
OPENCLAW_GATEWAY_PORT |
主机发布的网关端口（默认18789）；两个容器内部都保留端口 18789 |
OPENCLAW_IMAGE_APT_PACKAGES |
在构建期间安装额外的 apt 软件包（以空格分隔）。旧版别名：OPENCLAW_DOCKER_APT_PACKAGES |
OPENCLAW_IMAGE_PIP_PACKAGES |
在构建期间安装额外的 Python 软件包（以空格分隔） |
OPENCLAW_EXTENSIONS |
Compile/package 支持选定的插件并安装其运行时依赖项（逗号或空格分隔的 ID） |
OPENCLAW_DOCKER_BUILD_NODE_OPTIONS |
覆盖本地源码构建的 Node 选项（默认为 --max-old-space-size=8192） |
OPENCLAW_DOCKER_BUILD_TSDOWN_MAX_OLD_SPACE_MB |
以 MB 为单位覆盖本地源码构建的 tsdown 堆内存大小 |
OPENCLAW_DOCKER_BUILD_SKIP_DTS |
在仅运行时的本地镜像构建期间跳过声明文件输出（默认为 1） |
OPENCLAW_INSTALL_BROWSER |
在构建时将 Chromium + Xvfb 内置到镜像中 |
OPENCLAW_EXTRA_MOUNTS |
额外的主机绑定挂载（以逗号分隔的 source:target[:opts]） |
OPENCLAW_HOME_VOLUME |
将 /home/node 持久化到一个命名 Docker 卷中 |
OPENCLAW_TZ |
将网关和 CLI 容器的时区设置为 IANA 名称（默认为 UTC） |
OPENCLAW_SANDBOX |
选择加入沙箱引导（1、true、yes、on） |
OPENCLAW_SKIP_ONBOARDING |
跳过交互式入门步骤（1、true、yes、on） |
OPENCLAW_DOCKER_SOCKET |
覆盖 Docker 套接字路径 |
OPENCLAW_DISABLE_BONJOUR |
强制打开（0）或关闭（1）Bonjour/mDNS广告；参见 Bonjour / mDNS |
OPENCLAW_DISABLE_BUNDLED_SOURCE_OVERLAYS |
禁用内置插件源绑定挂载覆盖 |
OTEL_EXPORTER_OTLP_ENDPOINT |
用于 OpenTelemetry 导出的共享 OTLP/HTTP 收集器端点 |
OTEL_EXPORTER_OTLP_*_ENDPOINT |
用于跟踪、指标或日志的 Signal- 特定 OTLP 端点 |
OTEL_EXPORTER_OTLP_PROTOCOL |
共享 OTLP 协议回退。仅支持http/protobuf |
OTEL_EXPORTER_OTLP_*_PROTOCOL |
Signal- 跟踪、指标或日志的特定协议回退；战胜共享后备 |
OTEL_SERVICE_NAME |
用于 OpenTelemetry 资源的服务名称 |
OTEL_SEMCONV_STABILITY_OPT_IN |
选择加入最新的实验性 GenAI 语义属性 |
OPENCLAW_OTEL_PRELOADED |
跳过开始第二个OpenTelemetry SDK当一个被预加载时 |
更改 .env 或 Compose 环境设置后，运行 docker compose up -d openclaw-gateway 以使用新值重新创建网关。 docker compose restart 不应用环境更改。
The official image ships no Homebrew.在入门引导期间，OpenClaw 在没有 brew 的 Linux 容器中隐藏仅限 brew 的技能依赖项安装程序；通过自定义映像提供这些依赖项或手动安装。对 Debian- 打包依赖项使用 OPENCLAW_IMAGE_APT_PACKAGES，对 Python 依赖项使用 OPENCLAW_IMAGE_PIP_PACKAGES（在构建时运行 python3 -m pip install --break-system-packages，因此固定版本并仅使用您信任的索引）。
如果 Docker 报告 ResourceExhausted、cannot allocate memory，或在 tsdown 期间中止，请提高 Docker 构建器的内存限制，或改用更小的显式堆内存重试：
显式 tsdown 堆覆盖也是受支持的选择，用于尝试低于自动检测到的安全最小值的构建。这种尝试可能会停滞或失败。
本页有帮助吗？