Grupy

​

Wprowadzenie dla początkujących (2 minuty)

• Grupy są ograniczone (groupPolicy: "allowlist"); nadawcy w grupach są blokowani do czasu dodania ich do listy dozwolonych.
• Odpowiedzi wymagają wzmianki, chyba że dla danej grupy wyłączono ograniczenie oparte na wzmiankach.
• Końcowy tekst odpowiedzi jest automatycznie publikowany w pokoju (visibleReplies: "automatic").

groupPolicy? disabled -> odrzuć
groupPolicy? allowlist -> grupa dozwolona? nie -> odrzuć
requireMention? tak -> wspomniano? nie -> zapisz tylko jako kontekst
wzmianka/odpowiedź/polecenie/wiadomość prywatna -> żądanie użytkownika
rozmowa w stale aktywnej grupie -> żądanie użytkownika lub zdarzenie pokoju, jeśli skonfigurowano

​

Widoczne odpowiedzi

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

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

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

​

Widoczność kontekstu i listy dozwolonych

• Autoryzacja wyzwalania: kto może uruchamiać agenta (groupPolicy, groups, groupAllowFrom, listy dozwolonych właściwe dla kanału).
• Widoczność kontekstu: jaki dodatkowy kontekst jest przekazywany do modelu (tekst odpowiedzi/cytatu, historia wątku, metadane przekazania).

​

Klucze sesji

• Sesje grupowe używają kluczy sesji agent:<agentId>:<channel>:group:<id> (pokoje i kanały używają agent:<agentId>:<channel>:channel:<id>).
• Tematy forum Telegram dodają :topic:<threadId> do identyfikatora grupy, dzięki czemu każdy temat ma własną sesję.
• Czaty bezpośrednie używają sesji głównej (lub sesji osobnych dla poszczególnych nadawców, jeśli skonfigurowano session.dmScope).
• Heartbeat działa w skonfigurowanej sesji Heartbeat (domyślnie w głównej sesji agenta); sesje grupowe nie uruchamiają własnych Heartbeat.

​

Wzorzec: osobiste wiadomości prywatne i publiczne grupy (jeden agent)

• Wiadomości prywatne: pełny zestaw narzędzi (host)
• Grupy: piaskownica i ograniczony zestaw narzędzi

{
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main", // grupy/kanały nie są główne -> działają w piaskownicy
        scope: "session", // najsilniejsza izolacja (jeden kontener na grupę/kanał)
        workspaceAccess: "none",
      },
    },
  },
  tools: {
    sandbox: {
      tools: {
        // Jeśli lista allow nie jest pusta, wszystko inne jest blokowane (deny nadal ma pierwszeństwo).
        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: [
            // ścieżkaHosta:ścieżkaKontenera:tryb
            "/home/user/FriendsShared:/data:ro",
          ],
        },
      },
    },
  },
}

• Klucze konfiguracji i wartości domyślne: Konfiguracja Gateway
• Debugowanie przyczyn blokowania narzędzia: Piaskownica a polityka narzędzi a podwyższone uprawnienia
• Szczegóły montowania powiązań: Piaskownica

​

Etykiety wyświetlania

• Etykiety interfejsu użytkownika używają displayName, jeśli jest dostępny, w formacie <channel>:<token>.
• #room jest zarezerwowany dla pokojów i kanałów; czaty grupowe używają g-<slug> (małe litery, spacje -> -, zachowaj #@+._-). Bardzo długie nieprzezroczyste identyfikatory są skracane do stabilnego tokenu, aby pełne identyfikatory tras nie trafiały do interfejsu użytkownika.

​

Polityka grup

{
  channels: {
    whatsapp: {
      groupPolicy: "disabled", // "open" | "disabled" | "allowlist"
      groupAllowFrom: ["+15551234567"],
    },
    telegram: {
      groupPolicy: "disabled",
      groupAllowFrom: ["123456789"], // numeryczny identyfikator użytkownika Telegram (konfiguracja rozpoznaje @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 },
      },
    },
  },
}

​

Wymóg wzmianki (domyślny)

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

​

Ograniczanie zakresu skonfigurowanych wzorców wzmianek

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

​

Ograniczenia narzędzi dla grup/kanałów (opcjonalne)

• tools: zezwala na narzędzia lub ich zabrania dla całej grupy (allow, alsoAllow, deny; odmowa ma pierwszeństwo).
• toolsBySender: nadpisania dla poszczególnych nadawców w grupie. Należy używać jawnych prefiksów kluczy: channel:<channelId>:<senderId>, id:<senderId>, e164:<phone>, username:<handle>, name:<displayName> oraz symbolu wieloznacznego "*". Identyfikatory kanałów używają kanonicznych identyfikatorów kanałów OpenClaw; aliasy takie jak teams są normalizowane do msteams. Starsze klucze bez prefiksów są nadal akceptowane, dopasowywane wyłącznie jako id: i powodują zapisanie ostrzeżenia o wycofaniu w dzienniku.

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

​

Listy dozwolonych grup

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

​

Aktywacja (tylko dla właściciela)

• /activation mention
• /activation always

​

Pola kontekstu

• ChatType=group
• GroupSubject (jeśli znane)
• GroupMembers (jeśli znane)
• WasMentioned (wynik bramkowania według wzmianki)
• Tematy forum Telegram zawierają również MessageThreadId i IsForum.

​

Szczegóły dotyczące iMessage

• Podczas kierowania lub tworzenia listy dozwolonych preferowane jest chat_id:<id>.
• Wyświetlanie listy czatów: imsg chats --limit 20.
• Odpowiedzi grupowe zawsze wracają do tego samego chat_id.

​

Monity systemowe WhatsApp

​

Szczegóły dotyczące WhatsApp

​

Powiązane

• Grupy rozgłoszeniowe
• Kierowanie kanałów
• Wiadomości grupowe
• Parowanie