AionClaw任务失败时须30秒内捕获5类关键信息：①复制任务ID并grep日志；②提取START/ERROR/END三段带时间戳日志；③检查浏览器存活与文件锁状态；④5分钟内导出上下文快照；⑤禁用干扰技能、手打最小指令、启用单步调试复现。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当AionClaw执行任务失败却只显示“操作未完成”“流程中断”或空白错误弹窗时，你无法靠猜来定位问题——必须在30秒内捕获5类关键现场信息，否则重启后日志被覆盖、临时文件被清理、上下文状态丢失，排查成本翻倍。
第一步：立即锁定失败任务的唯一标识
在任务面板中右键点击失败项→选择「复制任务ID」。这个ID形如task_7f3a9b2e_4d8c_11ef_b2a1_00155d012345，是后续所有日志检索的唯一锚点。【不要截图，截图无法用于命令行搜索】。
打开终端（Windows用PowerShell，macOS/Linux用Terminal），进入AionClaw安装目录，执行：
grep -n "task_7f3a9b2e_4d8c_11ef_b2a1_00155d012345" logs/backend.log
第二步：提取三段核心日志并标注时间戳
从上一步grep结果中，向上找最近一条含“START”的INFO行，向下找最近一条含“ERROR”或“PANIC”的行，再向下找第一条含“END”的INFO行——这三行必须完整复制，包括方括号里的毫秒级时间戳，例如[2026-10-14T16:22:41.837Z]。时间差超过15秒的任务，大概率卡在外部依赖（如浏览器未响应、Excel被其他进程占用）。
把这三行粘贴进记事本，手动在每行前加标签：①启动时刻、②错误现场、③结束状态。别用截图，文本可搜索、可比对、可发给技术支持直接定位。
第三步：确认失败环节是否涉及外部工具
方法一：检查浏览器是否存活
任务若含网页操作，在终端执行：ps aux | grep -i "chrome\|edge\|firefox" | grep -v "grep"。若无输出，说明AionClaw调起的浏览器进程已崩溃，需检查「安全保护」→「允许后台唤醒浏览器」是否启用。
方法二：验证文件锁状态
若任务读写Excel/Word/PDF，打开资源管理器，手动尝试双击该文件。若提示“此文件正由另一程序使用”，说明AionClaw未正常释放句柄——此时不要关闭AionClaw，先执行：
lsof -i :50052（macOS/Linux）或 netstat -ano | findstr :50052（Windows），确认是否有残留连接。
第四步：导出当前运行时上下文快照
在AionClaw主界面左下角点击「诊断」→「生成上下文快照」→勾选「包含内存变量快照」「附带技能加载状态」→点击「导出JSON」。该文件体积通常在120KB～450KB之间，不含原始业务数据，但记录了任务执行时所有环境变量、已加载技能版本、插件启用状态和最近3次输入缓存。【导出后不要手动修改文件名，保留默认时间戳命名】。
这一步必须在任务失败后5分钟内完成。超过时限，内存变量可能被GC回收，快照中对应字段将显示null而非真实值。
第五步：复现失败路径并禁用干扰项
第一步：关闭所有非必要技能
进入「工具管理」→「技能中心」→取消勾选「OCR增强识别」「网页表单自动填充」「定时任务调度器」——只保留与当前任务强相关的1～2个技能。
第二步：用最小指令重试
不复制原指令，而是手打最简等效指令，例如原指令是“把销售报表.xlsx里Q3华东区数据按产品线汇总并邮件发给王经理”，改为：“打开销售报表.xlsx → 切到‘Q3数据’表 → 选中A2:D100 → 复制”。这能排除自然语言解析歧义导致的隐式失败。
第三步：启用单步调试模式
在任务配置中开启「详细日志输出」+「DOM操作高亮」，重跑一次。观察浏览器窗口是否出现黄色边框闪烁——有则说明网页元素识别成功，问题在后续动作；无则说明卡在语义解析层，需检查页面是否动态加载或含反爬JS。
