OpenClaw QQ Bot in 5 Minuten einrichten

Kennst du das? Du willst eigentlich nur schnell einen Bot für deine Community aufsetzen, aber die API-Anbindung raubt dir den letzten Nerv. Mit OpenClaw und dem QQ Bot Plugin kommst du schneller ans Ziel und kannst dich auf das konzentrieren, was zählt: die Interaktion mit deinen Usern.

Der QQ Bot verbindet sich über die offizielle QQ Bot API (WebSocket Gateway) mit OpenClaw. Das Plugin unterstützt C2C-Privatchats, Gruppen-@Nachrichten und Guild-Channel-Nachrichten mit Rich Media (Bilder, Sprache, Video, Dateien).

Status: Integriertes Channel-Plugin. Direktnachrichten, Gruppen-Chats, Guild-Channels und Medien werden unterstützt. Reactions und Threads werden nicht unterstützt.

In OpenClaw enthalten

Aktuelle OpenClaw-Installationen enthalten den QQ Bot bereits. Du benötigst keinen separaten openclaw plugins install Schritt für die normale Einrichtung.

Einrichtung

1. Gehe zur QQ Open Platform und scanne den QR-Code mit deinem Handy-QQ, um dich zu registrieren oder anzumelden.
2. Klicke auf Create Bot, um einen neuen QQ-Bot zu erstellen.
3. Suche die AppID und das AppSecret auf der Einstellungsseite des Bots und kopiere sie.

Das AppSecret wird nicht im Klartext gespeichert — wenn du die Seite verlässt, ohne es zu speichern, musst du ein neues generieren.

4. Füge den Channel hinzu:

openclaw channels add --channel qqbot --token "AppID:AppSecret"

5. Starte das Gateway neu.

Interaktive Einrichtungspfade:

openclaw channels add
openclaw configure --section channels

Konfiguration

Minimale Konfiguration:

{
  channels: {
    qqbot: {
      enabled: true,
      appId: "YOUR_APP_ID",
      clientSecret: "YOUR_APP_SECRET",
    },
  },
}

Umgebungsvariablen für den Standard-Account:

• QQBOT_APP_ID
• QQBOT_CLIENT_SECRET

Datei-basiertes AppSecret:

{
  channels: {
    qqbot: {
      enabled: true,
      appId: "YOUR_APP_ID",
      clientSecretFile: "/path/to/qqbot-secret.txt",
    },
  },
}

Hinweise:

• Der Env-Fallback gilt nur für den Standard-QQ-Bot-Account.
• openclaw channels add --channel qqbot --token-file ... setzt nur das AppSecret; die AppID muss bereits in der Konfiguration oder über QQBOT_APP_ID festgelegt sein.
• clientSecret akzeptiert auch SecretRef-Eingaben, nicht nur Klartext-Strings.

Multi-Account

{
  channels: {
    qqbot: {
      enabled: true,
      appId: "111111111",
      clientSecret: "secret-of-bot-1",
      accounts: {
        bot2: {
          enabled: true,
          appId: "222222222",
          clientSecret: "secret-of-bot-2",
        },
      },
    },
  },
}

openclaw channels add --channel qqbot --account bot2 --token "222222222:secret-of-bot-2"

{
  channels: {
    qqbot: {
      stt: {
        provider: "your-provider",
        model: "your-stt-model",
      },
      tts: {
        provider: "your-provider",
        model: "your-tts-model",
        voice: "your-voice",
      },
    },
  },
}