Grupos

​

Introducción para principiantes (2 minutos)

• Los grupos están restringidos (groupPolicy: "allowlist"); los remitentes de grupos están bloqueados hasta que se incluyan en la lista de permitidos.
• Las respuestas requieren una mención, a menos que se desactive el requisito de mención para un grupo.
• El texto de la respuesta final se publica automáticamente en la sala (visibleReplies: "automatic").

¿groupPolicy? disabled -> descartar
¿groupPolicy? allowlist -> ¿grupo permitido? no -> descartar
¿requireMention? sí -> ¿se mencionó? no -> almacenar solo como contexto
mención/respuesta/comando/DM -> solicitud del usuario
conversación de grupo siempre activa -> solicitud del usuario o evento de sala cuando esté configurado

​

Respuestas visibles

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

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

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

​

Visibilidad del contexto y listas de permitidos

• Autorización de activación: quién puede activar el agente (groupPolicy, groups, groupAllowFrom, listas de permitidos específicas del canal).
• Visibilidad del contexto: qué contexto complementario se inyecta en el modelo (texto de respuestas/citas, historial del hilo, metadatos reenviados).

​

Claves de sesión

• Las sesiones de grupos usan claves de sesión agent:<agentId>:<channel>:group:<id> (las salas/canales usan agent:<agentId>:<channel>:channel:<id>).
• Los temas de foros de Telegram añaden :topic:<threadId> al id del grupo para que cada tema tenga su propia sesión.
• Los chats directos usan la sesión principal (o sesiones por remitente si se configura session.dmScope).
• Los Heartbeats se ejecutan en la sesión de Heartbeat configurada (de forma predeterminada, la sesión principal del agente); las sesiones de grupos no ejecutan sus propios Heartbeats.

​

Patrón: mensajes directos personales + grupos públicos (un solo agente)

• Mensajes directos: herramientas completas (host)
• Grupos: entorno aislado + herramientas restringidas

{
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main", // los grupos/canales no son principales -> aislados
        scope: "session", // aislamiento máximo (un contenedor por grupo/canal)
        workspaceAccess: "none",
      },
    },
  },
  tools: {
    sandbox: {
      tools: {
        // Si allow no está vacío, todo lo demás se bloquea (deny sigue teniendo prioridad).
        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",
          ],
        },
      },
    },
  },
}

• Claves de configuración y valores predeterminados: Configuración del Gateway
• Depuración de los motivos por los que se bloquea una herramienta: Entorno aislado frente a política de herramientas frente a permisos elevados
• Detalles de los montajes vinculados: Aislamiento

​

Etiquetas visibles

• Las etiquetas de la interfaz usan displayName cuando está disponible, con el formato <channel>:<token>.
• #room está reservado para salas/canales; los chats de grupo usan g-<slug> (minúsculas, espacios -> -, conservar #@+._-). Los id opacos muy largos se acortan a un token estable en lugar de exponer los id completos de las rutas en la interfaz.

​

Política de grupos

{
  channels: {
    whatsapp: {
      groupPolicy: "disabled", // "open" | "disabled" | "allowlist"
      groupAllowFrom: ["+15551234567"],
    },
    telegram: {
      groupPolicy: "disabled",
      groupAllowFrom: ["123456789"], // id numérico de usuario de Telegram (la configuración resuelve @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 },
      },
    },
  },
}

​

Requisito de mención (predeterminado)

{
  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: {
    entries: {
      main: {
        groupChat: {
          mentionPatterns: ["@openclaw", "openclaw", "\\+15555550123"],
          historyLimit: 50,
        },
      },
    },
  },
}

​

Delimitación de los patrones de mención configurados

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

​

Restricciones de herramientas por grupo/canal (opcional)

• tools: permite/deniega herramientas para todo el grupo (allow, alsoAllow, deny; la denegación prevalece).
• toolsBySender: anulaciones por remitente dentro del grupo. Usa prefijos de clave explícitos: channel:<channelId>:<senderId>, id:<senderId>, e164:<phone>, username:<handle>, name:<displayName> y el comodín "*". Los identificadores de canal usan los identificadores de canal canónicos de OpenClaw; los alias como teams se normalizan como msteams. Las claves heredadas sin prefijo se siguen aceptando, solo se comparan como id: y registran una advertencia de obsolescencia.

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

​

Listas de grupos permitidos

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

​

Activación (solo para el propietario)

• /activation mention
• /activation always

​

Campos de contexto

• ChatType=group
• GroupSubject (si se conoce)
• GroupMembers (si se conoce)
• WasMentioned (resultado de la restricción por mención)
• Los temas de los foros de Telegram también incluyen MessageThreadId y IsForum.

​

Aspectos específicos de iMessage

• Se recomienda chat_id:<id> para el enrutamiento o las listas de permitidos.
• Enumerar chats: imsg chats --limit 20.
• Las respuestas de grupo siempre se devuelven al mismo chat_id.

​

Prompts del sistema de WhatsApp

​

Aspectos específicos de WhatsApp

​

Contenido relacionado

• Grupos de difusión
• Enrutamiento de canales
• Mensajes de grupo
• Emparejamiento