​

Guruhlar

​

Boshlang‘ich kirish (2 daqiqa)

• Guruhlar cheklangan (groupPolicy: "allowlist").
• Javoblar uchun siz mention gating’ni ataylab o‘chirib qo‘ymaguningizcha, tilga olish (mention) talab qilinadi.

TL;DR

• DM access is controlled by *.allowFrom.
• Group access is controlled by *.groupPolicy + allowlists (*.groups, *.groupAllowFrom).
• Reply triggering is controlled by mention gating (requireMention, /activation).

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

​

4. Sessiya kalitlari

• 5. Guruh sessiyalari agent:<agentId>:<channel>:group:<id> sessiya kalitlaridan foydalanadi (xonalar/kanallar agent:<agentId>:<channel>:channel:<id> dan foydalanadi).
• 6. Telegram forum mavzulari guruh identifikatoriga :topic:<threadId> qoʻshadi, shuning uchun har bir mavzu alohida sessiyaga ega boʻladi.
• 7. Toʻgʻridan-toʻgʻri chatlar asosiy sessiyadan foydalanadi (yoki sozlangan boʻlsa, joʻnatuvchi boʻyicha alohida).
• 8. Yurak urishlari (heartbeats) guruh sessiyalari uchun oʻtkazib yuboriladi.

​

9. Andoza: shaxsiy DMlar + ommaviy guruhlar (bitta agent)

10. Ha — agar “shaxsiy” trafikingiz DMlar va “ommaviy” trafikingiz guruhlar boʻlsa, bu juda yaxshi ishlaydi.
11. Sabab: bitta-agent rejimida DMlar odatda asosiy sessiya kalitiga (agent:main:main) tushadi, guruhlar esa har doim asosiy boʻlmagan sessiya kalitlaridan foydalanadi (agent:main:<channel>:group:<id>). 12. Agar mode: "non-main" bilan sandboxingni yoqsangiz, guruh sessiyalari Docker’da ishlaydi, asosiy DM sessiyangiz esa xostda qoladi.
12. Bu sizga bitta agent “miyasi”ni (umumiy ish maydoni + xotira), ammo ikki xil bajarilish holatini beradi:

• 14. DMlar: toʻliq vositalar (xost)
• 15. Guruhlar: sandbox + cheklangan vositalar (Docker)

16. Agar haqiqatan ham alohida ish maydonlari/personalar kerak boʻlsa (“shaxsiy” va “ommaviy” hech qachon aralashmasligi kerak), ikkinchi agent + bogʻlashlardan foydalaning. 17. Qarang: Multi-Agent Routing.

18. Misol (DMlar xostda, guruhlar sandboxlangan + faqat xabar almashish vositalari):

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

20. “Guruhlar faqat X papkani koʻra olsin” deganini “xostga umuman kirish yoʻq” oʻrniga xohlaysizmi? 21. workspaceAccess: "none" ni saqlang va faqat ruxsat etilgan yoʻllarni sandboxga ulang:

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

23. Bogʻliq:

• 24. Sozlama kalitlari va standartlari: Gateway configuration
• 25. Vosita nima uchun bloklanganini sozlash: Sandbox vs Tool Policy vs Elevated
• 26. Bind mount tafsilotlari: Sandboxing

​

27. Koʻrsatish yorliqlari

• 28. UI yorliqlari mavjud boʻlsa displayName dan foydalanadi, <channel>:<token> formatida.
• 29. #room xonalar/kanallar uchun band qilingan; guruh chatlari g-<slug> dan foydalanadi (kichik harflar, bo‘shliqlar -> -, #@+._- saqlanadi).

​

30. Guruh siyosati

31. Har bir kanal boʻyicha guruh/xona xabarlari qanday qayta ishlanishini boshqaring:

32. {
  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 },
      },
    },
  },
}

41. Eslatmalar:

• 42. groupPolicy eslatma-cheklashdan alohida (u @eslatmalarni talab qiladi).
• 43. WhatsApp/Telegram/Signal/iMessage/Microsoft Teams: groupAllowFrom dan foydalaning (zaxira: aniq allowFrom).
• 44. Discord: allowlist channels.discord.guilds.<id> dan foydalanadi45. .channels.
• 46. Slack: allowlist channels.slack.channels dan foydalanadi.
• 47. Matrix: allowlist channels.matrix.groups dan foydalanadi (xona IDlari, aliaslar yoki nomlar). 48. Joʻnatuvchilarni cheklash uchun channels.matrix.groupAllowFrom dan foydalaning; xonaga xos users allowlistlari ham qoʻllab-quvvatlanadi.
• 49. Guruh DMlari alohida boshqariladi (channels.discord.dm.*, channels.slack.dm.*).
• 50. Telegram allowlist foydalanuvchi IDlarini ("123456789", "telegram:123456789", "tg:123456789") yoki foydalanuvchi nomlarini ("@alice" yoki "alice") moslashtirishi mumkin; prefikslar katta-kichik harfga sezgir emas.
• Default is groupPolicy: "allowlist"; if your group allowlist is empty, group messages are blocked.

1. groupPolicy (open/disabled/allowlist)
2. guruh allowlistlari (*.groups, *.groupAllowFrom, kanalga xos allowlist)
3. mention gating (requireMention, /activation)

​

Mention gating (standart)

{
  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 katta-kichik harfga sezgir bo‘lmagan regexlardir.
• Aniq mentionlarni taqdim etadigan interfeyslar baribir o‘tkaziladi; patternlar zaxira sifatida ishlatiladi.
• Agent bo‘yicha override: agents.list[].groupChat.mentionPatterns (bir nechta agentlar bitta guruhni bo‘lishganda foydali).
• Mention gating is only enforced when mention detection is possible (native mentions or mentionPatterns are configured).
• Discord standartlari channels.discord.guilds."*" da joylashgan (guild/kanal bo‘yicha o‘zgartirilishi mumkin).
• Guruh tarix konteksti barcha kanallarda bir xil tarzda o‘raladi va faqat pending (mention gating sababli o‘tkazib yuborilgan xabarlar); global standart uchun messages.groupChat.historyLimit dan foydalaning va override uchun channels.<channel>.historyLimit(yokichannels.<channel>.accounts.*.historyLimit) dan foydalaning. O‘chirish uchun 0 ni o‘rnating.

​

Guruh/kanal asbob cheklovlari (ixtiyoriy)

• tools: butun guruh uchun asboblarni allow/deny qilish.
• toolsBySender: guruh ichida jo‘natuvchi bo‘yicha override (kalitlar kanalga qarab jo‘natuvchi IDlari/foydalanuvchi nomlari/email/telefon raqamlari bo‘lishi mumkin). Wildcard sifatida "*" dan foydalaning.

1. guruh/kanal toolsBySender mos kelishi
2. guruh/kanal tools
3. standart ("*") toolsBySender mos kelishi
4. standart ("*") tools

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

• Guruh/kanal asbob cheklovlari global/agent asbob siyosatiga qo‘shimcha ravishda qo‘llanadi (deny baribir ustun).
• Baʼzi kanallar xonalar/kanallar uchun boshqa ichki tuzilmani ishlatadi (masalan, Discord guilds.*.channels.*, Slack channels.*, MS Teams teams.*.channels.*).

​

Guruh allowlistlari

1. Barcha guruh javoblarini o‘chirish

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

2. Faqat muayyan guruhlarga ruxsat berish (WhatsApp)

{
  channels: {
    whatsapp: {
      groups: {
        "[email protected]": { requireMention: true },
        "[email protected]": { requireMention: false },
      },
    },
  },
}

3. Barcha guruhlarga ruxsat berish, lekin mention talab qilish (aniq)

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

4. Guruhlarda faqat egasi trigger qila oladi (WhatsApp)

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

​

Faollashtirish (faqat egasi)

• /activation mention
• /activation always

​

Kontekst maydonlari

• ChatType=group
• GroupSubject (agar ma’lum bo‘lsa)
• GroupMembers (agar ma’lum bo‘lsa)
• WasMentioned (mention gating natijasi)
• Telegram forum mavzulari, shuningdek, MessageThreadId va IsForum ni ham o‘z ichiga oladi.

​

iMessage ga xos jihatlar

• Yo‘naltirish yoki ruxsat ro‘yxatiga olishda chat_id:<id> ni afzal ko‘ring.
• Chatlarni ro‘yxatlash: imsg chats --limit 20.
• Guruh javoblari har doim bir xil chat_id ga qaytadi.

​

WhatsApp ga xos jihatlar