Twitch는 세계 최대의 게임 라이브 스트리밍 플랫폼 중 하나이며, 채팅방은 IRC(Internet Relay Chat) 프로토콜을 기반으로 운영됩니다. OpenClaw은 플러그인 시스템을 통해 Twitch IRC 채널을 지원하여, Twitch 라이브 방에 AI 챗봇을 배포하여 시청자 질문에 자동 응답, 인터랙티브 엔터테인먼트, 콘텐츠 관리 보조 등의 기능을 구현할 수 있습니다.
사전 준비
시작하기 전에 다음 항목을 준비해야 합니다:
- OpenClaw 인스턴스가 배포되어 정상적으로 실행 중
- Bot 신분으로 사용할 Twitch 계정(스트리머 개인 계정이 아닌 전용 Bot 계정 생성 권장)
- Twitch OAuth Token(Bot 인증용)
- 참여할 채널 이름 목록
Twitch OAuth Token 발급
Bot이 Twitch IRC에 연결하려면 OAuth 토큰이 필요합니다. Twitch 개발자 포털에서 애플리케이션을 등록하여 발급받을 수 있습니다.
먼저 dev.twitch.tv에 접속하여 Bot 계정으로 로그인하고 새 애플리케이션을 생성합니다. Client ID를 기록합니다. 그런 다음 OAuth 인증 흐름을 통해 액세스 토큰을 발급받으며, 필요한 권한 범위(scope)는 chat:read와 chat:edit입니다.
발급받은 토큰 형식은 oauth:xxxxxxxxxxxxxx와 같으며, 이후 설정에 사용됩니다.
Twitch IRC 플러그인 설치
OpenClaw 플러그인 시스템을 통해 설치합니다:
openclaw plugin install twitch-irc
인터랙티브 명령으로 설정합니다:
openclaw channels login twitch-irc
시스템이 Bot 사용자 이름, OAuth Token, 참여할 채널 이름을 차례로 입력하도록 안내합니다.
openclaw.json 설정
수동 설정 방식:
{
"channels": {
"twitch-irc": {
"enabled": true,
"username": "your_bot_username",
"token": "oauth:xxxxxxxxxxxxxx",
"channels": ["channel1", "channel2"],
"commandPrefix": "!ask"
}
}
}
username은 Bot의 Twitch 사용자 이름, token은 OAuth 토큰, channels는 참여할 채널 목록(# 접두사 불필요), commandPrefix는 AI 응답을 트리거하는 명령 접두사입니다.
트리거 메커니즘
Twitch 채팅방의 메시지 양은 보통 매우 많으며, 특히 인기 라이브 방에서는 더욱 그렇습니다. AI가 모든 메시지에 응답하는 것은 현실적이지도 적절하지도 않습니다. OpenClaw은 다양한 트리거 모드를 제공합니다:
명령 접두사 모드: 지정된 접두사로 시작하는 메시지만 AI 응답을 트리거합니다. 예를 들어 commandPrefix를 !ask로 설정하면, 사용자가 !ask 오늘 날씨 어때?를 보낼 때만 응답합니다. 가장 권장하는 모드입니다.
멘션 모드: 채팅 메시지에서 Bot 사용자 이름을 @했을 때 응답을 트리거합니다. "triggerMode": "mention"으로 설정합니다.
키워드 모드: 메시지에 특정 키워드가 포함되면 트리거합니다. "triggerKeywords": ["키워드1", "키워드2"]로 설정합니다.
{
"channels": {
"twitch-irc": {
"triggerMode": "command",
"commandPrefix": "!ai"
}
}
}
메시지 길이 제한
Twitch IRC는 단일 메시지에 500자의 길이 제한이 있습니다. AI 응답이 이 길이를 초과하면, OpenClaw이 자동으로 응답을 여러 메시지로 분할하여 전송합니다. 설정에서 이 동작을 조정할 수도 있습니다:
{
"channels": {
"twitch-irc": {
"maxMessageLength": 450,
"splitLongMessages": true
}
}
}
Twitch가 추가할 수 있는 접두사를 위해 여유를 두고 maxMessageLength를 500보다 약간 작은 값으로 설정하는 것을 권장합니다.
속도 제한
Twitch는 IRC 메시지 전송에 엄격한 속도 제한이 있습니다. 일반 사용자는 30초당 최대 20개 메시지를 보낼 수 있으며, "알려진 봇"으로 인증하면 제한이 완화됩니다. OpenClaw의 Twitch 플러그인에는 속도 제어 로직이 내장되어 있어 자동으로 큐에 넣고 전송을 지연시켜 제한을 트리거하지 않도록 합니다.
Bot이 트래픽이 많은 채널에서 실행해야 하는 경우, Twitch 개발자 포털에서 "알려진 봇" 상태를 신청하여 더 높은 속도 제한을 받는 것을 권장합니다.
보안 및 권한
allowlist를 사용하여 AI 응답을 트리거할 수 있는 사용자를 제한합니다:
{
"channels": {
"twitch-irc": {
"allowlist": ["user1", "user2"],
"moderatorsAllowed": true,
"subscribersOnly": false
}
}
}
moderatorsAllowed를 true로 설정하면, 채널의 관리자(Moderator)가 자동으로 사용 권한을 얻습니다. subscribersOnly를 true로 설정하면, 채널의 구독자만 AI 기능을 사용할 수 있습니다.
다중 채널 및 공존
하나의 OpenClaw 인스턴스의 Twitch Bot은 여러 채널에 동시에 참여할 수 있으며, 각 채널의 대화는 독립적으로 처리됩니다. 또한 Twitch 채널은 OpenClaw의 다른 채널(Discord, Telegram 등)과 공존하여 실행될 수 있으며, 동일한 AI 백엔드를 공유합니다. 크로스 플랫폼으로 운영하는 스트리머나 커뮤니티에 매우 적합합니다.
자주 묻는 질문
Bot이 Twitch IRC에 연결할 수 없는 경우, 먼저 OAuth Token이 유효한지 확인하세요. 토큰이 만료되어 재생성이 필요할 수 있습니다. Bot이 이미 연결되었지만 메시지에 응답하지 않는 경우, 트리거 모드 설정이 올바른지, Bot이 실제로 대상 채널에 참여했는지 확인하세요. OpenClaw 로그에서 IRC 연결 및 메시지 수신의 상세 상태를 확인할 수 있습니다.