Mattermost 채널 설정

OpenClaw와 Mattermost를 연동하는 방법을 안내합니다.

개요

Mattermost는 자체 호스팅 가능한 오픈소스 팀 협업 도구입니다:

• Slack과 유사한 기능
• 완전한 데이터 소유권
• 오픈소스 (무료 사용 가능)
• On-premise 또는 클라우드 배포

요구사항

• Mattermost 서버 (자체 호스팅 또는 클라우드)
• 봇 계정 생성 권한

1단계: Bot 계정 생성

1. Mattermost 관리자 콘솔 → Integrations → Bot Accounts
2. Add Bot Account 클릭
3. 봇 사용자명, 표시 이름 입력
4. Access Token 복사

2단계: Webhook 또는 Bot API 설정

Incoming Webhook (단방향)

관리자 콘솔 → Integrations → Incoming Webhooks → Add Incoming Webhook

Bot API (양방향, 권장)

Bot Account의 Access Token을 사용합니다.

3단계: OpenClaw 설정

{
  "channels": {
    "mattermost": {
      "enabled": true,
      "serverUrl": "https://your-mattermost.com",
      "botToken": "your-bot-access-token",
      "teamId": "your-team-id",
      "channels": ["town-square", "ai-assistant"]
    }
  }
}

채널 및 팀 ID 확인

# API로 팀 ID 확인
curl https://your-mattermost.com/api/v4/teams \
  -H "Authorization: Bearer YOUR_BOT_TOKEN"

# 채널 ID 확인
curl https://your-mattermost.com/api/v4/channels \
  -H "Authorization: Bearer YOUR_BOT_TOKEN"

트러블슈팅

401 Unauthorized

Bot Access Token이 올바른지 확인하고 만료 여부를 점검합니다.

채널에서 응답 없음

봇이 해당 채널에 멤버로 추가되어 있는지 확인합니다:

• Mattermost에서 /invite @botname 실행

참고:

• Mattermost Bot Accounts 문서
• 공식 문서: Mattermost Channel