龙虾机器人Web控制台加载异常的五大原因及排查步骤：一、检查clawdbot-gateway服务状态；二、确认8080端口未被占用；三、批准待定设备配对；四、禁用浏览器扩展并清除缓存；五、使用GitHub Pages离线资源验证网络问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试访问龙虾机器人Web控制台，但页面加载缓慢或完全无响应，则可能是由于服务未启动、端口冲突、静态资源加载阻塞或设备配对未完成所致。以下是排查此问题的步骤：
一、验证clawdbot gateway进程状态
clawdbot gateway是提供网页端HTTP服务的核心进程，若其未处于active运行状态，浏览器将无法建立初始连接，表现为白屏、超时或ERR_CONNECTION_REFUSED。
1、在终端中执行systemctl is-active clawdbot-gateway，确认输出为active；
2、若输出为inactive或failed，执行sudo systemctl start clawdbot-gateway启动服务；
3、启动后再次检查状态，并使用sudo journalctl -u clawdbot-gateway -n 50 --no-pager查看最近50行日志，确认无Failed to load model或Out of memory等关键错误。
二、检查8080端口监听与占用情况
平台默认绑定127.0.0.1:8080，若该端口被其他进程（如另一实例、开发服务器或恶意软件）独占，gateway将无法绑定，导致前端请求始终失败。
1、运行lsof -i :8080（macOS/Linux）或netstat -ano | findstr :8080（Windows WSL），确认是否存在监听进程；
2、若存在PID，执行kill -9 [PID]强制终止占用进程；
3、重启gateway服务后，再次执行curl -I http://127.0.0.1:8080，验证是否返回HTTP/1.1 200 OK及Content-Type: text/html头信息。
三、确认设备配对授权状态
当server.host配置为0.0.0.0或首次部署时，Web控制台默认启用安全锁定机制，所有新设备访问均需人工批准，否则会卡在空白页或重定向至授权待决界面。
1、在终端执行clawdbot devices list，检查输出中是否存在ID字段值为pending的条目；
2、若存在，执行clawdbot devices approve [PENDING_ID]（将[PENDING_ID]替换为实际ID）；
3、批准后刷新浏览器，页面应立即跳转至主控仪表盘，且Network面板中/dashboard/api/status返回200。
四、禁用浏览器扩展并清除本地缓存
部分广告拦截器、隐私保护插件或旧版缓存脚本可能干扰Vue单页应用的初始化流程，造成JS加载中断或API调用被静默丢弃，表现为按钮点击无反应、图表不渲染等现象。
1、打开浏览器地址栏，输入chrome://extensions，临时禁用所有非必要扩展；
2、按Ctrl+Shift+Delete（Windows/Linux）或Cmd+Shift+Delete（macOS），勾选“缓存的图像和文件”“Cookie及其他网站数据”，时间范围选“所有时间”，点击清除；
3、关闭全部标签页，重新打开http://127.0.0.1:8080，此时页面应完整加载，且开发者工具Console中无Failed to load resource或Uncaught ReferenceError报错。
五、切换至备用节点或离线文档包
当主域名clawd.bot因DNS污染、本地hosts劫持或网络策略限制无法解析时，即使gateway正常运行，前端仍可能因资源路径硬编码失败而加载中断，此时可绕过域名依赖直接使用GitHub Pages托管的离线资源。
1、在浏览器中访问https://clawd-bot.github.io/；
2、进入/static/clawdbot-ui/子路径，下载最新index.html与assets/目录；
3、将解压后的文件夹置于本地任意路径（如/tmp/clawd-offline），执行python3 -m http.server 8081 --directory /tmp/clawd-offline；
4、访问http://127.0.0.1:8081，该实例不依赖任何远程域名，所有JS/CSS均从本地服务加载，可验证是否为网络层解析故障。
