​

المجموعات

​

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

• المجموعات مقيّدة (groupPolicy: "allowlist").
• تتطلب الردود إشارة ما لم تقم بتعطيل تقييد الإشارات صراحةً.

باختصار

• يتم التحكم في الوصول إلى الرسائل الخاصة بواسطة *.allowFrom.
• يتم التحكم في الوصول إلى المجموعات بواسطة *.groupPolicy + قوائم السماح (*.groups, *.groupAllowFrom).
• يتم التحكم في تشغيل الردود بواسطة تقييد الإشارات (requireMention, /activation).

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

​

رؤية السياق وقوائم السماح

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

• بعض القنوات تطبق بالفعل تصفية تستند إلى المرسل للسياق التكميلي في مسارات محددة (مثل تهيئة سلاسل Slack، وعمليات بحث الرد/السلسلة في Matrix).
• قنوات أخرى ما تزال تمرر سياق الاقتباس/الرد/إعادة التوجيه كما تم استلامه.

• contextVisibility: "all" (الافتراضي) يُبقي السلوك الحالي كما تم استلامه.
• contextVisibility: "allowlist" يرشح السياق التكميلي إلى المرسلين الموجودين في قائمة السماح.
• contextVisibility: "allowlist_quote" هو allowlist مع استثناء صريح واحد للاقتباس/الرد.

​

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

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

​

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

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

إذا كنت تحتاج إلى مساحات عمل/شخصيات منفصلة تمامًا (يجب ألا يختلط “الشخصي” و”العام” أبدًا)، فاستخدم وكيلاً ثانيًا + bindings. راجع التوجيه متعدد الوكلاء.

{
  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
• تصحيح سبب حظر أداة: Sandbox مقابل Tool Policy مقابل Elevated
• تفاصيل bind mounts: العزل

​

تسميات العرض

• تستخدم تسميات واجهة المستخدم 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 },
      },
    },
  },
}

• groupPolicy منفصلة عن تقييد الإشارات (الذي يتطلب @mentions).
• WhatsApp/Telegram/Signal/iMessage/Microsoft Teams/Zalo: استخدم groupAllowFrom (والبديل الاحتياطي: allowFrom الصريح).
• تنطبق موافقات الاقتران للرسائل الخاصة (إدخالات التخزين *-allowFrom) على الوصول إلى الرسائل الخاصة فقط؛ أما تفويض مرسل المجموعة فيظل صريحًا عبر قوائم السماح الخاصة بالمجموعات.
• Discord: تستخدم قائمة السماح channels.discord.guilds.<id>.channels.
• Slack: تستخدم قائمة السماح channels.slack.channels.
• Matrix: تستخدم قائمة السماح channels.matrix.groups. فَضِّل معرّفات الغرف أو الأسماء المستعارة؛ ويكون البحث باسم الغرفة المنضم إليها بأفضل جهد، ويتم تجاهل الأسماء غير المحلولة وقت التشغيل. استخدم channels.matrix.groupAllowFrom لتقييد المرسلين؛ كما أن قوائم السماح users لكل غرفة مدعومة أيضًا.
• يتم التحكم في الرسائل الخاصة الجماعية بشكل منفصل (channels.discord.dm.*, channels.slack.dm.*).
• يمكن أن تطابق قائمة السماح في Telegram معرّفات المستخدمين ("123456789", "telegram:123456789", "tg:123456789") أو أسماء المستخدمين ("@alice" أو "alice"); والبادئات غير حساسة لحالة الأحرف.
• القيمة الافتراضية هي groupPolicy: "allowlist"؛ وإذا كانت قائمة السماح الخاصة بالمجموعات فارغة، فسيتم حظر رسائل المجموعات.
• أمان وقت التشغيل: عندما تكون كتلة الموفر مفقودة بالكامل (channels.<provider> غير موجودة)، تعود سياسة المجموعات إلى وضع مغلق افتراضيًا وآمنًا (عادةً allowlist) بدلًا من وراثة channels.defaults.groupPolicy.

1. groupPolicy ‏(open/disabled/allowlist)
2. قوائم السماح الخاصة بالمجموعات (*.groups, *.groupAllowFrom, قائمة السماح الخاصة بالقناة)
3. تقييد الإشارات (requireMention, /activation)

​

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

{
  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 هي أنماط regex آمنة وغير حساسة لحالة الأحرف؛ ويتم تجاهل الأنماط غير الصالحة وأشكال التكرار المتداخل غير الآمنة.
• الأسطح التي توفر إشارات صريحة تظل تمر؛ والأنماط هي بديل احتياطي.
• تجاوز لكل وكيل: agents.list[].groupChat.mentionPatterns (مفيد عندما تشترك عدة وكلاء في مجموعة).
• لا يتم فرض تقييد الإشارات إلا عندما يكون اكتشاف الإشارات ممكنًا (إشارات أصلية أو تم ضبط mentionPatterns).
• توجد القيم الافتراضية لـ Discord ضمن channels.discord.guilds."*" (وقابلة للتجاوز لكل guild/channel).
• يتم تغليف سياق سجل المجموعات بشكل موحد عبر القنوات وهو معلّق فقط (الرسائل التي تم تخطيها بسبب تقييد الإشارات)؛ استخدم messages.groupChat.historyLimit كقيمة افتراضية عامة وchannels.<channel>.historyLimit (أو channels.<channel>.accounts.*.historyLimit) للتجاوزات. عيّن القيمة 0 للتعطيل.

​

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

• tools: السماح/المنع للأدوات على مستوى المجموعة بالكامل.
• toolsBySender: تجاوزات لكل مرسل داخل المجموعة. استخدم بادئات مفاتيح صريحة: id:<senderId>, e164:<phone>, username:<handle>, name:<displayName>، وبديل "*" العام. ما تزال المفاتيح القديمة غير المسبوقة ببادئة مقبولة وتُطابق على أنها id: فقط.

1. تطابق toolsBySender للمجموعة/القناة
2. tools للمجموعة/القناة
3. تطابق toolsBySender الافتراضي ("*" )
4. tools الافتراضي ("*")

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

• تُطبّق قيود أدوات المجموعة/القناة بالإضافة إلى سياسة الأدوات العامة/الخاصة بالوكيل (ويظل المنع هو الغالب).
• تستخدم بعض القنوات تداخلًا مختلفًا للغرف/القنوات (مثل Discord guilds.*.channels.*، وSlack channels.*، وMicrosoft Teams teams.*.channels.*).

​

قوائم السماح الخاصة بالمجموعات

1. تعطيل كل الردود في المجموعات

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

2. السماح فقط بمجموعات محددة (WhatsApp)

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

3. السماح بكل المجموعات لكن طلب الإشارة (صراحةً)

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

4. المالك فقط يمكنه التشغيل داخل المجموعات (WhatsApp)

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

​

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

• /activation mention
• /activation always

​

حقول السياق

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

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

​

تفاصيل iMessage

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

​

تفاصيل WhatsApp