docker部署openclaw遇到的问题总结

在部署与运行 OpenClaw 服务时，常会遇到模块缺失、容器重启、UI 访问、设备配对、认证失败等常见报错，影响服务正常启动与使用。本文整理了五类高频故障的精准解决方案，涵盖 Dockerfile 配置、日志排查、证书配置、设备授权、环境修复等实操方法，帮你快速定位问题、高效排障，保障服务稳定运行。

1. 关于各种包确实的问题，例如

1. Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'nostr-tools' imported from /app/dist/nostr-CbbGL74J.js
2. Cannot find package 'zca-js' imported from /app/dist/zalouser-CxeH9e8o.js

解决方法：

修改 dockerfile 文件，在 RUN pnpm build:docker 前增加以下代码，缺少哪个包安装哪个包，比如我这里需要安装 nostr-tools、 zca-js、 google-auth-library。

RUN pnpm add nostr-tools zca-js google-auth-library -w

2. 容器一直重启

Container openclaw-openclaw-gateway-1 Started0.0s
Error response from daemon: Container bee17a63c281f5774d3e87c45e1a1b20d304613bf4786d63100e97e76142fd97 is restarting, wait until the container is running

查看日志获取具体报错：

docker logs bee17a63c281f5774d3e87c45e1a1b20d304613bf4786d63100e97e76142fd97 #容器号换成自己的

docker logs bee17a63c281f5774d3e87c45e1a1b20d304613bf4786d63100e97e76142fd97
2026-03-20T01:56:59.491+00:00 Gateway failed to start: Error: non-loopback Control UI requires gateway.controlUi.allowedOrigins (set explicit origins), or set gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback=true to use Host-header origin fallback mode

解决方法：

检查配置文件‌，确保你的配置文件（如 .env 或 openclaw.json）中包含了正确的 gateway.controlUi.allowedOrigins 设置。例如：

{  "gateway": {    "controlUi": {      "allowedOrigins": [        "http://localhost:18789",        "https://localhost:18789",        "http://127.0.0.1:18789",        "https://你的服务器 ip:18789",]    }  }}

3. control ui requires device identity (use HTTPS or localhost secure context

解决方法：

先建立密钥对存放在当前路径下的文件夹 certs 下，再在 docker-compose.yml 文件中添加挂在目录，添加完毕重启容器。

4. 访问 UI 出现 pairing required

解决方法：

在容器内部执行以下代码进行配对

openclaw devices list  # 列出待配对和已配对的设备openclaw devices approve <设备标识>  #对可信设备进行配对授权

5. 聊天窗口对话出现：HTTP 401: Invalid Authentication

解决方法：

在容器内部执行以下代码

openclaw setup

总结

以上就是 OpenClaw 核心报错的完整解决指南，覆盖包依赖、容器重启、安全证书、设备配对、身份认证全场景问题。掌握日志排查、配置修改、容器命令、证书挂载等关键操作，就能快速解决各类启动与访问故障，让 OpenClaw 服务顺利部署、稳定可用。