OpenClaw QQ Bot-Kanal
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.
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
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.
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.
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.
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
{
"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 QQ Plugin-Installation
# 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 setupOpenClaw QQ-Bot erstellen
# Über Umgebungsvariablen
export QQ_APP_ID="your-app-id"
export QQ_CLIENT_SECRET="your-app-secret"
# Oder über CLI
openclaw channels addOpenClaw QQ Nachrichtentypen und Medienunterstützung
OpenClaw QQ Gruppenchat- und Kanalkonfiguration
{
"channels": {
"qqbot": {
"dmEnabled": true,
"groupEnabled": true,
"channelEnabled": true
}
}
}Nützliche OpenClaw-Befehle für QQ
QQ Konfigurationsreferenz
| Key | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | true | QQ-Kanal aktivieren oder deaktivieren |
| appId | string | "" | AppID des QQ-Bots, von der QQ Open Platform erhalten |
| clientSecret | string | "" | ClientSecret des QQ-Bots, von der QQ Open Platform erhalten |
| sandbox | boolean | false | Sandbox-Modus aktivieren, für Entwicklungs- und Testumgebungen |
| dmEnabled | boolean | true | Antworten auf Direktnachrichten aktivieren |
| groupEnabled | boolean | true | Antworten auf Gruppenchat-Nachrichten aktivieren (@-Auslöser erforderlich) |
| channelEnabled | boolean | true | Antworten auf QQ-Kanalnachrichten aktivieren |
| messageFormat | string | "markdown" | Antwortnachricht-Format. Optionen: text (Klartext), markdown |
| debug | boolean | false | Debug-Modus aktivieren, detaillierte Verbindungs- und Nachrichtenlogs ausgeben |
QQ-Kanal aktivieren oder deaktivieren
AppID des QQ-Bots, von der QQ Open Platform erhalten
ClientSecret des QQ-Bots, von der QQ Open Platform erhalten
Sandbox-Modus aktivieren, für Entwicklungs- und Testumgebungen
Antworten auf Direktnachrichten aktivieren
Antworten auf Gruppenchat-Nachrichten aktivieren (@-Auslöser erforderlich)
Antworten auf QQ-Kanalnachrichten aktivieren
Antwortnachricht-Format. Optionen: text (Klartext), markdown
Debug-Modus aktivieren, detaillierte Verbindungs- und Nachrichtenlogs ausgeben
QQ Häufig gestellte Fragen
QQ Fehlerbehebung
AppID oder ClientSecret ist falsch, Plugin ist nicht korrekt installiert oder Bot hat die Plattformüberprüfung nicht bestanden.
Der QQ-Server verfügt über einen Filtermechanismus für aktive Nachrichten, wobei Nicht-Antwort-Nachrichten blockiert werden können.
Fehlende Berechtigungen für Mediennachrichten oder Dateigröße überschreitet das QQ-Plattformlimit.
channelEnabled ist nicht aktiviert oder Bot wurde dem QQ-Kanal nicht hinzugefügt.
Spracherkennungsdienst-Störung oder unzureichende Berechtigungen.