AionClaw前端请求失败时需启用重试机制保障关键操作连续性，支持网关全局配置、手动封装fetch及技能脚本中调用retryRequest三种方式，分别适用于通用代理请求、特定页面精细控制和AI技能场景。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当AionClaw前端发起的HTTP请求因网络抖动、服务端5xx或超时而失败时，必须确保关键操作不因单次失败中断，比如技能触发、文件上传、会话状态同步等场景。直接忽略错误或仅弹出提示会导致AI指令执行断裂，用户感知为“命令没反应”。
启用内置重试策略（推荐）
打开AionClaw网关配置文件：~/.openclaw/openclaw.json。
在"http"节点下添加或修改"retry"配置块，示例如下：
{ "http": { "retry": { "maxRetries": 3, "baseDelayMs": 800, "backoffFactor": 2, "retryOnStatusCodes": [500, 502, 503, 504, 429] } } }
立即学习“前端免费学习笔记（深入）”；
保存后执行openclaw-gateway restart重启网关服务。该配置对所有由网关代理的前端请求生效，包括WebSocket连接建立阶段的HTTP握手请求。
手动封装fetch并注入重试逻辑
适用于需精细控制某类请求（如导出报表、批量提交）的前端页面或插件脚本。
方法一：使用指数退避+AbortController超时控制
定义一个fetchWithRetry函数，传入URL、选项、最大重试次数和超时毫秒数；每次失败前用AbortController中断上一轮fetch，避免请求堆积；延迟时间按baseDelayMs × 2^尝试次数递增。
方法二：捕获特定错误类型再重试
只对DOMException: The user aborted a request.（即AbortError）、TypeError: Failed to fetch（网络断开）、以及响应状态码匹配/5\d{2}/的服务器错误触发重试；其他错误如400、401、403立即抛出，不重试——【4xx错误通常表示客户端问题，重试无意义】。
在技能脚本中主动调用重试接口
第一步：确认当前技能运行环境支持globalThis.retryRequest全局函数（AionClaw v2.8.0+默认注入）。
第二步：在技能JS代码中，将原始请求替换为await retryRequest({ url: '/api/submit', method: 'POST', body: data })。
第三步：该函数自动读取网关配置中的retry参数，且会在控制台输出重试日志，格式为[RETRY #2] POST /api/submit → 503 Service Unavailable。
第四步：若所有重试均失败，函数返回{ success: false, error: 'max_retries_exhausted', attempts: 3 }，技能可据此执行降级逻辑，例如切换本地缓存数据或推送“稍后重试”通知。
