> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Mattermost

# 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](https://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):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/mattermost
```

Checkout local (ao executar a partir de um repositório git):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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](/tools/plugin)

## 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:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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`:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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`.