Saltar para o conteúdo principal

​
Mattermost (plugin)

Status: suportado via plugin (token de bot + eventos WebSocket). Canais, grupos e DMs são suportados. Mattermost é uma plataforma de mensagens de equipe auto-hospedável; veja o site oficial em mattermost.com para detalhes do produto e downloads.

​
Plugin obrigatório

O Mattermost é distribuído como um plugin e não vem incluído na instalação principal. Instale via CLI (registro npm): 
openclaw plugins install @openclaw/mattermost
Checkout local (ao executar a partir de um repositório git): 
openclaw plugins install ./extensions/mattermost
Se você escolher Mattermost durante a configuração/integração inicial e um checkout git for detectado, o OpenClaw oferecerá automaticamente o caminho de instalação local. Detalhes: Plugins

​
Início rápido

  1. Instale o plugin do Mattermost.
  2. Crie uma conta de bot no Mattermost e copie o token do bot.
  3. Copie a URL base do Mattermost (por exemplo, https://chat.example.com).
  4. Configure o OpenClaw e inicie o gateway.
Configuração mínima: 
{
  channels: {
    mattermost: {
      enabled: true,
      botToken: "mm-token",
      baseUrl: "https://chat.example.com",
      dmPolicy: "pairing",
    },
  },
}

​
Variáveis de ambiente (conta padrão)

Defina estas no host do Gateway se preferir variáveis de ambiente:
  • MATTERMOST_BOT_TOKEN=...
  • MATTERMOST_URL=https://chat.example.com
As variáveis de ambiente se aplicam apenas à conta padrão (default). Outras contas devem usar valores de configuração.

​
Modos de chat

O Mattermost responde automaticamente a DMs. O comportamento em canais é controlado por chatmode:
  • oncall (padrão): responde apenas quando @mencionado em canais.
  • onmessage: responde a todas as mensagens do canal.
  • onchar: responde quando uma mensagem começa com um prefixo de gatilho.
Exemplo de configuração: 
{
  channels: {
    mattermost: {
      chatmode: "onchar",
      oncharPrefixes: [">", "!"],
    },
  },
}
Notas:
  • onchar ainda responde a @menções explícitas.
  • channels.mattermost.requireMention é respeitado para configurações legadas, mas chatmode é preferido.

​
Controle de acesso (DMs)

  • Padrão: channels.mattermost.dmPolicy = "pairing" (remetentes desconhecidos recebem um código de pareamento).
  • Aprovar via:
    • openclaw pairing list mattermost
    • openclaw pairing approve mattermost <CODE>
  • DMs públicas: channels.mattermost.dmPolicy="open" mais channels.mattermost.allowFrom=["*"].

​
Canais (grupos)

  • Padrão: channels.mattermost.groupPolicy = "allowlist" (controlado por menção).
  • Permitir remetentes por lista de permissões com channels.mattermost.groupAllowFrom (IDs de usuário ou @username).
  • Canais abertos: channels.mattermost.groupPolicy="open" (controlado por menção).

​
Alvos para entrega de saída

Use estes formatos de destino com openclaw message send ou cron/webhooks:
  • channel:<id> para um canal
  • user:<id> para uma DM
  • @username para uma DM (resolvida via a API do Mattermost)
IDs simples são tratados como canais.

​
Múltiplas contas

O Mattermost suporta múltiplas contas em 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" },
      },
    },
  },
}

​
Solução de problemas

  • Sem respostas em canais: verifique se o bot está no canal e mencione-o (oncall), use um prefixo de gatilho (onchar) ou defina chatmode: "onmessage".
  • Erros de autenticação: verifique o token do bot, a URL base e se a conta está habilitada.
  • Problemas com múltiplas contas: variáveis de ambiente se aplicam apenas à conta default.