qclaw将于2026年12月24日停运，系腾讯ai战略从多点试错转向资源集中，其能力已整合至workbuddy，用户可一键迁移并获积分补贴。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当AionClaw工作流执行失败却只看到“任务中断”或空白响应时，你无法靠重试蒙混过关——必须立刻定位到具体哪一步卡住、为什么卡住、输入输出是否异常。这一步不解决，后续所有自动化都只是幻觉。
查看实时执行日志
打开 AionClaw 安装目录下的 logs/agent-execution.log 文件，用文本编辑器直接打开（不要用记事本，推荐 VS Code 或 Notepad++）。滚动到底部，找到最近一次失败任务的起始时间戳，例如 [2026-10-13 05:28:42]。
从该时间戳开始向上追溯，重点关注含 ERROR、Failed to execute step、Timeout after 的行。注意：日志中每个步骤会标注 step_id: xxx，这是后续排查的唯一锚点。
如果日志为空或没有 ERROR 行，说明 Gateway 没把请求路由到 Agent，问题不在工作流内部，而在飞书/Webhook 接入层。
在工作流编辑器中启用调试模式
方法一：全局开启调试日志
进入 AionClaw 控制台 →「工作流管理」→ 点击目标工作流右侧「编辑」→ 在顶部菜单栏点击「设置」→ 勾选「启用全链路调试日志」→ 保存并重启该工作流实例。
方法二：精准断点定位（推荐）
在疑似出错节点的前一个节点后，手动插入一个「Debug Breakpoint」节点；确保它与下游节点连线正确；触发工作流后，立即打开 logs/debug-context-timestamp.json，该文件会完整记录断点处所有变量名、值类型、JSON 结构层级。
【断点节点不会自动跳过，必须手动点击「继续执行」才能往下走】
对照错误码快速归因
第一步：从日志或断点 JSON 中提取错误码，常见如下：
WF_STEP_EXEC_FAILED —— 工具调用失败，检查该步骤绑定的技能是否已启用、对应软件是否正在运行（如 Excel 未打开则「读取表格」必报此错）。
WF_INPUT_MISMATCH —— 输入字段缺失或类型错，比如上游传的是字符串 "123"，当前节点期待整型 123，JSON 解析时直接抛异常。
WF_TOOL_PERMISSION_DENIED —— Windows 下尤其常见：AionClaw 进程未以管理员身份运行，导致无法操作剪贴板、模拟按键或访问受保护路径。
WF_MODEL_TIMEOUT —— 模型无响应，此时要立刻切到 TaoToken 控制台，检查 API Key 是否过期、配额是否耗尽、Base URL 是否误填成带 UTM 参数的推广链接。
验证工具链连通性
① 打开命令行，进入 AionClaw 安装目录：cd "C:\Program Files\AionClaw"（Windows）或 cd /Applications/AionClaw.app/Contents/Resources（macOS）。
② 执行测试指令：./aionclaw-cli tool test --name file_read --path "./test.xlsx"。
③ 观察返回：若提示 Tool executed successfully，说明技能本身可用；若报 Permission denied 或 No such file，说明 workspace 路径配置错误或权限未授予。
这一步绕过整个工作流调度器，直连工具底层，能快速排除是“流程设计问题”还是“环境能力问题”。
