From f8bfd7c1070ba150e211df5eae46b1d4f396c3dd Mon Sep 17 00:00:00 2001
From: "Ringo.Typowriter" <ringotypewriter@qq.com>
Date: Mon, 9 Mar 2026 23:37:28 +0800
Subject: [PATCH] docs(channels): add QQ channel configuration guide (#219)

---
 docs/docs/.vitepress/en.ts            |  4 +++
 docs/docs/channels/index.md           |  1 +
 docs/docs/channels/qq.md              | 42 +++++++++++++++++++++++++++
 docs/docs/getting-started/channels.md |  1 +
 4 files changed, 48 insertions(+)
 create mode 100644 docs/docs/channels/qq.md

diff --git a/docs/docs/.vitepress/en.ts b/docs/docs/.vitepress/en.ts
index 8a203951..45240e66 100644
--- a/docs/docs/.vitepress/en.ts
+++ b/docs/docs/.vitepress/en.ts
@@ -110,6 +110,10 @@ export const en = [
         text: 'Discord',
         link: '/channels/discord.md'
       },
+      {
+        text: 'QQ',
+        link: '/channels/qq.md'
+      },
     ]
   },
 ]
\ No newline at end of file
diff --git a/docs/docs/channels/index.md b/docs/docs/channels/index.md
index 7789e332..09cfcbef 100644
--- a/docs/docs/channels/index.md
+++ b/docs/docs/channels/index.md
@@ -7,6 +7,7 @@ Memoh currently supports the following channels:
 - **[Telegram](./telegram)**: The most feature-rich integration with streaming and attachment support.
 - **[Feishu (Lark)](./feishu)**: Enterprise-ready integration for business workflows.
 - **[Discord](./discord)**: Community-focused integration for servers and direct messages.
+- **[QQ](./qq)**: Quick setup for personal DM bots via the dedicated AI bot registration portal.
 - **Email**: Connect via standard SMTP and IMAP (configured through Email Providers).
 - **Web**: Built-in chat interface for immediate access.
 
diff --git a/docs/docs/channels/qq.md b/docs/docs/channels/qq.md
new file mode 100644
index 00000000..70ae2175
--- /dev/null
+++ b/docs/docs/channels/qq.md
@@ -0,0 +1,42 @@
+# QQ Channel Configuration
+
+Connecting your Memoh Bot to QQ allows it to interact with users through QQ's official Bot platform.
+
+## Step 1: Create a QQ Bot
+
+1. Go to the [QQ Bot Open Platform](https://q.qq.com/qqbot/openclaw/) and log in with your QQ account.
+2. Click **Create Bot** (创建机器人) - no approval required. Each account can create up to 5 bots.
+3. Copy the **AppID** and **AppSecret** displayed on the page.
+
+> **Important**: AppSecret is only shown once. Save it securely - viewing it again will force a reset.
+
+## Step 2: Configure Memoh
+
+1. Go to your Bot's **Channels** tab in the Memoh Web UI.
+2. Click **Add Channel** and select **QQ**.
+3. Paste your **AppID** and **AppSecret**.
+4. Configure optional settings:
+   - **Markdown Support**: Enable Markdown formatting (default: enabled).
+   - **Enable Input Hint**: Show typing indicators (default: enabled).
+5. Click **Save and Enable**.
+
+## Step 3: Bind Your Identity (Optional)
+
+If your bot is a `personal` type bot, bind your QQ identity to chat with it directly:
+
+1. In Memoh Web UI, go to **Settings** > **Bind Code**.
+2. Select **QQ** and click **Generate**.
+3. Copy the code and send it to your bot in a QQ direct message.
+
+## Features Supported
+
+- **Message Content**: Full support for text messages.
+- **Markdown**: Rich formatting with bold, italic, code blocks, and links.
+- **Attachments**: Support for images and files.
+- **Typing Indicators**: Visual feedback while generating responses.
+- **Target Types**: C2C (direct message), group, and channel.
+
+## Official Resources
+
+- [QQ Bot Open Platform](https://q.qq.com/)
+- [QQ Bot Documentation](https://bot.q.qq.com/wiki/)
diff --git a/docs/docs/getting-started/channels.md b/docs/docs/getting-started/channels.md
index d349809a..d27c1b56 100644
--- a/docs/docs/getting-started/channels.md
+++ b/docs/docs/getting-started/channels.md
@@ -19,6 +19,7 @@ For detailed step-by-step guides on how to create and configure bots for each pl
 - **[Telegram Configuration](/channels/telegram)**
 - **[Feishu (Lark) Configuration](/channels/feishu)**
 - **[Discord Configuration](/channels/discord)**
+- **[QQ Configuration](/channels/qq)**
 
 ---