aionclaw执行复合指令卡顿或返回空结果，主因是任务规划器未启用或动作链未结构化拆解；需手动开启soul.md中task_planning: enabled并重启，再通过预设skill模板或自定义yaml绑定原子动作链，并分步加debug验证各环节输出。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你让AionClaw处理“整理上月所有客户邮件，提取合同金额并生成Excel报表”这类复合指令却卡在中间、返回空结果或只做了一半时，问题往往不出在模型能力，而在于需求没有被正确拆解成它能稳定执行的原子动作链。
先确认任务规划器是否已启用
OpenClaw底层的任务自动拆解能力默认关闭，AionClaw虽预装Gateway组件，但必须手动激活才能触发自然语言→子步骤的映射。这一步漏掉，后续所有指令都只能走单轮响应，无法分步推进。
打开AionClaw安装目录下的Workspace文件夹，找到SOUL.md文件；
用任意文本编辑器打开，在文件末尾新增一行：task_planning: enabled；
保存后，必须重启主程序——【不重启，配置不会生效】；
重启后，在对话框中发送测试指令：“把Downloads里所有PDF按作者名重命名，并移动到‘文献/2026’文件夹”，观察控制台日志或调试面板中是否出现以[PLAN]开头的多行步骤序列。没有则说明规划器未真正启用。
用结构化模板强制绑定动作链
当自然语言模糊（如“整理一下”“弄个报表”）或涉及跨应用操作（邮件→Excel→本地路径）时，内置规划器容易漏步或顺序错乱。此时应绕过实时推理，直接注入预设动作链。
方法一：复用已有Skill模板
进入Skills/email_processing子目录，找到extract_contract_amount.yaml；
检查steps字段是否包含完整闭环：读取邮箱→定位发件人+时间范围→正则匹配金额字段→新建Excel→逐行写入→保存到指定路径；
若缺失任一环节，手动补全，尤其注意路径需写绝对路径（如/Users/xxx/Documents/Reports/）；
方法二：自定义轻量模板
在Skills/custom_tasks下新建invoice_report.yaml，粘贴以下最小必要结构：
name: 月度合同金额报表
trigger: “生成上月客户合同金额Excel”
steps:
- action: fetch_emails
params: {folder: “INBOX”, date_range: “last_month”}
- action: extract_numbers
params: {pattern: “¥\d+\.\d{2}”}
- action: write_to_excel
params: {path: “/Users/xxx/Desktop/合同报表.xlsx”}
【trigger字段必须与你实际发送的指令完全一致，包括标点和空格】
分阶段验证每一步输出
不要等整条链跑完再看结果。AionClaw支持在任意step后插入debug: true，强制中断并返回该步输出。这是排查卡点最有效的方式。
第一步：在fetch_emails步骤后加debug: true；
第二步：运行指令，确认返回的是真实邮件列表（含Subject、Date、Body片段），而非空数组或报错；
第三步：若返回为空，立刻检查邮箱账户是否已在AionClaw中完成OAuth授权——【未授权账户无法读取Gmail/Outlook等受保护邮箱】；
第四步：仅当上一步通过，才去掉debug，继续在extract_numbers后加debug，验证正则是否命中目标金额；
第五步：最后验证write_to_excel是否真在桌面生成了文件，且内容格式正确（非乱码、无空行）。
