QClaw执行复杂指令超时需五步解决：一、修改config.yaml中timeout_seconds至300–600并重启服务；二、微信指令前加/async启用异步执行；三、将复合指令拆为间隔3秒以上的原子任务；四、确保Excel/Outlook/Chrome等依赖程序正常运行；五、在技能管理中禁用非必要技能以降低负载。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您在使用 QClaw 执行复杂指令（如“整理桌面全部 Excel 文件并汇总销售额”）时收到“指令超时”提示，说明任务执行时间已超过系统默认等待阈值，导致进程被强制中止。以下是解决此问题的步骤：
一、调整 QClaw 本地执行超时参数
QClaw 客户端对单次指令设置了默认超时限制（Windows/macOS 默认为 120 秒），当技能链路长、文件量大或网络延迟高时易触发。需手动延长该时限以适配复杂操作。
1、打开 QClaw 安装目录下的 config.yaml 文件（路径示例：Windows 为 C:\Program Files\QClaw\config.yaml，macOS 为 ~/Library/Application Support/QClaw/config.yaml）。
2、定位到 execution 区块，查找 timeout_seconds 字段。
3、将原值（如 120）修改为 300 或更高（最大建议不超过 600）。
4、保存文件后，在系统托盘右键点击 QClaw 图标，选择 重启服务 使配置生效。
二、启用分步确认与异步执行模式
QClaw 支持将长耗时任务转为后台异步执行，并通过微信消息推送结果，避免前端阻塞和超时中断。该模式适用于含多文件处理、跨应用调用或远程数据拉取的任务。
1、在微信中向 QClaw 发送指令前，**添加前缀**：/async（例如：/async 整理桌面全部 Excel 文件并汇总销售额）。
2、QClaw 将立即返回任务 ID（如 TASK-20260312-8842）并进入后台执行。
3、执行完成后，QClaw 会主动向同一微信对话发送结果文件或摘要信息。
4、如需查询任务状态，可发送：/status TASK-20260312-8842。
三、拆解复杂指令为原子化子任务
QClaw 的技能调度器对单条指令的语义解析深度有限，过长或嵌套逻辑（如“筛选→计算→绘图→邮件发送”）易导致解析失败或执行流卡顿，间接引发超时。人工拆解可提升成功率与可控性。
1、识别原始指令中的关键动词与对象，例如：“把 D:\Reports 下近7天的 .xlsx 文件中 Sheet1 的 B 列求和，结果发到邮箱 admin@xxx.com”。
2、将其拆为三步独立指令，**间隔 3 秒以上**依次发送：
1、提取 D:\Reports 近7天的 .xlsx 文件列表；
2、读取上述每个文件的 Sheet1 中 B 列数值并累加；
3、将总和数字通过 Outlook 发送至 admin@xxx.com。
3、每步执行成功后，QClaw 会返回明确反馈（如文件数、数值、发送成功提示），便于逐环验证。
四、检查本地技能依赖项运行状态
部分技能（如 Excel 处理、邮件发送、浏览器自动化）依赖外部进程（Microsoft Excel、Outlook、Chrome）。若对应程序未响应、被系统休眠或权限受限，QClaw 将持续轮询直至超时。
1、确保 Windows 系统中已安装且能正常启动 Microsoft Excel（2016 及以上版本）；
2、在任务管理器中确认 EXCEL.EXE 进程未处于“挂起”状态；
3、若使用 Outlook 邮件功能，需保证 Outlook 已登录账户并处于前台运行（QClaw 当前不支持无界面 Outlook COM 调用）；
4、对于浏览器类技能，检查 Chrome 是否已安装，且未被杀毒软件拦截 chrome.exe 的自动化接口。
五、禁用非必要技能以降低调度负载
QClaw 默认加载全部已安装技能（超 5000+），即使未被调用也会占用内存与初始化资源。当系统资源紧张（如低配笔记本运行多个后台程序）时，技能注册阶段延迟可能传导至后续指令超时。
1、打开 QClaw 客户端主界面，点击左下角 设置 → 技能管理；
2、在技能列表中，取消勾选当前无需使用的类别，例如：YouTube 上传、Telegram 推送、语音合成（TTS）；
3、点击 保存并重载技能，客户端将仅初始化勾选项，缩短启动与调度响应时间。
