Mattermost (플러그인)¶

상태: 플러그인을 통해 지원됨 (봇 토큰 + WebSocket 이벤트). 채널, 그룹 및 다이렉트 메시지가 지원됩니다. Mattermost 는 자체 호스팅 가능한 팀 메시징 플랫폼입니다. 제품 상세 및 다운로드는 공식 사이트 mattermost.com 을 참고하십시오.

플러그인 필요¶

Mattermost 는 플러그인으로 제공되며 코어 설치에 번들로 포함되지 않습니다.

CLI (npm 레지스트리) 를 통해 설치:

openclaw plugins install @openclaw/mattermost

로컬 체크아웃 (git 저장소에서 실행하는 경우):

openclaw plugins install ./extensions/mattermost

구성/온보딩 중 Mattermost 를 선택하고 git 체크아웃이 감지되면, OpenClaw 가 로컬 설치 경로를 자동으로 제안합니다.

자세한 내용은 다음을 참고하십시오: Plugins

빠른 시작¶

Mattermost 플러그인을 설치합니다.
Mattermost 봇 계정을 생성하고 봇 토큰 을 복사합니다.
Mattermost 기본 URL 을 복사합니다 (예: https://chat.example.com).
OpenClaw 를 구성하고 Gateway(게이트웨이) 를 시작합니다.

최소 구성:

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

환경 변수 (기본 계정)¶

환경 변수를 선호하는 경우 Gateway(게이트웨이) 호스트에 다음을 설정하십시오:

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

환경 변수는 기본 계정 (default) 에만 적용됩니다. 다른 계정은 구성 값을 사용해야 합니다.

채팅 모드¶

Mattermost 는 다이렉트 메시지에 자동으로 응답합니다. 채널 동작은 chatmode 로 제어됩니다:

oncall (기본값): 채널에서 @멘션될 때만 응답합니다.
onmessage: 모든 채널 메시지에 응답합니다.
onchar: 메시지가 트리거 접두사로 시작할 때 응답합니다.

구성 예시:

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

참고 사항:

onchar 는 명시적인 @멘션에는 계속 응답합니다.
channels.mattermost.requireMention 는 레거시 구성에서 존중되지만 chatmode 가 권장됩니다.

접근 제어 (다이렉트 메시지)¶

기본값: channels.mattermost.dmPolicy = "pairing" (알 수 없는 발신자는 페어링 코드를 받습니다).
승인 방법:
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/웹훅과 함께 다음 대상 형식을 사용하십시오:

채널의 경우 channel:<id>
다이렉트 메시지의 경우 user:<id>
다이렉트 메시지의 경우 @username (Mattermost API 를 통해 해석됨)

베어 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" },
      },
    },
  },
}

문제 해결¶

채널에서 응답이 없음: 봇이 채널에 포함되어 있는지 확인하고 멘션(oncall) 하거나, 트리거 접두사(onchar) 를 사용하거나, chatmode: "onmessage" 를 설정하십시오.
인증 오류: 봇 토큰, 기본 URL, 그리고 계정이 활성화되어 있는지 확인하십시오.
다중 계정 문제: 환경 변수는 default 계정에만 적용됩니다.

Overview

Messaging platforms

Configuration

Mattermost