Twitch

透過 Twurple 用戶端，經由 Twitch 的聊天（IRC）介面支援 Twitch 聊天。OpenClaw 會以 Twitch 機器人帳號登入，為每個已設定的帳號加入一個頻道，並在該頻道中回覆。

安裝

Twitch 以官方外掛形式提供，不屬於核心安裝的一部分。

openclaw plugins install @openclaw/twitch

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

plugins install 會註冊並啟用此外掛。在 openclaw onboard 或 openclaw channels add 期間選擇 Twitch，會依需求安裝它。使用不含版本的套件名稱即可跟隨目前版本；只有在需要可重現的安裝時，才鎖定確切版本。需要 OpenClaw 2026.4.10 或更新版本。

詳細資訊：外掛

快速設定

openclaw gateway run

最小設定：

{  channels: {    twitch: {      enabled: true,      username: "openclaw", // 機器人的 Twitch 帳號（用於驗證）      accessToken: "oauth:abc123...", // OAuth 存取權杖（或使用 OPENCLAW_TWITCH_ACCESS_TOKEN 環境變數）      clientId: "xyz789...", // 來自 Token Generator 的用戶端 ID      channel: "yourchannel", // 要加入哪個 Twitch 頻道的聊天室（必填）      allowFrom: ["123456789"], // （建議）僅允許你的 Twitch 使用者 ID    },  },}

功能概述

• 由閘道擁有的 Twitch 頻道。
• 確定性路由：回覆一律傳回訊息來源的 Twitch 頻道。
• 每個已加入的頻道都會對應至隔離的群組工作階段金鑰 agent:<agentId>:twitch:group:<channel>。
• username 是機器人的帳號（用於驗證的帳號），channel 則是要加入的聊天室。每個帳號項目只會加入一個頻道。
• 權杖無論是否含有 oauth: 前綴都能使用；OpenClaw 會將兩種形式正規化（設定精靈預期使用 oauth: 形式）。

權杖重新整理（選用）

Twitch Token Generator 產生的權杖無法由 OpenClaw 重新整理，請在到期後重新產生（有效期為數小時，無須註冊應用程式）。

若要自動重新整理，請在 Twitch Developer Console 建立自己的應用程式，並新增：

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

兩者皆有設定時，外掛會使用可重新整理的驗證提供者，在權杖到期前予以更新，並記錄每次重新整理。若缺少 refreshToken，則會記錄 token refresh disabled (no refresh token)；若缺少 clientSecret，則會退回使用靜態（不會重新整理的）權杖。

多帳號支援

使用 channels.twitch.accounts 設定各帳號的認證資訊。共用模式請參閱設定。

範例（一個機器人帳號用於兩個頻道）：

{  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

Using env token source for mybotAccess token refreshed for user 123456 (expires in 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。
• 若遇到問題：確認沒有其他程序占用工作階段後，重新啟動閘道。

限制

• 每則訊息最多 500 個字元；較長的回覆會在單字邊界處分段。
• 傳送前會移除 Markdown（Twitch 聊天使用純文字；換行會轉為空格）。
• OpenClaw 本身不會新增速率限制；Twurple 聊天用戶端會處理 Twitch 的速率限制。

相關內容

• 頻道路由 — 訊息的工作階段路由
• 頻道概覽 — 所有支援的頻道
• 群組 — 群組聊天行為與提及閘門
• 配對 — 私訊驗證與配對流程
• 安全性 — 存取模型與強化措施