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

# الرسائل

# الرسائل

تربط هذه الصفحة بين كيفية تعامل OpenClaw مع الرسائل الواردة، والجلسات، والاصطفاف،
والبثّ، وإتاحة عرض الاستدلال.

## إخماد الرسائل الواردة (Debouncing)

```
Inbound message
  -> routing/bindings -> session key
  -> queue (if a run is active)
  -> agent run (streaming + tools)
  -> outbound replies (channel limits + chunking)
```

مقابض المفاتيح موجودة في التكوين:

* `messages.*` للبادئات، والاصطفاف، وسلوك المجموعات.
* `agents.defaults.*` لإعدادات بثّ الكتل والتجزئة الافتراضية.
* تجاوزات القنوات (`channels.whatsapp.*`، `channels.telegram.*`، إلخ) للحدود القصوى ومفاتيح تشغيل/إيقاف البثّ. لأغطية و تبديل البث.

انظر [التهيئة](/gateway/configuration) للاطلاع على المخطط الكامل.

## تسليم داخلي

يمكن للقنوات إعادة تسليم الرسالة نفسها بعد إعادة الاتصال. يحتفظ OpenClaw بذاكرة
مؤقتة قصيرة العمر مُفهرسة بحسب القناة/الحساب/النظير/الجلسة/معرّف الرسالة، بحيث لا
تؤدي التسليمات المكررة إلى تشغيل وكيل آخر.

## السحب الوارد

يمكن تجميع الرسائل المتتالية السريعة من **المرسِل نفسه** في دورة وكيل واحدة عبر
`messages.inbound`. يُنطاق الإخماد لكل قناة + محادثة، ويستخدم أحدث رسالة لربط الردود/المعرّفات.

التهيئة (افتراضي عام + تجاوزات لكل قناة):

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  messages: {
    inbound: {
      debounceMs: 2000,
      byChannel: {
        whatsapp: 5000,
        slack: 1500,
        discord: 1500,
      },
    },
  },
}
```

ملاحظات:

* ينطبق الإخماد على الرسائل **النصية فقط**؛ إذ تُفرَّغ الوسائط/المرفقات فورًا.
* تتجاوز أوامر التحكم الإخماد لتبقى مستقلة.

## الجلسات والأجهزة

الجلسات مملوكة للبوابة، وليس للعملاء.

* المحادثات المباشرة تُدمَج ضمن مفتاح الجلسة الرئيسي للوكيل.
* تحصل المجموعات/القنوات على مفاتيح جلسات خاصة بها.
* مخزن الجلسات والنصوص التفريغية موجودان على مضيف Gateway.

يمكن لعدة أجهزة/قنوات أن تُطابِق الجلسة نفسها، لكن السجل لا يُزامَن بالكامل إلى كل
عميل. التوصية: استخدام جهاز أساسي واحد للمحادثات الطويلة لتجنّب تباين السياق. تعرض
واجهة التحكم وواجهة TUI دائمًا نص الجلسة المدعوم من Gateway، لذا فهما مصدر الحقيقة.

التفاصيل: [إدارة الجلسات](/concepts/session).

## الجثث الداخلة وسياق التاريخ

يفصل OpenClaw بين **جسم المُطالبة** و**جسم الأمر**:

* `Body`: نص المُطالبة المُرسل إلى الوكيل. قد يتضمن أُطُر القناة
  وأغلفة سجل اختيارية.
* `CommandBody`: نص المستخدم الخام لتحليل التوجيه/الأوامر.
* `RawBody`: اسم مستعار قديم لـ `CommandBody` (مُحتفَظ به للتوافق).

عندما توفّر القناة سجلًا، تستخدم غلافًا مشتركًا:

* `[Chat messages since your last reply - for context]`
* `[Current message - respond to this]`

بالنسبة إلى **المحادثات غير المباشرة** (المجموعات/القنوات/الغرف)، يُسبَق **جسم الرسالة الحالية**
بتسمية المرسِل (بالأسلوب نفسه المستخدم لإدخالات السجل). يحافظ ذلك على اتساق الرسائل
الآنية والمصطفّة/التاريخية داخل مُطالبة الوكيل.

مخازن السجل **معلّقة فقط**: فهي تتضمن رسائل المجموعات التي *لم*
تُشغِّل دورة (على سبيل المثال، الرسائل المقيّدة بالمناداة)، وتستبعد الرسائل
الموجودة بالفعل في نص الجلسة.

يُطبَّق نزع التوجيهات على **قسم الرسالة الحالية** فقط بحيث يبقى السجل سليمًا. يجب على القنوات التي تُغلّف السجل ضبط `CommandBody` (أو
`RawBody`) على نص الرسالة الأصلي، والإبقاء على `Body` كمُطالبة
مُدمجة.
يمكن تهيئة مخازن السجل عبر `messages.groupChat.historyLimit` (افتراضي
عام) وتجاوزات لكل قناة مثل `channels.slack.historyLimit` أو
`channels.telegram.accounts.<id>.historyLimit` (اضبط `0` للتعطيل).

## الاصطفاف والمتابعات

إذا كانت دورة قيد التنفيذ بالفعل، يمكن اصطفاف الرسائل الواردة، أو توجيهها إلى
الدورة الحالية، أو جمعها لدورة متابعة.

* تُضبط عبر `messages.queue` (و `messages.queue.byChannel`).
* الأوضاع: `interrupt`، `steer`، `followup`، `collect`، إضافةً إلى متغيرات التراكم.

التفاصيل: [الاصطفاف](/concepts/queue).

## البث و التقطيع و الدفعي

يرسل بثّ الكتل ردودًا جزئية مع إنتاج النموذج لكتل النص.
تحترم التجزئة حدود نص القناة وتتجنّب تقسيم الشيفرة المُسوَّرة.

الإعدادات الأساسية:

* `agents.defaults.blockStreamingDefault` (`on|off`، مُعطَّل افتراضيًا)
* `agents.defaults.blockStreamingBreak` (`text_end|message_end`)
* `agents.defaults.blockStreamingChunk` (`minChars|maxChars|breakPreference`)
* `agents.defaults.blockStreamingCoalesce` (تجميع قائم على الخمول)
* `agents.defaults.humanDelay` (توقّف شبيه بالبشر بين ردود الكتل)
* تجاوزات القنوات: `*.blockStreaming` و `*.blockStreamingCoalesce` (تتطلب القنوات غير Telegram ضبط `*.blockStreaming: true` صراحةً)

التفاصيل: [البثّ + التجزئة](/concepts/streaming).

## سبب الرؤية والرموز المميزة

يمكن لـ OpenClaw إظهار أو إخفاء استدلال النموذج:

* يتحكم `/reasoning on|off|stream` في الإتاحة.
* لا يزال محتوى الاستدلال يُحتسب ضمن استخدام الرموز عندما ينتجه النموذج.
* يدعم Telegram بثّ الاستدلال إلى فقاعة المسودة.

التفاصيل: [توجيهات التفكير + الاستدلال](/tools/thinking) و[استخدام الرموز](/reference/token-use).

## البادئات، وترابط الردود، والردّ

تتم مركزة تنسيق الرسائل الصادرة في `messages`:

* `messages.responsePrefix`، و `channels.<channel>.responsePrefix`، و `channels.<channel>.accounts.<id>.responsePrefix` (تتابع بادئات الصادر)، إضافةً إلى `channels.whatsapp.messagePrefix` (بادئة الوارد في WhatsApp)
* ترابط الردود عبر `replyToMode` وافتراضات كل قناة

التفاصيل: [التهيئة](/gateway/configuration#messages) ووثائق القنوات.