QQ Integration

Required config

{
  "services": {
    "chat": {
      "channels": {
        "qq": {
          "enabled": true,
          "channelAccountId": "qq-main"
        }
      }
    }
  }
}

Credential source:

1. Create qq-main in Console UI Global / Channel Accounts.
2. Fill appId, appSecret, and optional sandbox/authId in that channel account.

Start runtime

city agent start

Verify channel status

city service status chat

Group behavior

• Group messages are accepted directly (no @mention required).
• If your bot only receives @ messages, verify QQ platform event permissions (especially GROUP_MESSAGE_CREATE).

Voice messages (voice/audio)

When extensions.voice.enabled=true, QQ inbound voice/audio attachments are transcribed in best-effort mode and the transcript is appended to the user instruction.

Recommended setup:

city voice on SenseVoiceSmall
city voice status

Notes:

• Transcription failures do not break the main chat flow.
• QQ voice attachment delivery depends on gateway AUDIO_ACTION capability. If your bot app does not have that permission, audio payload fields may be missing.