qoderwake任务失败需按日志信号、权限配置、连接状态、技能授权、凭证时效五维度逐层排查：先提取runtime.log中task_failed事件的fallback_reason定位断点；再验证identity字段与memory模块状态；接着检查技能授权开关、手动刷新connector凭证并测试连接；然后监听gateway.log抓取502错误及上游异常；最后启用debug日志捕获mcp-error或tool-timeout中断标记。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QoderWake自动化任务运行失败时，需从日志信号、权限配置、连接状态、技能授权和凭证时效五个维度逐层验证，跳过模糊描述直接定位真实断点。
提取runtime.log中task_failed事件
第一步：登录部署节点，执行ls -l /var/log/qoderwake/agents/确认目标数字员工ID（如dp-7f3a9b21）。
第二步：运行jq 'select(.event_type == "task_failed") | {timestamp, fallback_reason, call_stack}' /var/log/qoderwake/agents/dp-7f3a9b21/runtime.log，聚焦输出中fallback_reason字段值。
若返回"unhandled_state_transition"，说明流程引擎遇到未定义的状态跳转分支；若为"auth_failed"，则问题出在凭证或权限层，无需继续查网络连通性。
验证身份与记忆模块是否启用
方法一：检查配置文件中是否存在identity字段且值为已注册角色（如digital_programmer），【缺失该字段将导致所有跨工具操作被静默拒绝】。
方法二：运行qoderwake memory status，返回connected: true且read_write: ok才表示记忆模块正常工作；若显示connection refused，需核查Redis地址、端口及密码是否与enable_memory: true配置匹配。
确认技能授权与Connector凭证状态
① 进入Qoder管理控制台→“技能授权”页签，找到当前身份对应条目，检查目标技能（如“写入Notion数据库”）右侧开关是否为开启状态。
② 切换至“Connector”列表，点击对应条目右侧的“刷新凭证”按钮——这一步必须手动触发，系统不会自动轮换过期的Slack OAuth token或GitHub PAT。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
③ 执行最小化测试任务：在控制台输入/test connector notionalert，观察是否返回✅ Connected。若失败，日志中将明确标记auth_failed并附带失效时间戳。
抓取网关层502错误上下文
执行tail -f /var/log/qoderwake/gateway.log | grep -E "(502|upstream|timeout)"实时监听。
当出现upstream prematurely closed connection时，立即运行ps aux --sort=-%mem | head -n 5查看内存占用最高的进程——若qoderwake-worker排前三，说明JVM堆内存溢出，需调整-Xmx参数后重启。
若日志含connect() failed (111: Connection refused)，表明后端服务进程已崩溃，此时应直接执行systemctl status qoderwake-backend而非继续排查DNS。
强制启用DEBUG日志捕获中间态
在项目根目录创建qoder-debug.conf文件，写入：
log_level = debugenable_trace_context = true
启动命令必须包含--config qoder-debug.conf，否则DEBUG日志完全不输出。
复现失败任务时，在终端运行qoderlog --follow --level=debug，紧盯[MCP-ERROR]和[TOOL-TIMEOUT]标记行——这两类字段出现即代表任务在协议握手或工具调用环节已实质性中断，无需再查前端界面反馈。
