Saltar al contenido principal

​
Mattermost (plugin)

Estado: compatible mediante plugin (token de bot + eventos WebSocket). Se admiten canales, grupos y mensajes directos. Mattermost es una plataforma de mensajería de equipo autoalojable; consulte el sitio oficial en mattermost.com para detalles del producto y descargas.

​
Plugin requerido

Mattermost se distribuye como un plugin y no viene incluido con la instalación principal. Instale mediante la CLI (registro de npm): 
openclaw plugins install @openclaw/mattermost
Repositorio local (al ejecutar desde un repositorio git): 
openclaw plugins install ./extensions/mattermost
Si elige Mattermost durante la configuración/incorporación y se detecta un checkout de git, OpenClaw ofrecerá automáticamente la ruta de instalación local. Detalles: Plugins

​
Configuración rápida

  1. Instale el plugin de Mattermost.
  2. Cree una cuenta de bot de Mattermost y copie el token del bot.
  3. Copie la URL base de Mattermost (p. ej., https://chat.example.com).
  4. Configure OpenClaw e inicie el Gateway.
Configuración mínima: 
{
  channels: {
    mattermost: {
      enabled: true,
      botToken: "mm-token",
      baseUrl: "https://chat.example.com",
      dmPolicy: "pairing",
    },
  },
}

​
Variables de entorno (cuenta predeterminada)

Establézcalas en el host del Gateway si prefiere variables de entorno:
  • MATTERMOST_BOT_TOKEN=...
  • MATTERMOST_URL=https://chat.example.com
Las variables de entorno se aplican solo a la cuenta predeterminada (default). Otras cuentas deben usar valores de configuración.

​
Modos de chat

Mattermost responde a mensajes directos automáticamente. El comportamiento en canales se controla con chatmode:
  • oncall (predeterminado): responde solo cuando se le @menciona en los canales.
  • onmessage: responde a cada mensaje del canal.
  • onchar: responde cuando un mensaje comienza con un prefijo de activación.
Ejemplo de configuración: 
{
  channels: {
    mattermost: {
      chatmode: "onchar",
      oncharPrefixes: [">", "!"],
    },
  },
}
Notas:
  • onchar aún responde a @menciones explícitas.
  • channels.mattermost.requireMention se respeta para configuraciones heredadas, pero se prefiere chatmode.

​
Control de acceso (mensajes directos)

  • Predeterminado: channels.mattermost.dmPolicy = "pairing" (los remitentes desconocidos reciben un código de emparejamiento).
  • Aprobar mediante:
    • openclaw pairing list mattermost
    • openclaw pairing approve mattermost <CODE>
  • Mensajes directos públicos: channels.mattermost.dmPolicy="open" más channels.mattermost.allowFrom=["*"].

​
Canales (grupos)

  • Predeterminado: channels.mattermost.groupPolicy = "allowlist" (restringido por mención).
  • Agregue remitentes a la lista de permitidos con channels.mattermost.groupAllowFrom (IDs de usuario o @username).
  • Canales abiertos: channels.mattermost.groupPolicy="open" (restringido por mención).

​
Destinos para la entrega saliente

Use estos formatos de destino con openclaw message send o cron/webhooks:
  • channel:<id> para un canal
  • user:<id> para un mensaje directo
  • @username para un mensaje directo (resuelto mediante la API de Mattermost)
Los IDs simples se tratan como canales.

​
Multicuenta

Mattermost admite múltiples cuentas bajo channels.mattermost.accounts: 
{
  channels: {
    mattermost: {
      accounts: {
        default: { name: "Primary", botToken: "mm-token", baseUrl: "https://chat.example.com" },
        alerts: { name: "Alerts", botToken: "mm-token-2", baseUrl: "https://alerts.example.com" },
      },
    },
  },
}

​
Solución de problemas

  • No hay respuestas en los canales: asegúrese de que el bot esté en el canal y menciónelo (oncall), use un prefijo de activación (onchar) o establezca chatmode: "onmessage".
  • Errores de autenticación: verifique el token del bot, la URL base y si la cuenta está habilitada.
  • Problemas de multicuenta: las variables de entorno solo se aplican a la cuenta default.