المجموعات

يتعامل OpenClaw مع محادثات المجموعات باتساق عبر الأسطح: Discord، iMessage، Matrix، Microsoft Teams، QQBot، Signal، Slack، Telegram، WhatsApp، Zalo.

للغرف دائمة التشغيل التي ينبغي أن توفر سياقًا هادئًا ما لم يرسل الوكيل رسالة مرئية صراحةً، راجع أحداث الغرف المحيطة.

مقدمة للمبتدئين (دقيقتان)

"يعيش" OpenClaw على حسابات المراسلة الخاصة بك. لا يوجد مستخدم بوت WhatsApp منفصل. إذا كنت أنت موجودًا في مجموعة، يستطيع OpenClaw رؤية تلك المجموعة والرد فيها.

السلوك الافتراضي:

• المجموعات مقيّدة (groupPolicy: "allowlist").
• تتطلب الردود إشارة ما لم تعطّل بوابة الإشارة صراحةً.
• تستخدم الردود المرئية في المجموعات/القنوات أداة message افتراضيًا.

الترجمة: يستطيع المرسلون الموجودون في قائمة السماح تشغيل OpenClaw عبر الإشارة إليه.

التدفق السريع (ما يحدث لرسالة مجموعة):

groupPolicy? disabled -> dropgroupPolicy? allowlist -> group allowed? no -> droprequireMention? yes -> mentioned? no -> store for context onlymention/reply/command/DM -> user requestalways-on group chatter -> user request, or room event when configured

الردود المرئية

لطلبات المجموعات/القنوات العادية، يستخدم OpenClaw افتراضيًا messages.groupChat.visibleReplies: "automatic". يُنشر نص المساعد النهائي عبر مسار الرد المرئي القديم ما لم تجعل الغرفة تستخدم إخراج أداة الرسائل فقط.

استخدم messages.groupChat.visibleReplies: "message_tool" عندما ينبغي لغرفة مشتركة أن تترك للوكيل قرار وقت التحدث عبر استدعاء message(action=send). يعمل هذا أفضل مع غرف المجموعات المدعومة بنماذج الجيل الأحدث الموثوقة في استخدام الأدوات، مثل GPT 5.5. إذا فوّت النموذج تلك الأداة وأعاد نصًا نهائيًا ذا مضمون، يُبقي OpenClaw ذلك النص النهائي خاصًا بدلًا من نشره في الغرفة.

استخدم "automatic" للنماذج أو بيئات التشغيل الأضعف التي لا تفهم التسليم المعتمد على الأدوات فقط بموثوقية. في الوضع التلقائي، يكون نص المساعد النهائي هو مسار الرد المرئي المصدر، لذلك لا يزال بإمكان نموذج لا يستطيع استدعاء message(action=send) باستمرار أن يجيب بشكل عادي.

في الوضع التلقائي، تُنشر الردود النهائية النصية العادية مباشرةً في الغرفة. إذا كان الرد المرئي يحتاج إلى ملفات أو صور أو مرفقات أخرى، قد يظل الوكيل يستخدم message(action=send) لذلك المرفق بدلًا من محاولة تمريره عبر رد النص النهائي.

إذا لم تكن أداة الرسائل متاحة بموجب سياسة الأدوات النشطة، يعود OpenClaw إلى الردود المرئية التلقائية بدلًا من كبت الاستجابة بصمت. يحذّر openclaw doctor من عدم التطابق هذا.

للمحادثات المباشرة وأي حدث مصدر آخر، استخدم messages.visibleReplies: "message_tool" لتطبيق سلوك الرد المرئي المعتمد على الأداة فقط نفسه عالميًا. تستخدم أدوار WebChat المباشرة الداخلية افتراضيًا تسليم الرد النهائي التلقائي حتى يتلقى Pi وCodex عقد الرد المرئي نفسه. عيّن messages.visibleReplies: "message_tool" لطلب message(action=send) عمدًا للإخراج المرئي. يظل messages.groupChat.visibleReplies هو التجاوز الأكثر تحديدًا لغرف المجموعات/القنوات.

يستبدل هذا النمط القديم الذي كان يجبر النموذج على الإجابة بـ NO_REPLY لمعظم أدوار وضع الترقب. في وضع الأدوات فقط، لا يعرّف الموجه عقد NO_REPLY. عدم فعل أي شيء مرئي يعني ببساطة عدم استدعاء أداة الرسائل.

روابط المحادثات المملوكة من Plugin هي الاستثناء. بمجرد أن يربط Plugin سلسلة محادثة ويدّعي الدور الوارد، يكون الرد الذي يعيده Plugin هو استجابة الربط المرئية؛ ولا يحتاج إلى message(action=send). ذلك الرد هو إخراج بيئة تشغيل Plugin، وليس نصًا نهائيًا خاصًا من النموذج.

لا تزال مؤشرات الكتابة تُرسل لطلبات المجموعات المباشرة. تظل أحداث الغرف المحيطة دائمة التشغيل، عند تمكينها، صارمة وهادئة ما لم يستدعِ الوكيل أداة الرسائل.

تكبت الجلسات ملخصات الأدوات/التقدم المطوّلة افتراضيًا. استخدم /verbose on لإظهار تلك الملخصات للجلسة الحالية أثناء التصحيح، و /verbose off للعودة إلى سلوك الرد النهائي فقط. تنطبق حالة الإسهاب نفسها عبر المحادثات المباشرة والمجموعات والقنوات وموضوعات المنتديات.

لإرسال ثرثرة المجموعات دائمة التشغيل غير المشار إليها كسياق غرفة هادئ بدلًا من طلبات مستخدم، استخدم أحداث الغرف المحيطة:

{  messages: {    groupChat: {      unmentionedInbound: "room_event",    },  },}

القيمة الافتراضية هي unmentionedInbound: "user_request".

تظل الرسائل المشار إليها، والأوامر، وطلبات الإيقاف، والرسائل المباشرة طلبات مستخدم.

لطلب مرور الإخراج المرئي عبر أداة الرسائل لطلبات المجموعات/القنوات:

{  messages: {    groupChat: {      visibleReplies: "message_tool",    },  },}

يعيد Gateway تحميل إعدادات messages تحميلًا ساخنًا بعد حفظ الملف. لا تعِد التشغيل إلا عندما تكون مراقبة الملفات أو إعادة تحميل الإعدادات معطلة في النشر.

لطلب مرور الإخراج المرئي عبر أداة الرسائل لكل محادثة مصدر:

{  messages: {    visibleReplies: "message_tool",  },}

تتجاوز أوامر الشرطة المائلة الأصلية (Discord وTelegram والأسطح الأخرى التي تدعم الأوامر الأصلية) visibleReplies: "message_tool" وترد دائمًا بشكل مرئي حتى تحصل واجهة أوامر القناة الأصلية على الاستجابة التي تتوقعها. ينطبق هذا على أدوار الأوامر الأصلية المتحقق منها فقط؛ أما أوامر /... المكتوبة نصيًا وأدوار الدردشة العادية فما زالت تتبع الإعداد الافتراضي المضبوط للمجموعة.

ظهور السياق وقوائم السماح

هناك عنصران مختلفان للتحكم في أمان المجموعات:

• تفويض التشغيل: من يستطيع تشغيل الوكيل (groupPolicy، groups، groupAllowFrom، قوائم السماح الخاصة بالقنوات).
• ظهور السياق: ما السياق التكميلي الذي يُحقن في النموذج (نص الرد، الاقتباسات، سجل سلسلة المحادثة، بيانات التعريف المعاد توجيهها).

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

إذا أردت...

لقوائم سماح المرسلين القابلة لإعادة الاستخدام، راجع مجموعات الوصول.

مفاتيح الجلسات

• تستخدم جلسات المجموعات مفاتيح جلسة agent:<agentId>:<channel>:group:<id> (تستخدم الغرف/القنوات agent:<agentId>:<channel>:channel:<id>).
• تضيف موضوعات منتديات Telegram ‏:topic:<threadId> إلى معرف المجموعة بحيث يكون لكل موضوع جلسته الخاصة.
• تستخدم المحادثات المباشرة الجلسة الرئيسية (أو جلسة لكل مرسل إذا ضُبطت كذلك).
• يتم تخطي Heartbeats لجلسات المجموعات.

النمط: رسائل مباشرة شخصية + مجموعات عامة (وكيل واحد)

نعم — يعمل هذا جيدًا إذا كانت حركة المرور "الشخصية" لديك هي رسائل مباشرة وكانت حركة المرور "العامة" لديك هي مجموعات.

السبب: في وضع الوكيل الواحد، تصل الرسائل المباشرة عادةً إلى مفتاح الجلسة الرئيسي (agent:main:main)، بينما تستخدم المجموعات دائمًا مفاتيح جلسة غير رئيسية (agent:main:<channel>:group:<id>). إذا فعّلت العزل باستخدام mode: "non-main"، تعمل جلسات المجموعات تلك في واجهة العزل الخلفية المضبوطة بينما تبقى جلسة الرسائل المباشرة الرئيسية لديك على المضيف. Docker هي الواجهة الخلفية الافتراضية إذا لم تختر واحدة.

يمنحك هذا "عقل" وكيل واحدًا (مساحة عمل + ذاكرة مشتركتان)، لكن بوضعَي تنفيذ:

• الرسائل المباشرة: أدوات كاملة (المضيف)
• المجموعات: عزل + أدوات مقيّدة

{  agents: {    defaults: {      sandbox: {        mode: "non-main", // groups/channels are non-main -> sandboxed        scope: "session", // strongest isolation (one container per group/channel)        workspaceAccess: "none",      },    },  },  tools: {    sandbox: {      tools: {        // If allow is non-empty, everything else is blocked (deny still wins).        allow: ["group:messaging", "group:sessions"],        deny: ["group:runtime", "group:fs", "group:ui", "nodes", "cron", "gateway"],      },    },  },}

{  agents: {    defaults: {      sandbox: {        mode: "non-main",        scope: "session",        workspaceAccess: "none",        docker: {          binds: [            // hostPath:containerPath:mode            "/home/user/FriendsShared:/data:ro",          ],        },      },    },  },}

مرتبط:

• مفاتيح الإعدادات والقيم الافتراضية: إعدادات Gateway
• تصحيح سبب حظر أداة: العزل مقابل سياسة الأدوات مقابل الرفع
• تفاصيل روابط التحميل: العزل

تسميات العرض

• تستخدم تسميات واجهة المستخدم displayName عندما تكون متاحة، منسقةً على شكل <channel>:<token>.
• #room محجوز للغرف/القنوات؛ تستخدم محادثات المجموعات g-<slug> (أحرف صغيرة، المسافات -> -، مع إبقاء #@+._-).

سياسة المجموعات

تحكم في كيفية التعامل مع رسائل المجموعات/الغرف لكل قناة:

{  channels: {    whatsapp: {      groupPolicy: "disabled", // "open" | "disabled" | "allowlist"      groupAllowFrom: ["+15551234567"],    },    telegram: {      groupPolicy: "disabled",      groupAllowFrom: ["123456789"], // numeric Telegram user id (wizard can resolve @username)    },    signal: {      groupPolicy: "disabled",      groupAllowFrom: ["+15551234567"],    },    imessage: {      groupPolicy: "disabled",      groupAllowFrom: ["chat_id:123"],    },    msteams: {      groupPolicy: "disabled",      groupAllowFrom: ["user@org.com"],    },    discord: {      groupPolicy: "allowlist",      guilds: {        GUILD_ID: { channels: { help: { allow: true } } },      },    },    slack: {      groupPolicy: "allowlist",      channels: { "#general": { allow: true } },    },    matrix: {      groupPolicy: "allowlist",      groupAllowFrom: ["@owner:example.org"],      groups: {        "!roomId:example.org": { enabled: true },        "#alias:example.org": { enabled: true },      },    },  },}

نموذج ذهني سريع (ترتيب التقييم لرسائل المجموعات):

تقييد الإشارة (افتراضي)

تتطلب رسائل المجموعات إشارة ما لم يتم تجاوز ذلك لكل مجموعة. تعيش الإعدادات الافتراضية لكل نظام فرعي ضمن *.groups."*".

يُحتسب الرد على رسالة بوت كإشارة ضمنية عندما تدعم القناة بيانات تعريف الرد. ويمكن أيضا أن يُحتسب اقتباس رسالة بوت كإشارة ضمنية في القنوات التي تكشف بيانات تعريف الاقتباس. تشمل الحالات المضمنة الحالية Telegram وWhatsApp وSlack وDiscord وMicrosoft Teams وZaloUser.

{  channels: {    whatsapp: {      groups: {        "*": { requireMention: true },        "123@g.us": { requireMention: false },      },    },    telegram: {      groups: {        "*": { requireMention: true },        "123456789": { requireMention: false },      },    },    imessage: {      groups: {        "*": { requireMention: true },        "123": { requireMention: false },      },    },  },  agents: {    list: [      {        id: "main",        groupChat: {          mentionPatterns: ["@openclaw", "openclaw", "\\+15555550123"],          historyLimit: 50,        },      },    ],  },}

تحديد نطاق أنماط الإشارة المضبوطة

تعد mentionPatterns المضبوطة محفزات احتياطية بتعابير نمطية. استخدمها عندما لا تكشف المنصة عن إشارة بوت أصلية، أو عندما تريد أن يُحتسب نص عادي مثل openclaw: كإشارة. إشارات المنصة الأصلية منفصلة: عندما يمكن لـ Discord أو Slack أو Telegram أو Matrix أو قناة أخرى إثبات أن الرسالة ذكرت البوت صراحة، فستظل تلك الإشارة الأصلية تشغل حتى إذا تم رفض أنماط التعابير النمطية المضبوطة.

افتراضيا، تنطبق أنماط الإشارة المضبوطة في كل مكان تمرر فيه تلك القناة حقائق المزود والمحادثة إلى كشف الإشارة. لمنع الأنماط الواسعة من إيقاظ الوكيل في كل مجموعة، حدد نطاقها لكل قناة باستخدام channels.<channel>.mentionPatterns.

استخدم mode: "deny" عندما ينبغي إيقاف أنماط الإشارة بالتعابير النمطية افتراضيا لقناة ما، ثم فعّل غرفا محددة باستخدام allowIn:

{  messages: {    groupChat: {      mentionPatterns: ["\\bopenclaw\\b", "\\bops bot\\b"],    },  },  channels: {    slack: {      mentionPatterns: {        mode: "deny",        allowIn: ["C0123OPS"],      },    },  },}

استخدم mode: "allow" الافتراضي (أو احذف mode) عندما ينبغي أن تنطبق أنماط الإشارة بالتعابير النمطية على نطاق واسع، ثم أوقفها في الغرف كثيرة الضجيج باستخدام denyIn:

{  messages: {    groupChat: {      mentionPatterns: ["\\bopenclaw\\b"],    },  },  channels: {    telegram: {      mentionPatterns: {        denyIn: ["-1001234567890", "-1001234567890:topic:42"],      },    },  },}

حل السياسة:

سياسة التعابير النمطية محددة النطاق المدعومة حاليا:

يمكن لإعدادات القناة على مستوى الحساب ضبط السياسة نفسها ضمن channels.<channel>.accounts.<accountId>.mentionPatterns عندما تدعم تلك القناة حسابات متعددة. تتقدم سياسة الحساب على سياسة القناة ذات المستوى الأعلى لذلك الحساب.

قيود أدوات المجموعة/القناة (اختياري)

تدعم بعض إعدادات القنوات تقييد الأدوات المتاحة داخل مجموعة/غرفة/قناة محددة.

• tools: السماح بالأدوات أو رفضها للمجموعة كلها.
• toolsBySender: تجاوزات لكل مرسل داخل المجموعة. استخدم بادئات مفاتيح صريحة: channel:<channelId>:<senderId>، وid:<senderId>، وe164:<phone>، وusername:<handle>، وname:<displayName>، وحرف البدل "*". تستخدم معرفات القنوات معرفات قنوات OpenClaw القياسية؛ ويتم تطبيع الأسماء المستعارة مثل teams إلى msteams. لا تزال المفاتيح القديمة غير المسبوقة مقبولة وتطابق كـ id: فقط.

ترتيب الحل (الأكثر تحديدا يفوز):

مثال (Telegram):

{  channels: {    telegram: {      groups: {        "*": { tools: { deny: ["exec"] } },        "-1001234567890": {          tools: { deny: ["exec", "read", "write"] },          toolsBySender: {            "id:123456789": { alsoAllow: ["exec"] },          },        },      },    },  },}

قوائم سماح المجموعات

عند ضبط channels.whatsapp.groups أو channels.telegram.groups أو channels.imessage.groups، تعمل المفاتيح كقائمة سماح للمجموعات. استخدم "*" للسماح بجميع المجموعات مع الاستمرار في ضبط سلوك الإشارة الافتراضي.

الأهداف الشائعة (نسخ/لصق):

{  channels: { whatsapp: { groupPolicy: "disabled" } },}

{  channels: {    whatsapp: {      groups: {        "123@g.us": { requireMention: true },        "456@g.us": { requireMention: false },      },    },  },}

{  channels: {    whatsapp: {      groups: { "*": { requireMention: true } },    },  },}

{  channels: {    whatsapp: {      groupPolicy: "allowlist",      groupAllowFrom: ["+15551234567"],      groups: { "*": { requireMention: true } },    },  },}

التفعيل (المالك فقط)

يمكن لمالكي المجموعات تبديل التفعيل لكل مجموعة:

• /activation mention
• /activation always

يُحدَّد المالك بواسطة channels.whatsapp.allowFrom (أو رقم E.164 الذاتي للبوت عند عدم ضبطه). أرسل الأمر كرسالة مستقلة. تتجاهل الأسطح الأخرى حاليًا /activation.

حقول السياق

تضبط حمولات المجموعات الواردة:

• ChatType=group
• GroupSubject (إذا كان معروفًا)
• GroupMembers (إذا كان معروفًا)
• WasMentioned (نتيجة بوابة الإشارة)
• تتضمن موضوعات منتدى Telegram أيضًا MessageThreadId وIsForum.

تتضمن مطالبة نظام الوكيل مقدمة للمجموعة في أول دور من جلسة مجموعة جديدة. وهي تذكّر النموذج بأن يرد مثل الإنسان، ويقلل الأسطر الفارغة ويتبع تباعد الدردشة المعتاد، ويتجنب كتابة تسلسلات \n حرفية. كما تثبط المجموعات غير التابعة لـ Telegram استخدام جداول Markdown؛ أما إرشادات النص المنسق في Telegram فتأتي من مطالبة قناة Telegram. تُعرض أسماء المجموعات وتسميات المشاركين الواردة من القنوات كبيانات وصفية غير موثوقة داخل سياج، لا كتعليمات نظام مضمنة.

تفاصيل iMessage

• فضّل chat_id:<id> عند التوجيه أو الإدراج في قائمة السماح.
• سرد الدردشات: imsg chats --limit 20.
• تعود ردود المجموعات دائمًا إلى نفس chat_id.

مطالبات نظام WhatsApp

راجع WhatsApp للاطلاع على قواعد مطالبات نظام WhatsApp الأساسية، بما في ذلك حل مطالبات المجموعات والمباشرة، وسلوك أحرف البدل، ودلالات تجاوز الحساب.

تفاصيل WhatsApp

راجع رسائل المجموعات للاطلاع على السلوك الخاص بـ WhatsApp فقط (إدخال السجل، وتفاصيل التعامل مع الإشارات).

ذو صلة

• مجموعات البث
• توجيه القنوات
• رسائل المجموعات
• الإقران