Twitch

通过 IRC 连接支持 Twitch 聊天。OpenClaw 以 Twitch 用户（机器人账号）身份连接，用于在频道中接收和发送消息。

# 内置插件

如果你使用的是较旧构建，或是排除了 Twitch 的自定义安装，请直接安装 npm 包：

openclaw plugins install @openclaw/twitch

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

使用裸包名可跟随当前官方发布标签。仅在需要可复现安装时才固定精确版本。

详情：插件

# 快速设置（初学者）

最小配置：

{
  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 并使用 action：

• send - 向频道发送消息

示例：

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

# 安全与运维

• 像对待密码一样对待令牌 — 切勿将令牌提交到 git。
• 使用自动令牌刷新 适用于长期运行的机器人。
• 使用用户 ID 允许列表 而不是用户名来进行访问控制。
• 监控日志 以查看令牌刷新事件和连接状态。
• 最小化令牌作用域 — 仅请求 chat:read 和 chat:write。
• 如果卡住：确认没有其他进程占用该会话后，重启 Gateway 网关。

# 限制

• 每条消息 500 个字符（会在词边界自动分块）。
• Markdown 会在分块前被移除。
• 无速率限制（使用 Twitch 内置速率限制）。

# 相关

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