> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# سياسة إعادة المحاولة

## الأهداف

* إعادة المحاولة لكل طلب 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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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)