openclaw本地部署后localhost:3000页面空白或连接被拒绝，说明服务未正常启动或端口未暴露；需依次检查容器状态（docker ps）、查看实时日志（docker logs -f）、验证cuda与显存是否满足要求（≥8gb）、确认端口映射是否正确（-p 3000:3000），最后强制重建并启用debug模式定位问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw本地部署后浏览器访问localhost:3000页面空白、连接被拒绝或显示“无法访问此网站”，说明服务未正常暴露或启动失败，不是网络或浏览器问题。
确认容器是否真正运行
执行 docker ps 查看容器列表，检查是否有名称含 openclaw 或状态为 Up 的容器。若无任何输出，说明容器已退出或根本没启动成功。
若看到容器但状态是 Exited (1) 或 Restarting，直接跳到下一个小标题——这代表启动流程卡在初始化阶段，必须查日志才能定位。
查看容器实时日志定位崩溃点
运行命令：docker logs -f openclaw-app（假设容器名为 openclaw-app；若不确定，用 docker ps -a --format "{{.Names}} {{.Status}}" | grep -i openclaw 先查真实名字）。
重点盯住最后 10 行输出：如果出现 ERROR: failed to start server、Connection refused 或 ModuleNotFoundError: No module named 'xxx'，说明依赖缺失或配置错误；如果卡在 Starting OpenClaw server... 后长时间无响应，大概率是模型加载超时或显存不足。
【关键前提】 OpenClaw 默认依赖 CUDA 环境且需至少 8GB 显存加载基础模型，若你用的是无 GPU 的笔记本或 macOS（不支持 CUDA），容器会静默失败——此时日志里通常只有 torch.cuda.is_available() returned False 一行，但紧接着就退出，极易被忽略。
面向代理工作区的网络数据防泄漏。扫描技能和文件中的出站URL、数据泄露端点、可疑域名及网络函数调用。映射所有外部连接。免费告警层——升级至openclaw‑egress‑pro可实现阻断、隔离和URL白名单。
验证端口是否被占用或映射失败
执行 netstat -tuln | grep :3000（Linux/macOS）或 netsh interface portproxy show v4tov4（Windows PowerShell），确认主机 3000 端口未被 Node.js、Vite、其他 Docker 容器或杀毒软件劫持。
如果端口空闲但页面仍打不开，检查 Docker 运行命令中是否漏写了 -p 3000:3000。常见错误写法：-p 3000（只写了容器端口，没指定主机端口），这会导致 Docker 随机分配主机端口，必须用 docker port openclaw-app 查实际映射地址。
强制重建并启用调试模式
第一步：删掉旧容器和残留卷
执行 docker rm -f openclaw-app → docker volume prune（清空可能损坏的配置卷）。
第二步：拉取最新镜像docker pull ghcr.io/openclaw/openclaw:latest
第三步：以调试模式启动（禁用前端构建缓存 + 输出全部日志）docker run -it --rm -p 3000:3000 -e DEBUG=true -v $(pwd)/logs:/app/logs ghcr.io/openclaw/openclaw:latest
这一步会阻塞终端并实时打印每条日志。只要看到 Server running at http://0.0.0.0:3000 且后续无 ERROR 行，立刻在浏览器打开 localhost:3000 ——此时若仍白屏，右键检查页面元素，看 network 标签页里 /api/health 是否返回 503 或 timeout。
