aionclaw任务中途失败时，须按真实故障路径逐层定位：先点右上角状态图标查看任务生命周期快照，再查scheduler.log、agent-execution.log、model-api.log三类日志，接着用内置工具或curl验证模型通道（注意base url为https://taotoken.net/api且不带/v1），最后检查输入源是否被占用、选择器是否失效或剪贴板含格式符。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当AionClaw执行任务中途失败、卡在某一步不动、或弹出“通道绑定失败”“model not found”“请求超时”等提示时，不能直接重试或重启软件，必须按真实故障路径逐层定位——因为失败可能发生在本地权限层、模型通道层、任务调度层或数据输入层，各层日志位置和排查逻辑完全不同。
先看执行窗口右上角的实时状态图标
点击任务执行界面右上角那个带感叹号或暂停符号的灰色小图标，它会弹出当前任务的完整生命周期快照：从触发时间、调度器分配ID、所用智能体角色、调用的模型ID，到每一步操作的耗时与返回码。如果这里显示「调度成功→模型请求发出→无响应」，说明问题不在本地；如果卡在「获取Excel文件权限」或「读取剪贴板内容失败」，就不用往下查模型了，立刻切到权限检查。
这一步操作起来很简单，直接点图标就行，但很多人忽略它，一上来就去翻日志文件，浪费至少8分钟。
查 logs 目录下的三类关键日志文件
打开 AionClaw 安装目录 → logs 子文件夹，里面不是一堆乱序日志，而是严格按功能分层命名：
• 【scheduler.log】 记录任务是否被正确排入队列、有没有被漏掉、定时任务是否准时触发；
• 【agent-execution.log】 记录智能体实际执行动作的过程，比如“点击浏览器地址栏→粘贴URL→回车→等待页面加载→查找‘导出’按钮”，每步都有时间戳和结果标记；
• 【model-api.log】 只记录模型调用环节：请求发给谁（model ID）、Base URL 是什么、HTTP 状态码、响应头里的 X-RateLimit-Remaining 值、以及原始响应体（截断前128字符）。
注意：如果 model-api.log 里反复出现 401 或 404，说明 TaoToken Key 未生效或 Base URL 填错了带 /v1 的地址；如果 scheduler.log 里有大量 “skipped due to conflict” 字样，说明两个定时任务撞了资源锁，需手动调整触发间隔。
验证模型通道是否真的通
方法一：用内置诊断工具快速验通道
进入「设置 → 大模型对接 → 测试连接」，点击后会向当前配置的 Base URL 发起一个最小化请求（只传 model=deepseek-chat、messages=[{"role":"user","content":"hi"}]），3秒内返回 JSON 且 status=200 才算真正通。这比看界面上的“已连接”绿标可靠得多——那个绿标只校验 URL 格式，不发真实请求。
方法二：手动 curl 验证（适合排查 DNS 或代理问题）
打开终端，执行：
curl -X POST https://taotoken.net/api/chat/completions \
-H "Authorization: Bearer your_tao_token_here" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-chat","messages":[{"role":"user","content":"test"}]}'
如果返回 403 或超时，说明本机网络策略拦截了 taotoken.net；如果返回 {"error":"invalid_api_key"}，说明 Key 复制时多了空格或用了中文引号；如果返回 HTML 页面内容，说明你把官网地址 https://taotoken.net/?utm_source=... 当成 API 地址填进去了。
方法三：换模型 ID 快速交叉验证
在设置里把 model ID 临时改成 kimi-k3 或 douba-qwen，再点一次「测试连接」。如果 deepseek-chat 不通但 kimi-k3 通，基本可锁定是 DeepSeek 侧的配额耗尽或服务维护，不是你本地的问题。
检查任务输入源是否异常
第一步：确认输入文件没被其他程序占用
比如任务要求读取 D:\data\orders.xlsx，而 Excel 正开着这个文件，AionClaw 就会静默失败，log 里只写 “open file failed”，不会报具体错误。关掉所有 Office 程序再试一次，90% 的“读取失败”问题当场解决。
第二步：检查网页元素选择器是否失效
如果任务含「在淘宝订单页点击‘导出明细’按钮」，而淘宝刚更新了前端，原 selector #J_OrderExportBtn 已变成 .order-export-btn，AionClaw 就会一直等待按钮出现直到超时。此时要进「技能编辑器」，用「录制新动作」重新抓取该按钮，不能手动改 selector 文本——容易漏掉动态 class 或 shadow DOM 结构。
第三步：验证剪贴板内容是否为纯文本
AionClaw 读剪贴板时默认按 UTF-8 解析，如果你复制的是微信聊天截图里的文字（带不可见格式符），或从 PDF 复制含特殊空格的段落，agent-execution.log 会出现 “clipboard content decode error”。此时需先粘贴到记事本中再复制一次，清除所有富文本残留。
