OpenClawをTwitch配信チャットに接続する

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 は 1 メッセージあたり 500 文字の長さ制限があります。AI の返信がこの長さを超える場合、OpenClaw は自動的に返信を複数のメッセージに分割して送信します。設定でこの動作を調整することもできます。

{
  "channels": {
    "twitch-irc": {
      "maxMessageLength": 450,
      "splitLongMessages": true
    }
  }
}

maxMessageLength は 500 よりやや小さい値に設定することを推奨します。Twitch が追加する可能性のあるプレフィックスの余裕を確保するためです。

レート制限

Twitch は IRC メッセージの送信に厳格なレート制限を設けています。一般ユーザーは 30 秒あたり最大 20 メッセージです。「既知のボット」として認証されると制限が緩和されます。OpenClaw の Twitch プラグインにはレート制御ロジックが組み込まれており、自動的にキューイングと送信の遅延を行い、制限のトリガーを回避します。

Bot が高トラフィックチャンネルで動作する必要がある場合、Twitch 開発者ポータルで「既知のボット」ステータスを申請して、より高いレート上限を得ることを推奨します。

セキュリティと権限

allowlist を使用して AI の返信をトリガーできるユーザーを制限します。

{
  "channels": {
    "twitch-irc": {
      "allowlist": ["user1", "user2"],
      "moderatorsAllowed": true,
      "subscribersOnly": false
    }
  }
}

moderatorsAllowed を true にすると、チャンネルのモデレーターが自動的に使用権限を得ます。subscribersOnly を true にすると、チャンネルのサブスクライバーのみが AI 機能を使用できます。

マルチチャンネルと共存

1 つの OpenClaw インスタンスの Twitch Bot は同時に複数のチャンネルに参加でき、各チャンネルの会話は独立して処理されます。同時に、Twitch チャンネルは OpenClaw の他のチャンネル（Discord、Telegram など）と共存して動作でき、同じ AI バックエンドを共有します。クロスプラットフォーム運営を行う配信者やコミュニティに非常に適しています。

よくある問題

Bot が Twitch IRC に接続できない場合、まず OAuth Token が有効かどうかを確認してください。Token は期限切れになることがあり、再生成が必要です。Bot が接続済みだがメッセージに応答しない場合は、トリガーモードの設定が正しいかどうか、および Bot が実際にターゲットチャンネルに参加しているかどうかを確認してください。OpenClaw のログで IRC 接続とメッセージ受信の詳細な状態を確認できます。