OpenClaw

OpenClaw QQ Bot-Kanal

Messaging
Mittel

Verbinden Sie OpenClaw mit QQ über Community-Plugins (QQ ist kein offiziell integrierter OpenClaw-Kanal). Diese Integration unterstützt Direktnachrichten, Gruppenchats (@-Auslöser), Kanalnachrichten, Kanal-DMs, Rich Media (Bilder, Audio, Video, Dateien), Sprache-zu-Text, geplante Nachrichten, Markdown-Formatierung und Zitatnachricht-Kontext. Installieren Sie das Plugin, erstellen Sie einen Bot auf der QQ Open Platform, konfigurieren Sie die Anmeldedaten und Sie können loslegen.

Kurzinfo
SchwierigkeitsgradMittel
KategorieMessaging
Unterstützte Funktionen4 / 6

QQ Unterstützte Funktionen

Textnachrichten

Unterstützt

Medien & Dateien

Unterstützt

Reaktionen

Nicht unterstützt

Threads

Nicht unterstützt

Sprachnachrichten

Unterstützt

Gruppenchat

Unterstützt

QQ Voraussetzungen

  • Ein Entwicklerkonto auf der QQ Open Platform
  • QQ-Plugin installiert: openclaw plugins install @openclaw-china/qqbot
  • OpenClaw Gateway läuft und ist konfiguriert
  • Node.js 18+ auf Ihrem Server installiert

QQ Schnelleinrichtung

1

QQ-Plugin installieren

Führen Sie 'openclaw plugins install @openclaw-china/qqbot' in Ihrem Terminal aus, um das offiziell von Tencent gewartete QQ-Bot-Plugin zu installieren. Dieses Plugin hat auf GitHub 186 Sterne und wird aktiv gepflegt.

2

Bot auf der QQ Open Platform erstellen

Melden Sie sich bei der QQ Open Platform (q.qq.com) an und erstellen Sie eine neue Bot-Anwendung. Auf der App-Einstellungsseite erhalten Sie die AppID und das ClientSecret. Diese Anmeldedaten sind erforderlich, um OpenClaw mit QQ zu verbinden.

3

Berechtigungen konfigurieren

Konfigurieren Sie auf der Berechtigungsverwaltungsseite der QQ Open Platform die erforderlichen Berechtigungen für den Bot. Aktivieren Sie Berechtigungen für Direktnachrichten, Gruppenchats, Kanalnachrichten und den Versand von Mediennachrichten. Reichen Sie die Konfiguration nach Abschluss zur Überprüfung ein.

4

OpenClaw konfigurieren und testen

Empfohlen: Führen Sie 'openclaw china setup' aus, um den interaktiven Einrichtungsassistenten zu starten. Alternativ fügen Sie die QQ-Kanalkonfiguration in ~/.openclaw/openclaw.json hinzu und tragen Sie appId und clientSecret ein. Führen Sie 'openclaw gateway restart' aus, um das Gateway neu zu starten, und senden Sie dann eine Nachricht an den Bot in QQ, um die Funktionalität zu testen.

QQ Konfigurationsbeispiel

config.json
{
  "channels": {
    "qqbot": {
      "enabled": true,
      "appId": "your-app-id",
      "clientSecret": "your-app-secret",
      "sandbox": false,
      "dmEnabled": true,
      "groupEnabled": true,
      "channelEnabled": true
    }
  }
}

QQ Integrationsanleitung

OpenClaw QQ Architekturübersicht

OpenClaw verbindet sich über das @openclaw-china/qqbot-Plugin mit der QQ Open Platform. Dieses Plugin wird offiziell von Tencent gewartet und nutzt die Bot-API der QQ Open Platform für die Nachrichtenverarbeitung. Nachrichtenfluss: Benutzer sendet Nachricht in QQ → QQ Open Platform → Push an OpenClaw Gateway → KI-Verarbeitung → Antwort über QQ Bot API → Nachricht wird in QQ zugestellt. Dieses Plugin unterstützt mehrere Nachrichtenszenarien: Direktnachrichten, Gruppenchats (@-Auslöser erforderlich), Kanalnachrichten und Kanal-DMs und deckt damit die wichtigsten Interaktionswege im QQ-Ökosystem ab.
Das Plugin wird offiziell von Tencent gewartet, was Stabilität und Kompatibilität gewährleistet.
QQ ist ein Community-Plugin-Kanal, kein offiziell integrierter OpenClaw-Kanal. Das Plugin wird separat vom OpenClaw-Kern installiert und gewartet — nach einem OpenClaw-Upgrade kann ein Plugin-Kompatibilitätsupdate erforderlich sein.

OpenClaw QQ Plugin-Installation

Die Installation des QQ-Plugins ist einfach und erfordert nur einen Befehl: openclaw plugins install @openclaw-china/qqbot Nach der Installation wird das Plugin automatisch im OpenClaw Gateway registriert. Mit 'openclaw plugins list' können Sie die Installation bestätigen.
terminal
# QQ-Plugin installieren
openclaw plugins install @openclaw-china/qqbot

# Installation bestätigen
openclaw plugins list

# Plugin aktualisieren
openclaw plugins update @openclaw-china/qqbot

# Interaktiven Einrichtungsassistenten starten
openclaw china setup

OpenClaw QQ-Bot erstellen

Für die QQ-Integration müssen Sie eine Bot-Anwendung auf der QQ Open Platform erstellen: 1. Melden Sie sich bei der QQ Open Platform (q.qq.com) an und öffnen Sie die Entwicklerkonsole. 2. Klicken Sie auf 'Bot erstellen' und geben Sie Bot-Name, Beschreibung und Avatar ein. 3. Nach der Erstellung finden Sie AppID und ClientSecret auf der App-Einstellungsseite. 4. Aktivieren Sie in den Funktionseinstellungen die benötigten Nachrichtentypen (Direktnachrichten, Gruppenchats, Kanäle usw.). 5. Reichen Sie die Konfiguration nach Abschluss zur Überprüfung ein und warten Sie auf die Genehmigung der Plattform.
terminal
# Über Umgebungsvariablen
export QQ_APP_ID="your-app-id"
export QQ_CLIENT_SECRET="your-app-secret"

# Oder über CLI
openclaw channels add
Bewahren Sie Ihr ClientSecret sicher auf. Committen Sie es niemals in die Versionskontrolle. Verwenden Sie in Produktionsumgebungen Umgebungsvariablen. Falls es kompromittiert wird, setzen Sie es sofort auf der QQ Open Platform zurück.

OpenClaw QQ Nachrichtentypen und Medienunterstützung

Das QQ-Plugin unterstützt umfangreiche Nachrichtentypen: **Empfang**: Text, Bilder, Audio, Video, Dateien **Versand**: Text, Markdown, Bilder, Audio, Video, Dateien **Besondere Funktionen**: • Sprache-zu-Text — Sprachnachrichten werden automatisch in Text umgewandelt und an die KI übergeben • Geplante Nachrichten — Unterstützung für zeitgesteuerten Nachrichtenversand • Markdown-Formatierung — Unterstützung für formatierte Antworten • Zitatnachricht-Kontext — Vorherige Nachrichten können als Gesprächskontext zitiert werden
Sprachnachrichten werden automatisch in Text umgewandelt. Keine zusätzliche Konfiguration erforderlich.
Markdown-Formatierung wird in QQ gut dargestellt und wird als Standard-Antwortformat empfohlen.

OpenClaw QQ Gruppenchat- und Kanalkonfiguration

Das QQ-Plugin unterstützt die unabhängige Konfiguration von drei Nachrichtenszenarien: **Direktnachrichten (dmEnabled)**: Steuert die Antwort auf Direktnachrichten. **Gruppenchat (groupEnabled)**: Steuert die Antwort auf Gruppenchat-Nachrichten. In Gruppenchats ist eine @-Erwähnung des Bots erforderlich, um übermäßige Antworten in aktiven Gruppen zu vermeiden. **Kanal (channelEnabled)**: Steuert die Antwort auf Nachrichten in QQ-Kanälen, einschließlich öffentlicher Kanalnachrichten und Kanal-DMs. Jedes Szenario kann unabhängig aktiviert oder deaktiviert werden, was eine flexible Kontrolle über den Antwortbereich des Bots ermöglicht.
openclaw.json
{
  "channels": {
    "qqbot": {
      "dmEnabled": true,
      "groupEnabled": true,
      "channelEnabled": true
    }
  }
}
In Gruppenchats wird eine Antwort durch @-Erwähnung des Bot-Namens ausgelöst.
Kanalnachrichten und Kanal-DMs können über channelEnabled einheitlich gesteuert werden.

Nützliche OpenClaw-Befehle für QQ

OpenClaw bietet mehrere Befehle zur Verwaltung Ihres QQ-Bots: • openclaw gateway status — Gateway-Verbindungsstatus prüfen • openclaw gateway restart — Gateway-Dienst neu starten • openclaw logs --follow — Echtzeit-Logs anzeigen • openclaw channels add — Kanal interaktiv hinzufügen • openclaw plugins list — Installierte Plugins anzeigen • openclaw plugins update @openclaw-china/qqbot — QQ-Plugin aktualisieren • openclaw china setup — Interaktiven Einrichtungsassistenten starten • openclaw doctor — Umfassende Diagnose durchführen

QQ Konfigurationsreferenz

enabled
Type: booleanDefault: true

QQ-Kanal aktivieren oder deaktivieren

appId
Type: stringDefault: ""

AppID des QQ-Bots, von der QQ Open Platform erhalten

clientSecret
Type: stringDefault: ""

ClientSecret des QQ-Bots, von der QQ Open Platform erhalten

sandbox
Type: booleanDefault: false

Sandbox-Modus aktivieren, für Entwicklungs- und Testumgebungen

dmEnabled
Type: booleanDefault: true

Antworten auf Direktnachrichten aktivieren

groupEnabled
Type: booleanDefault: true

Antworten auf Gruppenchat-Nachrichten aktivieren (@-Auslöser erforderlich)

channelEnabled
Type: booleanDefault: true

Antworten auf QQ-Kanalnachrichten aktivieren

messageFormat
Type: stringDefault: "markdown"

Antwortnachricht-Format. Optionen: text (Klartext), markdown

debug
Type: booleanDefault: false

Debug-Modus aktivieren, detaillierte Verbindungs- und Nachrichtenlogs ausgeben

QQ Häufig gestellte Fragen

QQ Fehlerbehebung

Bot antwortet überhaupt nicht

AppID oder ClientSecret ist falsch, Plugin ist nicht korrekt installiert oder Bot hat die Plattformüberprüfung nicht bestanden.

Prüfen Sie der Reihe nach: 1) Bestätigen Sie, dass der Bot die QQ Open Platform-Überprüfung bestanden hat; 2) Überprüfen Sie AppID und ClientSecret; 3) Führen Sie 'openclaw plugins list' aus, um die Plugin-Installation zu bestätigen; 4) Führen Sie 'openclaw gateway status' aus, um den Verbindungsstatus zu prüfen; 5) Prüfen Sie 'openclaw logs --follow' auf detaillierte Fehlerinformationen.
Aktiver Nachrichtenversand fehlgeschlagen

Der QQ-Server verfügt über einen Filtermechanismus für aktive Nachrichten, wobei Nicht-Antwort-Nachrichten blockiert werden können.

Verwenden Sie hauptsächlich den passiven Antwortmodus (erst Benutzernachricht empfangen, dann antworten). Wenn aktives Pushen erforderlich ist, konfigurieren Sie die entsprechenden Berechtigungen auf der QQ Open Platform und beachten Sie die Frequenzbegrenzungen für aktive Nachrichten.
Mediennachricht-Versand fehlgeschlagen

Fehlende Berechtigungen für Mediennachrichten oder Dateigröße überschreitet das QQ-Plattformlimit.

Überprüfen Sie, ob die Mediennachricht-Berechtigungen auf der QQ Open Platform erteilt wurden. Prüfen Sie, ob die Dateigröße das Plattformlimit überschreitet. Prüfen Sie 'openclaw logs --follow' auf detaillierte Fehlercodes und Ursachen.
Kanalnachrichten können nicht empfangen werden

channelEnabled ist nicht aktiviert oder Bot wurde dem QQ-Kanal nicht hinzugefügt.

Stellen Sie sicher, dass channelEnabled in der Konfiguration auf true steht. Überprüfen Sie, ob der Bot dem Ziel-QQ-Kanal hinzugefügt wurde. Bestätigen Sie auf der QQ Open Platform, dass die Kanalnachricht-Berechtigungen aktiviert sind.
Sprache-zu-Text-Funktion funktioniert nicht

Spracherkennungsdienst-Störung oder unzureichende Berechtigungen.

Überprüfen Sie, ob die Sprachnachricht-Berechtigungen erteilt wurden. Suchen Sie in den Gateway-Logs nach Fehlermeldungen zur Sprachverarbeitung. Versuchen Sie, das Gateway neu zu starten und erneut zu testen.