Mattermost

Status: indirilebilir Plugin (bot token'ı + WebSocket olayları). Kanallar, gruplar ve DM'ler desteklenir. Mattermost, kendi ortamınızda barındırılabilen bir ekip mesajlaşma platformudur; ürün ayrıntıları ve indirmeler için mattermost.com adresindeki resmi siteye bakın.

# Yükleme

Kanalı yapılandırmadan önce Mattermost'u yükleyin:

openclaw plugins install @openclaw/mattermost

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

Ayrıntılar: Pluginler

# Hızlı kurulum

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

# Yerel slash komutları

Yerel slash komutları isteğe bağlıdır. Etkinleştirildiğinde OpenClaw, Mattermost API üzerinden oc_* slash komutlarını kaydeder ve Gateway HTTP sunucusunda callback POST'ları alır.

{
  channels: {
    mattermost: {
      commands: {
        native: true,
        nativeSkills: true,
        callbackPath: "/api/channels/mattermost/command",
        // Mattermost Gateway'e doğrudan ulaşamadığında kullanın (ters proxy/herkese açık URL).
        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",
      },
    },
  },
}

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

Env var'ları tercih ediyorsanız bunları Gateway host'unda ayarlayın:

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

# Sohbet modları

Mattermost, DM'lere otomatik olarak yanıt verir. Kanal davranışı chatmode ile denetlenir:

Yapılandırma örneği:

{
  channels: {
    mattermost: {
      chatmode: "onchar",
      oncharPrefixes: [">", "!"],
    },
  },
}

Notlar:

• onchar, açık @bahsetmelere yine yanıt verir.
• channels.mattermost.requireMention eski yapılandırmalar için desteklenir, ancak chatmode tercih edilir.

# İş parçacıkları ve oturumlar

Kanal ve grup yanıtlarının ana kanalda mı kalacağını yoksa tetikleyen gönderinin altında bir iş parçacığı mı başlatacağını denetlemek için channels.mattermost.replyToMode kullanın.

• off (varsayılan): yalnızca gelen gönderi zaten bir iş parçacığındaysa iş parçacığında yanıt ver.
• first: üst düzey kanal/grup gönderileri için, o gönderinin altında bir iş parçacığı başlat ve konuşmayı iş parçacığı kapsamlı bir oturuma yönlendir.
• all: bugün Mattermost için first ile aynı davranış.
• Doğrudan mesajlar bu ayarı yok sayar ve iş parçacığı kullanılmadan kalır.

Yapılandırma örneği:

{
  channels: {
    mattermost: {
      replyToMode: "all",
    },
  },
}

Notlar:

• İş parçacığı kapsamlı oturumlar, tetikleyen gönderi kimliğini iş parçacığı kökü olarak kullanır.
• first ve all şu anda eşdeğerdir; çünkü Mattermost bir iş parçacığı köküne sahip olduğunda, takip parçaları ve medya aynı iş parçacığında devam eder.

# Erişim denetimi (DM'ler)

• Varsayılan: channels.mattermost.dmPolicy = "pairing" (bilinmeyen gönderenler bir eşleştirme kodu alır).
• Şununla onaylayın:
  • openclaw pairing list mattermost
  • openclaw pairing approve mattermost <CODE>
• Herkese açık DM'ler: channels.mattermost.dmPolicy="open" artı channels.mattermost.allowFrom=["*"].

# Kanallar (gruplar)

• Varsayılan: channels.mattermost.groupPolicy = "allowlist" (bahsetme kapılı).
• Gönderenleri channels.mattermost.groupAllowFrom ile izin listesine ekleyin (kullanıcı ID'leri önerilir).
• Kanal başına bahsetme geçersiz kılmaları, varsayılan için channels.mattermost.groups.<channelId>.requireMention veya 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 kapılı).
• Çalışma zamanı notu: channels.mattermost tamamen eksikse çalışma zamanı grup kontrolleri için groupPolicy="allowlist" değerine geri döner (channels.defaults.groupPolicy ayarlanmış olsa bile).

Örnek:

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

# Giden teslimat için hedefler

Bu hedef biçimlerini openclaw message send veya Cron/Webhook'larla kullanın:

• Bir kanal için channel:<id>
• Bir DM için user:<id>
• Bir DM için @username (Mattermost API üzerinden çözümlenir)

# DM kanalı yeniden denemesi

OpenClaw bir Mattermost DM hedefine gönderirken önce doğrudan kanalı çözümlemesi gerektiğinde, geçici doğrudan kanal oluşturma hatalarını varsayılan olarak yeniden dener.

Bu davranışı Mattermost Plugin'i için genel olarak ayarlamak üzere channels.mattermost.dmChannelRetry veya tek bir hesap için channels.mattermost.accounts.<id>.dmChannelRetry kullanın.

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

Notlar:

• Bu yalnızca DM kanalı oluşturmaya (/api/v4/channels/direct) uygulanır, her Mattermost API çağrısına değil.
• Yeniden denemeler hız sınırları, 5xx yanıtları ve 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ışı

Mattermost düşünmeyi, araç etkinliğini ve kısmi yanıt metnini, son yanıt göndermek için güvenli olduğunda yerinde tamamlanan tek bir taslak önizleme gönderisine aktarır. Önizleme, kanalı parça başına mesajlarla doldurmak yerine aynı gönderi kimliği üzerinde güncellenir. Medya/hata sonları bekleyen önizleme düzenlemelerini iptal eder ve tek kullanımlık bir önizleme gönderisini boşaltmak yerine normal teslimatı kullanır.

channels.mattermost.streaming üzerinden etkinleştirin:

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

# Tepkiler (mesaj aracı)

• channel=mattermost ile message action=react kullanın.
• messageId, Mattermost gönderi kimliğidir.
• emoji, thumbsup veya :+1: gibi adları kabul eder (iki nokta isteğe bağlıdır).
• Bir tepkiyi kaldırmak için remove=true (boolean) ayarlayın.
• Tepki ekleme/kaldırma olayları, yönlendirilen ajan oturumuna sistem olayları olarak iletilir.

Örnekler:

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

Yapılandırma:

• channels.mattermost.actions.reactions: tepki eylemlerini etkinleştir/devre dışı bırak (varsayılan true).
• Hesap başına geçersiz kılma: channels.mattermost.accounts.<id>.actions.reactions.

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

Tıklanabilir düğmeler içeren mesajlar gönderin. Bir kullanıcı bir düğmeye tıkladığında ajan seçimi alır ve yanıt verebilir.

Kanal yeteneklerine inlineButtons ekleyerek düğmeleri etkinleştirin:

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

buttons parametresiyle message action=send kullanın. Düğmeler 2B dizidir (düğme satırları):

message action=send channel=mattermost target=channel:<channelId> buttons=[[{"text":"Yes","callback_data":"yes"},{"text":"No","callback_data":"no"}]]

Düğme alanları:

Bir kullanıcı bir düğmeye tıkladığında:

# Doğrudan API entegrasyonu (harici betikler)

Harici betikler ve Webhook'lar, aracının message aracı üzerinden gitmek yerine düğmeleri doğrudan Mattermost REST API aracılığıyla gönderebilir. Mümkün olduğunda Plugin'den buildButtonAttachments() kullanın; ham JSON gönderiyorsanız şu kuralları izleyin:

Yük yapısı:

{
  channel_id: "<channelId>",
  message: "Choose an option:",
  props: {
    attachments: [
      {
        actions: [
          {
            id: "mybutton01", // alphanumeric only - see below
            type: "button", // required, or clicks are silently ignored
            name: "Approve", // display label
            style: "primary", // optional: "default", "primary", "danger"
            integration: {
              url: "https://gateway.example.com/mattermost/interactions/default",
              context: {
                action_id: "mybutton01", // must match button id (for name lookup)
                action: "approve",
                // ... any custom fields ...
                _token: "<hmac>", // see HMAC section below
              },
            },
          },
        ],
      },
    ],
  },
}

HMAC token üretimi

Gateway, düğme tıklamalarını HMAC-SHA256 ile doğrular. Harici betikler, Gateway'in doğrulama mantığıyla eşleşen token'lar üretmelidir:

Python örneği:

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 adaptörü

Mattermost Plugin'i, kanal ve kullanıcı adlarını Mattermost API aracılığıyla çözen bir dizin adaptörü içerir. Bu, openclaw message send ve Cron/Webhook teslimatlarında #channel-name ve @username hedeflerini etkinleştirir.

Yapılandırma gerekmez - adaptör hesap yapılandırmasındaki bot token'ını kullanır.

# Çok hesap

Mattermost, channels.mattermost.accounts altında birden fazla hesabı destekler:

{
  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

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