8.8 Mattermost集成

通过 Mattermost 插件将 OpenClaw 集成到自托管的协作平台。

概述

Mattermost 集成通过 @openclaw/mattermost 插件提供支持，允许您的 AI 助手在 Mattermost 工作区中与团队成员交互。该集成支持直接消息、频道消息、提及响应等功能。

状态

插件形式提供，需单独安装。

前置要求

• 一个运行中的 Mattermost 服务器实例
• Mattermost 机器人令牌（Bot Token）
• 服务器的基础 URL

安装插件

openclaw plugins install @openclaw/mattermost

基础配置

在您的 OpenClaw 配置文件中添加 Mattermost 通道设置：

{
  channels: {
    mattermost: {
      enabled: true,
      token: process.env.MATTERMOST_BOT_TOKEN,
      baseUrl: "https://mattermost.example.com",
      chatmode: "oncall"  // 可选：默认聊天模式
    }
  }
}

环境变量

建议使用环境变量存储敏感信息：

export MATTERMOST_BOT_TOKEN="your-bot-token-here"

直接消息策略

控制机器人如何处理直接消息（DM）：

{
  channels: {
    mattermost: {
      enabled: true,
      token: process.env.MATTERMOST_BOT_TOKEN,
      baseUrl: "https://mattermost.example.com",
      dmPolicy: "pairing"  // 默认值
    }
  }
}

dmPolicy 可选值：

• "pairing"（默认）：需要用户配对才能开始对话
• "allowlist"：仅允许特定用户列表
• "open"：接受所有直接消息
• "disabled"：禁用直接消息

频道支持

机器人可以在频道中响应提及（@mention）：

{
  channels: {
    mattermost: {
      enabled: true,
      token: process.env.MATTERMOST_BOT_TOKEN,
      baseUrl: "https://mattermost.example.com",
      mentionGating: true  // 默认：仅响应提及
    }
  }
}

多账号配置

支持同时使用多个 Mattermost 账号或服务器：

{
  channels: {
    mattermost: {
      accounts: {
        default: {
          enabled: true,
          token: process.env.MATTERMOST_BOT_TOKEN,
          baseUrl: "https://mattermost.example.com"
        },
        secondary: {
          enabled: true,
          token: process.env.MATTERMOST_BOT_TOKEN_2,
          baseUrl: "https://another-server.com"
        }
      }
    }
  }
}

安全配置

配置访问控制列表（allowlist）限制谁可以与机器人交互：

{
  channels: {
    mattermost: {
      enabled: true,
      token: process.env.MATTERMOST_BOT_TOKEN,
      baseUrl: "https://mattermost.example.com",
      dmPolicy: "allowlist",
      allowFrom: [
        "@username1",
        "@username2"
      ]
    }
  }
}

聊天模式

chatmode 控制机器人的默认行为：

• "oncall"：机器人主动响应消息
• "assistant"：被动等待明确指令

验证配置

启动 OpenClaw 网关后，检查机器人是否成功连接：

# 启动网关
openclaw gateway start

# 在另一个终端检查状态
openclaw status

故障排查

• 机器人无法连接：检查 baseUrl 是否正确，确保网络可访问
• 令牌错误：验证 MATTERMOST_BOT_TOKEN 是否设置正确
• 无法发送消息：确认机器人账号有相应频道的权限
• 提及不响应：检查 mentionGating 设置和机器人权限