Twitch

Twurple クライアントを介して Twitch のチャット（IRC）インターフェースを使用する Twitch チャット対応。OpenClaw は Twitch ボットアカウントとしてサインインし、設定されたアカウントごとに 1 つのチャンネルへ参加して、そのチャンネルで返信します。

インストール

Twitch は公式 Plugin として提供されており、コアインストールには含まれません。

openclaw plugins install @openclaw/twitch

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

plugins install は Plugin を登録して有効にします。openclaw onboard または openclaw channels add で Twitch を選択すると、必要に応じてインストールされます。現在のリリースに追従するにはバージョンなしのパッケージ名を使用し、再現可能なインストールが必要な場合にのみ正確なバージョンを固定してください。OpenClaw 2026.4.10 以降が必要です。

詳細: Plugin

クイックセットアップ

openclaw gateway run

最小構成:

{  channels: {    twitch: {      enabled: true,      username: "openclaw", // ボットの Twitch アカウント（認証に使用）      accessToken: "oauth:abc123...", // OAuth アクセストークン（または環境変数 OPENCLAW_TWITCH_ACCESS_TOKEN を使用）      clientId: "xyz789...", // Token Generator から取得した Client ID      channel: "yourchannel", // 参加する Twitch チャンネルのチャット（必須）      allowFrom: ["123456789"], // （推奨）自分の Twitch ユーザー ID のみ    },  },}

概要

• Gateway が所有する Twitch チャンネル。
• 決定論的ルーティング: 返信は常に、メッセージの送信元である Twitch チャンネルに返されます。
• 参加した各チャンネルは、分離されたグループセッションキー agent:<agentId>:twitch:group:<channel> に対応します。
• username はボットのアカウント（認証を行う側）、channel は参加するチャットルームです。各アカウントエントリは、ちょうど 1 つのチャンネルに参加します。
• トークンは oauth: プレフィックスの有無にかかわらず機能します。OpenClaw はどちらの形式も正規化します（セットアップウィザードでは oauth: 形式を想定しています）。

受信メッセージの耐久性

OpenClaw は、受け入れた各 Twitch チャットメッセージを通常のディスパッチ前に永続キューへ追加します。保留中または再試行可能なメッセージは Gateway の再起動後も維持され、設定されたチャンネル内で直列処理されます。また、有効または保持中の完了レコードが存在する間は、Twitch のメッセージ ID を使用してキューエントリの重複を抑止します。

クライアントが PRIVMSG を受け入れた後、Twitch チャットがそれを再送することはありません。これにより、ローカルでの受け入れからディスパッチまでの間に発生するクラッシュには対処できますが、永続キューへの受け入れ前に取りこぼしたメッセージは復元できません。キューへの追加自体が失敗した場合、OpenClaw はその失敗をログに記録します。再接続しても、Twitch にそのメッセージの再送は要求しません。

トークンの更新（任意）

Twitch Token Generator のトークンは OpenClaw では更新できません。期限切れになったら再生成してください（有効期間は数時間で、アプリの登録は不要です）。

自動更新を使用するには、Twitch Developer Console で独自のアプリを作成し、次を追加します。

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

両方を設定すると、Plugin は有効期限前にトークンを更新する認証プロバイダーを使用し、更新のたびにログを記録します。refreshToken がない場合は token refresh disabled (no refresh token) をログに記録し、clientSecret がない場合は静的な（更新されない）トークンにフォールバックします。

複数アカウント対応

アカウントごとの認証情報とともに channels.twitch.accounts を使用します。共通のパターンについては、設定を参照してください。

例（2 つのチャンネルで 1 つのボットアカウントを使用）:

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

アクセス制御

allowFrom は Twitch ユーザー ID の厳格な許可リストです。これが設定されている場合、allowedRoles は無視されます。代わりにロールベースのアクセスを使用するには、allowFrom を未設定のままにします。

利用可能なロール: "moderator"、"owner"、"vip"、"subscriber"、"all"。

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

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

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

トラブルシューティング

最初に、診断コマンドを実行します。

openclaw doctoropenclaw channels status --probe

mybot に環境変数のトークンソースを使用ユーザー 123456 のアクセストークンを更新（14400s 後に期限切れ）

設定

アカウント設定

プロバイダーオプション

• channels.twitch.enabled - チャンネルの起動を有効化または無効化
• channels.twitch.username / accessToken / clientId / channel - 簡略化された単一アカウント設定（暗黙的な default アカウント。accounts.default より優先）
• channels.twitch.accounts.<accountName> - 複数アカウント設定（上記のすべてのアカウントフィールド）
• channels.twitch.defaultAccount - デフォルトにするアカウント名
• channels.twitch.markdown.tables - Markdown テーブルのレンダリングモード（off | bullets | code | block）

完全な例:

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

ツールアクション

エージェントは、メッセージツールの send アクションを介して Twitch メッセージを送信できます。

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

to は任意で、デフォルトではアカウントに設定された channel が使用されます。

安全性と運用

• トークンをパスワードのように扱う - トークンを git にコミットしないでください。
• 長時間稼働するボットには、トークンの自動更新を使用する。
• アクセス制御には、ユーザー名ではなくユーザー ID の許可リストを使用する。
• トークン更新イベントと接続状態を確認するため、ログを監視する。
• トークンのスコープを最小限にする - chat:read と chat:write のみをリクエストしてください。
• 解決しない場合: 他のプロセスがセッションを所有していないことを確認してから、Gateway を再起動してください。

制限

• 1 メッセージあたり500 文字。それより長い返信は、単語の境界で分割されます。
• 送信前に Markdown は除去されます（Twitch チャットはプレーンテキストで、改行はスペースに変換されます）。
• OpenClaw 自体はレート制限を追加しません。Twitch のレート制限は Twurple チャットクライアントが処理します。

関連項目

• チャンネルルーティング — メッセージのセッションルーティング
• チャンネルの概要 — サポートされているすべてのチャンネル
• グループ — グループチャットの動作とメンションによる制御
• ペアリング — DM の認証とペアリングの流れ
• セキュリティ — アクセスモデルと堅牢化