> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Mattermost

# Mattermost (플러그인)

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

## 플러그인 필요

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/mattermost
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install ./extensions/mattermost
```

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

자세한 내용은 다음을 참고하십시오: [Plugins](/tools/plugin)

## 빠른 시작

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

최소 구성:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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`: 메시지가 트리거 접두사로 시작할 때 응답합니다.

구성 예시:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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` 하에서 여러 계정을 지원합니다:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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` 계정에만 적용됩니다.