跳轉到主要內容

​
Mattermost（外掛）

  1. 狀態：透過外掛支援（機器人權杖 + WebSocket 事件）。 17. 支援頻道、群組與私訊。
  2. Mattermost 是一個可自行架設的團隊即時通訊平台；產品詳情與下載請參見官方網站 mattermost.com。

​
19. 需要外掛

Mattermost 以外掛形式提供，未隨核心安裝一併提供。 透過 CLI 安裝（npm registry）： 
openclaw plugins install @openclaw/mattermost
本地檢出（從 git 儲存庫執行時）： 
openclaw plugins install ./extensions/mattermost
若在設定／入門引導期間選擇 Mattermost 且偵測到 git 檢出， OpenClaw 會自動提供本機安裝路徑。 詳情：Plugins

​
快速設定

    1. 安裝 Mattermost 外掛。
    1. 建立一個 Mattermost 機器人帳戶並複製 機器人權杖。
  3. 複製 Mattermost 基底 URL（例如：https://chat.example.com）。
  4. 設定 OpenClaw 並啟動 Gateway 閘道器。
最小設定： 
{
  channels: {
    mattermost: {
      enabled: true,
      botToken: "mm-token",
      baseUrl: "https://chat.example.com",
      dmPolicy: "pairing",
    },
  },
}

​
環境變數（預設帳號）

  1. 若偏好使用環境變數，請在閘道主機上設定以下項目：
  • MATTERMOST_BOT_TOKEN=...
  • MATTERMOST_URL=https://chat.example.com
環境變數僅適用於 預設 帳戶（default）。 24. 其他帳戶必須使用設定值。

​
聊天模式

  1. Mattermost 會自動回應私訊。 Mattermost 會自動回覆私訊。頻道行為由 chatmode 控制：
  • oncall（預設）：僅在頻道中被 @ 提及時回覆。
  • onmessage：回覆每一則頻道訊息。
  • onchar：當訊息以觸發前綴開頭時回覆。
設定範例： 
{
  channels: {
    mattermost: {
      chatmode: "onchar",
      oncharPrefixes: [">", "!"],
    },
  },
}
注意事項：
  • onchar 仍會回應明確的 @ 提及。
  • channels.mattermost.requireMention 會為相容舊版設定而被遵循，但建議使用 chatmode。

​
26. 存取控制（私訊）

  • 預設：channels.mattermost.dmPolicy = "pairing"（未知寄件者會取得配對碼）。
    1. 透過以下方式核准：
    • openclaw pairing list mattermost
    • openclaw pairing approve mattermost <CODE>
  • 公開私訊：channels.mattermost.dmPolicy="open" 加上 channels.mattermost.allowFrom=["*"]。

​
頻道（群組）

  • 預設：channels.mattermost.groupPolicy = "allowlist"（需提及）。
  • 使用 channels.mattermost.groupAllowFrom 將寄件者加入允許清單（使用者 ID 或 @username）。
  • 開放頻道：channels.mattermost.groupPolicy="open"（需提及）。

​
外送目標

搭配 openclaw message send 或 cron／webhooks 使用以下目標格式：
  • channel:<id>：頻道
  • user:<id>：私訊
  • @username：私訊（透過 Mattermost API 解析）
  1. 裸 ID 會被視為頻道。

​
多帳號

Mattermost 在 channels.mattermost.accounts 底下支援多個帳號： 
{
  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" },
      },
    },
  },
}

​
29. 疑難排解

  • 頻道沒有回覆：請確認機器人在頻道中並進行提及（oncall）、使用觸發前綴（onchar），或設定 chatmode: "onmessage"。
    1. 驗證錯誤：請檢查機器人權杖、基底 URL，以及帳戶是否已啟用。
    1. 多帳戶問題：環境變數僅適用於 default 帳戶。