Mattermost

​

Instalacja

openclaw plugins install @openclaw/mattermost

openclaw plugins install ./path/to/local/mattermost-plugin

​

Szybka konfiguracja

{
  channels: {
    mattermost: {
      enabled: true,
      botToken: "mm-token",
      baseUrl: "https://chat.example.com",
      dmPolicy: "pairing",
    },
  },
}

openclaw channels add --channel mattermost --bot-token <token> --http-url https://chat.example.com

​

Natywne polecenia ukośnikowe

{
  channels: {
    mattermost: {
      commands: {
        native: true,
        nativeSkills: true,
        callbackPath: "/api/channels/mattermost/command",
        // Użyj, gdy Mattermost nie może bezpośrednio uzyskać dostępu do Gateway (odwrotne proxy/publiczny adres URL).
        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",
      },
    },
  },
}

​

Zmienne środowiskowe (konto domyślne)

• MATTERMOST_BOT_TOKEN=...
• MATTERMOST_URL=https://chat.example.com

​

Tryby czatu

{
  channels: {
    mattermost: {
      chatmode: "onchar",
      oncharPrefixes: [">", "!"], // domyślnie
    },
  },
}

• onchar nadal odpowiada na jawne @wzmianki.
• channels.mattermost.requireMention jest nadal uwzględniane, ale preferowane jest chatmode. Ustawienia groups.<channelId>.requireMention poszczególnych kanałów mają pierwszeństwo przed oboma.
• Gdy bot wyśle widoczną odpowiedź w wątku kanału, na późniejsze wiadomości w tym samym wątku odpowiada bez nowej @wzmianki lub prefiksu onchar, dzięki czemu wieloetapowe rozmowy w wątku mogą być płynnie kontynuowane. Udział jest zapamiętywany przez 7 dni od ostatniej odpowiedzi bota w danym wątku i zachowywany po ponownym uruchomieniu Gateway. Nie wpływa to na wątki, które bot tylko obserwował; aby ponownie wymagać jawnej wzmianki, należy rozpocząć nową wiadomość najwyższego poziomu.

​

Wątki i sesje

• off (domyślnie): odpowiedź trafia do wątku tylko wtedy, gdy post przychodzący już się w nim znajduje.
• first: w przypadku postów najwyższego poziomu na kanałach lub w grupach rozpoczyna wątek pod danym postem i kieruje rozmowę do sesji powiązanej z wątkiem.
• all i batched: obecnie w Mattermost działają tak samo jak first, ponieważ po utworzeniu głównego postu wątku w Mattermost kolejne fragmenty i multimedia pozostają w tym samym wątku.
• Wiadomości bezpośrednie domyślnie używają off, nawet gdy ustawiono replyToMode.

• off (domyślnie): wiadomości bezpośrednie pozostają poza wątkami w jednej ciągłej sesji.
• first, all lub batched: każda wiadomość bezpośrednia najwyższego poziomu rozpoczyna wątek Mattermost obsługiwany przez nową, niezależną sesję.

{
  channels: {
    mattermost: {
      replyToMode: "all",
      replyToModeByChatType: {
        direct: "first",
      },
    },
  },
}

• Sesje powiązane z wątkiem używają identyfikatora postu wyzwalającego jako głównego postu wątku.
• first i all są obecnie równoważne, ponieważ po utworzeniu głównego postu wątku w Mattermost kolejne fragmenty i multimedia pozostają w tym samym wątku.
• Ustawienia dla poszczególnych typów czatu mają pierwszeństwo przed replyToMode. Bez ustawienia direct istniejące wdrożenia zachowują płaskie wiadomości bezpośrednie bez wątków.

​

Kontrola dostępu (wiadomości bezpośrednie)

• Domyślnie: channels.mattermost.dmPolicy = "pairing" (nieznani nadawcy otrzymują kod parowania). Inne wartości: allowlist, open, disabled.
• Zatwierdzanie za pomocą:
  • openclaw pairing list mattermost
  • openclaw pairing approve mattermost <CODE>
• Publiczne wiadomości bezpośrednie: channels.mattermost.dmPolicy="open" oraz channels.mattermost.allowFrom=["*"] (schemat konfiguracji wymusza symbol wieloznaczny).
• channels.mattermost.allowFrom przyjmuje identyfikatory użytkowników (zalecane) oraz wpisy accessGroup:<name>. Zobacz Grupy dostępu.

​

Kanały (grupy)

• Domyślnie: channels.mattermost.groupPolicy = "allowlist" (wymaga wzmianki).
• Nadawców można dodać do listy dozwolonych za pomocą channels.mattermost.groupAllowFrom (zalecane są identyfikatory użytkowników).
• channels.mattermost.groupAllowFrom przyjmuje wpisy accessGroup:<name>. Zobacz Grupy dostępu.
• Ustawienia wzmianki dla poszczególnych kanałów znajdują się w channels.mattermost.groups.<channelId>.requireMention, a wartość domyślna w channels.mattermost.groups["*"].requireMention.
• Dopasowanie @username jest zmienne i włączone tylko wtedy, gdy channels.mattermost.dangerouslyAllowNameMatching: true.
• Otwarte kanały: channels.mattermost.groupPolicy="open" (wymagają wzmianki).
• Kolejność rozpoznawania: channels.mattermost.groupPolicy, następnie channels.defaults.groupPolicy, a potem "allowlist".
• Uwaga dotycząca środowiska wykonawczego: jeśli sekcja channels.mattermost jest całkowicie nieobecna, środowisko wykonawcze bezpiecznie stosuje groupPolicy="allowlist" podczas kontroli grup (nawet jeśli ustawiono channels.defaults.groupPolicy) i rejestruje jednorazowe ostrzeżenie.

{
  channels: {
    mattermost: {
      groupPolicy: "open",
      groups: {
        "*": { requireMention: true },
        "team-channel-id": { requireMention: false },
      },
    },
  },
}

​

Cele dostarczania wychodzącego

​

Ponawianie dla kanału wiadomości bezpośrednich

{
  channels: {
    mattermost: {
      dmChannelRetry: {
        maxRetries: 3,
        initialDelayMs: 1000,
        maxDelayMs: 10000,
        timeoutMs: 30000,
      },
    },
  },
}

• Dotyczy to wyłącznie tworzenia kanału rozmowy prywatnej (/api/v4/channels/direct), a nie każdego wywołania API Mattermost.
• Ponowienia wykorzystują wykładniczo rosnące opóźnienie z losowym rozrzutem i dotyczą przejściowych niepowodzeń, takich jak limity częstotliwości, odpowiedzi 5xx oraz błędy sieciowe lub przekroczenia limitu czasu.
• Błędy klienta 4xx inne niż 429 są uznawane za trwałe i próby nie są ponawiane.

​

Strumieniowe przesyłanie podglądu

{
  channels: {
    mattermost: {
      streaming: { mode: "partial" }, // off | partial | block | progress
    },
  },
}

​

Reakcje (narzędzie wiadomości)

• Użyj message action=react z channel=mattermost.
• messageId to identyfikator wpisu Mattermost.
• emoji przyjmuje nazwy takie jak thumbsup lub :+1: (dwukropki są opcjonalne).
• Ustaw remove=true (wartość logiczna), aby usunąć reakcję.
• Zdarzenia dodawania i usuwania reakcji są przekazywane jako zdarzenia systemowe do kierowanej sesji agenta i podlegają tym samym kontrolom zasad rozmów prywatnych/grupowych co wiadomości.

message action=react channel=mattermost target=channel:<channelId> messageId=<postId> emoji=thumbsup
message action=react channel=mattermost target=channel:<channelId> messageId=<postId> emoji=thumbsup remove=true

• channels.mattermost.actions.reactions: włącza/wyłącza akcje reakcji (domyślnie true).
• Nadpisanie dla konta: channels.mattermost.accounts.<id>.actions.reactions.

​

Przyciski interaktywne (narzędzie wiadomości)

message action=send channel=mattermost target=channel:<channelId> presentation={"blocks":[{"type":"buttons","buttons":[{"label":"Tak","value":"yes"},{"label":"Nie","value":"no"}]}]}

{
  channels: {
    mattermost: {
      capabilities: ["inlineButtons"],
    },
  },
}

​

Bezpośrednia integracja z API (skrypty zewnętrzne)

{
  channel_id: "<channelId>",
  message: "Wybierz opcję:",
  props: {
    attachments: [
      {
        actions: [
          {
            id: "mybutton01", // tylko znaki alfanumeryczne — patrz poniżej
            type: "button", // wymagane, w przeciwnym razie kliknięcia są po cichu ignorowane
            name: "Zatwierdź", // wyświetlana etykieta
            style: "primary", // opcjonalne: "default", "primary", "danger"
            integration: {
              url: "https://gateway.example.com/mattermost/interactions/default",
              context: {
                action_id: "mybutton01", // musi odpowiadać identyfikatorowi przycisku
                action: "approve",
                // ... dowolne pola niestandardowe ...
                _token: "<hmac>", // patrz sekcja HMAC poniżej
              },
            },
          },
        ],
      },
    ],
  },
}

import hmac, hashlib, json

secret = hmac.new(
    b"openclaw-mattermost-interactions",
    bot_token.encode(), hashlib.sha256
).hexdigest()

ctx = {"action_id": "mybutton01", "action": "approve"}
payload = json.dumps(ctx, sort_keys=True, separators=(",", ":"))
token = hmac.new(secret.encode(), payload.encode(), hashlib.sha256).hexdigest()

context = {**ctx, "_token": token}

​

Adapter katalogu

​

Wiele kont

{
  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" },
      },
    },
  },
}

​

Rozwiązywanie problemów

​

Powiązane materiały

• Trasowanie kanałów — trasowanie sesji dla wiadomości
• Przegląd kanałów — wszystkie obsługiwane kanały
• Grupy — działanie czatu grupowego i ograniczanie za pomocą wzmianek
• Parowanie — uwierzytelnianie w wiadomościach bezpośrednich i proces parowania
• Bezpieczeństwo — model dostępu i wzmacnianie zabezpieczeń