Twitch

Suporte ao chat da Twitch pela interface de chat (IRC) da Twitch usando o cliente Twurple. O OpenClaw entra com uma conta de bot da Twitch, participa de um canal por conta configurada e responde nesse canal.

Instalação

A Twitch é distribuída como um plugin oficial; ela não faz parte da instalação principal.

openclaw plugins install @openclaw/twitch

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

plugins install registra e ativa o plugin. Selecionar Twitch durante openclaw onboard ou openclaw channels add instala o plugin sob demanda. Use apenas o nome do pacote para acompanhar a versão atual; fixe uma versão exata somente para instalações reproduzíveis. Requer o OpenClaw 2026.4.10 ou mais recente.

Detalhes: Plugins

Configuração rápida

openclaw gateway run

Configuração mínima:

{  channels: {    twitch: {      enabled: true,      username: "openclaw", // Conta da Twitch do bot (faz a autenticação)      accessToken: "oauth:abc123...", // Token de acesso OAuth (ou use a variável de ambiente OPENCLAW_TWITCH_ACCESS_TOKEN)      clientId: "xyz789...", // ID do cliente fornecido pelo Token Generator      channel: "yourchannel", // Chat de qual canal da Twitch participar (obrigatório)      allowFrom: ["123456789"], // (recomendado) Somente seu ID de usuário da Twitch    },  },}

O que é

• Um canal da Twitch gerenciado pelo Gateway.
• Roteamento determinístico: as respostas sempre retornam ao canal da Twitch de onde veio a mensagem.
• Cada canal do qual o bot participa é associado a uma chave de sessão de grupo isolada: agent:<agentId>:twitch:group:<channel>.
• username é a conta do bot (que faz a autenticação), enquanto channel é a sala de chat da qual ele participará. Cada entrada de conta participa de exatamente um canal.
• Os tokens funcionam com ou sem o prefixo oauth:; o OpenClaw normaliza os dois formatos (o assistente de configuração espera o formato com oauth:).

Renovação de token (opcional)

Os tokens do Twitch Token Generator não podem ser renovados pelo OpenClaw — gere outro quando o token expirar (eles duram algumas horas; não é necessário registrar um aplicativo).

Para a renovação automática, crie seu próprio aplicativo no Twitch Developer Console e adicione:

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

Com ambos definidos, o plugin usa um provedor de autenticação com renovação que renova os tokens antes da expiração e registra cada renovação. Sem refreshToken, ele registra token refresh disabled (no refresh token); sem clientSecret, ele usa como alternativa um token estático (sem renovação).

Suporte a várias contas

Use channels.twitch.accounts com credenciais específicas para cada conta. Consulte Configuração para conhecer o padrão compartilhado.

Exemplo (uma conta de bot em dois canais):

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

Controle de acesso

allowFrom é uma lista rígida de IDs de usuário da Twitch permitidos. Quando ela está definida, allowedRoles é ignorado; deixe allowFrom sem definição para usar o acesso baseado em funções.

Funções disponíveis: "moderator", "owner", "vip", "subscriber", "all".

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

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

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

Solução de problemas

Primeiro, execute os comandos de diagnóstico:

openclaw doctoropenclaw channels status --probe

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

Configuração

Configuração da conta

Opções do provedor

• channels.twitch.enabled - Ativa/desativa a inicialização do canal
• channels.twitch.username / accessToken / clientId / channel - Configuração simplificada de uma única conta (conta default implícita; tem precedência sobre accounts.default)
• channels.twitch.accounts.<accountName> - Configuração de várias contas (todos os campos de conta acima)
• channels.twitch.defaultAccount - Nome da conta que será a padrão
• channels.twitch.markdown.tables - Modo de renderização de tabelas Markdown (off | bullets | code | block)

Exemplo completo:

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

Ações da ferramenta

O agente pode enviar mensagens da Twitch por meio da ação send da ferramenta de mensagens:

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

to é opcional e usa como padrão o channel configurado da conta.

Segurança e operações

• Trate os tokens como senhas — nunca faça commit de tokens no Git.
• Use a renovação automática de tokens para bots executados por longos períodos.
• Use listas de IDs de usuário permitidos em vez de nomes de usuário para controle de acesso.
• Monitore os registros para acompanhar eventos de renovação de token e o status da conexão.
• Restrinja os escopos dos tokens ao mínimo — solicite somente chat:read e chat:write.
• Se estiver com dificuldades: reinicie o Gateway depois de confirmar que nenhum outro processo é proprietário da sessão.

Limites

• 500 caracteres por mensagem; respostas mais longas são divididas nos limites entre palavras.
• O Markdown é removido antes do envio (o chat da Twitch usa texto simples; quebras de linha tornam-se espaços).
• O OpenClaw não adiciona limitação de taxa própria; o cliente de chat Twurple gerencia os limites de taxa da Twitch.

Conteúdo relacionado

• Roteamento de canais — roteamento de sessões para mensagens
• Visão geral dos canais — todos os canais compatíveis
• Grupos — comportamento de chats em grupo e exigência de menção
• Pareamento — autenticação por mensagem direta e fluxo de pareamento
• Segurança — modelo de acesso e proteção