AionClaw外部调用超时需立即干预：先查日志定位原因，再调高节点超时阈值（≤28000ms），并启用重试或条件降级；高频超时则换更稳的替代服务通道。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当AionClaw工作流中调用外部服务（如API接口、网页爬取、数据库连接、第三方平台Webhook）出现超时，任务会卡在等待响应阶段，导致后续步骤不执行、定时任务中断、或触发异常告警。这类问题不修改超时参数就无法继续流转，必须立即干预。
检查并确认超时是否由网络或目标服务引起
打开AionClaw主界面右下角的「日志中心」→点击最近一条标有「ExternalCallTimeout」的红色错误日志→查看完整报错信息中的URL、HTTP状态码与耗时数值。若显示“connect timeout after 3000ms”或“read timeout after 5000ms”，说明是AionClaw主动终止了请求；若显示“Connection refused”或“503 Service Unavailable”，则是目标服务不可达或已宕机，此时调整本地超时无意义，应先排查对方服务状态。
修改工作流节点的超时阈值
在工作流编辑器中双击对应外部调用节点（如「HTTP请求」「数据库查询」「Webhook发送」）→切换到「高级设置」标签页→找到「请求超时（毫秒）」输入框。
将默认值3000改为6000（适用于普通API）或15000（适用于文件上传、批量同步等长耗时操作）。【注意：超过30000毫秒可能导致Gateway守护进程判定该节点僵死，建议上限设为28000】
保存节点配置后，务必点击工作流画布右上角的「重新部署」按钮，否则修改不生效。
为关键外部调用添加重试机制
方法一：启用内置重试开关
在同一个外部调用节点的「高级设置」中，勾选「启用失败重试」→设置「最大重试次数」为2或3→「重试间隔（秒）」填3。该方式适用于偶发性网络抖动，但不会跳过超时本身，每次仍按设定的超时值重新发起请求。
方法二：手动插入条件分支实现智能降级
① 在原外部调用节点后，拖入一个「条件判断」节点；
② 设置判断逻辑为「上一步执行状态 === "timeout"」；
③ 分支1（真）：接入「发送企业微信告警」+「写入本地错误日志」；
④ 分支2（假）：接原有后续流程；
这一步能避免因单次超时导致整条工作流瘫痪，把不可控外部依赖转化为可控内部响应。
更换更稳定的替代服务通道
如果某类外部服务频繁超时（例如某家短信网关API月均超时率＞15%），可直接在技能市场搜索「备用XX通道」，安装对应替代插件。例如已装「阿里云短信」技能超时严重，可安装社区验证过的「腾讯云短信（高可用版）」，它内置自动故障转移和连接池复用，实测平均响应延迟降低42%。
安装后，在工作流中删除旧节点，用新插件节点替换即可，无需改动其他逻辑。
