Twitch

​

Installazione

openclaw plugins install @openclaw/twitch

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

​

Configurazione rapida

openclaw gateway run

{
  channels: {
    twitch: {
      enabled: true,
      username: "openclaw", // Account Twitch del bot (esegue l'autenticazione)
      accessToken: "oauth:abc123...", // Token di accesso OAuth (oppure usa la variabile d'ambiente OPENCLAW_TWITCH_ACCESS_TOKEN)
      clientId: "xyz789...", // ID client ottenuto da Token Generator
      channel: "yourchannel", // Chat del canale Twitch a cui accedere (obbligatorio)
      allowFrom: ["123456789"], // (consigliato) Solo il tuo ID utente Twitch
    },
  },
}

​

Cos’è

• Un canale Twitch gestito dal Gateway.
• Instradamento deterministico: le risposte vengono sempre inviate al canale Twitch da cui proviene il messaggio.
• Ogni canale a cui si accede corrisponde a una chiave di sessione di gruppo isolata agent:<agentId>:twitch:group:<channel>.
• username è l’account del bot che esegue l’autenticazione, mentre channel è la chat a cui accedere. Ogni voce di account accede esattamente a un canale.
• I token funzionano con o senza il prefisso oauth:; OpenClaw normalizza entrambe le forme (la procedura guidata di configurazione richiede la forma con oauth:).

​

Aggiornamento del token (facoltativo)

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

​

Supporto multi-account

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

​

Controllo degli accessi

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

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

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

​

Risoluzione dei problemi

openclaw doctor
openclaw channels status --probe

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

​

Configurazione

​

Configurazione dell’account

​

Opzioni del provider

• channels.twitch.enabled - Abilita o disabilita l’avvio del canale
• channels.twitch.username / accessToken / clientId / channel - Configurazione semplificata per un singolo account (account default implicito; ha la precedenza su accounts.default)
• channels.twitch.accounts.<accountName> - Configurazione multi-account (tutti i campi dell’account indicati sopra)
• channels.twitch.defaultAccount - Nome dell’account predefinito
• channels.twitch.markdown.tables - Modalità di rendering delle tabelle 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"],
        },
      },
    },
  },
}

​

Azioni degli strumenti

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

​

Sicurezza e operatività

• Tratta i token come password: non eseguire mai il commit dei token in git.
• Usa l’aggiornamento automatico del token per i bot in esecuzione prolungata.
• Usa elenchi di autorizzazione degli ID utente anziché nomi utente per il controllo degli accessi.
• Monitora i registri per gli eventi di aggiornamento del token e lo stato della connessione.
• Riduci al minimo gli ambiti dei token: richiedi solo chat:read e chat:write.
• In caso di blocco: riavvia il Gateway dopo aver verificato che nessun altro processo sia proprietario della sessione.

​

Limiti

• 500 caratteri per messaggio; le risposte più lunghe vengono suddivise in corrispondenza dei confini tra parole.
• Markdown viene rimosso prima dell’invio (la chat di Twitch usa testo normale; le interruzioni di riga diventano spazi).
• OpenClaw non aggiunge una propria limitazione della frequenza; il client di chat Twurple gestisce i limiti di frequenza di Twitch.

​

Argomenti correlati

• Instradamento dei canali — instradamento delle sessioni per i messaggi
• Panoramica dei canali — tutti i canali supportati
• Gruppi — comportamento delle chat di gruppo e vincolo della menzione
• Associazione — autenticazione dei messaggi diretti e flusso di associazione
• Sicurezza — modello di accesso e protezione avanzata