若qoderwake启动失败，需依次执行三步排查：一、用qoder wake check --verbose命令检查环境缺失项；二、用deveco studio appanalyzer扫描harmonyos兼容性；三、手动验证node.js、python版本及沙盒、connector路径权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试启动QoderWake数字员工，但系统提示初始化失败或功能异常，则可能是由于本地环境缺少必要组件或存在版本兼容性冲突。以下是执行环境检查与问题定位的步骤：
一、运行QoderWake内置环境检查命令
该方法通过Qoder CLI直接调用预置检测模块，覆盖Node.js版本、Python运行时、Connector依赖库、沙盒权限状态及审计日志路径可写性等核心项。检测结果以结构化JSON输出，便于快速识别缺失项。
1、打开终端，确保已安装Qoder CLI并完成身份登录。
2、执行命令：qoder wake check --verbose。
3、等待输出完成，观察返回中status字段为"missing"或"mismatch"的条目。
4、若出现"connector-github: not found"类提示，需手动安装对应Connector插件。
二、使用DevEco Studio AppAnalyzer进行兼容性扫描
该方法适用于HarmonyOS NEXT目标平台下的QoderWake部署场景，利用AppAnalyzer的“场景化体检”能力，对QoderWake所依赖的ArkTS运行时、module.json5配置约束、权限沙盒隔离机制进行深度校验。
1、在DevEco Studio 6.0.1 Beta1及以上版本中，点击菜单栏Tools > AppAnalyzer。
2、连接已签名的QoderWake测试HAP包，或选择其源码工程根目录。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3、在AppAnalyzer首页切换至场景化体检页签，点击+号创建自定义卡片。
4、勾选权限沙盒完整性与Connector接入链路两个检测项，设置单次录制时长为30秒。
5、点击开始体检，完成后查看报告中“阻断级问题”区域的红色标记项。
三、手动验证关键依赖路径与版本匹配
该方法绕过自动化工具，直接检查文件系统级依赖是否存在、是否可执行、是否满足QoderWake声明的最低版本要求，适用于离线环境或调试深层兼容性问题。
1、确认Node.js版本不低于v18.17.0：在终端执行node --version。
2、确认Python版本处于3.9–3.11区间：执行python3 --version。
3、检查~/.qoder/wake/sandbox/目录是否存在且当前用户具有读写权限。
4、进入项目根目录，运行ls -l ./qoder/connectors/，确认所需Connector子目录（如github、notion）非空且含main.py文件。
