---
read_when:
    - تحديث سلوك إعادة المحاولة لدى المزوّد أو الإعدادات الافتراضية
    - استكشاف أخطاء الإرسال لدى المزوّد أو حدود معدل الطلبات وإصلاحها
summary: سياسة إعادة المحاولة لاستدعاءات المزوّد الصادرة
title: سياسة إعادة المحاولة
x-i18n:
    generated_at: "2026-05-02T07:25:38Z"
    model: gpt-5.5
    provider: openai
    source_hash: 7720092499effdfa011fc0a0310adb2ecddca9e94f57f749794eab1c9ab4c922
    source_path: concepts/retry.md
    workflow: 16
---

## الأهداف

- إعادة المحاولة لكل طلب HTTP، وليس لكل تدفق متعدد الخطوات.
- الحفاظ على الترتيب عبر إعادة محاولة الخطوة الحالية فقط.
- تجنب تكرار العمليات غير الآمنة للتكرار.

## الإعدادات الافتراضية

- المحاولات: 3
- الحد الأقصى للتأخير: 30000 مللي ثانية
- التذبذب: 0.1 (10 بالمئة)
- إعدادات المزوّدين الافتراضية:
  - الحد الأدنى لتأخير Telegram: 400 مللي ثانية
  - الحد الأدنى لتأخير Discord: 500 مللي ثانية

## السلوك

### مزوّدو النماذج

- يتيح OpenClaw لحِزم SDK الخاصة بالمزوّدين التعامل مع عمليات إعادة المحاولة القصيرة العادية.
- بالنسبة إلى حِزم SDK المبنية على Stainless مثل Anthropic وOpenAI، يمكن أن تتضمن الاستجابات القابلة لإعادة المحاولة
  (`408` و`409` و`429` و`5xx`) `retry-after-ms` أو
  `retry-after`. عندما يكون وقت الانتظار هذا أطول من 60 ثانية، يحقن OpenClaw
  `x-should-retry: false` بحيث يعرض SDK الخطأ فورًا، ويمكن لتجاوز فشل النموذج
  التبديل إلى ملف تعريف مصادقة آخر أو نموذج احتياطي.
- تجاوز الحد باستخدام `OPENCLAW_SDK_RETRY_MAX_WAIT_SECONDS=<seconds>`.
  اضبطه على `0` أو `false` أو `off` أو `none` أو `disabled` للسماح لحِزم SDK باحترام فترات نوم `Retry-After` الطويلة داخليًا.

### Discord

- يعيد المحاولة عند أخطاء حدود المعدل (HTTP 429)، وانتهاء مهلة الطلب، واستجابات HTTP 5xx،
  وفشل النقل العابر مثل فشل البحث في DNS، وإعادة ضبط الاتصال،
  وإغلاق المقابس، وفشل الجلب.
- يستخدم `retry_after` الخاص بـ Discord عند توفره، وإلا فيستخدم التراجع الأسي.

### Telegram

- يعيد المحاولة عند الأخطاء العابرة (429، انتهاء المهلة، الاتصال/إعادة الضبط/الإغلاق، غير متاح مؤقتًا).
- يستخدم `retry_after` عند توفره، وإلا فيستخدم التراجع الأسي.
- لا تُعاد محاولة أخطاء تحليل Markdown؛ بل تعود إلى النص العادي.

## التهيئة

عيّن سياسة إعادة المحاولة لكل مزوّد في `~/.openclaw/openclaw.json`:

```json5
{
  channels: {
    telegram: {
      retry: {
        attempts: 3,
        minDelayMs: 400,
        maxDelayMs: 30000,
        jitter: 0.1,
      },
    },
    discord: {
      retry: {
        attempts: 3,
        minDelayMs: 500,
        maxDelayMs: 30000,
        jitter: 0.1,
      },
    },
  },
}
```

## ملاحظات

- تنطبق عمليات إعادة المحاولة لكل طلب (إرسال رسالة، رفع وسائط، تفاعل، استطلاع، ملصق).
- لا تعيد التدفقات المركبة محاولة الخطوات المكتملة.

## ذات صلة

- [تجاوز فشل النموذج](/ar/concepts/model-failover)
- [طابور الأوامر](/ar/concepts/queue)