الرسائل

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

تدفق الرسائل (مستوى عالٍ)

رسالة واردة
  -> التوجيه/الارتباطات -> مفتاح الجلسة
  -> الطابور (إذا كان هناك تشغيل نشط)
  -> تشغيل الوكيل (تدفق + أدوات)
  -> ردود صادرة (حدود القناة + التقسيم)

توجد عناصر التحكم الرئيسية في التكوين:

• messages.* للبادئات، الطابور، وسلوك المجموعة.
• agents.defaults.* لإعدادات تدفق الكتل والتقسيم الافتراضية.
• تجاوزات القناة (channels.whatsapp.*, channels.telegram.*, إلخ.) للحدود وتبديلات التدفق.

راجع التكوين للحصول على المخطط الكامل.

إزالة تكرار الوارد

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

تخفيف ارتداد الوارد

يمكن تجميع الرسائل المتتالية السريعة من نفس المرسل في دورة وكيل واحدة عبر messages.inbound. يتم تحديد نطاق تخفيف الارتداد لكل قناة + محادثة ويستخدم أحدث رسالة لخيط/معرفات الرد. التكوين (الافتراضي العام + تجاوزات لكل قناة):

{
  messages: {
    inbound: {
      debounceMs: 2000,
      byChannel: {
        whatsapp: 5000,
        slack: 1500,
        discord: 1500,
      },
    },
  },
}

ملاحظات:

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

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

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

• تنهار الدردشات المباشرة إلى مفتاح الجلسة الرئيسي للوكيل.
• تحصل المجموعات/القنوات على مفاتيح جلسات خاصة بها.
• مخزن الجلسات والنصوص موجود على مضيف البوابة.

يمكن أن ترتبط أجهزة/قنوات متعددة بنفس الجلسة، ولكن لا تتم مزامنة السجل بالكامل مع كل عميل. التوصية: استخدم جهازًا أساسيًا واحدًا للمحادثات الطويلة لتجنب السياق المتباين. تظهر واجهة تحكم المستخدم (UI) وواجهة المستخدم النصية (TUI) دائمًا نص الجلسة المدعوم من البوابة، لذا فهما مصدر الحقيقة. التفاصيل: إدارة الجلسات.

محتويات الوارد وسياق السجل

يفصل OpenClaw نص المطالبة عن نص الأمر:

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

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

• [رسائل الدردشة منذ ردك الأخير - للسياق]
• [الرسالة الحالية - رد على هذا]

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

الطابور والمتابعات

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

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

التفاصيل: الطابور.

التدفق، التقسيم، والتجميع

يرسل تدفق الكتل ردودًا جزئية أثناء إنتاج النموذج لنصوص الكتل. يحترم التقسيم حدود نص القناة ويتجنب تقسيم الكود المحاط بأسوار. الإعدادات الرئيسية:

• agents.defaults.blockStreamingDefault (on|off، الإعداد الافتراضي 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 صراحة)

التفاصيل: التدفق + التقسيم.

وضوح التفكير والرموز (Tokens)

يمكن لـ OpenClaw كشف أو إخفاء تفكير النموذج:

• /reasoning on|off|stream يتحكم في الوضوح.
• لا يزال محتوى التفكير يحسب ضمن استخدام الرموز (Tokens) عندما ينتجه النموذج.
• يدعم Telegram تدفق التفكير في فقاعة المسودة.

التفاصيل: التفكير + توجيهات التفكير و استخدام الرموز (Tokens).

البادئات، الخيوط، والردود

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

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

التفاصيل: التكوين ووثائق القناة.

الحضورالتدفق والتقسيم