Canal Bot QQ OpenClaw
Connectez OpenClaw à QQ via des plugins communautaires (QQ n'est pas un canal officiellement intégré à OpenClaw). Cette intégration prend en charge les messages directs, les discussions de groupe (déclenchement par @), les messages de canal, les DMs de canal, les médias enrichis (images, audio, vidéo, fichiers), la conversion voix-texte, les messages programmés, le format Markdown et le contexte de message cité. Installez le plugin, créez un bot sur QQ Open Platform, configurez les identifiants et vous êtes prêt.
QQ Fonctionnalités prises en charge
Messages texte
Pris en charge
Médias et fichiers
Pris en charge
Réactions
Non pris en charge
Fils de discussion
Non pris en charge
Messages vocaux
Pris en charge
Discussion de groupe
Pris en charge
QQ Prérequis
- Un compte développeur sur QQ Open Platform
- Plugin QQ installé : openclaw plugins install @openclaw-china/qqbot
- OpenClaw Gateway en cours d'exécution et configuré
- Node.js 18+ installé sur votre serveur
QQ Configuration rapide
Installer le plugin QQ
Exécutez 'openclaw plugins install @openclaw-china/qqbot' dans votre terminal pour installer le plugin QQ bot officiellement maintenu par Tencent. Ce plugin compte plus de 186 étoiles sur GitHub.
Créer un bot sur QQ Open Platform
Connectez-vous à QQ Open Platform (q.qq.com) et créez une nouvelle application bot. Sur la page de configuration de l'application, obtenez les identifiants AppID et ClientSecret. Ceux-ci sont nécessaires pour connecter OpenClaw à QQ.
Configurer les permissions
Sur la page de gestion des permissions de QQ Open Platform, configurez les permissions requises pour le bot. Activez les permissions pour les messages directs, les discussions de groupe, les messages de canal et l'envoi de messages multimédias. Une fois terminé, soumettez pour examen.
Configurer OpenClaw et tester
Recommandé : Exécutez 'openclaw china setup' pour lancer l'assistant de configuration interactif. Sinon, ajoutez la configuration du canal QQ dans ~/.openclaw/openclaw.json avec votre appId et clientSecret. Exécutez 'openclaw gateway restart' pour redémarrer le Gateway, puis envoyez un message au bot dans QQ pour vérifier que tout fonctionne correctement.
QQ Exemple de configuration
{
"channels": {
"qqbot": {
"enabled": true,
"appId": "your-app-id",
"clientSecret": "your-app-secret",
"sandbox": false,
"dmEnabled": true,
"groupEnabled": true,
"channelEnabled": true
}
}
}QQ Guide d'Intégration
Architecture d'OpenClaw QQ
Installation du plugin OpenClaw QQ
# Installer le plugin QQ
openclaw plugins install @openclaw-china/qqbot
# Confirmer l'installation
openclaw plugins list
# Mettre à jour le plugin
openclaw plugins update @openclaw-china/qqbot
# Lancer l'assistant de configuration interactif
openclaw china setupCréation du bot QQ dans OpenClaw
# Via les variables d'environnement
export QQ_APP_ID="your-app-id"
export QQ_CLIENT_SECRET="your-app-secret"
# Ou via CLI
openclaw channels addTypes de messages et multimédia OpenClaw QQ
Configuration des groupes et canaux OpenClaw QQ
{
"channels": {
"qqbot": {
"dmEnabled": true,
"groupEnabled": true,
"channelEnabled": true
}
}
}Commandes utiles d'OpenClaw pour QQ
QQ Référence de Configuration
| Key | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | true | Activer ou désactiver le canal QQ |
| appId | string | "" | AppID du bot QQ, obtenu sur QQ Open Platform |
| clientSecret | string | "" | ClientSecret du bot QQ, obtenu sur QQ Open Platform |
| sandbox | boolean | false | Activer le mode sandbox, pour les environnements de développement et de test |
| dmEnabled | boolean | true | Activer les réponses aux messages directs |
| groupEnabled | boolean | true | Activer les réponses aux messages de discussion de groupe (déclenchement par @ requis) |
| channelEnabled | boolean | true | Activer les réponses aux messages de canal QQ |
| messageFormat | string | "markdown" | Format du message de réponse. Options : text (texte brut), markdown |
| debug | boolean | false | Activer le mode débogage, génère des logs détaillés de connexion et de messages |
Activer ou désactiver le canal QQ
AppID du bot QQ, obtenu sur QQ Open Platform
ClientSecret du bot QQ, obtenu sur QQ Open Platform
Activer le mode sandbox, pour les environnements de développement et de test
Activer les réponses aux messages directs
Activer les réponses aux messages de discussion de groupe (déclenchement par @ requis)
Activer les réponses aux messages de canal QQ
Format du message de réponse. Options : text (texte brut), markdown
Activer le mode débogage, génère des logs détaillés de connexion et de messages
QQ Questions Fréquentes
QQ Dépannage
AppID ou ClientSecret incorrect, plugin non installé correctement ou le bot n'a pas passé la vérification de la plateforme.
Le serveur QQ dispose d'un mécanisme de filtrage pour les messages actifs, les messages qui ne sont pas des réponses peuvent être bloqués.
Permissions insuffisantes pour les messages multimédias ou la taille du fichier dépasse la limite de la plateforme QQ.
channelEnabled n'est pas activé ou le bot n'a pas été ajouté au canal QQ.
Anomalie du service de reconnaissance vocale ou permissions insuffisantes.