Twitch 채널 설정

OpenClaw와 Twitch를 연결하여 스트리머 채팅용 AI 봇을 구축하는 방법을 안내합니다.

개요

Twitch는 IRC 기반 채팅 시스템을 사용하며, OpenClaw와 연결하여 스트림 채팅용 AI 봇을 만들 수 있습니다.

• IRC 연결 — Twitch IRC 서버에 직접 연결
• Chat Commands — !command 형식의 봇 명령어
• 채널 청취 — 여러 채널 동시 참여 가능
• Twitch API — Helix API 통합
• 스트리머 지원 — 스트림 중 실시간 상호작용

플러그인 채널: 별도 설치 필요

1단계: Twitch 플러그인 설치

openclaw plugin install @openclaw/channel-twitch

2단계: Twitch Developers 앱 등록

1. Twitch Developers Console 접속: https://dev.twitch.tv/console
2. Apps → Register Your Application
3. 앱 정보 입력:
   • Name: OpenClaw Bot
   • OAuth Redirect URLs: http://localhost:3000/callback
   • Category: Chat Bot

3단계: Access Token 생성

1. 생성된 앱 선택
2. Client ID 복사
3. Client Secret 생성
4. OAuth Token Generator에서 access token 생성

4단계: OpenClaw 설정

{
  "channels": {
    "twitch": {
      "enabled": true,
      "username": "openclaw-bot",
      "oauthToken": "oauth:your-access-token",
      "channels": ["your-channel", "another-channel"],
      "joinOnStart": true
    }
  }
}

환경 변수로 설정:

TWITCH_USERNAME=openclaw-bot
TWITCH_OAUTH_TOKEN=oauth:your-access-token

5단계: 게이트웨이 시작

openclaw gateway

트위치 스트림 채팅에서 테스트:

!help

고급 설정

Chat Commands

{
  "channels": {
    "twitch": {
      "commands": {
        "prefix": "!",
        "enabled": true
      }
    }
  }
}

멀티 채널

{
  "channels": {
    "twitch": {
      "channels": ["channel1", "channel2", "channel3"],
      "joinOnStart": true
    }
  }
}

Helix API

{
  "channels": {
    "twitch": {
      "helix": {
        "enabled": true,
        "clientId": "your-client-id",
        "clientSecret": "your-client-secret"
      }
    }
  }
}

커스텀 명령어

{
  "channels": {
    "twitch": {
      "customCommands": {
        "!hello": "Hello @{user}! Welcome to the stream!",
        "!social": "Follow me on Twitter: @yourhandle"
      }
    }
  }
}

트러블슈팅

IRC 연결 실패

증상: Login authentication failed

해결:

1. OAuth Token 유효성 확인
2. oauth: 프리픽스가 포함되었는지 확인
3. Twitch Developers Console에서 토큰 재발급

채널에 참여하지 못함

• 채널 이름 확인 (소문자)
• 채널이 존재하는지 확인
• 봇이 차단되지 않았는지 확인

메시지가 전송되지 않음

• 봇이 채널에 모더레이터 권한이 있는지 확인
• Rate limit 확인 (20개 메시지/30초)
• OpenClaw 로그 확인:

  openclaw logs --follow
  

참고:

• Twitch Chat IRC
• Twitch Helix API
• 공식 문서: Twitch Channel