AionClaw中需显式配置OkHttp超时以防阻塞，包括connectTimeout（5秒）、readTimeout（10秒）、writeTimeout（10秒）；支持全局客户端设置和接口级@Timeout注解（v2.3.0+），并需注意dispatcher队列影响。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 AionClaw 中为调用外部服务的接口设置超时，是为了防止因下游服务响应缓慢或不可达导致主线程阻塞、资源耗尽或请求堆积。默认情况下，AionClaw 使用 OkHttp 作为底层 HTTP 客户端，其连接、读取、写入超时均需显式配置，否则可能无限等待。
通过 OkHttp 初始化时全局设置超时
方法一：自定义 OkHttpClient 实例并注入到 AionClaw 客户端
第一步：创建带超时参数的 OkHttpClient 实例，分别指定 connectTimeout、readTimeout、writeTimeout（单位毫秒）：
OkHttpClient client = new OkHttpClient.Builder()<br> .connectTimeout(5, TimeUnit.SECONDS)<br> .readTimeout(10, TimeUnit.SECONDS)<br> .writeTimeout(10, TimeUnit.SECONDS)<br> .build();
第二步：将该 client 传入 AionClaw 构造器初始化客户端：
AionClaw claw = new AionClaw.Builder().httpClient(client).build();
这一步必须在首次调用前完成；若已创建默认实例，再传入新 client 不会覆盖已有行为，【必须在 new AionClaw.Builder() 阶段传入】。
对单个 API 接口设置独立超时
当不同外部服务稳定性差异大，比如支付接口要求强实时性而日志上报可容忍长延迟，就需要按接口粒度控制超时。
方法一：使用 @Timeout 注解（仅限 AionClaw v2.3.0+ 支持）
在对应 RPC 接口方法上添加注解，单位为毫秒：
@Get("/order/status")<br>@Timeout(connect = 3000, read = 8000)<br>CompletableFuture<OrderStatus> getOrderStatus(@Query("id") String id);
注意：@Timeout 仅作用于当前方法，不继承、不传递，且仅对 HTTP 类型接口生效。
方法二：运行时动态构造 RequestConfig（适用于低版本或需条件化超时）
调用前手动封装 RequestConfig 对象，传入 execute() 或 asyncExecute() 方法：
RequestConfig config = RequestConfig.builder()<br> .connectTimeoutMs(2000)<br> .readTimeoutMs(5000)<br> .build();<br>claw.asyncExecute("GET", "https://api.example.com/health", config);
验证超时是否生效
启动一个本地慢响应服务（如 Python 的 http.server + time.sleep(12)），发起调用后观察是否在设定时间点抛出 IOException 或 TimeoutException。
若仍长时间无响应，请检查是否误用了 OkHttp 的 dispatcher.maxRequestsPerHost，默认值为 64——当并发量高且未及时释放连接时，新请求会在队列中等待，看似“超时不生效”，实际是排队而非网络超时。
建议同步调整 dispatcher：
client.dispatcher().setMaxRequestsPerHost(128);
