Pré-requisitos
- Uma conta QQ
- Acesso à QQ Open Platform (conta de desenvolvedor)
- Uma instância Claw (crie uma aqui)
Guia de Configuração
Criar um Aplicativo de Bot do QQ
- Vá para a QQ Open Platform
- Faça login e vá para a seção Bot
- Clique em Create Bot
- Preencha as informações do bot (nome, avatar, descrição)
- Envie para revisão
Obter Credenciais
- Assim que aprovado, vá para as Development Settings do seu bot
- Copie o AppID
- Copie o AppSecret (Client Secret)
Configurar Sandbox (para Testes)
- Nas configurações do bot, vá para Sandbox Configuration
- Adicione seu número QQ à whitelist do sandbox
- Isso permite que você teste antes de entrar no ar
Configurar no Painel LemonData
- Vá para o seu Painel Claw
- Clique no ícone de configurações na sua instância
- Abra a aba IM Integrations
- Expanda a seção QQ
- Cole seu AppID e AppSecret
- Clique em Save
Tipos de Mensagens Suportados
| Tipo | Descrição |
|---|---|
| C2C (Privado) | Mensagens diretas para o bot |
| Group @mention | @mencione o bot em um grupo do QQ |
| Channel | Mensagens em canais do QQ (频道) |
Solução de Problemas
O bot não está respondendo
O bot não está respondendo
- Verifique se o AppID e o AppSecret estão corretos
- Verifique se o seu número QQ está na whitelist do sandbox (se estiver testando)
- Certifique-se de que o aplicativo do bot foi aprovado
Erro 'invalid appid'
Erro 'invalid appid'
- Verifique novamente o AppID — ele deve ser uma string numérica
- Certifique-se de que está usando o AppSecret correto (não o token)