Групи

​

Вступ для початківців (2 хвилини)

• Групи обмежені (groupPolicy: "allowlist"); відправників у групах заблоковано, доки їх не додано до списку дозволених.
• Для відповідей потрібна згадка, якщо для групи не вимкнено обмеження за згадкою.
• Остаточний текст відповіді автоматично публікується в кімнаті (visibleReplies: "automatic").

groupPolicy? disabled -> відкинути
groupPolicy? allowlist -> групу дозволено? ні -> відкинути
requireMention? так -> згадано? ні -> зберегти лише для контексту
згадка/відповідь/команда/особисте повідомлення -> запит користувача
повідомлення в постійно активній групі -> запит користувача або подія кімнати, якщо це налаштовано

​

Видимі відповіді

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

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

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

​

Видимість контексту та списки дозволених

• Авторизація активації: хто може активувати агента (groupPolicy, groups, groupAllowFrom, списки дозволених для окремих каналів).
• Видимість контексту: який додатковий контекст передається моделі (текст відповіді або цитати, історія гілки, метадані пересилання).

​

Ключі сеансів

• Групові сеанси використовують ключі сеансів agent:<agentId>:<channel>:group:<id> (кімнати й канали використовують agent:<agentId>:<channel>:channel:<id>).
• Теми форуму Telegram додають :topic:<threadId> до ідентифікатора групи, тому кожна тема має власний сеанс.
• Прямі чати використовують основний сеанс (або окремі сеанси для кожного відправника, якщо налаштовано session.dmScope).
• Heartbeat виконуються в налаштованому сеансі Heartbeat (типово — в основному сеансі агента); групові сеанси не запускають власні Heartbeat.

​

Схема: особисті повідомлення + публічні групи (один агент)

• Особисті повідомлення: усі інструменти (хост)
• Групи: ізольоване середовище й обмежені інструменти

{
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main", // групи/канали є неосновними -> в ізольованому середовищі
        scope: "session", // найсильніша ізоляція (один контейнер на групу/канал)
        workspaceAccess: "none",
      },
    },
  },
  tools: {
    sandbox: {
      tools: {
        // Якщо allow не порожній, усе інше заблоковано (deny однаково має перевагу).
        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"], // числовий ідентифікатор користувача Telegram (під час налаштування @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: { enabled: true } } },
      },
    },
    slack: {
      groupPolicy: "allowlist",
      channels: { "#general": { enabled: true } },
    },
    matrix: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["@owner:example.org"],
      groups: {
        "!roomId:example.org": { enabled: true },
        "#alias:example.org": { enabled: true },
      },
    },
  },
}

​

Вимога згадки (за замовчуванням)

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

​

Обмеження області налаштованих шаблонів згадок

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

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

​

Обмеження інструментів для групи/каналу (необов’язково)

• tools: дозволяє/забороняє інструменти для всієї групи (allow, alsoAllow, deny; заборона має перевагу).
• toolsBySender: перевизначення для окремих відправників у групі. Використовуйте явні префікси ключів: channel:<channelId>:<senderId>, id:<senderId>, e164:<phone>, username:<handle>, name:<displayName> і шаблон "*". Ідентифікатори каналів використовують канонічні ідентифікатори каналів OpenClaw; псевдоніми на кшталт teams нормалізуються до msteams. Застарілі ключі без префіксів усе ще приймаються, зіставляються лише як id: і спричиняють запис попередження про застарілість до журналу.

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

​

Списки дозволених груп

{
  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

​

Поля контексту

• ChatType=group
• GroupSubject (якщо відомо)
• GroupMembers (якщо відомо)
• WasMentioned (результат перевірки згадки)
• Теми форумів Telegram також містять MessageThreadId і IsForum.

​

Особливості iMessage

• Для маршрутизації або додавання до списку дозволених віддавайте перевагу chat_id:<id>.
• Перегляд списку чатів: imsg chats --limit 20.
• Групові відповіді завжди надсилаються назад до того самого chat_id.

​

Системні запити WhatsApp

​

Особливості WhatsApp

​

Пов’язане

• Групи розсилки
• Маршрутизація каналів
• Групові повідомлення
• Сполучення