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 يرد على @الإشارات الصريحة.
• يُحترم channels.mattermost.requireMention للإعدادات القديمة، لكن chatmode هو المفضل.
• بعد أن يرسل البوت ردًا مرئيًا في سلسلة قناة، تُجاب الرسائل اللاحقة في السلسلة نفسها دون @إشارة جديدة أو بادئة onchar، لذلك تستمر محادثات السلاسل متعددة الجولات. تُتذكّر المشاركة لمدة 7 أيام من خمول السلسلة (وتُحدّث عند كل رد) وتستمر عبر عمليات إعادة تشغيل Gateway. لا تتأثر السلاسل التي راقبها البوت فقط؛ ابدأ رسالة جديدة في المستوى الأعلى لطلب إشارة صريحة مرة أخرى.

​

السلاسل والجلسات

• off (الافتراضي): الرد في سلسلة فقط عندما يكون المنشور الوارد موجودًا بالفعل في سلسلة.
• first: لمنشورات القناة/المجموعة في المستوى الأعلى، ابدأ سلسلة تحت ذلك المنشور ووجّه المحادثة إلى جلسة بنطاق السلسلة.
• all: السلوك نفسه مثل first لـ Mattermost حاليًا.
• تتجاهل الرسائل المباشرة هذا الإعداد وتبقى غير مسلسلة.

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

• تستخدم الجلسات بنطاق السلسلة معرّف المنشور المشغّل كجذر للسلسلة.
• first وall متكافئان حاليًا لأنه بمجرد أن يكون لدى Mattermost جذر سلسلة، تستمر المقاطع اللاحقة والوسائط في السلسلة نفسها.

​

التحكم في الوصول (الرسائل المباشرة)

• الافتراضي: channels.mattermost.dmPolicy = "pairing" (المرسلون غير المعروفين يحصلون على رمز اقتران).
• الموافقة عبر:
  • openclaw pairing list mattermost
  • openclaw pairing approve mattermost <CODE>
• الرسائل المباشرة العامة: channels.mattermost.dmPolicy="open" بالإضافة إلى channels.mattermost.allowFrom=["*"].
• يقبل channels.mattermost.allowFrom إدخالات accessGroup:<name>. راجع مجموعات الوصول.

​

القنوات (المجموعات)

• الافتراضي: channels.mattermost.groupPolicy = "allowlist" (محكوم بالإشارة).
• اسمح للمرسلين باستخدام channels.mattermost.groupAllowFrom (يُوصى بمعرّفات المستخدمين).
• يقبل 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="allowlist" لفحوصات المجموعة (حتى إذا كان channels.defaults.groupPolicy مضبوطًا).

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

​

أهداف التسليم الصادر

• channel:<id> لقناة
• user:<id> لرسالة مباشرة
• @username لرسالة مباشرة (تُحل عبر Mattermost API)

​

إعادة محاولة قناة الرسائل المباشرة

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

• ينطبق هذا فقط على إنشاء قناة الرسائل المباشرة (/api/v4/channels/direct)، وليس كل استدعاء لـ Mattermost API.
• تنطبق إعادة المحاولة على الإخفاقات المؤقتة مثل حدود المعدل، واستجابات 5xx، وأخطاء الشبكة أو المهلة.
• تُعامل أخطاء العميل 4xx غير 429 كدائمة ولا تُعاد محاولتها.

​

بث المعاينة

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

​

التفاعلات (أداة الرسائل)

• استخدم message action=react مع channel=mattermost.
• messageId هو معرّف منشور Mattermost.
• يقبل emoji أسماء مثل thumbsup أو :+1: (النقطتان الرأسيتان اختياريتان).
• اضبط remove=true (منطقي) لإزالة تفاعل.
• تُمرر أحداث إضافة/إزالة التفاعلات كأحداث نظام إلى جلسة الوكيل الموجّهة.

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.

​

الأزرار التفاعلية (أداة الرسائل)

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

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

​

التكامل المباشر مع API (السكربتات الخارجية)

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

​

محوّل الدليل

​

الحسابات المتعددة

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

​

استكشاف الأخطاء وإصلاحها

​

ذات صلة

• توجيه القنوات - توجيه الجلسات للرسائل
• نظرة عامة على القنوات - كل القنوات المدعومة
• المجموعات - سلوك دردشة المجموعات وبوابة الذكر
• الاقتران - مصادقة الرسائل المباشرة وتدفق الاقتران
• الأمان - نموذج الوصول والتقوية