If you’re running OpenClaw and want to control it directly from QQ — you’re in the right place.

QQ Channel integration lets you command your AI agent without switching apps. Whether you want to automate tasks, run scripts, or manage files, everything happens inside your familiar QQ interface.

This guide walks you through the complete setup — from QQ Open Platform registration to live testing. No complex configs. No technical background required.

—

Table of Contents

1. [Prerequisites](#prerequisites)
2. [Step 1: Create Your QQ Bot](#step-1-create-your-qq-bot)
3. [Step 2: Install the QQ Bot Plugin](#step-2-install-the-qq-bot-plugin)
4. [Step 3: Configure the QQ Channel](#step-3-configure-the-qq-channel)
5. [Step 4: Verify & Test](#step-4-verify–test)
6. [Useful Commands](#useful-commands)
7. [Summary](#summary)

—

Prerequisites

Before you start, make sure you have:

• OpenClaw installed and running (local machine or server)

• QQ account with real-name verification (personal or business)

• Node.js ≥ 22 — check with `node -v`

• Supported OS: macOS 10.15+, Linux (Ubuntu recommended), or Windows with WSL2

If OpenClaw isn’t installed yet, run the official installer:

“`bash
curl -fsSL https://openclaw.ai/install.sh | bash

iwr -useb https://openclaw.ai/install.ps1 | iex
“`

Verify the installation:

“`bash
openclaw –version
“`

—

Step 1: Create Your QQ Bot

1. Visit the QQ Open Platform: [https://q.qq.com/](https://q.qq.com/) or [https://q.qq.com/qqbot/openclaw/login.html](https://q.qq.com/qqbot/openclaw/login.html)
2. Log in with your QQ account and complete real-name verification
3. Go to Bot Management → Click Create Bot
4. Fill in the bot name, avatar, and description
5. Record your AppID and AppSecret — AppSecret only shows once, save it immediately
6. Enable Private Chat / Group Chat / Channel permissions
7. Add your server’s public IP to the IP whitelist

—

Step 2: Install the QQ Bot Plugin

Open your terminal and run:

“`bash
openclaw plugins install @openclaw/qqbot@latest
“`

—

Step 3: Configure the QQ Channel

Add the QQ channel with your credentials:

“`bash
openclaw channels add –channel qqbot –token “YOUR_APPID:YOUR_APPSECRET”
“`

• `–channel qqbot`: Fixed channel type

• `–token`: Format is `AppID:AppSecret`

Restart the gateway to apply changes:

“`bash
openclaw gateway restart
“`

Alternative: WebUI Configuration

Prefer a visual interface?

1. Open OpenClaw WebUI (default: `http://YOUR_SERVER_IP:18789`)
2. Go to App Management → Channel Config
3. Select QQ, enter your AppID and AppSecret
4. Click Add & Apply
5. Restart the service

—

Step 4: Verify & Test

Check service status:

“`bash
openclaw status
“`

Make sure the status shows `running` or `active`.

Then:
1. Add the bot as a friend in QQ, or invite it to a group/channel
2. Send a test message
3. If you get a reply — setup is complete!

—

Useful Commands

Here are the most common commands for managing your QQ Channel setup:

“`bash
openclaw channels list

openclaw channels remove qqbot

openclaw channels add –channel qqbot –token “NEW_APPID:NEW_APPSECRET”

openclaw plugins status

openclaw plugins disable qqbot
openclaw plugins enable qqbot
“`

—

Summary

Compared to other platforms like Feishu, WeChat Work, or DingTalk — QQ Channel is the simplest and most hassle-free option for OpenClaw integration.

The core concept is simple: Plugin adaptation + Key configuration. No complex technical operations needed. As long as you follow the steps — prepare the environment, install the plugin, get your credentials, and configure the channel — you’ll have seamless connectivity between QQ and OpenClaw.

Once connected, you can command your AI agent directly from QQ to:

• Automate repetitive tasks

• Execute scripts

• Manage files

• And more — all from your chat box

For troubleshooting, run `openclaw doctor` to diagnose your environment and quickly identify issues.

—

Start your AI automation journey today — command your digital employee from QQ!

—

*Did you find this guide helpful? Let us know in the comments below. Don’t forget to subscribe for more AI tools and automation tutorials.*