Twitch

​

Installation

openclaw plugins install @openclaw/twitch

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

​

Configuration rapide

openclaw gateway run

{
  channels: {
    twitch: {
      enabled: true,
      username: "openclaw", // Compte Twitch du bot (utilisé pour l’authentification)
      accessToken: "oauth:abc123...", // Jeton d’accès OAuth (ou utilisez la variable d’environnement OPENCLAW_TWITCH_ACCESS_TOKEN)
      clientId: "xyz789...", // Identifiant client provenant du générateur de jetons
      channel: "yourchannel", // Canal Twitch dont rejoindre le chat (obligatoire)
      allowFrom: ["123456789"], // (recommandé) Votre identifiant utilisateur Twitch uniquement
    },
  },
}

​

Présentation

• Un canal Twitch détenu par le Gateway.
• Routage déterministe : les réponses sont toujours renvoyées vers le canal Twitch d’où provient le message.
• Chaque canal rejoint correspond à une clé de session de groupe isolée agent:<agentId>:twitch:group:<channel>.
• username désigne le compte du bot (celui qui s’authentifie) et channel le salon de discussion à rejoindre. Chaque entrée de compte rejoint exactement un canal.
• Les jetons fonctionnent avec ou sans le préfixe oauth: ; OpenClaw normalise les deux formes (l’assistant de configuration attend la forme oauth:).

​

Actualisation du jeton (facultatif)

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

​

Prise en charge de plusieurs comptes

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

​

Contrôle d’accès

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

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

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

​

Dépannage

openclaw doctor
openclaw channels status --probe

Using env token source for mybot
Access token refreshed for user 123456 (expires in 14400s)

​

Configuration

​

Configuration du compte

​

Options du fournisseur

• channels.twitch.enabled - Activer ou désactiver le démarrage du canal
• channels.twitch.username / accessToken / clientId / channel - Configuration simplifiée pour un seul compte (compte default implicite ; prioritaire sur accounts.default)
• channels.twitch.accounts.<accountName> - Configuration de plusieurs comptes (tous les champs de compte ci-dessus)
• channels.twitch.defaultAccount - Nom du compte utilisé par défaut
• channels.twitch.markdown.tables - Mode de rendu des tableaux 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"],
        },
      },
    },
  },
}

​

Actions de l’outil

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

​

Sécurité et exploitation

• Traitez les jetons comme des mots de passe : ne validez jamais de jetons dans git.
• Utilisez l’actualisation automatique des jetons pour les bots fonctionnant sur de longues périodes.
• Utilisez des listes d’autorisation d’identifiants utilisateur plutôt que des noms d’utilisateur pour le contrôle d’accès.
• Surveillez les journaux pour suivre les événements d’actualisation des jetons et l’état de la connexion.
• Limitez autant que possible la portée des jetons : demandez uniquement chat:read et chat:write.
• En cas de blocage : redémarrez le Gateway après avoir vérifié qu’aucun autre processus ne détient la session.

​

Limites

• 500 caractères par message ; les réponses plus longues sont découpées aux limites des mots.
• Le Markdown est supprimé avant l’envoi (le chat Twitch utilise du texte brut ; les sauts de ligne deviennent des espaces).
• OpenClaw n’ajoute aucune limitation de débit propre ; le client de chat Twurple gère les limites de débit de Twitch.

​

Pages connexes

• Routage des canaux — routage des sessions pour les messages
• Vue d’ensemble des canaux — tous les canaux pris en charge
• Groupes — comportement des discussions de groupe et filtrage par mention
• Appairage — authentification par message privé et processus d’appairage
• Sécurité — modèle d’accès et renforcement de la sécurité