What breaks without openclaw qq bot adapter
No QQ reach. Official API locked behind credentials. Chinese market unreachable.
→
QQ group access × official Tencent API ÷ 20-minute install ÷ zero reverse-engineering = bots Chinese users actually receive.
Security check — openclaw qq bot adapter
Privacy score: 7/10 — accesses connected platform APIs only.
Lock it: review OAuth scopes before install, confirm Linux, macOS; OpenClaw ≥1.0; outbound HTTPS to Tencent API compatibility.
Quick start — openclaw qq bot adapter in 20–40 minutes
Setup time: 20–40 minutes
!
You need:
- OpenClaw core
- QQ Bot developer account
- approved Tencent open platform application
Install the package:
npm install @tencent-connect/openclaw-qqbot
1
Apply for QQ Bot developer account at q.qq.com
2
Create a bot application and obtain AppID + Token
4
Set QQ_APP_ID and QQ_APP_TOKEN in .env
5
Register adapter in openclaw.config.js
6
Start OpenClaw and verify webhook receipt in Tencent console
Compatibility & status
Works with: Linux, macOS; OpenClaw ≥1.0; outbound HTTPS to Tencent API
intermediate
Last updated: Sep 2025
★ 1100 on GitHub
MIT
Official docs →
View on GitHub →
FAQ — openclaw qq bot adapter
Does this support QQ channels (频道) as well as groups?
Yes. Set the mode flag to subscribe to both QQ groups and QQ Guild events.
Is a paid Tencent account required?
The Bot API is free but requires identity verification and application approval.
Can this receive file and voice messages?
File/voice events are received as metadata; download requires additional API calls.