Mattermost

​

Cài đặt

openclaw plugins install @openclaw/mattermost

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

​

Thiết lập nhanh

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

​

Lệnh gạch chéo gốc

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

​

Biến môi trường (tài khoản mặc định)

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

​

Chế độ trò chuyện

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

• onchar vẫn phản hồi các @nhắc đến rõ ràng.
• channels.mattermost.requireMention vẫn được tôn trọng cho cấu hình cũ, nhưng nên dùng chatmode.
• Sau khi bot gửi một phản hồi hiển thị trong một luồng kênh, các tin nhắn sau đó trong cùng luồng sẽ được trả lời mà không cần @nhắc đến mới hoặc tiền tố onchar, để các cuộc trò chuyện luồng nhiều lượt tiếp tục liền mạch. Việc tham gia được ghi nhớ trong 7 ngày không hoạt động của luồng (được làm mới ở mỗi phản hồi) và vẫn tồn tại qua các lần khởi động lại gateway. Các luồng mà bot chỉ quan sát sẽ không bị ảnh hưởng; bắt đầu một tin nhắn cấp cao mới để lại yêu cầu nhắc đến rõ ràng.

​

Luồng và phiên

• off (mặc định): chỉ trả lời trong một luồng khi bài đăng đến đã ở trong một luồng.
• first: với bài đăng cấp cao trong kênh/nhóm, bắt đầu một luồng dưới bài đăng đó và định tuyến cuộc trò chuyện tới một phiên theo phạm vi luồng.
• all: hành vi giống first đối với Mattermost hiện nay.
• Tin nhắn trực tiếp bỏ qua thiết lập này và vẫn không theo luồng.

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

• Phiên theo phạm vi luồng dùng id bài đăng kích hoạt làm gốc luồng.
• first và all hiện tương đương vì sau khi Mattermost có gốc luồng, các phần tiếp theo và phương tiện sẽ tiếp tục trong cùng luồng đó.

​

Kiểm soát truy cập (DM)

• Mặc định: channels.mattermost.dmPolicy = "pairing" (người gửi không xác định nhận mã ghép đôi).
• Phê duyệt qua:
  • openclaw pairing list mattermost
  • openclaw pairing approve mattermost <CODE>
• DM công khai: channels.mattermost.dmPolicy="open" cộng với channels.mattermost.allowFrom=["*"].
• channels.mattermost.allowFrom chấp nhận các mục nhập accessGroup:<name>. Xem Nhóm truy cập.

​

Kênh (nhóm)

• Mặc định: channels.mattermost.groupPolicy = "allowlist" (được kiểm soát bằng nhắc đến).
• Cho phép người gửi bằng channels.mattermost.groupAllowFrom (khuyến nghị dùng ID người dùng).
• channels.mattermost.groupAllowFrom chấp nhận các mục nhập accessGroup:<name>. Xem Nhóm truy cập.
• Ghi đè nhắc đến theo từng kênh nằm dưới channels.mattermost.groups.<channelId>.requireMention hoặc channels.mattermost.groups["*"].requireMention cho mặc định.
• Khớp @username là có thể thay đổi và chỉ được bật khi channels.mattermost.dangerouslyAllowNameMatching: true.
• Kênh mở: channels.mattermost.groupPolicy="open" (được kiểm soát bằng nhắc đến).
• Ghi chú thời gian chạy: nếu thiếu hoàn toàn channels.mattermost, thời gian chạy sẽ quay về groupPolicy="allowlist" cho kiểm tra nhóm (ngay cả khi đã đặt channels.defaults.groupPolicy).

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

​

Đích để gửi đi

• channel:<id> cho một kênh
• user:<id> cho một DM
• @username cho một DM (được phân giải qua Mattermost API)

​

Thử lại kênh DM

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

• Điều này chỉ áp dụng cho việc tạo kênh DM (/api/v4/channels/direct), không phải mọi lệnh gọi Mattermost API.
• Thử lại áp dụng cho các lỗi tạm thời như giới hạn tốc độ, phản hồi 5xx, và lỗi mạng hoặc hết thời gian chờ.
• Lỗi máy khách 4xx ngoài 429 được xem là vĩnh viễn và không được thử lại.

​

Phát trực tuyến bản xem trước

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

​

Phản ứng (công cụ tin nhắn)

• Dùng message action=react với channel=mattermost.
• messageId là id bài đăng Mattermost.
• emoji chấp nhận tên như thumbsup hoặc :+1: (dấu hai chấm là tùy chọn).
• Đặt remove=true (boolean) để xóa một phản ứng.
• Sự kiện thêm/xóa phản ứng được chuyển tiếp dưới dạng sự kiện hệ thống tới phiên agent đã định tuyến.

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: bật/tắt hành động phản ứng (mặc định true).
• Ghi đè theo tài khoản: channels.mattermost.accounts.<id>.actions.reactions.

​

Nút tương tác (công cụ tin nhắn)

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

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

​

Tích hợp API trực tiếp (tập lệnh bên ngoài)

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

​

Bộ chuyển đổi thư mục

​

Nhiều tài khoản

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

​

Khắc phục sự cố

​

Liên quan

• Định tuyến kênh - định tuyến phiên cho tin nhắn
• Tổng quan về kênh - tất cả các kênh được hỗ trợ
• Nhóm - hành vi trò chuyện nhóm và cổng nhắc đến
• Ghép nối - xác thực DM và luồng ghép nối
• Bảo mật - mô hình truy cập và gia cố