Gruppi

​

Introduzione per principianti (2 minuti)

• I gruppi sono soggetti a restrizioni (groupPolicy: "allowlist"); i mittenti dei gruppi vengono bloccati finché non vengono inseriti nell’elenco consentiti.
• Le risposte richiedono una menzione, a meno che il filtro delle menzioni non venga disabilitato per un gruppo.
• Il testo della risposta finale viene pubblicato automaticamente nella stanza (visibleReplies: "automatic").

groupPolicy? disabled -> ignora
groupPolicy? allowlist -> gruppo consentito? no -> ignora
requireMention? yes -> menzionato? no -> memorizza solo come contesto
menzione/risposta/comando/messaggio diretto -> richiesta dell'utente
conversazione di gruppo sempre attiva -> richiesta dell'utente oppure evento della stanza, se configurato

​

Risposte visibili

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

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

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

​

Visibilità del contesto ed elenchi consentiti

• Autorizzazione all’attivazione: chi può attivare l’agente (groupPolicy, groups, groupAllowFrom, elenchi consentiti specifici per canale).
• Visibilità del contesto: quale contesto supplementare viene inserito nel modello (testo di risposte/citazioni, cronologia dei thread, metadati inoltrati).

​

Chiavi di sessione

• Le sessioni di gruppo usano chiavi di sessione agent:<agentId>:<channel>:group:<id> (le stanze/i canali usano agent:<agentId>:<channel>:channel:<id>).
• Gli argomenti dei forum di Telegram aggiungono :topic:<threadId> all’id del gruppo, affinché ogni argomento disponga di una propria sessione.
• Le chat dirette usano la sessione principale (oppure sessioni per mittente, se è configurato session.dmScope).
• Gli Heartbeat vengono eseguiti nella sessione Heartbeat configurata (impostazione predefinita: la sessione principale dell’agente); le sessioni di gruppo non eseguono Heartbeat propri.

​

Schema: messaggi diretti personali + gruppi pubblici (agente singolo)

• Messaggi diretti: strumenti completi (host)
• Gruppi: sandbox + strumenti con restrizioni

{
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main", // i gruppi/canali non sono principali -> vengono eseguiti in sandbox
        scope: "session", // isolamento massimo (un container per gruppo/canale)
        workspaceAccess: "none",
      },
    },
  },
  tools: {
    sandbox: {
      tools: {
        // Se allow non è vuoto, tutto il resto viene bloccato (deny continua ad avere la precedenza).
        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",
          ],
        },
      },
    },
  },
}

• Chiavi di configurazione e valori predefiniti: Configurazione del Gateway
• Debug dei motivi per cui uno strumento è bloccato: Sandbox, criteri degli strumenti ed esecuzione con privilegi elevati
• Dettagli sui montaggi bind: Esecuzione in sandbox

​

Etichette di visualizzazione

• Le etichette dell’interfaccia utente usano displayName quando disponibile, nel formato <channel>:<token>.
• #room è riservato alle stanze/ai canali; le chat di gruppo usano g-<slug> (minuscolo, spazi -> -, mantenere #@+._-). Gli id opachi molto lunghi vengono abbreviati in un token stabile anziché mostrare nell’interfaccia utente gli id completi delle route.

​

Criteri per i gruppi

{
  channels: {
    whatsapp: {
      groupPolicy: "disabled", // "open" | "disabled" | "allowlist"
      groupAllowFrom: ["+15551234567"],
    },
    telegram: {
      groupPolicy: "disabled",
      groupAllowFrom: ["123456789"], // ID utente numerico di Telegram (la configurazione risolve @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 },
      },
    },
  },
}

​

Filtro per menzione (predefinito)

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

​

Definire l’ambito dei modelli di menzione configurati

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

​

Restrizioni degli strumenti per gruppo/canale (facoltative)

• tools: consente/nega gli strumenti per l’intero gruppo (allow, alsoAllow, deny; la negazione prevale).
• toolsBySender: sostituzioni per singolo mittente all’interno del gruppo. Usare prefissi di chiave espliciti: channel:<channelId>:<senderId>, id:<senderId>, e164:<phone>, username:<handle>, name:<displayName> e il carattere jolly "*". Gli ID dei canali usano gli ID canonici dei canali OpenClaw; gli alias come teams vengono normalizzati in msteams. Le chiavi legacy senza prefisso sono ancora accettate, corrispondono solo come id: e generano un avviso di deprecazione nel registro.

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

​

Elenchi di autorizzazione dei gruppi

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

​

Attivazione (solo proprietario)

• /activation mention
• /activation always

​

Campi del contesto

• ChatType=group
• GroupSubject (se noto)
• GroupMembers (se noto)
• WasMentioned (risultato del controllo delle menzioni)
• Gli argomenti dei forum Telegram includono anche MessageThreadId e IsForum.

​

Dettagli specifici di iMessage

• Preferire chat_id:<id> per l’instradamento o l’inserimento negli elenchi di autorizzazione.
• Elencare le chat: imsg chats --limit 20.
• Le risposte di gruppo vengono sempre inviate allo stesso chat_id.

​

Prompt di sistema di WhatsApp

​

Dettagli specifici di WhatsApp

​

Argomenti correlati

• Gruppi di trasmissione
• Instradamento dei canali
• Messaggi di gruppo
• Associazione