Twitch

Twitch 透過 IRC 連線支援聊天。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",
    },
  },
}

如果環境變數和設定皆已設定，設定檔優先。

# 存取控制（建議）

{
  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)

# 設定

# 帳號設定

# 提供者選項

• 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 驗證與配對流程
• 安全性 — 存取模型與強化