Twitch

IRC 연결을 통한 Twitch 채팅 지원. OpenClaw는 Twitch 사용자(봇 계정)로 연결하여 채널에서 메시지를 받고 보냅니다.

# 번들 Plugin

이전 빌드를 사용 중이거나 Twitch가 제외된 사용자 지정 설치를 사용하는 경우, npm 패키지를 직접 설치하세요.

openclaw plugins install @openclaw/twitch

openclaw plugins install ./path/to/local/twitch-plugin

현재 공식 릴리스 태그를 따르려면 기본 패키지를 사용하세요. 재현 가능한 설치가 필요할 때만 정확한 버전을 고정하세요.

세부 정보: Plugins

# 빠른 설정(초보자)

최소 구성:

{
  channels: {
    twitch: {
      enabled: true,
      username: "openclaw", // Bot's Twitch account
      accessToken: "oauth:abc123...", // OAuth Access Token (or use OPENCLAW_TWITCH_ACCESS_TOKEN env var)
      clientId: "xyz789...", // Client ID from Token Generator
      channel: "vevisk", // Which Twitch channel's chat to join (required)
      allowFrom: ["123456789"], // (recommended) Your Twitch user ID only - get it from https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/
    },
  },
}

# 개요

• Gateway가 소유한 Twitch 채널입니다.
• 결정적 라우팅: 응답은 항상 Twitch로 돌아갑니다.
• 각 계정은 격리된 세션 키 agent:<agentId>:twitch:<accountName>에 매핑됩니다.
• username은 봇 계정(인증 주체)이고, channel은 참여할 채팅방입니다.

# 설정(자세히)

# 자격 증명 생성

Twitch Token Generator를 사용하세요.

• Bot Token을 선택합니다
• chat:read 및 chat:write 범위가 선택되어 있는지 확인합니다
• Client ID 및 Access Token을 복사합니다

# 봇 구성

OPENCLAW_TWITCH_ACCESS_TOKEN=oauth:abc123...

{
  channels: {
    twitch: {
      enabled: true,
      username: "openclaw",
      accessToken: "oauth:abc123...",
      clientId: "xyz789...",
      channel: "vevisk",
    },
  },
}

env와 구성이 둘 다 설정된 경우 구성이 우선합니다.

# 액세스 제어(권장)

{
  channels: {
    twitch: {
      allowFrom: ["123456789"], // (recommended) Your Twitch user ID only
    },
  },
}

강력한 허용 목록에는 allowFrom을 선호하세요. 역할 기반 액세스를 원하면 대신 allowedRoles를 사용하세요.

사용 가능한 역할: "moderator", "owner", "vip", "subscriber", "all".

# 토큰 갱신(선택 사항)

Twitch Token Generator의 토큰은 자동으로 갱신할 수 없습니다. 만료되면 다시 생성하세요.

자동 토큰 갱신을 사용하려면 Twitch Developer Console에서 직접 Twitch 애플리케이션을 만들고 구성에 추가하세요.

{
  channels: {
    twitch: {
      clientSecret: "your_client_secret",
      refreshToken: "your_refresh_token",
    },
  },
}

봇은 만료 전에 토큰을 자동으로 갱신하고 갱신 이벤트를 로그에 기록합니다.

# 다중 계정 지원

계정별 토큰과 함께 channels.twitch.accounts를 사용하세요. 공유 패턴은 구성을 참조하세요.

예시(두 채널의 봇 계정 하나):

{
  channels: {
    twitch: {
      accounts: {
        channel1: {
          username: "openclaw",
          accessToken: "oauth:abc123...",
          clientId: "xyz789...",
          channel: "vevisk",
        },
        channel2: {
          username: "openclaw",
          accessToken: "oauth:def456...",
          clientId: "uvw012...",
          channel: "secondchannel",
        },
      },
    },
  },
}

# 액세스 제어

{
  channels: {
    twitch: {
      accounts: {
        default: {
          allowFrom: ["123456789", "987654321"],
        },
      },
    },
  },
}

{
  channels: {
    twitch: {
      accounts: {
        default: {
          allowedRoles: ["moderator", "vip"],
        },
      },
    },
  },
}

{
  channels: {
    twitch: {
      accounts: {
        default: {
          requireMention: false,
        },
      },
    },
  },
}

# 문제 해결

먼저 진단 명령을 실행하세요.

openclaw doctor
openclaw channels status --probe

Using env token source for mybot
Access token refreshed for user 123456 (expires in 14400s)

# 구성

# 계정 구성

# Provider 옵션

• channels.twitch.enabled - 채널 시작 활성화/비활성화
• channels.twitch.username - 봇 사용자 이름(간소화된 단일 계정 구성)
• channels.twitch.accessToken - OAuth 액세스 토큰(간소화된 단일 계정 구성)
• channels.twitch.clientId - Twitch Client ID(간소화된 단일 계정 구성)
• channels.twitch.channel - 참여할 채널(간소화된 단일 계정 구성)
• channels.twitch.accounts.<accountName> - 다중 계정 구성(위의 모든 계정 필드)

전체 예시:

{
  channels: {
    twitch: {
      enabled: true,
      username: "openclaw",
      accessToken: "oauth:abc123...",
      clientId: "xyz789...",
      channel: "vevisk",
      clientSecret: "secret123...",
      refreshToken: "refresh456...",
      allowFrom: ["123456789"],
      allowedRoles: ["moderator", "vip"],
      accounts: {
        default: {
          username: "mybot",
          accessToken: "oauth:abc123...",
          clientId: "xyz789...",
          channel: "your_channel",
          enabled: true,
          clientSecret: "secret123...",
          refreshToken: "refresh456...",
          expiresIn: 14400,
          obtainmentTimestamp: 1706092800000,
          allowFrom: ["123456789", "987654321"],
          allowedRoles: ["moderator"],
        },
      },
    },
  },
}

# 도구 작업

에이전트는 다음 작업으로 twitch를 호출할 수 있습니다.

• send - 채널에 메시지 보내기

예시:

{
  action: "twitch",
  params: {
    message: "Hello Twitch!",
    to: "#mychannel",
  },
}

# 안전 및 운영

• 토큰을 비밀번호처럼 취급하세요 — 토큰을 git에 절대 커밋하지 마세요.
• 장기 실행 봇에는 자동 토큰 갱신을 사용하세요.
• 액세스 제어에는 사용자 이름 대신 사용자 ID 허용 목록을 사용하세요.
• 토큰 갱신 이벤트와 연결 상태를 위해 로그를 모니터링하세요.
• 토큰 범위를 최소화하세요 — chat:read 및 chat:write만 요청하세요.
• 막혔다면: 다른 프로세스가 세션을 소유하지 않는지 확인한 후 Gateway를 다시 시작하세요.

# 제한

• 메시지당 500자(단어 경계에서 자동 분할).
• Markdown은 분할 전에 제거됩니다.
• 속도 제한 없음(Twitch의 내장 속도 제한 사용).

# 관련 항목

• 채널 라우팅 — 메시지의 세션 라우팅
• 채널 개요 — 지원되는 모든 채널
• 그룹 — 그룹 채팅 동작 및 멘션 게이팅
• 페어링 — DM 인증 및 페어링 흐름
• 보안 — 액세스 모델 및 강화