가장 중요함(플러그인)

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

플러그인이 필요합니다

Mattermost는 플러그인으로 제공되며 핵심 설치와 함께 번들로 제공되지 않습니다.

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

openclaw plugins install @openclaw/mattermost

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

openclaw plugins install ./extensions/mattermost

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

세부정보: 플러그인

빠른 설정

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

최소 구성:

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

환경 변수(기본 계정)

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

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

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

채팅 모드

Mattermost는 DM에 자동으로 응답합니다. 채널 동작은 chatmode에 의해 제어됩니다:

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

구성 예:

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

참고:

• onchar는 여전히 명시적인 @멘션에 응답합니다.
• channels.mattermost.requireMention는 레거시 구성에 적용되지만 chatmode가 선호됩니다.

액세스 제어(DM)

• 기본값: channels.mattermost.dmPolicy = "pairing" (알 수 없는 발신자가 페어링 코드를 받습니다.)
• 승인 방법:
  • openclaw pairing list mattermost
  • openclaw pairing approve mattermost <CODE>
• 공개 DM: 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> DM의 경우
• DM의 경우 @username(Mattermost API를 통해 해결됨)

Bare 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 계정에만 적용됩니다.