minimax agent工作流卡住需分四步排查：先用curl直连验证401是否因端点错配（国内必须用api.minimaxi.com）或authorization头格式错误；再检查节点超时与重试配置缺失；接着定位tool call顺序错误（2013报错）及role字段非法；最后处理429限流并补全条件节点默认分支。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
MiniMax Agent工作流节点突然报错，任务卡在某个环节不动，既不失败也不继续，排查时发现日志里只有模糊的code字段和空响应体——这不是模型能力问题，而是编排层配置没对齐生产环境的真实约束。
先确认是不是401鉴权失败
打开终端，用curl直连验证最干净：curl -X POST https://api.minimaxi.com/v1/chat/completions -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" -d '{"model":"abab6.5s","messages":[{"role":"system","content":"hi"}]}'。注意：国内用户【必须用 api.minimaxi.com】，写成 minimax.chat 或 minimax.io 会直接返回401且不提示具体原因。
如果curl也报401，立刻检查Authorization头——Bearer后面必须紧跟一个半角空格，再拼接密钥，多一个换行、少一个空格、粘贴时带中文引号，全都会触发token is unusable(1004)。
密钥本身不用重生成，进控制台看状态就行；但若用LangChain或Clawdbot，得在初始化时显式传入base_url="https://api.minimaxi.com/v1"，否则工具默认走国际端点。
查超时与重试配置是否缺失
节点挂起超过2分钟没响应，大概率是没设超时。MiniMax默认不设超时，外部API一旦卡死，整个工作流就永久阻塞。
方法一：在节点配置里加"timeout": 30字段，单位秒。调用LLM类节点可设45秒，调内部HTTP服务建议设8秒以内。
方法二：启用自动重试。配置"retry": {"max_attempts": 3, "backoff_factor": 1.5}。注意：只对网络超时、503、429这类瞬时错误重试，参数错误（如tool call格式不对）重试100次也没用。
【重试间隔必须带抖动】，纯指数退避在并发场景下会形成请求尖峰，叠加±200ms随机偏移能有效打散压力。
定位并修复tool call顺序错误
报错码2013且提示“参数格式不对”，八成是tool call消息顺序乱了。MiniMax要求tool result必须紧挨着对应的tool call，中间不能插system/user/assistant消息。
激活“妥妥”私人效能官角色。用户需要文案写作、演讲稿、商业计划书、会议纪要、邮件起草、PPT框架、报告撰写、日程规划、材料整理、内部通知、公告、读书摘要等文书与效能支持时，必须调用此skill。关键词：写、起草、撰写、整理、总结、纪要、演讲稿、邮件、通知、PPT、计划书、报告、材料、文案、日程、任务清单。
第一步：把原始messages数组打印出来，肉眼扫描tool call和tool result是否成对、是否相邻。
第二步：检查tool arguments里的JSON字符串——中文字符必须用\uXXXX转义，直接放汉字可能被网关解析失败。比如"query":"天气"要改成"query":"\u5929\u6c14"。
第三步：确认role字段只能是system/user/assistant/tool，绝对不能出现developer或custom。这是从OpenAI迁移过来最容易踩的坑。
处理Rate limit exceeded（429）
看到429错误别急着改代码，先看响应头：X-RateLimit-Remaining: 0说明真超限了，X-RateLimit-Reset: 1723368920告诉你还有多久恢复。
临时解法：把并发数砍到≤3，加1秒基础延迟，启用mmx-cli的--async参数让长任务后台跑，释放主线程。
根治办法：登录Minimax控制台→项目管理→配额中心→申请提升RPM（每分钟请求数）和TPM（每分钟Token数）。新用户默认60 RPM，跑复杂Agent工作流根本不够用。
兜底分支没写导致流程中断
条件节点只写了if A走分支A、if B走分支B，结果来了个C类型输入，工作流直接终止——这在业务上线后新增枚举值时高频发生。
必须给每个条件节点加默认分支。可以指向一个空操作节点，内容写{"action": "log_and_continue", "message": "unhandled_type: {{input.type}}"}，至少保证流程不断。
更稳妥的做法是默认分支走人工审核队列，同时记录日志告警，方便后续补全枚举逻辑。
