登录后卡加载、空白或跳回登录页，是因Gateway未启动或配置异常。需先执行openclaw gateway start启动网关，再用openclaw config init --force重建配置，最后删除缓存并运行openclaw doctor --reset-ui-state重置UI状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
登录 AionClaw 后界面卡在加载动画、空白页或反复跳回登录页，说明客户端已通过身份验证但未能成功初始化本地工作环境或网关服务，问题不出在账号密码，而在于后台进程未就绪或关键配置缺失。
检查 Gateway 服务是否已启动
Gateway 是 AionClaw 的核心通信网关，所有技能调用、模型请求、文件读写都经它中转。登录后进不去主界面，90% 情况是它根本没跑起来。
打开终端（Windows 用 PowerShell，macOS/Linux 用 Terminal），执行：
openclaw gateway status
如果返回 【not running】 或命令报错“command not found”，说明 Gateway 进程未启动或 AionClaw CLI 未正确注册到系统 PATH。
此时不要重启客户端——它不会自动拉起 Gateway。必须手动启动：
openclaw gateway start
启动后等待 3～5 秒，再刷新客户端或重新打开软件。这一步跳过会导致后续所有功能全部灰显不可用。
验证本地工作路径与配置文件完整性
Gateway 能启动，但界面仍白屏，大概率是 openclaw.json 配置损坏或缺失关键字段。
方法一：用命令快速重建默认配置
openclaw config init --force
该命令会覆盖当前配置，生成一份最小可用的 openclaw.json，含默认 data_dir、gateway.mode=local、tos=full 等基础项。适合新装后首次卡住的用户。
方法二：手动校验配置路径有效性
先执行 openclaw config --show-path，拿到真实配置路径（如 【/Users/Alice/.openclaw/openclaw.json】）；然后用文本编辑器打开该文件，确认是否存在 "data_dir" 字段且值为一个真实存在的绝对路径（不能是 ./data 或 ~/Documents）。
注意：如果 data_dir 指向 OneDrive、iCloud Drive 或腾讯微云同步目录，AionClaw 可能因文件锁无法初始化工作区，导致界面卡死。请改设为本地非同步路径，例如 /Users/Alice/aionclaw-data。
强制重置 UI 状态并清除缓存
第一步：关闭所有 AionClaw 进程
Windows：任务管理器 → 结束 “openclaw.exe” 和 “AionClaw.app” 相关进程
macOS：活动监视器 → 强制退出 “openclaw”、“AionClaw”、“Gateway” 所有条目
第二步：删除 UI 缓存目录
Windows：删除 【%LOCALAPPDATA%\AionClaw\Cache】
macOS：删除 【~/Library/Caches/AionClaw】
第三步：清空本地状态快照
执行 openclaw doctor --reset-ui-state
这三步做完，再双击启动图标。UI 会重新加载初始布局，绕过上次崩溃时残留的异常渲染状态。
