OpenClaw浏览器访问空白/拒绝/超时,本质是网络、端口或服务状态未打通;需依次检查systemctl服务状态、修改config.yaml监听地址为0.0.0.0、放行防火墙与安全组8080端口,并确认前端dist目录存在且Nginx配置正确。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw部署完成后,浏览器访问服务器地址显示空白页、连接被拒绝或超时,说明服务未正常暴露或前端资源未正确加载。这不是代码写错了,而是网络、端口、服务状态三者中至少有一环没打通。
确认OpenClaw后端服务是否真正运行
打开终端,执行:
systemctl status openclaw-server
如果显示 【inactive (dead)】 或 【failed】,说明服务根本没起来。此时不要尝试访问网页,先解决服务启动问题。
执行 sudo journalctl -u openclaw-server -n 50 --no-pager 查看最近50行日志,重点找 ERROR、panic、listen tcp :8080: bind: address already in use 这类报错。若提示端口被占,用 sudo lsof -i :8080 找出进程并 kill -9 强制终止。
检查监听地址和端口是否对外暴露
默认配置下,OpenClaw后端监听 127.0.0.1:8080 —— 这意味着只允许本机 curl 访问,外部机器无法连接。
编辑配置文件:
sudo nano /etc/openclaw/config.yaml
找到 server → host 字段,将 127.0.0.1 改为 0.0.0.0;同时确认 port 值是 8080(或其他你计划暴露的端口)。
【改完必须重启服务】:sudo systemctl restart openclaw-server
验证端口是否真实可访问
在服务器本地执行:
curl -I http://localhost:8080/api/health
如果返回 HTTP/1.1 200 OK,说明后端已就绪;如果 Connection refused,说明服务没监听或端口不对。
在客户端(你自己的电脑)执行:
telnet 8080
若卡住几秒后提示 Connection refused,说明请求压根没抵达服务器——问题出在网络层或防火墙;若直接通了,但浏览器打不开,问题大概率在反向代理或前端静态资源路径上。
排查防火墙与安全组拦截
方法一(Linux服务器):
sudo ufw status verbose
查看输出中是否有 8080/tcp 的 ALLOW 规则。没有就加:
sudo ufw allow 8080/tcp
方法二(云服务器):
登录云厂商控制台 → 找到对应ECS实例 → 进入「安全组」→ 检查入方向规则是否放行 TCP 8080 端口,且源地址包含你的公网IP或 0.0.0.0/0。
注意:安全组和系统防火墙是两层独立策略,缺一不可。只开安全组而关着 ufw,照样连不上。
确认前端资源是否部署到位
OpenClaw 前端默认不内置在后端服务里,需单独部署静态文件。检查目录:
ls -l /var/www/openclaw/dist/
该目录下必须有 index.html、assets/ 子目录及其中的 JS/CSS 文件。如果为空或只有 README.md,说明构建或拷贝步骤遗漏。
若使用 Nginx 反代,检查配置:
sudo nginx -t → 验证语法
sudo systemctl reload nginx → 重载配置
Nginx location 块中 root 必须指向 dist 目录,且需包含 try_files $uri $uri/ /index.html; 否则路由刷新会 404。


















