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", // Bot's Twitch account (authenticates)      accessToken: "oauth:abc123...", // OAuth access token (or use OPENCLAW_TWITCH_ACCESS_TOKEN env var)      clientId: "xyz789...", // Client ID from Token Generator      channel: "yourchannel", // Which Twitch channel's chat to join (required)      allowFrom: ["123456789"], // (recommended) Your Twitch user ID only    },  },}

功能说明

• 由 Gateway 网关拥有的 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。
• 如果遇到阻碍：确认没有其他进程占用该会话后，重启 Gateway 网关。

限制

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

相关内容

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