Mattermost

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

التثبيت

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 هو المفضل.

​

المحادثات المتفرعة والجلسات

• 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 لرسالة مباشرة (تُحل عبر API الخاص بـ Mattermost)

​

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

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

• ينطبق هذا فقط على إنشاء قناة الرسائل المباشرة (/api/v4/channels/direct)، وليس على كل استدعاء API لـ Mattermost.
• تنطبق إعادة المحاولات على حالات الفشل العابرة مثل حدود المعدل، واستجابات 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" },
      },
    },
  },
}

​

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

​

ذات صلة

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