OpenClaw

Canal Bot QQ OpenClaw

Messagerie
Moyen

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.

Info rapide
DifficultéMoyen
CatégorieMessagerie
Fonctionnalités prises en charge4 / 6

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

1

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.

2

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.

3

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.

4

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

config.json
{
  "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

OpenClaw se connecte à QQ Open Platform via le plugin @openclaw-china/qqbot. Ce plugin est officiellement maintenu par Tencent et utilise l'API Bot de QQ Open Platform pour gérer l'envoi et la réception des messages. Flux des messages : l'utilisateur envoie un message dans QQ → QQ Open Platform → push vers le Gateway OpenClaw → traitement par l'IA → réponse via QQ Bot API → message délivré dans QQ. Ce plugin prend en charge plusieurs scénarios de messagerie : messages directs, discussions de groupe (déclenchement par @ requis), messages de canal et DMs de canal, couvrant les principales méthodes d'interaction de l'écosystème QQ.
Plugin officiellement maintenu par Tencent, garantissant stabilité et compatibilité.
QQ est un canal fourni par des plugins communautaires, non intégré officiellement à OpenClaw. Le plugin est installé et maintenu séparément du cœur d'OpenClaw — après une mise à jour d'OpenClaw, une mise à jour de compatibilité du plugin peut être nécessaire.

Installation du plugin OpenClaw QQ

L'installation du plugin QQ est simple et ne nécessite qu'une seule commande : openclaw plugins install @openclaw-china/qqbot Après l'installation, le plugin est automatiquement enregistré dans le Gateway OpenClaw. Vous pouvez confirmer l'installation avec 'openclaw plugins list'.
terminal
# 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 setup

Création du bot QQ dans OpenClaw

Pour configurer l'intégration QQ, vous devez créer une application bot sur QQ Open Platform : 1. Connectez-vous à QQ Open Platform (q.qq.com) et accédez à la console développeur. 2. Cliquez sur 'Créer un bot' et entrez le nom, la description et l'avatar du bot. 3. Une fois créé, trouvez l'AppID et l'ClientSecret sur la page de configuration de l'application. 4. Dans les paramètres de fonctionnalités, activez les types de messages nécessaires (messages directs, discussions de groupe, canaux, etc.). 5. Une fois la configuration terminée, soumettez-la pour examen et attendez l'approbation de la plateforme.
terminal
# Via les variables d'environnement
export QQ_APP_ID="your-app-id"
export QQ_CLIENT_SECRET="your-app-secret"

# Ou via CLI
openclaw channels add
Gardez votre ClientSecret en sécurité. Ne le commitez jamais dans le contrôle de version. Utilisez des variables d'environnement en production. S'il est compromis, réinitialisez-le immédiatement sur QQ Open Platform.

Types de messages et multimédia OpenClaw QQ

Le plugin QQ prend en charge une grande variété de types de messages : **Réception** : texte, images, audio, vidéo, fichiers **Envoi** : texte, Markdown, images, audio, vidéo, fichiers **Fonctionnalités particulières** : • Voix-texte — convertit automatiquement les messages vocaux en texte avant de les transmettre à l'IA • Messages programmés — prise en charge de l'envoi de messages planifiés • Format Markdown — prise en charge des réponses formatées • Contexte de message cité — possibilité de citer des messages précédents comme contexte de conversation
Les messages vocaux sont automatiquement convertis en texte. Aucune configuration supplémentaire n'est requise.
Le format Markdown s'affiche bien dans QQ et est recommandé comme format de réponse par défaut.

Configuration des groupes et canaux OpenClaw QQ

Le plugin QQ prend en charge la configuration indépendante de trois scénarios de messagerie : **Messages directs (dmEnabled)** : contrôle la réponse aux messages directs. **Discussion de groupe (groupEnabled)** : contrôle la réponse aux messages de discussion de groupe. Dans les discussions de groupe, une @mention du bot est requise pour déclencher une réponse, évitant les réponses excessives dans les groupes actifs. **Canal (channelEnabled)** : contrôle la réponse aux messages dans les canaux QQ, y compris les messages publics de canal et les DMs de canal. Chaque scénario peut être activé ou désactivé indépendamment, permettant un contrôle flexible de la portée de réponse du bot.
openclaw.json
{
  "channels": {
    "qqbot": {
      "dmEnabled": true,
      "groupEnabled": true,
      "channelEnabled": true
    }
  }
}
Dans les discussions de groupe, @mentionner le nom du bot déclenche une réponse.
Les messages de canal et les DMs de canal peuvent être contrôlés de manière unifiée avec channelEnabled.

Commandes utiles d'OpenClaw pour QQ

OpenClaw fournit plusieurs commandes pour gérer votre bot QQ : • openclaw gateway status — vérifier l'état de connexion du Gateway • openclaw gateway restart — redémarrer le service Gateway • openclaw logs --follow — afficher les logs en temps réel • openclaw channels add — ajouter un canal de manière interactive • openclaw plugins list — afficher les plugins installés • openclaw plugins update @openclaw-china/qqbot — mettre à jour le plugin QQ • openclaw china setup — lancer l'assistant de configuration interactif • openclaw doctor — exécuter un diagnostic complet

QQ Référence de Configuration

enabled
Type: booleanDefault: true

Activer ou désactiver le canal QQ

appId
Type: stringDefault: ""

AppID du bot QQ, obtenu sur QQ Open Platform

clientSecret
Type: stringDefault: ""

ClientSecret du bot QQ, obtenu sur QQ Open Platform

sandbox
Type: booleanDefault: false

Activer le mode sandbox, pour les environnements de développement et de test

dmEnabled
Type: booleanDefault: true

Activer les réponses aux messages directs

groupEnabled
Type: booleanDefault: true

Activer les réponses aux messages de discussion de groupe (déclenchement par @ requis)

channelEnabled
Type: booleanDefault: true

Activer les réponses aux messages de canal QQ

messageFormat
Type: stringDefault: "markdown"

Format du message de réponse. Options : text (texte brut), markdown

debug
Type: booleanDefault: false

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

Le bot ne répond pas du tout

AppID ou ClientSecret incorrect, plugin non installé correctement ou le bot n'a pas passé la vérification de la plateforme.

Vérifiez étape par étape : 1) Confirmez que le bot a passé la vérification de QQ Open Platform ; 2) Vérifiez l'AppID et l'ClientSecret ; 3) Exécutez 'openclaw plugins list' pour confirmer l'installation du plugin ; 4) Exécutez 'openclaw gateway status' pour vérifier l'état de connexion ; 5) Consultez 'openclaw logs --follow' pour des informations détaillées sur l'erreur.
Échec de l'envoi de messages actifs

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.

Utilisez principalement le mode de réponse passive (recevoir d'abord le message de l'utilisateur puis répondre). Si l'envoi actif est nécessaire, configurez les permissions correspondantes sur QQ Open Platform et respectez les limites de fréquence des messages actifs.
Échec de l'envoi de messages multimédias

Permissions insuffisantes pour les messages multimédias ou la taille du fichier dépasse la limite de la plateforme QQ.

Vérifiez que les permissions de messages multimédias sont accordées sur QQ Open Platform. Vérifiez que la taille du fichier ne dépasse pas la limite de la plateforme. Consultez 'openclaw logs --follow' pour obtenir les codes d'erreur et les causes détaillées.
Impossible de recevoir les messages de canal

channelEnabled n'est pas activé ou le bot n'a pas été ajouté au canal QQ.

Assurez-vous que channelEnabled est défini sur true dans la configuration. Vérifiez que le bot a été ajouté au canal QQ cible. Confirmez sur QQ Open Platform que les permissions de messages de canal sont activées.
La fonction voix-texte ne fonctionne pas

Anomalie du service de reconnaissance vocale ou permissions insuffisantes.

Vérifiez que les permissions de messages vocaux sont accordées. Recherchez les messages d'erreur liés au traitement vocal dans les logs du Gateway. Essayez de redémarrer le Gateway et testez à nouveau.