Waker卡在“正在初始化执行环境”或“等待沙盒就绪”超90秒时，需依次关闭进程、删除lock文件夹、重启QoderWake；若仍失败，则检测MCP健康状态并重启；资源紧张时可启用轻量级模式跳过沙盒。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QoderWake创建Waker卡在“正在初始化执行环境”或“等待沙盒就绪”状态超过90秒，说明Waker实例未能完成核心上下文加载与权限握手，此时界面无报错但按钮灰显、进度条停滞，需立即干预避免长期占用Agent调度队列。
检查并重置本地沙盒执行环境
沙盒初始化失败是Waker卡住的首要原因，常见于首次运行未授权全盘访问、或沙盒进程被杀后残留锁文件未清除。
第一步：关闭QoderWake主程序，确保后台无qoderwake进程残留——Windows执行taskkill /f /im qoderwake.exe，macOS/Linux执行pkill -f qoderwake。
第二步：定位沙盒锁文件目录。Windows为%LOCALAPPDATA%\QoderWake\sandbox\lock；macOS为~/Library/Caches/QoderWake/sandbox/lock；Linux为~/.cache/qoderwake/sandbox/lock。
第三步：删除整个lock文件夹（不是只删里面文件），这会强制下次启动重建沙盒握手协议。【删除前确认QoderWake已完全退出，否则可能损坏沙盒元数据】
第四步：重新启动QoderWake，点击「新建Waker」→ 选择模板后，观察右下角状态栏是否出现“沙盒：就绪”提示。若仍卡住，进入下一环节。
验证并修复MCP工具链连接状态
Waker依赖MCP（Model Control Protocol）与本地模型服务通信，若MCP代理未启动或端口不通，Waker将无限等待握手响应。
方法一：终端直连检测
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
在终端中执行curl -I http://localhost:3001/health，若返回HTTP/1.1 200 OK，说明MCP服务正常；若超时或Connection refused，则需手动拉起MCP。
方法二：强制重启MCP子系统
执行qoderwake mcp --restart，该命令会终止旧进程、清理临时socket、重新绑定3001端口并加载默认模型路由表。等待终端输出“MCP ready on :3001”后再试创建Waker。
注意：若此前手动修改过~/.qoderwake/mcp/config.yaml，请确认host字段未设为127.0.0.2等不可达地址——错误配置会导致MCP静默监听失败。
跳过沙盒直接启用轻量级Waker模式
当硬件资源紧张（如内存＜8GB）或沙盒策略过于严格时，标准Waker初始化会因等待GPU上下文或密钥环解锁而挂起。此时可绕过沙盒，用纯CPU模式快速生成基础Waker。
在创建Waker的模板选择页，点击右上角齿轮图标 → 开启“启用轻量级执行模式”开关 → 勾选“禁用沙盒隔离”与“跳过密钥环绑定” → 点击“确认并创建”。
这一步操作起来很简单，直接跳过所有系统级权限校验，Waker将在5秒内完成注册并进入就绪状态，适合调试与临时任务场景。
