Twitch

通过 Twurple 客户端使用 Twitch 的聊天（IRC）接口提供 Twitch 聊天支持。OpenClaw 以 Twitch Bot 账号登录，每个已配置账号加入一个频道，并在该频道中回复。

安装

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", // Bot 的 Twitch 账号（用于身份验证）      accessToken: "oauth:abc123...", // OAuth 访问令牌（或使用 OPENCLAW_TWITCH_ACCESS_TOKEN 环境变量）      clientId: "xyz789...", // 来自 Token Generator 的客户端 ID      channel: "yourchannel", // 要加入哪个 Twitch 频道的聊天室（必需）      allowFrom: ["123456789"], // （推荐）仅填写你的 Twitch 用户 ID    },  },}

工作原理

• 由 Gateway 网关拥有的 Twitch 频道。
• 确定性路由：回复始终发回消息来源的 Twitch 频道。
• 每个已加入的频道都映射到一个隔离的群组会话键 agent:<agentId>:twitch:group:<channel>。
• username 是 Bot 的账号（用于身份验证），channel 是要加入的聊天室。每个账号条目只加入一个频道。
• 令牌无论是否带有 oauth: 前缀均可使用；OpenClaw 会规范化这两种形式（设置向导要求使用 oauth: 形式）。

入站持久性

OpenClaw 会在正常分发前，将每条已接受的 Twitch 聊天消息持久化到队列。待处理或可重试的消息在 Gateway 网关重启后仍会保留，并按已配置的频道串行处理；只要存在活动或保留的完成记录，就会使用 Twitch 的消息 ID 阻止重复的队列条目。

Twitch 聊天不会在客户端接受 PRIVMSG 后重放它。这可以防范从本地接受消息到分发消息期间的崩溃窗口，但无法恢复在持久化接纳前错过的消息。如果追加队列本身失败，OpenClaw 会记录该故障；重新连接不会要求 Twitch 重新发送该消息。

令牌刷新（可选）

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 配置各账号的凭据。有关共用模式，请参阅配置。

示例（一个 Bot 账号用于两个频道）：

{  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。
• 对于长期运行的 Bot，使用自动令牌刷新。
• 使用用户 ID 允许列表而非用户名进行访问控制。
• 监控日志中的令牌刷新事件和连接状态。
• 尽可能缩小令牌权限范围 — 仅请求 chat:read 和 chat:write。
• 如果遇到问题：确认没有其他进程占用该会话后，重启 Gateway 网关。

限制

• 每条消息不超过 500 个字符；较长的回复会在单词边界处分块。
• 发送前会移除 Markdown 格式（Twitch 聊天使用纯文本；换行符会转换为空格）。
• OpenClaw 本身不添加速率限制；Twurple 聊天客户端负责处理 Twitch 的速率限制。

相关内容

• 频道路由 — 消息的会话路由
• 渠道概览 — 所有受支持的渠道
• 群组 — 群聊行为和提及门控
• 配对 — 私信身份验证和配对流程
• 安全 — 访问模型和安全强化