Twitch

Compatibilidad con el chat de Twitch mediante conexión IRC. OpenClaw se conecta como un usuario de Twitch (cuenta de bot) para recibir y enviar mensajes en canales.

# Plugin incluido

Si usas una compilación antigua o una instalación personalizada que excluye Twitch, instala directamente el paquete npm:

openclaw plugins install @openclaw/twitch

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

Usa el paquete sin versión para seguir la etiqueta de versión oficial actual. Fija una versión exacta solo cuando necesites una instalación reproducible.

Detalles: Plugins

# Configuración rápida (principiante)

Configuración mínima:

{
  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/
    },
  },
}

# Qué es

• Un canal de Twitch propiedad del Gateway.
• Enrutamiento determinista: las respuestas siempre vuelven a Twitch.
• Cada cuenta se asigna a una clave de sesión aislada agent:<agentId>:twitch:<accountName>.
• username es la cuenta del bot (quien se autentica), channel es la sala de chat a la que se une.

# Configuración (detallada)

# Generar credenciales

Usa Twitch Token Generator:

• Selecciona Bot Token
• Verifica que los alcances chat:read y chat:write estén seleccionados
• Copia el Client ID y el Access Token

# Configurar el bot

OPENCLAW_TWITCH_ACCESS_TOKEN=oauth:abc123...

{
  channels: {
    twitch: {
      enabled: true,
      username: "openclaw",
      accessToken: "oauth:abc123...",
      clientId: "xyz789...",
      channel: "vevisk",
    },
  },
}

Si tanto env como la configuración están definidos, la configuración tiene prioridad.

# Control de acceso (recomendado)

{
  channels: {
    twitch: {
      allowFrom: ["123456789"], // (recommended) Your Twitch user ID only
    },
  },
}

Prefiere allowFrom para una lista de permitidos estricta. Usa allowedRoles en su lugar si quieres acceso basado en roles.

Roles disponibles: "moderator", "owner", "vip", "subscriber", "all".

# Actualización de token (opcional)

Los tokens de Twitch Token Generator no se pueden actualizar automáticamente; regénéralos cuando caduquen.

Para la actualización automática de tokens, crea tu propia aplicación de Twitch en Twitch Developer Console y agrégala a la configuración:

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

El bot actualiza automáticamente los tokens antes de que caduquen y registra los eventos de actualización.

# Compatibilidad con varias cuentas

Usa channels.twitch.accounts con tokens por cuenta. Consulta Configuración para ver el patrón compartido.

Ejemplo (una cuenta de bot en dos canales):

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

# Control de acceso

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

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

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

# Solución de problemas

Primero, ejecuta comandos de diagnóstico:

openclaw doctor
openclaw channels status --probe

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

# Configuración

# Configuración de cuenta

# Opciones del proveedor

• channels.twitch.enabled - Habilita/deshabilita el inicio del canal
• channels.twitch.username - Nombre de usuario del bot (configuración simplificada de cuenta única)
• channels.twitch.accessToken - Token de acceso OAuth (configuración simplificada de cuenta única)
• channels.twitch.clientId - Client ID de Twitch (configuración simplificada de cuenta única)
• channels.twitch.channel - Canal al que unirse (configuración simplificada de cuenta única)
• channels.twitch.accounts.<accountName> - Configuración de varias cuentas (todos los campos de cuenta anteriores)

Ejemplo completo:

{
  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"],
        },
      },
    },
  },
}

# Acciones de herramienta

El agente puede llamar a twitch con la acción:

• send - Envía un mensaje a un canal

Ejemplo:

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

# Seguridad y operaciones

• Trata los tokens como contraseñas — Nunca confirmes tokens en git.
• Usa actualización automática de tokens para bots de larga duración.
• Usa listas de permitidos de IDs de usuario en lugar de nombres de usuario para el control de acceso.
• Supervisa los registros para ver eventos de actualización de tokens y el estado de conexión.
• Limita al mínimo los alcances de los tokens — Solicita solo chat:read y chat:write.
• Si te bloqueas: Reinicia el Gateway después de confirmar que ningún otro proceso posee la sesión.

# Límites

• 500 caracteres por mensaje (dividido automáticamente en fragmentos en límites de palabra).
• Markdown se elimina antes de fragmentar.
• Sin limitación de velocidad (usa los límites de velocidad integrados de Twitch).

# Relacionado

• Enrutamiento de canales — enrutamiento de sesión para mensajes
• Descripción general de canales — todos los canales compatibles
• Grupos — comportamiento de chat grupal y control de menciones
• Emparejamiento — autenticación por DM y flujo de emparejamiento
• Seguridad — modelo de acceso y endurecimiento