MiniMax Agent长链任务一直卡在“正在处理中”，通常与未启用Ma vis Team模式、MMX-CLI未正确安装，或Verifier服务离线有关；可通过切换到Agent Team模式、安装并重启CLI、强制终止卡住的Worker，以及检查Verifier状态并重启服务来解决。

当MiniMax Agent执行长链任务、多步骤任务或复杂工作流时，如果突然停在某个环节不再推进，对话框中只显示“正在处理中”却长时间无响应，既不报错也不继续执行，这类问题通常与上下文压力触发的隐式中断，或底层运行环境、依赖组件未准备完成有关。

确认是否进入Ma vis Team模式

请先打开Agent客户端右上角的模式切换开关，确认当前是否处于【Agent Team】模式，而不是单Agent模式。需要注意的是，只有复杂任务通常才会自动启用Team Engine。若手动切换成单Agent模式，那么Leader拆解、Worker执行、Verifier验收这一完整闭环将无法运行，任务往往会卡在第一步，无法继续分发和推进。

点击对话框右侧的 “团队协作”图标，如果图标呈灰色且无法点击，说明当前任务未被系统识别为需要Team介入的复杂任务——这时建议在提示词开头明确写上 “请以Ma vis团队模式执行”，例如：“请以Ma vis团队模式分析这份财报，拆解为数据提取→趋势建模→风险标注→报告生成四步”。

检查MMX-CLI是否已安装并生效

打开终端，运行mmx --version。如果提示command not found，则表示MMX-CLI尚未安装，所有依赖命令行调用的Worker（如代码审计、视频生成、Excel解析等）都可能直接挂起，表现为不报错、不退出，也不自动超时。

执行两行安装命令：curl -fsSL https://cli.minimaxi.com/install.sh | sh → source ~/.mmx/bin/mmx-init.sh。安装完成后务必重启Agent客户端，否则旧进程依然无法读取到最新的CLI路径，问题可能仍会持续。

【关键前提】：如果没有安装MMX-CLI，任何需要调用本地工具链的Worker都会出现静默卡死的情况，并且不会向Leader回传失败状态，Leader会持续等待直至超时（默认15分钟），在此期间界面通常不会给出明显提示。

强制唤醒卡住的Worker任务

第一步：在Agent桌面端左下角点击「运行日志」→ 找到卡住任务对应的时间戳行 → 点击右侧「详情」。

第二步：在弹出面板中定位到具体Worker ID（格式如wkr-8a3f9d）→ 复制该ID。

第三步：打开终端，执行mmx worker kill --id wkr-8a3f9d（将ID替换为你复制的实际值）→ 等待返回OK: worker terminated。

第四步：回到Agent界面，点击对话框中的「重试当前步骤」按钮。Verifier会立即重新调度该Worker，并且由于状态机记录是完整保留的，因此无需从头重新执行整个任务。

注意：不要点击「重新开始整个任务」，否则Leader会再次进行任务拆解，并有可能再次分配到同一个故障Worker节点，导致卡死问题循环出现。

验证Verifier是否正常接入

方法一：向Agent发送测试指令“请用Verifier角色检查以下JSON是否符合RFC8259规范：{“name”:“test”,“valid”:true}”，如果能在3秒内返回结构化校验结果（包含line/column错误定位），则说明Verifier通道正常畅通。

方法二：在任务卡住时，观察右上角状态栏——如果出现闪烁的红色「V」图标，代表Verifier心跳已中断，此时Worker产出内容无人验收，任务必然会堆积并卡住。此时需要重启Verifier服务：mmx verifier restart。

Verifier一旦离线，Team Engine并不会自动降级为单Agent模式，而是会严格阻塞在验收环节，这是系统设计机制，并非bug。