AionClaw登录失败主因是本地服务未就绪或权限异常，需依次检查网关进程、重置协议/手机号绑定、修复workspace读写权限，确保aionclaw-daemon运行且用户对~/Library/Application Support/AionClaw/workspace（Mac）或%APPDATA%\AionClaw\workspace（Windows）拥有读写权。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
遇到 AionClaw 客户端提示“登录失败”，无法进入主界面完成初始化或继续使用，多数情况并非账号异常，而是本地环境校验环节被中断或权限未就绪，必须按顺序排查系统级前提条件才能恢复访问。
检查网络与服务通道状态
打开 AionClaw 安装目录下的 logs/system.log 文件，用文本编辑器搜索关键词 “channel bind failed” 或 “gateway timeout”。若存在任一匹配项，说明客户端未能连通本地服务网关——这不是网络断开，而是后台服务进程未启动成功。此时不要重启软件，先在活动监视器（Mac）或任务管理器（Windows）中查找名为 【aionclaw-daemon】 的进程，若该进程不存在或状态为“已停止”，则需手动触发服务唤醒。
双击安装包同级目录中的 【launch-daemon.sh】（Mac） 或 【launch-daemon.bat】（Windows），等待终端窗口输出 “Service ready on port 8081” 后再重试登录。
重置手机号绑定与协议确认
方法一：清除临时协议缓存
关闭客户端 → 进入用户主目录下的 【.aionclaw/cache/consent/】 文件夹 → 删除其中全部以 timestamp_ 开头的 JSON 文件 → 重新打开客户端，勾选《用户协议》《产品隐私说明》后点击“确认”。这一步跳过了因上次勾选状态未写入导致的校验拦截，适用于首次安装后卡在登录页的场景。
方法二：强制刷新手机号绑定
在登录界面连续点击手机号输入框右侧的 【?】图标 3 次 → 弹出提示“已启用绑定重置模式” → 输入原注册手机号 → 点击“获取验证码” → 若收不到短信，立即切换至「语音验证码」通道 → 输入语音播报的 6 位数字 → 完成绑定刷新。注意：此操作会【清空当前设备上的短期记忆缓存】，但不影响已安装技能与长期记忆文件。
修复本地读写权限异常
第一步：定位工作路径
在 Finder（Mac）或文件资源管理器（Windows）中，粘贴并访问以下路径：
~/Library/Application Support/AionClaw/（Mac）
%APPDATA%\AionClaw\（Windows）
第二步：验证关键文件夹权限
右键点击 【workspace】 文件夹 → “显示简介”（Mac）或“属性→安全”（Windows）→ 确认当前登录用户拥有“读取与写入”权限。若权限栏显示“只读”或“拒绝”，点击“解锁”→ 勾选“应用到所有子文件夹和文件”→ 点击“好”。这一步不可跳过，否则登录时模型加载器无法写入临时 token 文件，直接触发失败报错。
第三步：清理冲突配置
进入该路径下的 【config/】 子目录 → 删除 auth_state.json 和 device_id.bak 两个文件 → 保留 model_config.yaml 不动 → 重启客户端。
