Mattermost

​

Kurulum

openclaw plugins install @openclaw/mattermost

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

​

Hızlı kurulum

{
  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

​

Yerel eğik çizgi komutları

{
  channels: {
    mattermost: {
      commands: {
        native: true,
        nativeSkills: true,
        callbackPath: "/api/channels/mattermost/command",
        // Mattermost gateway'e doğrudan erişemediğinde kullanın (ters proxy/genel URL).
        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",
      },
    },
  },
}

​

Ortam değişkenleri (varsayılan hesap)

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

​

Sohbet modları

{
  channels: {
    mattermost: {
      chatmode: "onchar",
      oncharPrefixes: [">", "!"], // varsayılan
    },
  },
}

• onchar açık @bahsetmelerine yanıt vermeye devam eder.
• channels.mattermost.requireMention hâlâ dikkate alınır, ancak chatmode tercih edilir. Kanal başına groups.<channelId>.requireMention ayarları her ikisinden de önceliklidir.
• Bot bir kanal ileti dizisinde görünür bir yanıt gönderdikten sonra, aynı ileti dizisindeki sonraki mesajlar yeni bir @bahsetme veya onchar öneki olmadan yanıtlanır; böylece çok turlu ileti dizisi konuşmaları kesintisiz sürer. Katılım, botun söz konusu ileti dizisindeki son yanıtından itibaren 7 gün boyunca hatırlanır ve Gateway yeniden başlatmalarında korunur. Botun yalnızca gözlemlediği ileti dizileri bundan etkilenmez; yeniden açık bir bahsetme gerektirmek için yeni bir üst düzey mesaj başlatın.
• Katılım sağlanan ileti dizilerindeki takip mesajlarının bahsetme denetimini atlamasını önlemek için channels.mattermost.implicitMentions.threadParticipation: false ayarını belirleyin. Hesap geçersiz kılmaları channels.mattermost.accounts.<id>.implicitMentions kullanır. Mattermost şu anda replyToBot veya quotedBot bilgilerini üretmediğinden bu bayrakların burada hiçbir etkisi yoktur.

​

İleti dizileri ve oturumlar

• off (varsayılan): yalnızca gelen gönderi zaten bir ileti dizisindeyse ileti dizisinde yanıt verilir.
• first: üst düzey kanal/grup gönderileri için gönderinin altında bir ileti dizisi başlatılır ve konuşma ileti dizisi kapsamındaki bir oturuma yönlendirilir.
• all ve batched: Mattermost’ta bugün first ile aynı davranışı gösterir; çünkü Mattermost’ta bir ileti dizisi kökü oluşturulduktan sonra takip parçaları ve medya aynı ileti dizisinde devam eder.
• Doğrudan mesajlar, replyToMode ayarlanmış olsa bile varsayılan olarak off kullanır.

• off (varsayılan): doğrudan mesajlar, sürekli ilerleyen tek bir oturumda ileti dizisi olmadan kalır.
• first, all veya batched: her üst düzey doğrudan mesaj, yeni ve bağımsız bir oturum tarafından desteklenen bir Mattermost ileti dizisi başlatır.

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

• İleti dizisi kapsamındaki oturumlar, tetikleyici gönderi kimliğini ileti dizisi kökü olarak kullanır.
• first ve all şu anda eşdeğerdir; çünkü Mattermost’ta bir ileti dizisi kökü oluşturulduktan sonra takip parçaları ve medya aynı ileti dizisinde devam eder.
• Sohbet türü başına geçersiz kılmalar replyToMode ayarından önceliklidir. Bir direct geçersiz kılması olmadan mevcut dağıtımlar düz, ileti dizisiz doğrudan mesajları korur.

​

Erişim denetimi (doğrudan mesajlar)

• Varsayılan: channels.mattermost.dmPolicy = "pairing" (bilinmeyen gönderenlere bir eşleştirme kodu verilir). Diğer değerler: allowlist, open, disabled.
• Şunlar aracılığıyla onaylayın:
  • openclaw pairing list mattermost
  • openclaw pairing approve mattermost <CODE>
• Herkese açık doğrudan mesajlar: channels.mattermost.dmPolicy="open" ile birlikte channels.mattermost.allowFrom=["*"] (yapılandırma şeması joker karakteri zorunlu kılar).
• channels.mattermost.allowFrom, kullanıcı kimliklerini (önerilir) ve accessGroup:<name> girdilerini kabul eder. Bkz. Erişim grupları.

​

Kanallar (gruplar)

• Varsayılan: channels.mattermost.groupPolicy = "allowlist" (bahsetme gerektirir).
• Gönderenleri channels.mattermost.groupAllowFrom ile izin verilenler listesine ekleyin (kullanıcı kimlikleri önerilir).
• channels.mattermost.groupAllowFrom, accessGroup:<name> girdilerini kabul eder. Bkz. Erişim grupları.
• Kanal başına bahsetme geçersiz kılmaları channels.mattermost.groups.<channelId>.requireMention altında, varsayılan ayar ise channels.mattermost.groups["*"].requireMention altında bulunur.
• @username eşleştirmesi değişkendir ve yalnızca channels.mattermost.dangerouslyAllowNameMatching: true olduğunda etkinleştirilir.
• Açık kanallar: channels.mattermost.groupPolicy="open" (bahsetme gerektirir).
• Çözümleme sırası: channels.mattermost.groupPolicy, ardından channels.defaults.groupPolicy, ardından "allowlist".
• Çalışma zamanı notu: channels.mattermost bölümü tamamen eksikse çalışma zamanı, grup denetimleri için (channels.defaults.groupPolicy ayarlanmış olsa bile) güvenli biçimde groupPolicy="allowlist" durumuna geçer ve bir defalık uyarı kaydeder.

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

​

Giden teslimat hedefleri

​

DM kanalı yeniden denemesi

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

• Bu, her Mattermost API çağrısına değil, yalnızca DM kanalı oluşturmaya (/api/v4/channels/direct) uygulanır.
• Yeniden denemelerde değişken gecikmeli üstel geri çekilme kullanılır ve hız sınırları, 5xx yanıtları ile ağ veya zaman aşımı hataları gibi geçici hatalara uygulanır.
• 429 dışındaki 4xx istemci hataları kalıcı kabul edilir ve yeniden denenmez.

​

Önizleme akışı

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

​

Tepkiler (mesaj aracı)

• message action=react öğesini channel=mattermost ile kullanın.
• messageId, Mattermost gönderi kimliğidir.
• emoji, thumbsup veya :+1: gibi adları kabul eder (iki nokta üst üste isteğe bağlıdır).
• Bir tepkiyi kaldırmak için remove=true (boolean) ayarını kullanın.
• Tepki ekleme/kaldırma olayları, mesajlarla aynı DM/grup politikası kontrollerine tabi olarak yönlendirilmiş agent oturumuna sistem olayları şeklinde iletilir.

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: tepki eylemlerini etkinleştirin/devre dışı bırakın (varsayılan true).
• Hesap başına geçersiz kılma: channels.mattermost.accounts.<id>.actions.reactions.

​

Etkileşimli düğmeler (mesaj aracı)

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

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

​

Doğrudan API entegrasyonu (harici betikler)

{
  channel_id: "<channelId>",
  message: "Bir seçenek belirleyin:",
  props: {
    attachments: [
      {
        actions: [
          {
            id: "mybutton01", // yalnızca alfasayısal - aşağıya bakın
            type: "button", // gereklidir, aksi takdirde tıklamalar sessizce yok sayılır
            name: "Onayla", // görünen etiket
            style: "primary", // isteğe bağlı: "default", "primary", "danger"
            integration: {
              url: "https://gateway.example.com/mattermost/interactions/default",
              context: {
                action_id: "mybutton01", // düğme kimliğiyle eşleşmelidir
                action: "approve",
                // ... özel alanlar ...
                _token: "<hmac>", // aşağıdaki HMAC bölümüne bakın
              },
            },
          },
        ],
      },
    ],
  },
}

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}

​

Dizin bağdaştırıcısı

​

Çoklu hesap

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

​

Sorun giderme

​

İlgili konular

• Kanal Yönlendirme - iletiler için oturum yönlendirme
• Kanallara Genel Bakış - desteklenen tüm kanallar
• Gruplar - grup sohbeti davranışı ve bahsetme denetimi
• Eşleştirme - DM kimlik doğrulaması ve eşleştirme akışı
• Güvenlik - erişim modeli ve sağlamlaştırma