AionClaw启动后界面卡在旋转图标，首要排查TaoToken模型通道是否就绪：确认控制台可见API Keys和Models、生成并保存sk-开头密钥、模型状态为“可用”，且config.toml中base_url、api_key、model_id三项配置准确无误，再通过openclaw gateway status --deep和日志三行INFO验证连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
启动AionClaw后界面长时间卡在旋转图标或空白加载页，说明前端未能成功连接到后端服务，最常见原因是Gateway未真正就绪或模型调用链路中断，而非程序本身崩溃。
确认TaoToken模型通道是否已激活
这一步必须先做——如果模型API不通，AionClaw即使启动成功，也会卡在“正在初始化智能体”阶段，前端无任何错误提示，只显示加载动画。
打开浏览器访问 https://www.php.cn/link/ecd058faafa18f55f81d730b142f8fd3，登录后检查左侧菜单是否可见「API Keys」和「Models」两个入口。若缺失，说明账号未开通企业级API权限，需联系管理员处理。
点击「API Keys」→「新建密钥」，生成后【立即复制整串以sk-开头的32位密钥】并粘贴到记事本中保存——该密钥仅显示一次，关闭页面即永久丢失。
进入「Models」页面，确认你要用的模型（如 qwen2.5-72b）状态为「可用」且未标灰。若显示「配额耗尽」或「未授权」，AionClaw启动时会返回403错误，但日志可能被淹没在后台，前端只会无限等待。
检查AionClaw配置文件中的三项核心参数
进入AionClaw安装目录下的config.toml文件，用VS Code或记事本打开，逐行核对以下三处是否填写完整且无空格、换行、中文引号：
① base_url = "https://taotoken.net/api"——注意结尾不能带斜杠，也不能加任何查询参数（如?v=1），否则请求直接404；
② api_key = "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"——必须与控制台复制的密钥完全一致，大小写敏感，前后不能有空格；
③ model_id = "qwen2.5-72b"——必须与「Models」页显示的模型ID一字不差，连字符、点号、大小写均不可改动。曾有用户漏掉中间的点写成qwen25-72b，导致所有任务卡在“正在思考”，实际是模型路由失败。
验证Gateway是否真实运行并可通信
执行 openclaw gateway status 查看基础状态，若返回 active 但界面仍卡住，说明Gateway进程存活但未完成初始化。
运行 openclaw gateway status --deep 进行深度探测，该命令会尝试建立RPC连接并返回模型健康状态。若超时或报错 connection refused，说明Gateway未绑定端口或认证失败。
实时追踪日志：openclaw logs --follow。重点观察是否有如下三行INFO日志连续出现：
• “Gateway server started on 127.0.0.1:18789”
• “Model client initialized for qwen2.5-72b”
• “Agent runtime ready, accepting commands”
若日志中持续出现(no output)或长时间无新行输出，说明Gateway已挂起或未进入事件循环，需强制重启。
排查端口冲突与绑定地址问题
Gateway默认监听18789端口。若该端口被占用，服务无法完成TCP绑定，前端将永远收不到WebSocket握手响应。
查找占用进程：lsof -i :18789（macOS/Linux）或 netstat -ano | findstr :18789（Windows）。
确认PID后强制终止：kill -9
若需绑定非 loopback 地址（如局域网IP），必须提前配置认证令牌：openclaw config set gateway.auth.token your_secure_token。否则请回退至安全模式：openclaw config set gateway.bind loopback。
最后执行 openclaw gateway restart 使配置生效。
强制重置gateway.mode配置
OpenClaw强制要求显式声明Gateway运行模式。若配置文件中缺失 gateway.mode 字段或其值为空，Gateway将拒绝进入就绪状态，前端加载无限挂起。
方法一：通过CLI设置本地模式（推荐）→ openclaw config set gateway.mode local
方法二：手动编辑配置文件 ~/.openclaw/openclaw.json，确保存在结构 {"gateway": {"mode": "local"}}，保存后立即执行 openclaw gateway restart。
这一步不做，哪怕其他全部配置正确，AionClaw也永远不会跳出加载界面。
