OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书
查看原始文档 最近生成：2026/03/08 15:37

简要总结

Twitch

这页说明书在教你如何让你的机器人小伙伴“OpenClaw”去Twitch聊天室玩。Twitch就像一个有很多房间的线上俱乐部，人们可以在里面聊天。为了让你的机器人能进去听大家说话，并且也能和大家聊天，你需要先给它准备一张“门票”（就是一些密码和号码）。这页会一步一步告诉你怎么拿到这张门票，怎么把它交给机器人，还有怎么告诉机器人它只能听你或者你朋友的话，不能谁都理。如果你想让机器人在Twitch里帮你做点事情，比如自动打招呼，就看这里。

五岁小孩版解释

首先，你需要一个特别的“零件”才能让机器人连接Twitch。这个零件叫“插件”，就像给玩具车装上一个新轮子。你需要用电脑的命令行来安装它。

  1. 安装插件：打开一个像小黑板一样的窗口（命令行），然后输入一行魔法咒语来安装。咒语是：openclaw plugins install @openclaw/twitch。告诉电脑“请安装Twitch插件”。

好啦，零件装好了，现在来给机器人办一张进入Twitch的“门票”。

  1. 创建机器人账号：你需要先有一个Twitch账号给机器人用。可以新注册一个，或者用你已有的一个。
  2. 生成门票（令牌）：去一个叫“Twitch Token Generator”的网站。在那里：
    • 选择 Bot Token（机器人令牌）。
    • 确保两个小方框 chat:read（可以读聊天）和 chat:write（可以写聊天）都被勾选了。
    • 把生成的 Client ID（客户端ID）和 Access Token（访问令牌）像宝贝一样复制下来。这个令牌几个小时后就会失效，像冰淇淋会化掉一样。
  3. 找到你的Twitch用户ID：去另一个网站，输入你的Twitch用户名，它就会告诉你一串永久的数字ID。这个比用户名更可靠，因为用户名可能会改。
  4. 把门票交给机器人：有两种方法。第一种是设置一个叫 OPENCLAW_TWITCH_ACCESS_TOKEN 的环境变量，把令牌值放进去。第二种是在一个叫“配置文件”的纸条上写下来。如果两种都写了，机器人会优先看配置文件里的。
  5. 写配置文件：你需要创建一个文件，在里面告诉机器人所有信息。下面是一个最简单的例子，你就像填空一样把信息放进去：
    • enabled: true：意思是“启用这个功能”。
    • username: “openclaw”：这里填你给机器人用的Twitch账号名。
    • accessToken: “oauth:abc123…”：这里粘贴你刚才复制的那个长长的访问令牌。
    • clientId: “xyz789…”：这里粘贴你刚才复制的客户端ID。
    • channel: “vevisk”：这里填你想让机器人加入的Twitch聊天室名字（比如某个主播的房间）。
    • allowFrom: [“123456789”]：（非常重要！） 这里填你刚才找到的你自己账号的数字ID。这样机器人就只认你，别人叫它它不会乱答应。

要小心的事情：一定要设置 allowFrom 或者 allowedRoles，就像给家门上锁，只让允许的人进来。不然机器人可能会被陌生人指挥。默认情况下，机器人需要你@它（提到它的名字）它才会回应，这样更安全。

如果门票过期了怎么办？ 从那个生成器网站拿的令牌不会自动续期。过期了你就需要再去那个网站生成一个新的。如果你想让它自动续期，就需要去Twitch开发者网站自己创建一个应用，拿到更多的密码（clientSecret 和 refreshToken）填到配置文件里，机器人就会自己换新门票了。

想让机器人去多个聊天室吗？ 你可以在配置文件里用 accounts 来设置多个“小机器人”，每个都带着自己的门票去不同的房间。但注意，每个房间都需要一张独立的门票。

机器人不听话了？ 首先，你可以让机器人自己检查一下身体，输入命令：openclaw doctor 和 openclaw channels status --probe。如果它不回应消息，检查一下 allowFrom 里有没有你的ID，或者看看它是不是真的已经进入你指定的 channel 房间了。