المجموعات

يتعامل OpenClaw مع الدردشات الجماعية بشكل متسق عبر الأسطح: Discord, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo.

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

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

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

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

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

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

groupPolicy? disabled -> drop
groupPolicy? allowlist -> group allowed? no -> drop
requireMention? yes -> mentioned? no -> store for context only
otherwise -> reply

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

بالنسبة لغرف المجموعات/القنوات، يضبط OpenClaw افتراضياً messages.groupChat.visibleReplies: "message_tool". يكتب openclaw doctor --fix هذا الإعداد الافتراضي في إعدادات القنوات المكوّنة التي لا تتضمنه. يعني ذلك أن الوكيل لا يزال يعالج الدور ويمكنه تحديث الذاكرة/حالة الجلسة، لكن إجابته النهائية العادية لا تُنشر تلقائياً مرة أخرى في الغرفة. للتحدث بشكل مرئي، يستخدم الوكيل message(action=send).

يعتمد هذا الإعداد الافتراضي على نموذج/وقت تشغيل يستدعي الأدوات بشكل موثوق. إذا أظهرت السجلات نص المساعد لكن didSendViaMessagingTool: false، فهذا يعني أن النموذج أجاب بشكل خاص بدلاً من استدعاء أداة الرسائل. هذا ليس فشل إرسال في Discord/Slack/Telegram. استخدم نموذجاً موثوقاً في استدعاء الأدوات لجلسات المجموعات/القنوات، أو اضبط messages.groupChat.visibleReplies: "automatic" لاستعادة الردود النهائية المرئية القديمة.

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

بالنسبة للدردشات المباشرة وأي دور مصدر آخر، استخدم messages.visibleReplies: "message_tool" لتطبيق سلوك الردود المرئية المعتمد على الأداة فقط عالمياً. يمكن لأدوات الاختبار أيضاً اختيار هذا كإعداد افتراضي غير مضبوط لديها؛ تفعل أداة اختبار Codex ذلك للدردشات المباشرة في وضع Codex. يبقى messages.groupChat.visibleReplies التجاوز الأكثر تحديداً لغرف المجموعات/القنوات.

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

لا تزال مؤشرات الكتابة تُرسل أثناء عمل الوكيل في وضع الأداة فقط. تتم ترقية وضع كتابة المجموعة الافتراضي من "message" إلى "instant" لهذه الأدوار لأنه قد لا يكون هناك أبداً نص رسالة مساعد عادي قبل أن يقرر الوكيل ما إذا كان سيستدعي أداة الرسائل. يبقى إعداد وضع الكتابة الصريح هو الحاكم.

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

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

يعيد 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> إلى معرّف المجموعة بحيث يكون لكل موضوع جلسته الخاصة.
• تستخدم الدردشات المباشرة الجلسة الرئيسية (أو لكل مرسل إذا تم تكوين ذلك).
• يتم تخطي Heartbeat لجلسات المجموعات.

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

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

السبب: في وضع الوكيل الواحد، تصل الرسائل المباشرة عادةً إلى مفتاح الجلسة الرئيسي (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: ["[email protected]"],
    },
    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."*".

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

{
  channels: {
    whatsapp: {
      groups: {
        "*": { requireMention: true },
        "[email protected]": { 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,
        },
      },
    ],
  },
}

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

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

• tools: السماح بالأدوات أو منعها للمجموعة كلها.
• toolsBySender: تجاوزات لكل مرسل داخل المجموعة. استخدم بادئات مفاتيح صريحة: id:<senderId>، e164:<phone>، username:<handle>، name:<displayName>، وبدل "*" الشامل. لا تزال المفاتيح القديمة غير المسبوقة مقبولة وتطابق كـ 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: {
        "[email protected]": { requireMention: true },
        "[email protected]": { 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.

ملاحظات خاصة بالقنوات:

• يمكن لـ BlueBubbles اختياريا إثراء مشاركي مجموعات macOS غير المسماة من قاعدة بيانات جهات الاتصال المحلية قبل ملء GroupMembers. يكون هذا معطلا افتراضيا ولا يعمل إلا بعد نجاح بوابات المجموعة العادية.

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

# تفاصيل iMessage

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

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

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

# تفاصيل WhatsApp

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

# ذو صلة

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