Mattermost

​

इंस्टॉल करें

openclaw plugins install @openclaw/mattermost

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

​

त्वरित सेटअप

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

​

नेटिव स्लैश कमांड

{
  channels: {
    mattermost: {
      commands: {
        native: true,
        nativeSkills: true,
        callbackPath: "/api/channels/mattermost/command",
        // Use when Mattermost cannot reach the gateway directly (reverse proxy/public URL).
        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",
      },
    },
  },
}

​

पर्यावरण चर (डिफ़ॉल्ट अकाउंट)

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

​

चैट मोड

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

• onchar फिर भी स्पष्ट @mentions का उत्तर देता है।
• लेगेसी कॉन्फ़िग के लिए channels.mattermost.requireMention का सम्मान किया जाता है, लेकिन chatmode को प्राथमिकता दी जाती है।
• बॉट द्वारा चैनल थ्रेड में दृश्यमान उत्तर भेजने के बाद, उसी थ्रेड में बाद के संदेशों का उत्तर नए @mention या onchar prefix के बिना दिया जाता है, ताकि बहु-टर्न थ्रेड वार्तालाप चलते रहें। भागीदारी थ्रेड निष्क्रियता के 7 दिनों तक याद रखी जाती है (हर उत्तर पर रीफ़्रेश होती है) और Gateway रीस्टार्ट के बाद भी बनी रहती है। जिन थ्रेड को बॉट ने केवल देखा है, वे अप्रभावित रहते हैं; फिर से स्पष्ट mention आवश्यक करने के लिए नया top-level संदेश शुरू करें।

​

थ्रेडिंग और सेशन

• off (डिफ़ॉल्ट): केवल तब थ्रेड में उत्तर दें जब inbound पोस्ट पहले से किसी थ्रेड में हो।
• first: top-level चैनल/समूह पोस्ट के लिए, उस पोस्ट के अंतर्गत थ्रेड शुरू करें और वार्तालाप को thread-scoped session पर रूट करें।
• all: Mattermost के लिए आज first जैसा ही व्यवहार।
• डायरेक्ट मैसेज इस सेटिंग को अनदेखा करते हैं और non-threaded रहते हैं।

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

• Thread-scoped sessions triggering पोस्ट id को thread root के रूप में उपयोग करते हैं।
• first और all अभी समान हैं क्योंकि Mattermost के पास thread root हो जाने पर follow-up chunks और media उसी थ्रेड में जारी रहते हैं।

​

एक्सेस नियंत्रण (DMs)

• डिफ़ॉल्ट: channels.mattermost.dmPolicy = "pairing" (अज्ञात भेजने वालों को pairing code मिलता है)।
• इसके माध्यम से अनुमोदित करें:
  • openclaw pairing list mattermost
  • openclaw pairing approve mattermost <CODE>
• सार्वजनिक DMs: channels.mattermost.dmPolicy="open" और channels.mattermost.allowFrom=["*"]।
• channels.mattermost.allowFrom accessGroup:<name> प्रविष्टियां स्वीकार करता है। Access groups देखें।

​

चैनल (समूह)

• डिफ़ॉल्ट: channels.mattermost.groupPolicy = "allowlist" (mention-gated)।
• channels.mattermost.groupAllowFrom से भेजने वालों को allowlist करें (user IDs अनुशंसित)।
• channels.mattermost.groupAllowFrom accessGroup:<name> प्रविष्टियां स्वीकार करता है। Access groups देखें।
• प्रति-चैनल mention overrides channels.mattermost.groups.<channelId>.requireMention या डिफ़ॉल्ट के लिए channels.mattermost.groups["*"].requireMention के अंतर्गत रहते हैं।
• @username matching mutable है और केवल तब सक्षम होता है जब channels.mattermost.dangerouslyAllowNameMatching: true हो।
• खुले चैनल: channels.mattermost.groupPolicy="open" (mention-gated)।
• रनटाइम नोट: यदि channels.mattermost पूरी तरह अनुपस्थित है, तो रनटाइम समूह जांचों के लिए groupPolicy="allowlist" पर fallback करता है (भले ही channels.defaults.groupPolicy सेट हो)।

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

​

आउटबाउंड डिलीवरी के लिए target

• चैनल के लिए channel:<id>
• DM के लिए user:<id>
• DM के लिए @username (Mattermost API के माध्यम से resolved)

​

DM चैनल retry

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

• यह केवल DM channel creation (/api/v4/channels/direct) पर लागू होता है, हर Mattermost API call पर नहीं।
• Retries transient failures पर लागू होते हैं, जैसे rate limits, 5xx responses, और network या timeout errors।
• 429 के अलावा 4xx client errors को स्थायी माना जाता है और retry नहीं किया जाता।

​

प्रीव्यू स्ट्रीमिंग

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

​

Reactions (message tool)

• channel=mattermost के साथ message action=react उपयोग करें।
• messageId Mattermost post id है।
• emoji thumbsup या :+1: जैसे names स्वीकार करता है (colons वैकल्पिक हैं)।
• reaction हटाने के लिए remove=true (boolean) सेट करें।
• Reaction add/remove events routed agent session को system events के रूप में forward किए जाते हैं।

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: reaction actions सक्षम/अक्षम करें (डिफ़ॉल्ट true)।
• प्रति-अकाउंट override: channels.mattermost.accounts.<id>.actions.reactions।

​

Interactive buttons (message tool)

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

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

​

Direct API integration (external scripts)

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

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}

​

Directory adapter

​

Multi-account

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

​

Troubleshooting

​

Related

• Channel Routing - messages के लिए session routing
• Channels Overview - सभी supported channels
• Groups - group chat behavior और mention gating
• Pairing - DM authentication और pairing flow
• Security - access model और hardening