照着教程装了OpenClaw，但是启动之后访问不了页面，浏览器一直转圈。日志也不太看得懂。
环境是Ubuntu 22.04 + Docker，docker ps显示容器在跑，但访问localhost:3000就是白屏或者502。
有没有遇到过同样问题的？或者安装完第一次启动的常见坑有哪些？
502大概率是服务还没完全启动好。OpenClaw第一次启动会初始化数据库和下载依赖，可能需要等3-5分钟。
排查步骤：
1. 看容器日志
docker logs -f openclaw-app
如果看到「Server started on port 3000」就是启动成功了。如果有红色ERROR，把错误信息贴出来。
2. 检查端口映射
docker ps
看PORTS列是不是 0.0.0.0:3000->3000/tcp。如果只有 127.0.0.1:3000->3000，外网就访问不了。
3. 检查防火墙
ufw status
确保3000端口是开放的。云服务器还要检查安全组规则。
4. 内存不足
free -h
如果可用内存不到1G，容器可能会被OOM Kill。
90%的「安装后打不开」都是这四个原因之一。
1 个赞
我也遇到过白屏问题，最后发现是**.env文件没配好**。
OpenClaw启动时会读取.env里的配置，如果关键配置缺失（比如数据库连接地址），服务会启动但前端渲染失败，表现就是白屏。
检查一下你的.env文件是不是从.env.example复制过来的，里面的必填项有没有填。
1 个赞
感谢一楼和二楼！检查了一下确实是.env没配好，DATABASE_URL那行还是example里的默认值。改了之后重启容器就好了。
一楼说的排查步骤建议收藏，非常实用。
新人攒积分好难，活跃度不够分少