​

المجموعات

​

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

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

TL;DR

• الوصول إلى الرسائل الخاصة (DM) يتحكّم به *.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

​

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

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

​

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

• DMs: أدوات كاملة (المضيف)
• المجموعات: sandbox + أدوات مقيّدة (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
            "~/FriendsShared:/data:ro",
          ],
        },
      },
    },
  },
}

• مفاتيح التهيئة والقيم الافتراضية: تهيئة Gateway
• تصحيح سبب حظر أداة: Sandbox مقابل سياسة الأدوات مقابل الرفع
• تفاصيل bind mounts: Sandboxing

​

تسميات العرض

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

​

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

{
  channels: {
    whatsapp: {
      groupPolicy: "disabled", // "open" | "disabled" | "allowlist"
      groupAllowFrom: ["+15551234567"],
    },
    telegram: {
      groupPolicy: "disabled",
      groupAllowFrom: ["123456789", "@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": { allow: true },
        "#alias:example.org": { allow: true },
      },
    },
  },
}

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

1. groupPolicy (مفتوح/معطّل/قائمة سماح)
2. قوائم السماح للمجموعات (*.groups, *.groupAllowFrom, قائمة السماح الخاصة بالقناة)
3. بوابة الإشارات (requireMention, /activation)

​

البوابة (افتراضي)

{
  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,
        },
      },
    ],
  },
}

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

​

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

• tools: السماح/المنع للأدوات على مستوى المجموعة بالكامل.
• toolsBySender: تجاوزات لكل مرسل داخل المجموعة (المفاتيح هي معرّفات المرسلين/أسماء المستخدمين/عناوين البريد/أرقام الهواتف حسب القناة). استخدم "*" كرمز شامل.

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

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

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

​

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

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

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

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

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

​

خصوصيات iMessage

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

​

خصوصيات WhatsApp