# QQ QQ is a widely-used instant messaging platform that provides various communication capabilities such as text, voice, images, and files. It supports collaborative scenarios like group chats and channels, making it suitable for both personal communication and team collaboration. This integration method connects OpenClaw with a QQ Bot. It utilizes the platform's long-connection event subscription mechanism to receive message and event callbacks, enabling stable and secure message exchange and automation capability integration without exposing a public webhook address. # Step 1: Install the QQ Bot Plugin Install via the OpenClaw plugins command. ``` openclaw plugins install @sliverp/qqbot@latest ``` Install from source code: ``` git clone https://github.com/sliverp/qqbot.git && cd qqbot openclaw plugins install . ``` # Step 2: Create a QQ Bot ## 1. Register on the QQ Open Platform Go to the official website of the Tencent QQ Open Platform. You cannot log in directly with your personal QQ account by default; you need to register a new QQ Open Platform account.

After the initial registration, follow the platform's instructions to set up a super administrator.

After successfully scanning the QR code with your mobile QQ, proceed to the next step to fill in the relevant entity information. Using "Individual" as an example here, follow the prompts to enter your name, ID number, phone number, and verification code, then click continue to proceed to the facial recognition step.

Use your mobile QQ to scan the QR code for facial recognition.

Once the facial recognition review is approved, you can log in to the QQ Open Platform.

## 2. Create a QQ Bot On the QQ Open Platform's QQ Bot page, you can create a bot.

After the QQ Bot is created, you can select it and click to enter the management page.

On the QQ Bot management page, obtain the current bot's AppID and AppSecret, copy them, and save them to your personal notepad or memo (please ensure data security and do not leak them). They will be needed later in "Step 3: Configuring OpenClaw". Note: For security reasons, the QQ Bot's AppSecret is not stored in plain text. If you view it for the first time or forget it, you need to regenerate it.

## 3. Sandbox Configuration On the QQ Bot's "Development Management" page, in the "Sandbox Configuration" section, set up private chat (select "Configure in Message List"). You can configure this according to your own usage scenario, or you can complete the subsequent steps and then return to this step to operate. ⚠️ Note: The QQ Bot created here does not need to be published and made available to all QQ users. It can be used for personal (sandbox) debugging and experience. The QQ Open Platform does not support "Configuration in QQ Groups" for bots; it only supports private chat with the QQ Bot.

Note: When selecting "Configure in Message List", you need to first add members, and then use the QQ scan code of that member to add the bot.

Note here that after successfully adding a member, you still need to use QQ scan code to add the bot.

At this point, after adding the bot to your QQ account, you still cannot have a normal conversation with it. You will receive a prompt saying "The bot has gone to Mars, please try again later." This is because the QQ bot has not yet been connected to the OpenClaw application. You need to proceed with the following steps to configure the QQ bot's AppID and AppSecret for the OpenClaw application.

(Optional) You can also add more members by referring to the previous steps: First, add a new member in the member management page, then add the member in the sandbox configuration page. After that, the new member can add this QQ bot by scanning the QR code with QQ.

# Step 3: Configure OpenClaw ## Method 1: Configure via Wizard (Recommended) Add the qqbot channel and input the AppID and AppSecret obtained in Step 2. ``` openclaw channels add --channel qqbot --token "AppID:AppSecret" ``` ## Method 2: Configure via Configuration File Edit ~/.openclaw/openclaw.json: ``` json { "channels": { "qqbot": { "enabled": true, "appId": "Your AppID", "clientSecret": "Your AppSecret" } } } ``` # Step 4: Start and Test ## 1. Start the gateway ``` openclaw gateway ``` ## 2. Chat with the QQbot in QQ

# Features ## Rich Media Support This QQ Bot plugin supports receiving and sending various types of media messages, including images, voice, video, and other attachments. ### Receiving Media When users send media messages to the bot, the plugin will: - **Images**: Automatically download and provide local file path for AI processing - Supported formats: JPG, PNG, GIF, WebP, BMP - **Voice**: Automatically convert SILK/AMR format to WAV for better compatibility - Supported formats: SILK, AMR, MP3, WAV, OGG (auto-converted to WAV) - **Video**: Download and provide local file path for AI processing - Supported formats: MP4, MOV, AVI, MKV, FLV, WMV - **Other Attachments**: Download and provide file information ### Sending Media The bot can send media messages using special tags in the response: #### Send Images Use `` tag to send images: ``` /path/to/image.jpg https://example.com/image.png ``` - Local files: Must use absolute path - Network images: Must be valid HTTP/HTTPS URL - Supported formats: PNG, JPG, JPEG, GIF, WebP #### Send Video Use `` tag to send videos: ``` /path/to/video.mp4 https://example.com/video.mp4 ``` - Local files: Must use absolute path - Network videos: Must be valid HTTP/HTTPS URL - Supported formats: MP4, MOV, AVI #### Send Voice Use `` tag to send voice messages: ``` /path/to/audio.mp3 /path/to/recording.wav https://example.com/audio.mp3 ``` - Local files: Must use absolute path - Network audio: Must be valid HTTP/HTTPS URL - Supported formats: MP3, WAV, OGG, FLAC, AAC, M4A, SILK - **Auto-conversion**: Non-SILK formats are automatically converted to SILK format required by QQ ### Important Notes 1. **File Paths**: Always use absolute paths for local files 2. **Network URLs**: Must be valid and accessible HTTP/HTTPS URLs 3. **Format Conversion**: Voice messages are automatically converted to SILK format 4. **File Size**: Large files may take longer to process 5. **Passive Reply**: All media sending must be done as passive replies (within 5 minutes of receiving a message) # Upgrade ## Using openclaw/npm(Recommendation) > only for installed by`openclaw plugins install` ``` openclaw plugins upgrade @sliverp/qqbot@latest ``` ## Using npx ``` npx -y @sliverp/qqbot@latest upgrade ``` ## Using resource code ``` git clone https://github.com/sliverp/qqbot.git && cd qqbot # run upgrade script bash ./scripts/upgrade.sh # re-install clawdbot plugins install . # re-config clawdbot channels add --channel qqbot --token "AppID:AppSecret" # restart gateway clawdbot gateway restart ``` # Other Language README [简体中文](README.zh.md)

Qqbot Openclaw

Similar Plugins

Nats Eventstore

Clawietalkie Openclaw