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

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

​

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

{
  channels: {
    mattermost: {
      commands: {
        native: true,
        nativeSkills: true,
        callbackPath: "/api/channels/mattermost/command",
        // इसका उपयोग तब करें जब Mattermost सीधे Gateway तक न पहुँच सके (रिवर्स प्रॉक्सी/सार्वजनिक 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 को प्राथमिकता दी जाती है। प्रति-चैनल groups.<channelId>.requireMention सेटिंग दोनों पर वरीयता रखती हैं।
• चैनल थ्रेड में बॉट द्वारा दृश्यमान उत्तर भेजे जाने के बाद, उसी थ्रेड के बाद के संदेशों का उत्तर किसी नए @mention या onchar प्रीफ़िक्स के बिना दिया जाता है, जिससे बहु-चरणीय थ्रेड वार्तालाप जारी रहते हैं। बॉट द्वारा उस थ्रेड में अंतिम उत्तर दिए जाने के बाद भागीदारी 7 दिनों तक याद रखी जाती है और Gateway पुनः आरंभ होने के बाद भी बनी रहती है। जिन थ्रेडों को बॉट ने केवल देखा है, वे अप्रभावित रहते हैं; स्पष्ट उल्लेख फिर से आवश्यक बनाने के लिए नया शीर्ष-स्तरीय संदेश शुरू करें।
• भागीदारी वाले थ्रेड के अनुवर्ती संदेशों को उल्लेख गेटिंग से बचकर निकलने से रोकने के लिए channels.mattermost.implicitMentions.threadParticipation: false सेट करें। खाता ओवरराइड channels.mattermost.accounts.<id>.implicitMentions का उपयोग करते हैं। Mattermost वर्तमान में replyToBot या quotedBot तथ्य उत्पन्न नहीं करता, इसलिए इन फ़्लैग का यहाँ कोई प्रभाव नहीं पड़ता।

​

थ्रेडिंग और सत्र

• off (डिफ़ॉल्ट): केवल तभी थ्रेड में उत्तर दें, जब आने वाली पोस्ट पहले से किसी थ्रेड में हो।
• first: शीर्ष-स्तरीय चैनल/समूह पोस्ट के लिए, उस पोस्ट के अंतर्गत एक थ्रेड शुरू करें और वार्तालाप को थ्रेड-स्कोप वाले सत्र में रूट करें।
• all और batched: आज Mattermost के लिए first जैसा ही व्यवहार, क्योंकि Mattermost में थ्रेड रूट बनने के बाद अनुवर्ती खंड और मीडिया उसी थ्रेड में जारी रहते हैं।
• replyToMode सेट होने पर भी प्रत्यक्ष संदेश डिफ़ॉल्ट रूप से off का उपयोग करते हैं।

• off (डिफ़ॉल्ट): प्रत्यक्ष संदेश एक ही निरंतर सत्र में बिना थ्रेड के रहते हैं।
• first, all, या batched: प्रत्येक शीर्ष-स्तरीय प्रत्यक्ष संदेश एक नए, स्वतंत्र सत्र द्वारा समर्थित Mattermost थ्रेड शुरू करता है।

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

• थ्रेड-स्कोप वाले सत्र ट्रिगर करने वाली पोस्ट की ID को थ्रेड रूट के रूप में उपयोग करते हैं।
• first और all वर्तमान में समतुल्य हैं, क्योंकि Mattermost में थ्रेड रूट बनने के बाद अनुवर्ती खंड और मीडिया उसी थ्रेड में जारी रहते हैं।
• प्रति-चैट-प्रकार ओवरराइड replyToMode पर वरीयता रखते हैं। direct ओवरराइड के बिना, मौजूदा डिप्लॉयमेंट सपाट, बिना थ्रेड वाले DMs बनाए रखते हैं।

​

अभिगम नियंत्रण (DMs)

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

​

चैनल (समूह)

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

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

​

आउटबाउंड डिलीवरी के लक्ष्य

​

DM चैनल पुनः प्रयास

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

• यह केवल DM चैनल निर्माण (/api/v4/channels/direct) पर लागू होता है, प्रत्येक Mattermost API कॉल पर नहीं।
• पुनः प्रयास जिटर के साथ एक्सपोनेंशियल बैकऑफ़ का उपयोग करते हैं और दर सीमाओं, 5xx प्रतिक्रियाओं तथा नेटवर्क या टाइमआउट त्रुटियों जैसी अस्थायी विफलताओं पर लागू होते हैं।
• 429 के अलावा अन्य 4xx क्लाइंट त्रुटियों को स्थायी माना जाता है और उन पर पुनः प्रयास नहीं किया जाता।

​

पूर्वावलोकन स्ट्रीमिंग

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

​

प्रतिक्रियाएँ (संदेश टूल)

• message action=react को channel=mattermost के साथ उपयोग करें।
• messageId Mattermost पोस्ट ID है।
• emoji thumbsup या :+1: जैसे नाम स्वीकार करता है (कोलन वैकल्पिक हैं)।
• प्रतिक्रिया हटाने के लिए remove=true (बूलियन) सेट करें।
• प्रतिक्रिया जोड़ने/हटाने की घटनाएँ रूट किए गए एजेंट सत्र में सिस्टम घटनाओं के रूप में अग्रेषित की जाती हैं और उन पर संदेशों जैसी ही DM/समूह नीति जाँच लागू होती हैं।

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

​

इंटरैक्टिव बटन (संदेश टूल)

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

​

प्रत्यक्ष API एकीकरण (बाहरी स्क्रिप्ट)

{
  channel_id: "<channelId>",
  message: "कोई विकल्प चुनें:",
  props: {
    attachments: [
      {
        actions: [
          {
            id: "mybutton01", // केवल अक्षरांकीय - नीचे देखें
            type: "button", // आवश्यक, अन्यथा क्लिक चुपचाप अनदेखे कर दिए जाते हैं
            name: "स्वीकृत करें", // प्रदर्शित लेबल
            style: "primary", // वैकल्पिक: "default", "primary", "danger"
            integration: {
              url: "https://gateway.example.com/mattermost/interactions/default",
              context: {
                action_id: "mybutton01", // बटन id से मेल खाना आवश्यक है
                action: "approve",
                // ... कोई भी कस्टम फ़ील्ड ...
                _token: "<hmac>", // नीचे HMAC अनुभाग देखें
              },
            },
          },
        ],
      },
    ],
  },
}

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}

​

डायरेक्टरी अडैप्टर

​

एकाधिक खाते

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

​

समस्या निवारण

​

संबंधित

• चैनल रूटिंग—संदेशों के लिए सेशन रूटिंग
• चैनलों का अवलोकन—सभी समर्थित चैनल
• समूह—समूह चैट का व्यवहार और उल्लेख गेटिंग
• पेयरिंग—DM प्रमाणीकरण और पेयरिंग प्रवाह
• सुरक्षा—पहुँच मॉडल और सुदृढ़ीकरण