首页 教程 分类 Skills下载 关于
ZH EN JA KO
频道对接

OpenClaw连接Twitch直播聊天室

· 7 分钟

Twitch是全球最大的游戏直播平台之一,其聊天室基于IRC(Internet Relay Chat)协议运行。OpenClaw通过插件系统支持Twitch IRC频道,让你可以在Twitch直播间中部署AI聊天机器人,实现自动回复观众问题、互动娱乐、内容审核辅助等功能。

前置准备

在开始之前,你需要准备以下内容:

  • OpenClaw实例已部署并正常运行
  • 一个Twitch账户用作Bot身份(建议创建专门的Bot账户,而非使用主播个人账户)
  • Twitch OAuth Token(用于Bot认证)
  • 要加入的频道名称列表

获取Twitch OAuth Token

Bot连接Twitch IRC需要一个OAuth令牌进行认证。你可以通过Twitch开发者门户注册一个应用来获取。

首先访问 dev.twitch.tv,使用Bot账户登录并创建一个新应用。记下Client ID。然后通过OAuth授权流程获取访问令牌,需要的权限范围(scope)包括 chat:readchat:edit

获取到的token格式类似 oauth:xxxxxxxxxxxxxx,用于后续配置。

安装Twitch IRC插件

通过OpenClaw插件系统安装:

openclaw plugin install twitch-irc

使用交互式命令配置:

openclaw channels login twitch-irc

系统会依次提示你输入Bot用户名、OAuth Token和要加入的频道名。

配置openclaw.json

手动配置方式:

{
  "channels": {
    "twitch-irc": {
      "enabled": true,
      "username": "your_bot_username",
      "token": "oauth:xxxxxxxxxxxxxx",
      "channels": ["channel1", "channel2"],
      "commandPrefix": "!ask"
    }
  }
}

username 是Bot的Twitch用户名,token 是OAuth令牌,channels 是要加入的频道列表(不含#号前缀),commandPrefix 是触发AI回复的命令前缀。

触发机制

Twitch聊天室消息量通常很大,特别是在热门直播间中。让AI响应每条消息既不现实也不合适。OpenClaw提供了多种触发模式:

命令前缀模式:只有以指定前缀开头的消息才会触发AI回复。例如设置 commandPrefix!ask,用户发送 !ask 今天天气怎么样 时才会得到回复。这是最推荐的模式。

提及模式:当聊天消息中@了Bot用户名时触发回复。配置 "triggerMode": "mention" 即可。

关键词模式:当消息中包含特定关键词时触发。可以通过 "triggerKeywords": ["关键词1", "关键词2"] 配置。

{
  "channels": {
    "twitch-irc": {
      "triggerMode": "command",
      "commandPrefix": "!ai"
    }
  }
}

消息长度限制

Twitch IRC对单条消息有500字符的长度限制。如果AI回复超过这个长度,OpenClaw会自动将回复拆分为多条消息发送。你也可以在配置中调整这个行为:

{
  "channels": {
    "twitch-irc": {
      "maxMessageLength": 450,
      "splitLongMessages": true
    }
  }
}

建议将 maxMessageLength 设置为略小于500的值,留出余量给Twitch可能添加的前缀。

速率限制

Twitch对IRC消息发送有严格的速率限制。普通用户每30秒最多发送20条消息,认证为「已知机器人」后限制会放宽。OpenClaw的Twitch插件内置了速率控制逻辑,会自动排队和延迟发送以避免触发限制。

如果你的Bot需要在高流量频道中运行,建议到Twitch开发者门户申请「已知机器人」状态以获得更高的速率上限。

安全与权限

使用allowlist限制哪些用户可以触发AI回复:

{
  "channels": {
    "twitch-irc": {
      "allowlist": ["user1", "user2"],
      "moderatorsAllowed": true,
      "subscribersOnly": false
    }
  }
}

moderatorsAllowed 设为true时,频道的管理员(Moderator)自动获得使用权限。subscribersOnly 设为true时,只有频道的订阅者才能使用AI功能。

多频道与共存

一个OpenClaw实例的Twitch Bot可以同时加入多个频道,每个频道的对话独立处理。同时,Twitch频道可以和OpenClaw的其他频道(如Discord、Telegram等)共存运行,共享同一个AI后端,非常适合跨平台运营的主播或社区。

常见问题

如果Bot无法连接到Twitch IRC,首先检查OAuth Token是否有效。Token可能过期,需要重新生成。如果Bot已连接但不响应消息,确认触发模式配置是否正确,以及Bot是否真的加入了目标频道。可以在OpenClaw日志中查看IRC连接和消息接收的详细状态。

OpenClaw 是开源免费的个人AI助手,支持 WhatsApp、Telegram、Discord 等多平台接入