waker创建失败时需按顺序排查配置文件、运行时模块和专属目录：检查config.json中waker字段完整性及参数合法性；执行qoderwake --list-modules验证waker-voice、waker-biometric、waker-context状态并重装缺失模块；删除或清理~/.config/qoderwake/waker目录后重启主进程。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QoderWake创建Waker失败时，系统通常卡在“正在初始化Waker实例”界面或弹出“Failed to create Waker: invalid config or missing runtime”提示，说明Waker对象构建阶段因配置缺失、权限不足或运行时环境异常而中断，需按顺序排查并修复。
检查Waker配置文件完整性
Waker依赖config.json中waker字段的完整定义，若该字段为空、格式错误或关键键缺失，实例化会直接中止。
打开配置文件路径：【Windows】%USERPROFILE%\.config\qoderwake\config.json；【macOS/Linux】~/.config/qoderwake/config.json。
确认根对象内存在waker字段，且结构符合以下最小要求：
```json
{"waker": {"name": "default", "trigger": "hey-qoder", "model": "qw-llm-v2", "context_size": 4096}}```
若waker字段不存在，手动添加上述内容并保存；若存在但缺少name/model/context_size任一字段，补全后重启服务。注意：name值不可为空字符串，model值必须与控制台已开通模型名称完全一致（区分大小写），context_size必须为整数且≥1024。
验证Waker所需运行时模块是否加载
Waker启动前需加载本地语音引擎、声纹校准器和上下文解析器三个核心模块，任一模块未就绪都会导致创建失败。
第一步：执行命令检查模块状态：qoderwake --list-modules
第二步：观察输出中waker-voice、waker-biometric、waker-context三行的Status列——若任一列为missing或failed，说明对应模块未安装或损坏。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
第三步：对缺失模块执行强制重装：qoderwake module install waker-voice waker-biometric waker-context
第四步：安装完成后再次运行qoderwake --list-modules，确认三者Status均为ready。
重置Waker专属配置目录
Waker在首次创建时会在~/.config/qoderwake/waker/下生成设备指纹、声纹模板和缓存索引，若该目录被误删、权限锁死或残留损坏文件，会导致后续创建流程反复失败。
方法一（推荐）：直接删除整个waker子目录
Windows执行：rmdir /s /q "%USERPROFILE%\.config\qoderwake\waker"
macOS/Linux执行：rm -rf ~/.config/qoderwake/waker
方法二：保留声纹数据但清除运行时缓存
进入waker目录后，仅删除cache/和index/两个子文件夹，保留biometric/和fingerprint/。
【关键操作】删除后必须重启QoderWake主进程，否则旧缓存仍会被内存中残留句柄引用。
