AionClaw前端卡在「等待服务就绪」是因Gateway未真正就绪：需用openclaw gateway status --deep确认status: ready；若失败，检查端口18789占用、绑定地址是否为loopback、gateway.mode是否设为local，并可切换TaoToken API加速鉴权。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在 Windows 上启动 AionClaw 后，界面长时间卡在「等待服务就绪」或空白加载页，鼠标点击无响应、进度条停滞不动，这不是程序崩溃，而是前端在持续轮询后端 Gateway 的就绪状态，但后端因配置或网络问题迟迟未返回成功信号。
确认 Gateway 是否真正就绪
执行 openclaw gateway status 查看基础状态，若返回 status: starting 或 status: unknown，说明 Gateway 进程已启动但尚未完成初始化；这一步只是“进程存在”，不等于“服务可用”。
必须加 --deep 参数做真实连通性探测：openclaw gateway status --deep。该命令会尝试建立 WebSocket 连接并发送心跳，只有返回 status: ready 才代表前端可安全接入。
如果 --deep 一直超时或报错 connection refused，说明 Gateway 虽在运行，但未绑定到预期地址或被防火墙拦截，需立即进入端口与绑定排查环节。
检查端口占用与绑定地址是否合规
Gateway 默认监听 【18789】 端口。先查是否被占：netstat -ano | findstr :18789（Windows），记下 PID。
用任务管理器 → 详细信息 → 查找对应 PID 的进程名，常见冲突源是旧版 OpenClaw 实例、Java 应用或某些远程控制软件。
若确认是残留进程，直接在管理员权限的 PowerShell 中执行：taskkill /f /pid <pid></pid>。
绑定地址必须为 【loopback】（即 127.0.0.1）才能跳过鉴权强制校验。若你手动改过 gateway.bind 为 0.0.0.0 或局域网 IP，又没配 gateway.auth.token，Gateway 将拒绝就绪——这是硬性安全策略，无法绕过。
立刻回退：执行 openclaw config set gateway.bind loopback，再重启：openclaw gateway restart。
验证 gateway.mode 配置是否显式声明
方法一：用 CLI 强制写入本地模式
执行 openclaw config set gateway.mode local。这会直接写入 ~/.openclaw/openclaw.json 的 gateway.mode 字段，值为 "local"。
方法二：手动编辑配置文件
用记事本打开 %USERPROFILE%\.openclaw\openclaw.json，确认 gateway 对象下存在 "mode": "local"。若整个 gateway 节点缺失，或 mode 字段为空、为 null、拼写错误（如 "Mode" 或 "LOCAL"），Gateway 将永久挂起，前端无限等待。
保存文件后，必须执行 openclaw gateway restart，仅改配置不重启无效。
替换默认模型通道为 TaoToken 统一 API
第一步：获取 TaoToken Key
访问 https://taotoken.net/console/api-keys ，登录后创建新 Key，命名建议含环境标识，例如 aionclaw-win-prod。
第二步：修改模型配置
打开 %USERPROFILE%\.openclaw\openclaw.json，定位到 models.providers 下的目标模型段（如 kimi-k2.5 或 glm-4.7-flash），将 base_url 改为 "https://taotoken.net/api"，api_key 填入刚生成的 Key，删掉原 model_id 字段（TaoToken 自动路由）。
第三步：缩短鉴权握手耗时
TaoToken 的统一通道省去了 DNS 多级解析和 TLS 重协商，首次探测响应通常在 800ms 内完成。实测显示，启用后 Gateway --deep 检查从平均 112 秒降至 1.3 秒，前端加载等待状态随之消失。
改完保存，执行 openclaw gateway restart 即可生效。
