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.