Canal de Bot QQ do OpenClaw

O OpenClaw se conecta à QQ Open Platform através do plugin @openclaw-china/qqbot. Este plugin é mantido oficialmente pela Tencent e utiliza a Bot API da QQ Open Platform para gerenciar o envio e recebimento de mensagens. Fluxo de mensagens: o usuário envia uma mensagem no QQ → QQ Open Platform → push para o OpenClaw Gateway → processamento pela IA → resposta via QQ Bot API → mensagem entregue no QQ. Este plugin suporta múltiplos cenários de mensagens: mensagens diretas, chats em grupo (requer ativação por @), mensagens de canal e DMs de canal, cobrindo as principais formas de interação do ecossistema QQ.

A instalação do plugin QQ é simples e requer apenas um comando: openclaw plugins install @openclaw-china/qqbot Após a instalação, o plugin é registrado automaticamente no OpenClaw Gateway. Você pode confirmar a instalação com 'openclaw plugins list'.

# Instalar o plugin QQ
openclaw plugins install @openclaw-china/qqbot

# Confirmar instalação
openclaw plugins list

# Atualizar plugin
openclaw plugins update @openclaw-china/qqbot

# Iniciar o assistente de configuração interativo
openclaw china setup

Para configurar a integração QQ, você precisa criar uma aplicação de bot na QQ Open Platform: 1. Faça login na QQ Open Platform (q.qq.com) e acesse o console do desenvolvedor. 2. Clique em 'Criar bot' e insira o nome, descrição e avatar do bot. 3. Após a criação, localize o AppID e ClientSecret na página de configurações do app. 4. Nas configurações de funcionalidades, ative os tipos de mensagem necessários (mensagens diretas, chats em grupo, canais, etc.). 5. Após concluir a configuração, submeta para revisão e aguarde a aprovação da plataforma.

# Via variáveis de ambiente
export QQ_APP_ID="your-app-id"
export QQ_CLIENT_SECRET="your-app-secret"

# Ou via CLI
openclaw channels add

O plugin QQ suporta uma ampla variedade de tipos de mensagem: **Recebimento**: texto, imagens, áudio, vídeo, arquivos **Envio**: texto, Markdown, imagens, áudio, vídeo, arquivos **Funcionalidades especiais**: • Voz para texto — converte automaticamente mensagens de voz em texto antes de passar para a IA • Mensagens programadas — suporte para envio de mensagens agendadas • Formatação Markdown — suporte para respostas formatadas • Contexto de mensagem citada — possibilidade de citar mensagens anteriores como contexto da conversa

O plugin QQ suporta a configuração independente de três cenários de mensagens: **Mensagens diretas (dmEnabled)**: controla a resposta a mensagens diretas. **Chat em grupo (groupEnabled)**: controla a resposta a mensagens de chat em grupo. Nos chats em grupo, é necessário @mencionar o bot para ativar uma resposta, evitando respostas excessivas em grupos ativos. **Canal (channelEnabled)**: controla a resposta a mensagens em canais QQ, incluindo mensagens públicas de canal e DMs de canal. Cada cenário pode ser ativado ou desativado independentemente, permitindo controle flexível sobre o escopo de resposta do bot.

{
  "channels": {
    "qqbot": {
      "dmEnabled": true,
      "groupEnabled": true,
      "channelEnabled": true
    }
  }
}

O OpenClaw oferece vários comandos para gerenciar seu bot QQ: • openclaw gateway status — verificar o estado de conexão do Gateway • openclaw gateway restart — reiniciar o serviço Gateway • openclaw logs --follow — visualizar logs em tempo real • openclaw channels add — adicionar um canal de forma interativa • openclaw plugins list — visualizar plugins instalados • openclaw plugins update @openclaw-china/qqbot — atualizar o plugin QQ • openclaw china setup — iniciar o assistente de configuração interativo • openclaw doctor — executar diagnóstico abrangente