Need help with coolq-telegram-bot-x?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

143 Stars 19 Forks GNU General Public License v3.0 65 Commits 8 Opened issues


QQ && Telegram Forward Framework :: C++ Version

Services available


Need anything else?

Contributors list

# 54,042
42 commits
# 312,297
16 commits
# 101,533
Online ...
2 commits

CoolQ Telegram Bot X

Language: 🇺🇸 English | 🇨🇳 简体中文

CoolQ Telegram Bot X is a message forwarding bot. This bot can help to forward messages from one QQ / Telegram group to another. With simple config, you can customize the forwarding logic in a convenient way. Feel free to link between QQ and Telegram, or merge different messages to one place.


Deep Integration

CoolQ Telegram Bot X is an integration of QQ Bot and Telegram Bot. CoolQ Message SDK ensures the stability and availability of receiving and sending QQ messages every time. Telegram C++ SDK based on official Telegram Bot API shows its power to handle different kinds of messages. Forwarding logic unit will parse and transfer messages which QQ Bot or Telegram Bot receive to another group according to forward config.

All message SDKs and forwarding logic unit are packed into a CoolQ plugin. Start CoolQ, enable the plugin, and enjoy :)

Multi-direction Forwarding

CoolQ Telegram Bot X supports various forwarding type. No matter QQ to Telegram, or Telegram to QQ, it can parse and transfer messages correctly. Besides, QQ to QQ and Telegram to Telegram message forwarding can help you organize and merge messages from different groups.

In some cases, you may need one-direction forwarding rather than bi-direction forwarding. Don't worry, CoolQ Telegram Bot X is still capable to do it.

Smart Message Conversion

You may notice that QQ faces are special characters. CoolQ Telegram Bot X is so smart, converting QQ faces to emoji automatically when sending to Telegram group. In future work, we will support more special message conversion.


Quite easy, just follow these steps:

  1. Install CoolQ Main Program.

For Windows users, please download CoolQ from official website.

For Linux users, it is recommended to deploy Docker image from coolq/wine-coolq.

  1. Download CoolQ plugin and example configuration json file from relesase page.

  2. Place the cpk file to

    and place the json file to
    (You need to make the new directory yourself).
  3. Start CoolQ Main Program, enable the plugin.

For more details, please visit the installation guide in repository wiki.


Generally, if you need message sending to / receiving from Telegram groups, a Telegram bot token is needed to fill in config file. Then customize the forwarding rule in config file, you will find the bot works functionally.

For more details, please visit the configuration guide in repository wiki.

Join Development

The source code is a Visual Studio 2017 project, and requires a compiler supporting C++ 17 standard. Please use Microsoft/vcpkg to install dependencies:


For more details, please visit the development guide in repository wiki.

If you find some trouble in using or developing CoolQ Telegram Bot X, you can join our Support Group (Telegram).


You know, There is a Python version: jqqqqqqqqqq/CoolQ Telegram Bot.

What to choose? In short, the Python version focuses more on new features and extensiblility, but the C++ version cares more on convenience and simple deployment.

| | C++ Version | Python Version | | ------------------------ | ------------------------------------------------- | ----------------------- | | Forwarding direction | One-direction forwarding, bi-direction forwarding | Bi-direction forwarding | | Forwarding group | QQ - Telegram, QQ - QQ, Telegram - Telegram | QQ - Telegram | | Text forwarding | Support | Support | | Picture forwarding | Support | Support | | Audio forwarding | Unsupport (in plan) | Partly support | | Other message forwarding | Change to text message | Change to text message |


CoolQ Telegram Bot X is derived from jqqqqqqqqqq/CoolQ Telegram Bot.

CoolQ Message SDK is based on richardchien/coolq-cpp-sdk

Telegram C++ SDK uses the code from reo7sp/tgbot-cpp

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.