AionClaw处理大文件卡顿时，需先通过磁盘I/O与CPU状态判断是否真卡死；再检查路径权限、复制到本地测试；接着分析日志定位超时或内存不足问题；最后调整config.yaml中max_memory_mb值或启用流式解析模式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当AionClaw在处理大于500MB的Excel、PDF或视频类文件时突然无响应、进度条停滞、CPU占用持续高于85%且3分钟内无日志输出，说明已进入卡顿状态，需立即介入排查而非等待超时。
确认是否真卡住，还是正常高负载
打开任务管理器（Windows）或活动监视器（macOS），定位 AionClaw 进程 → 查看「磁盘活动」和「I/O 读取字节数/秒」。若磁盘读取持续高于120MB/s且无下降趋势，大概率是正在解压或解析大文件，属于正常高负载；若磁盘读写接近0、CPU飙高但I/O为0，则确已卡死。
这一步不能跳过——误判会导致不该中断的操作被强行终止，可能损坏临时缓存或中断文件锁。
检查文件路径与权限层级
方法一：用系统原生命令验证可访问性
在终端中执行：ls -la "/your/file/path.xlsx"（macOS/Linux）或 dir "C:\path\to\file.pdf"（Windows）。重点看三处：【文件是否被其他程序独占锁定】（如Excel正打开该文件）、【路径中是否含中文、空格或特殊符号】（AionClaw 本地运行时对非ASCII路径解析不稳定）、【文件是否位于网络映射盘或OneDrive同步中文件夹】（这类位置IO延迟不可控，极易触发超时）。
方法二：临时复制到本地安全路径测试
将问题文件拷贝至 C:\temp（Windows）或 /tmp（macOS），确保路径纯英文、无空格、无嵌套超过5层。再让 AionClaw 处理这个副本。如果副本能跑通，原路径就是根本原因。
定位卡点：从日志里抓最后一句有效输出
第一步：找到 AionClaw 日志主目录
Windows 默认在 %APPDATA%\AionClaw\logs\，macOS 在 ~/Library/Logs/AionClaw/。不要打开最新.log文件直接滚动到底——先按修改时间排序，找最近10分钟内仍在写入的 log 文件（文件大小持续增长）。
第二步：用命令行快速提取末尾上下文
在终端中执行：tail -n 50 your_active_log.log | grep -E "(read|parse|load|timeout|OOM|memory)"。重点关注含 “timeout after 120s”、“failed to mmap”、“out of memory while loading sheet” 的行。若出现 “mmap: cannot allocate memory”，说明文件过大触发了内存映射失败，不是程序bug，是资源硬限制。
第三步：核对当前配置内存上限
打开 AionClaw 安装目录下的 config.yaml，查找 max_memory_mb: 字段。默认值为 1024（即1GB），处理单个800MB Excel时必然不足。必须手动改为 max_memory_mb: 2560 并保存，重启 AionClaw 生效。
绕过卡死：强制启用流式处理模式
对于超大CSV或结构化日志文件，禁用全量加载，改用逐块读取。
在技能配置中，找到对应文件处理节点 → 展开「高级参数」→ 勾选「启用流式解析」→ 将「分块大小」设为 5000 行（非字节数）→ 取消勾选「预加载全部数据到内存」。
注意：【此模式不支持跨块逻辑计算，如全表去重、全局排序、跨行公式引用】。若任务依赖这些能力，流式模式会跳过错误行并静默丢弃，不会报错也不会告警。
这一步操作起来很简单，直接在界面勾选即可，无需重启服务。
