Twitch

​

Instalación

openclaw plugins install @openclaw/twitch

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

​

Configuración rápida

openclaw gateway run

{
  channels: {
    twitch: {
      enabled: true,
      username: "openclaw", // Cuenta de Twitch del bot (se autentica)
      accessToken: "oauth:abc123...", // Token de acceso OAuth (o use la variable de entorno OPENCLAW_TWITCH_ACCESS_TOKEN)
      clientId: "xyz789...", // ID de cliente de Token Generator
      channel: "yourchannel", // Chat del canal de Twitch al que unirse (obligatorio)
      allowFrom: ["123456789"], // (recomendado) Solo su ID de usuario de Twitch
    },
  },
}

​

Qué es

• Un canal de Twitch propiedad del Gateway.
• Enrutamiento determinista: las respuestas siempre vuelven al canal de Twitch del que procede el mensaje.
• Cada canal al que se une se asigna a una clave de sesión de grupo aislada agent:<agentId>:twitch:group:<channel>.
• username es la cuenta del bot (la que se autentica); channel indica a qué sala de chat unirse. Cada entrada de cuenta se une exactamente a un canal.
• Los tokens funcionan con o sin el prefijo oauth:; OpenClaw normaliza ambos formatos (el asistente de configuración espera el formato oauth:).

​

Durabilidad de los mensajes entrantes

​

Renovación de tokens (opcional)

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

​

Compatibilidad con varias cuentas

{
  channels: {
    twitch: {
      accounts: {
        channel1: {
          username: "openclaw",
          accessToken: "oauth:abc123...",
          clientId: "xyz789...",
          channel: "yourchannel",
        },
        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

openclaw doctor
openclaw channels status --probe

Usando la fuente de tokens de la variable de entorno para mybot
Token de acceso renovado para el usuario 123456 (caduca en 14400s)

​

Configuración

​

Configuración de la cuenta

​

Opciones del proveedor

• channels.twitch.enabled - Habilita o deshabilita el inicio del canal
• channels.twitch.username / accessToken / clientId / channel - Configuración simplificada de una sola cuenta (cuenta default implícita; tiene prioridad sobre accounts.default)
• channels.twitch.accounts.<accountName> - Configuración de varias cuentas (todos los campos de cuenta anteriores)
• channels.twitch.defaultAccount - Nombre de la cuenta predeterminada
• channels.twitch.markdown.tables - Modo de representación de tablas 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"],
        },
      },
    },
  },
}

​

Acciones de herramientas

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

​

Seguridad y operaciones

• Trate los tokens como contraseñas: nunca confirme tokens en git.
• Utilice la actualización automática de tokens para bots de larga duración.
• Utilice listas de usuarios permitidos basadas en el ID de usuario en lugar de nombres de usuario para el control de acceso.
• Supervise los registros para detectar eventos de actualización de tokens y el estado de la conexión.
• Limite al mínimo el alcance de los tokens: solicite únicamente chat:read y chat:write.
• Si el problema persiste: reinicie el Gateway después de confirmar que ningún otro proceso controla la sesión.

​

Límites

• 500 caracteres por mensaje; las respuestas más largas se dividen respetando los límites entre palabras.
• Markdown se elimina antes del envío (el chat de Twitch es texto sin formato; los saltos de línea se convierten en espacios).
• OpenClaw no añade ninguna limitación de velocidad propia; el cliente de chat Twurple gestiona los límites de velocidad de Twitch.

​

Contenido relacionado

• Enrutamiento de canales — enrutamiento de sesiones para mensajes
• Descripción general de los canales — todos los canales compatibles
• Grupos — comportamiento del chat grupal y control mediante menciones
• Emparejamiento — autenticación de mensajes directos y flujo de emparejamiento
• Seguridad — modelo de acceso y refuerzo de la seguridad