AionClaw网页本地上线后打不开，根本原因是gateway.bind_address配置错误（必须为0.0.0.0）、鉴权token缺失或失效、WebSocket握手被401拒绝，需依次检查监听地址、生成有效token、清除浏览器缓存并验证TaoToken通道。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
AionClaw网站本地正常上线后打不开，说明服务进程已启动、端口已暴露，但浏览器仍无法建立有效连接，问题必然出在WebSocket握手链路、鉴权token有效性或gateway监听地址配置上。
确认Gateway是否真正监听并接受外部连接
执行openclaw gateway status，观察输出中RPC probe: ok和Runtime: running是否同时存在。若仅显示running但probe failed，说明gateway虽在运行，却未对127.0.0.1:18789开放可响应的HTTP/WebSocket服务。
打开~/.openclaw/config.yaml，检查gateway.bind_address字段值。必须为0.0.0.0，不能是127.0.0.1或空值。Windows/macOS下某些安全策略会拦截localhost以外的回环访问，但AionClaw浏览器前端发起的是跨进程请求，【bind_address必须是0.0.0.0】，否则页面加载后立即断连。
改完保存，执行openclaw restart生效。
验证token是否过期或未生成
运行openclaw config get gateway.auth.token。如果返回空或一串明显短于32位的字符串，说明token未初始化或已被清空。
方法一：自动生成新token
执行openclaw config set gateway.auth.token $(openssl rand -hex 16)，然后openclaw restart。
方法二：强制重置鉴权配置
执行openclaw config unset gateway.auth.token → openclaw init --force，该命令会重建默认token并写入config.yaml。
注意：token一旦写死在配置中，就不会自动刷新。生产环境建议配合TaoToken做动态token轮换，但本地调试阶段用固定token更可控。
检查WebSocket握手是否被网关拒绝
在浏览器中打开开发者工具→Network标签页，刷新页面，找到ws://127.0.0.1:18789/ws这一项。若状态为Failed或Canceled，右键Copy→Copy as cURL，粘贴到终端执行，观察返回头里是否有HTTP/1.1 401 Unauthorized。
若确认是401，说明gateway已运行且监听，但鉴权失败。此时不要急着重配token，先运行openclaw doctor——它会自动扫描config.yaml中所有auth相关字段的格式合法性，比如token是否含非法字符、gateway.mode是否缺失、auth.enabled是否为true。
如果openclaw doctor报告No blocking issues found，但WebSocket仍401，唯一可能就是token被浏览器缓存。此时关闭所有AionClaw标签页→清除浏览器Cookie和缓存（重点清127.0.0.1域）→重启AionClaw服务→重开页面。
统一接入TaoToken通道排除模型侧干扰
第一步：登录https://taotoken.net/console/api-keys，创建新Key，命名如aionclaw-local-dev；复制Key值。
第二步：在AionClaw配置中切换模型出口
执行：
openclaw config set model.provider taotoken→
openclaw config set model.base_url https://taotoken.net/api→
openclaw config set model.api_key
第三步：验证通道连通性
运行openclaw channels status --probe，输出中出现taotoken: connected即表示模型通道就绪。这一步能排除“页面白屏实为模型请求超时触发前端降级”的假象。
