@sliverp/qqbot 1.3.6 → 1.3.8

package/README.md

@@ -1,106 +1,96 @@
+<div align="center">
+
 # QQ Bot Channel Plugin for Moltbot
 
-QQ 开放平台Bot API 的 Moltbot 渠道插件，支持 C2C 私聊、群聊 @消息、频道消息。
+QQ 开放平台 Bot API 的 Moltbot 渠道插件，支持 C2C 私聊、群聊 @消息、频道消息。
+
+[![npm version](https://img.shields.io/badge/npm-v1.3.7-blue)](https://www.npmjs.com/package/@sliverp/qqbot)
+[![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
+[![QQ Bot](https://img.shields.io/badge/QQ_Bot-API_v2-red)](https://bot.q.qq.com/wiki/)
+[![Platform](https://img.shields.io/badge/platform-Moltbot-orange)](https://github.com/sliverp/moltbot)
+[![Node.js](https://img.shields.io/badge/Node.js->=18-339933)](https://nodejs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6)](https://www.typescriptlang.org/)
+
+</div>
 
-## 功能特性
+---
 
-- **多场景支持**：C2C 单聊、QQ 群 @消息、频道公开消息、频道私信
-- **自动重连**：WebSocket 断连后自动重连，支持 Session Resume
-- **消息去重**：自动管理 `msg_seq`，支持对同一消息多次回复
-- **系统提示词**：可配置自定义系统提示词注入到 AI 请求
-- **错误提示**：AI 无响应时自动提示用户检查配置
+## ⭐ Star 趋势
 
-## 使用示例：
-<img width="952" height="582" alt="image" src="https://github.com/user-attachments/assets/a16d582b-708c-473e-b3a2-e0c4c503a0c8" />
+<!-- 在这里放置 Star 数量变化图 -->
 
-## 版本更新
-**使用`openclaw plugins list`来产看插件版本，建议使用最新版的版本**
-<img width="902" height="248" alt="Clipboard_Screenshot_1769739939" src="https://github.com/user-attachments/assets/d6f37458-900c-4de9-8fdc-f8e6bf5c7ee5" />
+---
 
-### 1.4.0（即将更新）
-- 支持Markdonw格式
+## 📸 使用示例
 
-  
-### 1.3.0-2026.02.03
-- 支持图片收发等功能
-  <img width="924" height="428" alt="Clipboard_Screenshot_1770112572" src="https://github.com/user-attachments/assets/80f38ae9-dc40-4545-ad17-e7e254064cf4" />
+<img width="600" alt="使用示例" src="https://github.com/user-attachments/assets/6f1704ab-584b-497e-8937-96f84ce2958f" />
 
-- 支持定时任务到时后主动推送
-  <img width="930" height="288" alt="Clipboard_Screenshot_1770112539" src="https://github.com/user-attachments/assets/9674cda0-91e9-4860-8dcc-bc50007862a2" />
-- 优化一些已知问题
+---
 
+## ✨ 功能特性
 
-### 1.2.5-2026.02.02
-- 解除URL发送限制，现在可以直接在私聊发送URL
-  <img width="886" height="276" alt="Clipboard_Screenshot_1770092858" src="https://github.com/user-attachments/assets/c660949e-28a5-4e5f-abc2-77f0a2c67bad" />
-- 更新Bot正在输入中状态
-  <img width="740" height="212" alt="Clipboard_Screenshot_1770091969" src="https://github.com/user-attachments/assets/47835c4b-ccd2-4782-aaa6-b873cb58f7d7" />
-- 提供主动推送能力（目前AI还不知道怎么调用主动推送，相关完整Skill能力将在后续版本更新）
-- 优化一些已知问题
-- 优化未收到未收到大模型响应时的提示信息
+- 🔒 **多场景支持** - C2C 私聊、群聊 @消息、频道消息、频道私信
+- 🖼️ **富媒体消息** - 支持图片收发、文件发送
+- ⏰ **定时推送** - 支持定时任务到时后主动推送
+- 🔗 **URL 无限制** - 私聊可直接发送 URL
+- ⌨️ **输入状态** - Bot 正在输入中状态提示
+- 🔄 **热更新** - 支持 npm 方式安装和热更新
+- 📝 **Markdown** - 支持 Markdown 格式（即将更新）
 
+---
 
-### 1.2.2-2026.01.31
-- 支持发送文件
-- 支持openclaw、moltbot命令行
-- 修复[health]检查提示: [health] refresh failed: Cannot read properties of undefined (reading 'appId')的问题（不影响使用）
-- 修复文件发送后clawdbot无法读取的问题
+## 📦 安装
 
-### 1.2.1
-- 解决了长时间使用会断联的问题
-- 解决了频繁重连的问题
-- 增加了大模型调用失败后的提示消息
+### 方式一：腾讯云 Lighthouse 镜像（最简单）
 
+[![Lighthouse](https://img.shields.io/badge/腾讯云-Lighthouse_镜像-00A4FF)](https://cloud.tencent.com/product/lighthouse)
 
-### 1.1.0
-- 解决了一些url会被拦截的问题
-- 解决了多轮消息会发送失败的问题
-- 修复了部分图片无法接受的问题
-- 增加支持onboard的方式配置AppId 和 AppSecret
+直接使用预装好的腾讯云 Lighthouse 镜像，开箱即用，无需手动安装配置。
 
+### 方式二：npm 安装（推荐）
 
-## 安装
+```bash
+openclaw plugins install @sliverp/qqbot@1.3.7
+```
 
-在插件目录下执行：
+### 方式三：源码安装
 
 ```bash
 git clone https://github.com/sliverp/qqbot.git && cd qqbot
-clawdbot plugins install . # 这一步会有点久，需要安装一些依赖。稍微耐心等待一下，尤其是小内存机器
+clawdbot plugins install .
 ```
 
-## 配置
+> 💡 安装过程需要一些时间，尤其是小内存机器，请耐心等待
+
+---
+
+## ⚙️ 配置
 
 ### 1. 获取 QQ 机器人凭证
 
 1. 访问 [QQ 开放平台](https://q.qq.com/)
 2. 创建机器人应用
 3. 获取 `AppID` 和 `AppSecret`（ClientSecret）
-4. Token 格式为 `AppID:AppSecret`，例如 `102146862:Xjv7JVhu7KXkxANbp3HVjxCRgvAPeuAQ`
+4. Token 格式：`AppID:AppSecret`
 
 ### 2. 添加配置
 
-#### 方式一：交互式配置
+**交互式配置：**
 
 ```bash
 clawdbot channels add
 # 选择 qqbot，按提示输入 Token
 ```
 
-#### 方式二：命令行配置
+**命令行配置：**
 
 ```bash
 clawdbot channels add --channel qqbot --token "AppID:AppSecret"
 ```
 
-示例：
-
-```bash
-clawdbot channels add --channel qqbot --token "102146862:xxxxxxxx"
-```
-
 ### 3. 手动编辑配置（可选）
 
-也可以直接编辑 `~/.clawdbot/clawdbot.json`：
+编辑 `~/.clawdbot/clawdbot.json`：
 
 ```json
 {
@@ -108,27 +98,28 @@ clawdbot channels add --channel qqbot --token "102146862:xxxxxxxx"
     "qqbot": {
       "enabled": true,
       "appId": "你的AppID",
-      "clientSecret": "你的AppSecret",
-      "systemPrompt": "你是一个友好的助手"
+      "clientSecret": "你的AppSecret"
     }
   }
 }
 ```
 
+---
 
-
-## 配置项说明
+## 📋 配置项说明
 
 | 配置项 | 类型 | 必填 | 说明 |
 |--------|------|------|------|
-| `appId` | string | 是 | QQ 机器人 AppID |
-| `clientSecret` | string | 是* | AppSecret，与 `clientSecretFile` 二选一 |
-| `clientSecretFile` | string | 是* | AppSecret 文件路径 |
-| `enabled` | boolean | 否 | 是否启用，默认 `true` |
-| `name` | string | 否 | 账户显示名称 |
-| `systemPrompt` | string | 否 | 自定义系统提示词 |
+| `appId` | string | ✅ | QQ 机器人 AppID |
+| `clientSecret` | string | ✅* | AppSecret，与 `clientSecretFile` 二选一 |
+| `clientSecretFile` | string | ✅* | AppSecret 文件路径 |
+| `enabled` | boolean | ❌ | 是否启用，默认 `true` |
+| `name` | string | ❌ | 账户显示名称 |
+| `systemPrompt` | string | ❌ | 自定义系统提示词 |
 
-## 支持的消息类型
+---
+
+## 📨 支持的消息类型
 
 | 事件类型 | 说明 | Intent |
 |----------|------|--------|
@@ -137,17 +128,17 @@ clawdbot channels add --channel qqbot --token "102146862:xxxxxxxx"
 | `AT_MESSAGE_CREATE` | 频道 @机器人消息 | `1 << 30` |
 | `DIRECT_MESSAGE_CREATE` | 频道私信 | `1 << 12` |
 
-## 使用
+---
+
+## 🚀 使用
 
-### 启动
+### 启动服务
 
-后台启动
 ```bash
+# 后台启动
 clawdbot gateway restart
-```
 
-前台启动, 方便试试查看日志
-```bash
+# 前台启动（查看日志）
 clawdbot gateway --port 18789 --verbose
 ```
 
@@ -158,23 +149,35 @@ clawdbot onboard
 # 选择 QQ Bot 进行交互式配置
 ```
 
-## 注意事项
+---
+
+## ⚠️ 注意事项
+
+- **群消息**：需要在群内 @机器人 才能触发回复
+- **沙箱模式**：新创建的机器人默认在沙箱模式，需要添加测试用户
 
-1. **群消息**：需要在群内 @机器人 才能触发回复
-2. **沙箱模式**：新创建的机器人默认在沙箱模式，需要添加测试用户
+---
+
+## 🔄 升级
+
+### npm 热更新
+
+```bash
+npx -y @sliverp/qqbot@1.3.7 upgrade
+```
 
-## 升级
+> 热更新后无需重新配置 AppId 和 AppSecret
 
-如果需要升级插件，先运行升级脚本清理旧版本：
+### 源码热更新
 
 ```bash
 git clone https://github.com/sliverp/qqbot.git && cd qqbot 
 
-# 运行升级脚本（清理旧版本和配置）
+# 运行升级脚本
 bash ./scripts/upgrade.sh
 
-# 重新安装插件
-clawdbot plugins install . # 这一步会有点久，需要安装一些依赖。稍微耐心等待一下，尤其是小内存机器
+# 重新安装
+clawdbot plugins install .
 
 # 重新配置
 clawdbot channels add --channel qqbot --token "AppID:AppSecret"
@@ -183,49 +186,82 @@ clawdbot channels add --channel qqbot --token "AppID:AppSecret"
 clawdbot gateway restart
 ```
 
-升级脚本会自动：
-- 删除 `~/.clawdbot/extensions/qqbot` 目录
-- 清理 `clawdbot.json` 中的 qqbot 相关配置
+升级脚本会自动清理旧版本和配置。
 
-## 开发
+---
 
-```bash
-# 安装依赖
-npm install
 
-# 编译
-npm run build
 
-# 监听模式
-npm run dev
-```
+---
 
-## 文件结构
+## 📚 版本历史
 
-```
-qqbot/
-├── index.ts          # 入口文件
-├── src/
-│   ├── api.ts        # QQ Bot API 封装
-│   ├── channel.ts    # Channel Plugin 定义
-│   ├── config.ts     # 配置解析
-│   ├── gateway.ts    # WebSocket 网关
-│   ├── onboarding.ts # CLI 配置向导
-│   ├── outbound.ts   # 出站消息处理
-│   ├── runtime.ts    # 运行时状态
-│   └── types.ts      # 类型定义
-├── scripts/
-│   └── upgrade.sh    # 升级脚本
-├── package.json
-└── tsconfig.json
-```
+<details>
+<summary><b>v1.4.0（即将更新）</b></summary>
+
+- 支持 Markdown 格式
+
+</details>
+
+<details>
+<summary><b>v1.3.0 - 2026.02.03</b></summary>
+
+- ✨ 支持图片收发等功能
+- ✨ 支持定时任务到时后主动推送
+- ✨ 支持使用 npm 等方式安装和升级
+- 🐛 优化一些已知问题
+
+</details>
+
+<details>
+<summary><b>v1.2.5 - 2026.02.02</b></summary>
+
+- ✨ 解除 URL 发送限制
+- ✨ 更新 Bot 正在输入中状态
+- ✨ 提供主动推送能力
+- 🐛 优化一些已知问题
+
+</details>
 
-## 相关链接
+<details>
+<summary><b>v1.2.2 - 2026.01.31</b></summary>
+
+- ✨ 支持发送文件
+- ✨ 支持 openclaw、moltbot 命令行
+- 🐛 修复 health 检查提示问题
+- 🐛 修复文件发送后 clawdbot 无法读取的问题
+
+</details>
+
+<details>
+<summary><b>v1.2.1</b></summary>
+
+- 🐛 解决长时间使用会断联的问题
+- 🐛 解决频繁重连的问题
+- ✨ 增加大模型调用失败后的提示消息
+
+</details>
+
+<details>
+<summary><b>v1.1.0</b></summary>
+
+- 🐛 解决 URL 被拦截的问题
+- 🐛 解决多轮消息发送失败的问题
+- 🐛 修复部分图片无法接收的问题
+- ✨ 增加支持 onboard 配置方式
+
+</details>
+
+---
+
+## 🔗 相关链接
 
 - [QQ 机器人官方文档](https://bot.q.qq.com/wiki/)
 - [QQ 开放平台](https://q.qq.com/)
 - [API v2 文档](https://bot.q.qq.com/wiki/develop/api-v2/)
 
-## License
+---
+
+## 📄 License
 
 MIT

package/bin/qqbot-cli.js

@@ -164,8 +164,8 @@ function upgrade() {
   }
 
   console.log('\n=== 升级完成 ===');
-  console.log(`\n可以运行以下命令启动机器人:`);
-  console.log(`  ${foundInstallation} gateway --verbose`);
+  console.log(`\n可以运行以下命令前台运行启动机器人:`);
+  console.log(`  ${foundInstallation} gateway  stop && ${foundInstallation} gateway --port 18789 --verbose`);
 }
 
 // 安装命令

package/dist/index.js

@@ -3,8 +3,8 @@ import { qqbotPlugin } from "./src/channel.js";
 import { setQQBotRuntime } from "./src/runtime.js";
 const plugin = {
     id: "qqbot",
-    name: "QQ Bot (Stream)",
-    description: "QQ Bot channel plugin with streaming message support",
+    name: "QQ Bot",
+    description: "QQ Bot channel plugin",
     configSchema: emptyPluginConfigSchema(),
     register(api) {
         setQQBotRuntime(api.runtime);

package/dist/src/channel.d.ts

@@ -1,3 +1,3 @@
-import type { ChannelPlugin } from "clawdbot/plugin-sdk";
+import { type ChannelPlugin } from "openclaw/plugin-sdk";
 import type { ResolvedQQBotAccount } from "./types.js";
 export declare const qqbotPlugin: ChannelPlugin<ResolvedQQBotAccount>;

package/dist/src/channel.js

@@ -1,8 +1,38 @@
-import { listQQBotAccountIds, resolveQQBotAccount, applyQQBotAccountConfig } from "./config.js";
-import { sendText } from "./outbound.js";
+import { applyAccountNameToChannelSection, deleteAccountFromConfigSection, setAccountEnabledInConfigSection, } from "openclaw/plugin-sdk";
+import { DEFAULT_ACCOUNT_ID, listQQBotAccountIds, resolveQQBotAccount, applyQQBotAccountConfig, resolveDefaultQQBotAccountId } from "./config.js";
+import { sendText, sendMedia } from "./outbound.js";
 import { startGateway } from "./gateway.js";
 import { qqbotOnboardingAdapter } from "./onboarding.js";
-const DEFAULT_ACCOUNT_ID = "default";
+import { getQQBotRuntime } from "./runtime.js";
+/**
+ * 简单的文本分块函数
+ * 用于预先分块长文本
+ */
+function chunkText(text, limit) {
+    if (text.length <= limit)
+        return [text];
+    const chunks = [];
+    let remaining = text;
+    while (remaining.length > 0) {
+        if (remaining.length <= limit) {
+            chunks.push(remaining);
+            break;
+        }
+        // 尝试在换行处分割
+        let splitAt = remaining.lastIndexOf("\n", limit);
+        if (splitAt <= 0 || splitAt < limit * 0.5) {
+            // 没找到合适的换行，尝试在空格处分割
+            splitAt = remaining.lastIndexOf(" ", limit);
+        }
+        if (splitAt <= 0 || splitAt < limit * 0.5) {
+            // 还是没找到，强制在 limit 处分割
+            splitAt = limit;
+        }
+        chunks.push(remaining.slice(0, splitAt));
+        remaining = remaining.slice(splitAt).trimStart();
+    }
+    return chunks;
+}
 export const qqbotPlugin = {
     id: "qqbot",
     meta: {
@@ -15,9 +45,14 @@ export const qqbotPlugin = {
     },
     capabilities: {
         chatTypes: ["direct", "group"],
-        media: false,
+        media: true,
         reactions: false,
         threads: false,
+        /**
+         * blockStreaming: true 表示该 Channel 支持块流式
+         * 框架会收集流式响应，然后通过 deliver 回调发送
+         */
+        blockStreaming: false,
     },
     reload: { configPrefixes: ["channels.qqbot"] },
     // CLI onboarding wizard
@@ -47,7 +82,22 @@ export const qqbotPlugin = {
     config: {
         listAccountIds: (cfg) => listQQBotAccountIds(cfg),
         resolveAccount: (cfg, accountId) => resolveQQBotAccount(cfg, accountId),
-        defaultAccountId: () => DEFAULT_ACCOUNT_ID,
+        defaultAccountId: (cfg) => resolveDefaultQQBotAccountId(cfg),
+        // 新增：设置账户启用状态
+        setAccountEnabled: ({ cfg, accountId, enabled }) => setAccountEnabledInConfigSection({
+            cfg,
+            sectionKey: "qqbot",
+            accountId,
+            enabled,
+            allowTopLevel: true,
+        }),
+        // 新增：删除账户
+        deleteAccount: ({ cfg, accountId }) => deleteAccountFromConfigSection({
+            cfg,
+            sectionKey: "qqbot",
+            accountId,
+            clearBaseFields: ["appId", "clientSecret", "clientSecretFile", "name"],
+        }),
         isConfigured: (account) => Boolean(account?.appId && account?.clientSecret),
         describeAccount: (account) => ({
             accountId: account?.accountId ?? DEFAULT_ACCOUNT_ID,
@@ -56,8 +106,30 @@ export const qqbotPlugin = {
             configured: Boolean(account?.appId && account?.clientSecret),
             tokenSource: account?.secretSource,
         }),
+        // 关键：解析 allowFrom 配置，用于命令授权
+        resolveAllowFrom: ({ cfg, accountId }) => {
+            const account = resolveQQBotAccount(cfg, accountId);
+            const allowFrom = account.config?.allowFrom ?? [];
+            console.log(`[qqbot] resolveAllowFrom: accountId=${accountId}, allowFrom=${JSON.stringify(allowFrom)}`);
+            return allowFrom.map((entry) => String(entry));
+        },
+        // 格式化 allowFrom 条目（移除 qqbot: 前缀，统一大写）
+        formatAllowFrom: ({ allowFrom }) => allowFrom
+            .map((entry) => String(entry).trim())
+            .filter(Boolean)
+            .map((entry) => entry.replace(/^qqbot:/i, ""))
+            .map((entry) => entry.toUpperCase()), // QQ openid 是大写的
     },
     setup: {
+        // 新增：规范化账户 ID
+        resolveAccountId: ({ accountId }) => accountId?.trim().toLowerCase() || DEFAULT_ACCOUNT_ID,
+        // 新增：应用账户名称
+        applyAccountName: ({ cfg, accountId, name }) => applyAccountNameToChannelSection({
+            cfg,
+            channelKey: "qqbot",
+            accountId,
+            name,
+        }),
         validateInput: ({ input }) => {
             if (!input.token && !input.tokenFile && !input.useEnv) {
                 return "QQBot requires --token (format: appId:clientSecret) or --use-env";
@@ -79,11 +151,14 @@ export const qqbotPlugin = {
                 clientSecret,
                 clientSecretFile: input.tokenFile,
                 name: input.name,
+                imageServerBaseUrl: input.imageServerBaseUrl,
             });
         },
     },
     outbound: {
         deliveryMode: "direct",
+        chunker: chunkText,
+        chunkerMode: "markdown",
         textChunkLimit: 2000,
         sendText: async ({ to, text, accountId, replyToId, cfg }) => {
             const account = resolveQQBotAccount(cfg, accountId);
@@ -94,6 +169,15 @@ export const qqbotPlugin = {
                 error: result.error ? new Error(result.error) : undefined,
             };
         },
+        sendMedia: async ({ to, text, mediaUrl, accountId, replyToId, cfg }) => {
+            const account = resolveQQBotAccount(cfg, accountId);
+            const result = await sendMedia({ to, text: text ?? "", mediaUrl: mediaUrl ?? "", accountId, replyToId, account });
+            return {
+                channel: "qqbot",
+                messageId: result.messageId,
+                error: result.error ? new Error(result.error) : undefined,
+            };
+        },
     },
     gateway: {
         startAccount: async (ctx) => {
@@ -122,6 +206,44 @@ export const qqbotPlugin = {
                 },
             });
         },
+        // 新增：登出账户（清除配置中的凭证）
+        logoutAccount: async ({ accountId, cfg }) => {
+            const nextCfg = { ...cfg };
+            const nextQQBot = cfg.channels?.qqbot ? { ...cfg.channels.qqbot } : undefined;
+            let cleared = false;
+            let changed = false;
+            if (nextQQBot) {
+                const qqbot = nextQQBot;
+                if (accountId === DEFAULT_ACCOUNT_ID && qqbot.clientSecret) {
+                    delete qqbot.clientSecret;
+                    cleared = true;
+                    changed = true;
+                }
+                const accounts = qqbot.accounts;
+                if (accounts && accountId in accounts) {
+                    const entry = accounts[accountId];
+                    if (entry && "clientSecret" in entry) {
+                        delete entry.clientSecret;
+                        cleared = true;
+                        changed = true;
+                    }
+                    if (entry && Object.keys(entry).length === 0) {
+                        delete accounts[accountId];
+                        changed = true;
+                    }
+                }
+            }
+            if (changed && nextQQBot) {
+                nextCfg.channels = { ...nextCfg.channels, qqbot: nextQQBot };
+                const runtime = getQQBotRuntime();
+                const configApi = runtime.config;
+                await configApi.writeConfigFile(nextCfg);
+            }
+            const resolved = resolveQQBotAccount(changed ? nextCfg : cfg, accountId);
+            const loggedOut = resolved.secretSource === "none";
+            const envToken = Boolean(process.env.QQBOT_CLIENT_SECRET);
+            return { ok: true, cleared, envToken, loggedOut };
+        },
     },
     status: {
         defaultRuntime: {
@@ -130,7 +252,18 @@ export const qqbotPlugin = {
             connected: false,
             lastConnectedAt: null,
             lastError: null,
+            lastInboundAt: null,
+            lastOutboundAt: null,
         },
+        // 新增：构建通道摘要
+        buildChannelSummary: ({ snapshot }) => ({
+            configured: snapshot.configured ?? false,
+            tokenSource: snapshot.tokenSource ?? "none",
+            running: snapshot.running ?? false,
+            connected: snapshot.connected ?? false,
+            lastConnectedAt: snapshot.lastConnectedAt ?? null,
+            lastError: snapshot.lastError ?? null,
+        }),
         buildAccountSnapshot: ({ account, runtime }) => ({
             accountId: account?.accountId ?? DEFAULT_ACCOUNT_ID,
             name: account?.name,
@@ -141,6 +274,8 @@ export const qqbotPlugin = {
             connected: runtime?.connected ?? false,
             lastConnectedAt: runtime?.lastConnectedAt ?? null,
             lastError: runtime?.lastError ?? null,
+            lastInboundAt: runtime?.lastInboundAt ?? null,
+            lastOutboundAt: runtime?.lastOutboundAt ?? null,
         }),
     },
 };

package/dist/src/config.js

@@ -104,11 +104,15 @@ export function resolveQQBotAccount(cfg, accountId) {
 export function applyQQBotAccountConfig(cfg, accountId, input) {
     const next = { ...cfg };
     if (accountId === DEFAULT_ACCOUNT_ID) {
+        // 如果没有设置过 allowFrom，默认设置为 ["*"]
+        const existingConfig = next.channels?.qqbot || {};
+        const allowFrom = existingConfig.allowFrom ?? ["*"];
         next.channels = {
             ...next.channels,
             qqbot: {
                 ...(next.channels?.qqbot || {}),
                 enabled: true,
+                allowFrom,
                 ...(input.appId ? { appId: input.appId } : {}),
                 ...(input.clientSecret
                     ? { clientSecret: input.clientSecret }
@@ -121,6 +125,9 @@ export function applyQQBotAccountConfig(cfg, accountId, input) {
         };
     }
     else {
+        // 如果没有设置过 allowFrom，默认设置为 ["*"]
+        const existingAccountConfig = next.channels?.qqbot?.accounts?.[accountId] || {};
+        const allowFrom = existingAccountConfig.allowFrom ?? ["*"];
         next.channels = {
             ...next.channels,
             qqbot: {
@@ -131,6 +138,7 @@ export function applyQQBotAccountConfig(cfg, accountId, input) {
                     [accountId]: {
                         ...(next.channels?.qqbot?.accounts?.[accountId] || {}),
                         enabled: true,
+                        allowFrom,
                         ...(input.appId ? { appId: input.appId } : {}),
                         ...(input.clientSecret
                             ? { clientSecret: input.clientSecret }

package/dist/src/gateway.d.ts

@@ -13,5 +13,6 @@ export interface GatewayContext {
 }
 /**
  * 启动 Gateway WebSocket 连接（带自动重连）
+ * 支持流式消息发送
  */
 export declare function startGateway(ctx: GatewayContext): Promise<void>;