Twitch

Suporte a chat da Twitch via conexão IRC. O OpenClaw se conecta como um usuário da Twitch (conta de bot) para receber e enviar mensagens em canais.

# Plugin incluído

Se você estiver em um build mais antigo ou em uma instalação personalizada que exclui a Twitch, instale o pacote npm diretamente:

openclaw plugins install @openclaw/twitch

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

Use o pacote sem versão para seguir a tag oficial atual de lançamento. Fixe uma versão exata somente quando precisar de uma instalação reproduzível.

Detalhes: Plugins

# Configuração rápida (iniciante)

Configuração 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/
    },
  },
}

# O que é

• Um canal da Twitch pertencente ao Gateway.
• Roteamento determinístico: as respostas sempre voltam para a Twitch.
• Cada conta é mapeada para uma chave de sessão isolada agent:<agentId>:twitch:<accountName>.
• username é a conta do bot (quem autentica), channel é a sala de chat a entrar.

# Configuração (detalhada)

# Gerar credenciais

Use o Twitch Token Generator:

• Selecione Bot Token
• Verifique se os escopos chat:read e chat:write estão selecionados
• Copie o Client ID e o Access Token

# Configurar o bot

OPENCLAW_TWITCH_ACCESS_TOKEN=oauth:abc123...

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

Se env e configuração forem definidos, a configuração tem precedência.

# Controle de acesso (recomendado)

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

Prefira allowFrom para uma allowlist estrita. Use allowedRoles em vez disso se quiser acesso baseado em função.

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

# Atualização de token (opcional)

Tokens do Twitch Token Generator não podem ser atualizados automaticamente - gere novamente quando expirarem.

Para atualização automática de token, crie sua própria aplicação da Twitch no Twitch Developer Console e adicione à configuração:

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

O bot atualiza tokens automaticamente antes da expiração e registra eventos de atualização nos logs.

# Suporte a múltiplas contas

Use channels.twitch.accounts com tokens por conta. Consulte Configuração para o padrão compartilhado.

Exemplo (uma conta de bot em dois canais):

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

# Controle de acesso

{
  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 doctor
openclaw channels status --probe

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

# Configuração

# Configuração da conta

# Opções do provedor

• channels.twitch.enabled - Ativar/desativar inicialização do canal
• channels.twitch.username - Nome de usuário do bot (configuração simplificada de conta única)
• channels.twitch.accessToken - Token de acesso OAuth (configuração simplificada de conta única)
• channels.twitch.clientId - Twitch Client ID (configuração simplificada de conta única)
• channels.twitch.channel - Canal a entrar (configuração simplificada de conta única)
• channels.twitch.accounts.<accountName> - Configuração de múltiplas contas (todos os campos de conta acima)

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

# Ações de ferramenta

O agente pode chamar twitch com a ação:

• send - Enviar uma mensagem para um canal

Exemplo:

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

# Segurança e operações

• Trate tokens como senhas — Nunca faça commit de tokens no git.
• Use atualização automática de token para bots de longa execução.
• Use allowlists de IDs de usuário em vez de nomes de usuário para controle de acesso.
• Monitore logs para eventos de atualização de token e status de conexão.
• Restrinja os escopos dos tokens ao mínimo — Solicite apenas chat:read e chat:write.
• Se estiver bloqueado: reinicie o Gateway depois de confirmar que nenhum outro processo é dono da sessão.

# Limites

• 500 caracteres por mensagem (divisão automática em blocos nos limites de palavras).
• Markdown é removido antes da divisão em blocos.
• Sem limitação de taxa (usa os limites de taxa integrados da Twitch).

# Relacionados

• Roteamento de canais — roteamento de sessão para mensagens
• Visão geral dos canais — todos os canais compatíveis
• Grupos — comportamento de chat em grupo e controle por menção
• Pareamento — autenticação por DM e fluxo de pareamento
• Segurança — modelo de acesso e reforço de segurança