AionClaw技能显示“任务完成”但文件未生成，主因是文件写入被静默拦截：需检查日志报错、输出路径是否为合法绝对路径、tos字段是否设为"full"以解除沙盒限制，并验证目录权限及技能内部保存逻辑是否实际执行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你点击运行AionClaw技能后，控制台明确输出“任务完成”，但指定路径下始终找不到生成的Excel、PDF或文本文件，连临时缓存目录都空空如也——这不是界面假成功，而是文件写入环节被静默拦截了。
确认任务是否真执行完毕
别信界面上那行绿色“✅ 任务完成”。打开终端，执行：openclaw log --tail 50，滚动查看最后50行日志。重点找含 【write failed】、【Permission denied】 或 【No such file or directory】 的报错行。很多任务在模型推理阶段就卡住，但框架仍会触发“完成”回调，实际根本没走到文件保存这步。
如果日志里压根没出现目标文件名（比如没看到 Writing report_20261012.xlsx...），说明技能根本没执行到输出逻辑，问题出在前置步骤——跳转到下一节排查。
检查技能配置中的输出路径是否合法
方法一：在AionClaw Web UI中打开该技能 → 点击右上角「编辑」→ 找到「输出设置」或「Save to」字段。确认路径不是以 ~/ 开头的相对路径，也不是Windows风格的 C:\temp\（在macOS/Linux或WSL环境下会失效）。
方法二：直接编辑技能定义文件。进入 ~/.openclaw/skills/ 目录，找到对应技能的 .yaml 文件，搜索 output_path:。若值为 ./output/report.pdf，需改为绝对路径，例如 /Users/yourname/AionClaw_Outputs/report.pdf（macOS）或 C:/Users/yourname/AionClaw_Outputs/report.pdf（Windows原生）。【相对路径在非交互式执行时大概率解析失败】
方法三：临时改用系统默认临时目录。把输出路径设为 /tmp/（Linux/macOS/WSL）或 %TEMP%（Windows），运行一次看文件是否出现在那里。能出现，证明是路径权限或格式问题；仍不出现，说明技能内部逻辑未触发写入。
验证文件系统写入权限是否真正放开
第一步：确认AionClaw进程拥有目标目录的写权限。在终端中执行：ls -ld /path/to/your/output/dir（Linux/macOS/WSL）或 icacls "C:\path\to\dir"（Windows）。若权限中不含 w（写）或 (W)，则必须修复。
第二步：检查 openclaw.json 中的沙盒限制。运行 openclaw config --show-path 获取真实配置路径，用文本编辑器打开该文件，搜索 "tos" 字段。如果值为 "minimal"，AionClaw被强制锁定在最小权限沙盒中，所有文件操作都会被拦截。必须将其改为 "full"，保存后执行 openclaw gateway restart 重启服务。
第三步：绕过权限验证，测试写入能力。在终端中手动执行：echo "test" > /path/to/your/output/dir/test.txt。若提示权限拒绝，说明系统级权限未开放，需用 sudo chown -R $USER:staff /path/to/dir（macOS/Linux）或右键目录→属性→安全→编辑→添加当前用户并勾选“完全控制”（Windows）。
排查技能内部是否跳过了文件保存逻辑
① 进入 ~/.openclaw/skills/，找到对应技能文件夹，打开其中的 main.py 或 index.js（取决于技能语言）。搜索关键词 save、write、to_excel、dump。
② 检查是否有条件判断提前 return，例如：if not data: return 或 if os.getenv("SKIP_SAVE"): return。这些逻辑可能因环境变量、空输入或上游API返回空而触发，导致函数中途退出，不执行保存。
③ 在保存语句前加一行调试输出，例如 Python 中插入 print(f"[DEBUG] About to save {output_path}")，然后重新运行技能，看该行是否出现在日志里。没出现，说明流程根本没走到这儿；出现了却没文件，就是写入本身失败。
④ 若技能调用外部工具（如 LibreOffice 转 PDF、Pandoc 渲染），需单独验证该工具能否正常执行：libreoffice --version 或 pandoc --version。缺失或版本不兼容会导致静默失败。
