Hoppa till huvudinnehåll

​
Mattermost (plugin)

Status: stöds via plugin (bot-token + WebSocket-händelser). Kanaler, grupper och DMs stöds. Mattermost är en plattform för teammeddelande; se den officiella webbplatsen på mattermost.com för produktdetaljer och nedladdningar.

​
Plugin krävs

Mattermost levereras som ett plugin och ingår inte i kärninstallationen. Installera via CLI (npm-registret): 
openclaw plugins install @openclaw/mattermost
Lokal checkout (när du kör från ett git-repo): 
openclaw plugins install ./extensions/mattermost
Om du väljer Mattermost under konfigurering/introduktion och en git-checkout upptäcks, erbjuder OpenClaw automatiskt den lokala installationssökvägen. Detaljer: Plugins

​
Snabbstart

  1. Installera Mattermost-pluginet.
  2. Skapa ett Mattermost-botkonto och kopiera bot-token.
  3. Kopiera Mattermost bas-URL (t.ex., ‘https://chat.example.com’).
  4. Konfigurera OpenClaw och starta gatewayn.
Minimal konfig: 
{
  channels: {
    mattermost: {
      enabled: true,
      botToken: "mm-token",
      baseUrl: "https://chat.example.com",
      dmPolicy: "pairing",
    },
  },
}

​
Miljövariabler (standardkonto)

Sätt dessa på gateway-värden om du föredrar miljövariabler:
  • MATTERMOST_BOT_TOKEN=...
  • MATTERMOST_URL=https://chat.example.com
Env vars gäller endast för kontot standard (default). Andra konton måste använda konfigurationsvärden.

​
Chattlägen

Mattermost svarar på DMs automatiskt. Kanalbeteende styrs av chatmode:
  • oncall (standard): svara endast när boten @omnämns i kanaler.
  • onmessage: svara på varje kanalmeddelande.
  • onchar: svara när ett meddelande börjar med ett trigger-prefix.
Konfigexempel: 
{
  channels: {
    mattermost: {
      chatmode: "onchar",
      oncharPrefixes: [">", "!"],
    },
  },
}
Noteringar:
  • onchar svarar fortfarande på explicita @omnämnanden.
  • channels.mattermost.requireMention respekteras för äldre konfigar men chatmode föredras.

​
Åtkomstkontroll (DM:er)

  • Standard: channels.mattermost.dmPolicy = "pairing" (okända avsändare får en parningskod).
  • Godkänn via:
    • openclaw pairing list mattermost
    • openclaw pairing approve mattermost <CODE>
  • Offentliga DM:er: channels.mattermost.dmPolicy="open" plus channels.mattermost.allowFrom=["*"].

​
Kanaler (grupper)

  • Standard: channels.mattermost.groupPolicy = "allowlist" (omnämningsstyrt).
  • Tillåtelselista av avsändare med channels.mattermost.groupAllowFrom (användar-ID:n eller @username).
  • Öppna kanaler: channels.mattermost.groupPolicy="open" (omnämningsstyrt).

​
Mål för utgående leverans

Använd dessa målformat med openclaw message send eller cron/webhooks:
  • channel:<id> för en kanal
  • user:<id> för en DM
  • @username för en DM (upplöst via Mattermost-API:t)
Rena ID:n behandlas som kanaler.

​
Flerkonton

Mattermost stöder flera konton under 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" },
      },
    },
  },
}

​
Felsökning

  • Inga svar i kanaler: säkerställ att boten är med i kanalen och omnämn den (oncall), använd ett trigger-prefix (onchar) eller sätt chatmode: "onmessage".
  • Autentiseringsfel: kontrollera bot-token, bas-URL och om kontot är aktiverat.
  • Flerkontoproblem: miljövariabler gäller endast för default-kontot.