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
Abrir a LemonClaw WebUI
- Se você usa o Claw hospedado, vá para seu Claw Dashboard e clique em Open WebUI
- Se você hospeda o LemonClaw por conta própria, abra sua própria WebUI (por exemplo
http://your-ip:18789) e entre com seu token - Na WebUI, vá para Settings → Channels
- 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 suporte atual de QQ no LemonClaw cobre mensagens diretas e eventos de grupo com @bot. Mensagens de grupo sem @ e conversas em canais do QQ ainda não são suportadas.
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)