Twitch

​

Instalação

openclaw plugins install @openclaw/twitch

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

​

Configuração rápida

openclaw gateway run

{
  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)

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

​

Suporte a várias contas

{
  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

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

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

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

​

Solução de problemas

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 - 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)

{
  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

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

​

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