QQ-bot

​

Installeren

openclaw plugins install @openclaw/qqbot

​

Instellen

1. Ga naar het QQ Open Platform en scan de QR-code met QQ op je telefoon om je te registreren / aan te melden.
2. Klik op Create Bot om een nieuwe QQ-bot te maken.
3. Zoek AppID en AppSecret op de instellingenpagina van de bot en kopieer ze.

4. Voeg het kanaal toe:

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

5. Start de Gateway opnieuw.

​

Duurzaamheid van inkomende berichten

openclaw channels add

​

Configureren

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

• QQBOT_APP_ID
• QQBOT_CLIENT_SECRET

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

{
  channels: {
    qqbot: {
      enabled: true,
      appId: "YOUR_APP_ID",
      clientSecret: { source: "env", provider: "default", id: "QQBOT_CLIENT_SECRET" },
    },
  },
}

• openclaw channels add --channel qqbot --token-file ... stelt alleen het AppSecret in; appId moet al zijn ingesteld in de configuratie of QQBOT_APP_ID.
• clientSecret accepteert een tekenreeks met platte tekst, een bestandspad (clientSecretFile), of een gestructureerd SecretRef-object.
• Verouderde markerreeksen secretref:... / secretref-env:... worden geweigerd voor clientSecret; gebruik in plaats daarvan een gestructureerd SecretRef-object.

​

Streaming

{
  channels: {
    qqbot: {
      streaming: {
        mode: "partial", // blokstreaming: "partial" (standaard) of "off"
        nativeTransport: true, // gebruik QQ's officiële C2C stream_messages-API voor privéberichten
      },
    },
  },
}

• streaming.mode: "off" schakelt blokstreaming voor het account uit.
• streaming.nativeTransport: true streamt C2C-antwoorden (privéberichten) via QQ’s officiële stream_messages-API; doelen in groepen/kanalen worden niet beïnvloed.
• Verouderde scalaire waarden van streaming: true|false en de sleutel streaming.c2cStreamApi worden via openclaw doctor --fix naar deze structuur gemigreerd.
• /bot-streaming on|off schakelt dezelfde configuratie vanuit een privébericht om.

​

Toegangsbeleid

• allowFrom / groupAllowFrom bepalen wie in een C2C- / groepscontext met de bot kan chatten. dmPolicy / groupPolicy (open | allowlist | disabled) bepalen de handhavingsmodus. dmPolicy wordt standaard allowlist zodra allowFrom een concrete vermelding (zonder jokerteken) bevat, anders open. groupPolicy wordt standaard allowlist zodra groupAllowFrom of allowFrom een concrete vermelding bevat, anders open.
• Slash-opdrachten met “Auth: allowlist” vereisen een expliciete vermelding zonder jokerteken in allowFrom (of groupAllowFrom voor aanroepen vanuit een groep), ongeacht dmPolicy / groupPolicy — zie Slash-opdrachten.

​

Instelling voor meerdere accounts

{
  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"

​

Groepschats

{
  channels: {
    qqbot: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["member_openid"],
      groups: {
        "*": {
          requireMention: true,
          commandLevel: "all",
          historyLimit: 50,
          tools: { deny: ["exec", "read", "write"] },
        },
        GROUP_OPENID: {
          name: "Release room",
          requireMention: false,
          ignoreOtherMentions: true,
          commandLevel: "safety",
          historyLimit: 20,
          prompt: "Keep replies short and operational.",
        },
      },
    },
  },
}

​

Spraak (STT / TTS)

{
  channels: {
    qqbot: {
      stt: {
        provider: "your-provider",
        model: "your-stt-model",
      },
      tts: {
        provider: "your-provider",
        model: "your-tts-model",
        voice: "your-voice",
      },
      accounts: {
        "qq-main": {
          tts: {
            providers: {
              openai: { voice: "shimmer" },
            },
          },
        },
      },
    },
  },
}

• sttDirectFormats
• uploadDirectFormats
• transcodeEnabled

​

Doelindelingen

​

Slash-opdrachten

​

Media en opslag

• Inkomende, uitgaande en via de Gateway-brug verzonden media delen één hoofdmap voor payloads onder ~/.openclaw/media/qqbot (waarbij OPENCLAW_HOME wordt gerespecteerd indien ingesteld), zodat uploads, downloads en transcoderingscaches binnen één beveiligde map blijven.
• De levering van rijke media aan C2C- en groepsdoelen verloopt via één sendMedia-pad. Lokale bestanden en buffers in het geheugen van 5 MiB of meer gebruiken de endpoints voor uploads in delen van QQ; kleinere payloads en bronnen via externe URL’s/Base64 gebruiken de API voor eenmalige uploads.
• Als een hot-upgrade de Gateway onderbreekt voordat deze klaar is met het schrijven van openclaw.json, herstelt de plugin bij de volgende start de laatst bekende appId / clientSecret voor dat account vanuit een interne momentopname (waarbij een opzettelijke configuratiewijziging nooit wordt overschreven), zodat het opnieuw scannen van de QR-code niet nodig is.

​

Problemen oplossen

• Gateway start niet / geen inkomende berichten: controleer of appId en clientSecret correct zijn en of de bot is ingeschakeld op het QQ Open Platform. Een ontbrekend toegangsmiddel wordt weergegeven als “QQBot niet geconfigureerd (appId of clientSecret ontbreekt)”.
• Instellen met --token-file wordt nog steeds als niet geconfigureerd weergegeven: --token-file stelt alleen het AppSecret in. appId moet nog steeds worden ingesteld in de configuratie of QQBOT_APP_ID.
• Piekgewijze groepsantwoorden botsen: wanneer de wachtrij van een peer volloopt, verwijdert de inkomende wachtrij berichten die door bots zijn opgesteld vóór menselijke berichten, en voegt deze pieken van normale groepsberichten (geen opdrachten) samen tot één beurt met bronvermelding, zodat een stortvloed aan botberichten menselijke berichten niet zou moeten verdringen.
• Proactieve berichten komen niet aan: QQ kan door de bot geïnitieerde berichten blokkeren als de gebruiker recent geen interactie heeft gehad.
• Spraak wordt niet getranscribeerd: zorg dat STT is geconfigureerd en dat de provider bereikbaar is.

​

Gerelateerd

• Koppelen
• Groepen
• Problemen met kanalen oplossen