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 по-прежнему отвечает на явные @упоминания.
• channels.mattermost.requireMention по-прежнему учитывается, но предпочтителен chatmode. Настройки groups.<channelId>.requireMention для отдельных каналов имеют приоритет над обоими.
• После того как бот отправляет видимый ответ в обсуждении канала, на последующие сообщения в том же обсуждении он отвечает без нового @упоминания или префикса onchar, поэтому многошаговые беседы в обсуждении продолжаются без прерывания. Участие запоминается на 7 дней после последнего ответа бота в этом обсуждении и сохраняется после перезапусков Gateway. Это не относится к обсуждениям, которые бот только просматривал; чтобы снова требовалось явное упоминание, начните новое сообщение верхнего уровня.

​

Обсуждения и сеансы

• off (по умолчанию): отвечать в обсуждении, только если входящее сообщение уже находится в нём.
• first: для сообщений верхнего уровня в каналах и группах начинать обсуждение под этим сообщением и направлять беседу в сеанс, относящийся к обсуждению.
• all и batched: сейчас в Mattermost работают так же, как first, поскольку после появления корневого сообщения обсуждения в Mattermost последующие части ответа и медиафайлы продолжают отправляться в то же обсуждение.
• Для личных сообщений по умолчанию используется off, даже если задан replyToMode.

• off (по умолчанию): личные сообщения остаются без обсуждений в одном непрерывном сеансе.
• first, all или batched: каждое личное сообщение верхнего уровня начинает обсуждение Mattermost, связанное с новым независимым сеансом.

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

• Сеансы, относящиеся к обсуждению, используют идентификатор сообщения-триггера в качестве корневого сообщения обсуждения.
• first и all сейчас эквивалентны, поскольку после появления корневого сообщения обсуждения в Mattermost последующие части ответа и медиафайлы продолжают отправляться в то же обсуждение.
• Переопределения для отдельных типов чата имеют приоритет над replyToMode. Без переопределения direct существующие развёртывания сохраняют плоские личные сообщения без обсуждений.

​

Управление доступом (личные сообщения)

• По умолчанию: channels.mattermost.dmPolicy = "pairing" (неизвестные отправители получают код сопряжения). Другие значения: allowlist, open, disabled.
• Подтверждение выполняется с помощью:
  • 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, затем channels.defaults.groupPolicy, затем "allowlist".
• Примечание о среде выполнения: если раздел channels.mattermost полностью отсутствует, при проверке групп среда выполнения безопасно отклоняет доступ согласно groupPolicy="allowlist" (даже если задан channels.defaults.groupPolicy) и однократно записывает предупреждение в журнал.

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

​

Цели исходящей доставки

​

Повторная попытка для канала личных сообщений

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

• Это относится только к созданию канала личной переписки (/api/v4/channels/direct), а не к каждому вызову API Mattermost.
• Повторные попытки используют экспоненциальную задержку с джиттером и применяются при временных сбоях, таких как ограничения частоты запросов, ответы 5xx, сетевые ошибки и истечение времени ожидания.
• Клиентские ошибки 4xx, кроме 429, считаются постоянными, и повторные попытки для них не выполняются.

​

Потоковая передача предпросмотра

{
  channels: {
    mattermost: {
      streaming: { mode: "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.

​

Интерактивные кнопки (инструмент сообщений)

message action=send channel=mattermost target=channel:<channelId> presentation={"blocks":[{"type":"buttons","buttons":[{"label":"Да","value":"yes"},{"label":"Нет","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", // должен соответствовать идентификатору кнопки
                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" },
      },
    },
  },
}

​

Устранение неполадок

​

Связанные материалы

• Маршрутизация каналов — маршрутизация сеансов для сообщений
• Обзор каналов — все поддерживаемые каналы
• Группы — поведение групповых чатов и фильтрация по упоминанию
• Сопряжение — аутентификация в личных сообщениях и процесс сопряжения
• Безопасность — модель доступа и усиление защиты