Twitch

​

Installeren

openclaw plugins install @openclaw/twitch

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

​

Snelle configuratie

openclaw gateway run

{
  channels: {
    twitch: {
      enabled: true,
      username: "openclaw", // Twitch-account van de bot (voor authenticatie)
      accessToken: "oauth:abc123...", // OAuth-toegangstoken (of gebruik de omgevingsvariabele OPENCLAW_TWITCH_ACCESS_TOKEN)
      clientId: "xyz789...", // Client-ID uit Token Generator
      channel: "yourchannel", // Aan welke Twitch-kanaalchat moet worden deelgenomen (verplicht)
      allowFrom: ["123456789"], // (aanbevolen) Alleen jouw Twitch-gebruikers-ID
    },
  },
}

​

Wat het is

• Een Twitch-kanaal dat eigendom is van de Gateway.
• Deterministische routering: antwoorden gaan altijd terug naar het Twitch-kanaal waaruit het bericht afkomstig is.
• Elk kanaal waaraan wordt deelgenomen, wordt toegewezen aan een geïsoleerde groepssessiesleutel agent:<agentId>:twitch:group:<channel>.
• username is het account van de bot (dat zich authenticeert), channel is de chatruimte waaraan wordt deelgenomen. Elke accountvermelding neemt aan precies één kanaal deel.
• Tokens werken met of zonder het voorvoegsel oauth:; OpenClaw normaliseert beide vormen (de configuratiewizard verwacht de vorm oauth:).

​

Duurzaamheid van inkomende berichten

​

Tokenvernieuwing (optioneel)

{
  channels: {
    twitch: {
      clientSecret: "your_client_secret",
      refreshToken: "your_refresh_token",
    },
  },
}

​

Ondersteuning voor meerdere accounts

{
  channels: {
    twitch: {
      accounts: {
        channel1: {
          username: "openclaw",
          accessToken: "oauth:abc123...",
          clientId: "xyz789...",
          channel: "yourchannel",
        },
        channel2: {
          username: "openclaw",
          accessToken: "oauth:def456...",
          clientId: "uvw012...",
          channel: "secondchannel",
        },
      },
    },
  },
}

​

Toegangsbeheer

{
  channels: {
    twitch: {
      accounts: {
        default: {
          allowFrom: ["123456789", "987654321"],
        },
      },
    },
  },
}

{
  channels: {
    twitch: {
      accounts: {
        default: {
          allowedRoles: ["moderator", "vip"],
        },
      },
    },
  },
}

{
  channels: {
    twitch: {
      accounts: {
        default: {
          requireMention: false,
        },
      },
    },
  },
}

​

Problemen oplossen

openclaw doctor
openclaw channels status --probe

Omgevingsvariabel tokenbron wordt gebruikt voor mybot
Toegangstoken vernieuwd voor gebruiker 123456 (verloopt over 14400s)

​

Configuratie

​

Accountconfiguratie

​

Provideropties

• channels.twitch.enabled - Opstarten van het kanaal in-/uitschakelen
• channels.twitch.username / accessToken / clientId / channel - Vereenvoudigde configuratie voor één account (impliciet account default; heeft voorrang op accounts.default)
• channels.twitch.accounts.<accountName> - Configuratie voor meerdere accounts (alle bovenstaande accountvelden)
• channels.twitch.defaultAccount - Welke accountnaam de standaard is
• channels.twitch.markdown.tables - Weergavemodus voor Markdown-tabellen (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"],
        },
      },
    },
  },
}

​

Toolacties

{
  channel: "twitch",
  action: "send",
  to: "#mychannel",
  message: "Hallo Twitch!",
}

​

Veiligheid en beheer

• Behandel tokens als wachtwoorden - commit tokens nooit naar git.
• Gebruik automatische tokenvernieuwing voor bots die langdurig actief zijn.
• Gebruik toelatingslijsten met gebruikers-ID’s in plaats van gebruikersnamen voor toegangsbeheer.
• Controleer logboeken op gebeurtenissen rond tokenvernieuwing en de verbindingsstatus.
• Beperk het bereik van tokens tot het minimum - vraag alleen chat:read en chat:write aan.
• Als je vastloopt: start de Gateway opnieuw nadat je hebt gecontroleerd dat geen ander proces eigenaar is van de sessie.

​

Limieten

• 500 tekens per bericht; langere antwoorden worden bij woordgrenzen opgesplitst.
• Markdown wordt vóór verzending verwijderd (Twitch-chat bestaat uit platte tekst; nieuwe regels worden spaties).
• OpenClaw voegt zelf geen snelheidsbeperking toe; de Twurple-chatclient handelt de snelheidslimieten van Twitch af.

​

Gerelateerd

• Kanaalroutering — sessieroutering voor berichten
• Overzicht van kanalen — alle ondersteunde kanalen
• Groepen — gedrag van groepschats en filtering op vermeldingen
• Koppelen — DM-authenticatie en koppelingsproces
• Beveiliging — toegangsmodel en versterking