@cxyhhhhh/openclaw-qqbot 2.0.0-dev.202607101321 → 2.0.0-dev.202607101541

package/openclaw.plugin.json

@@ -4,7 +4,7 @@
   "description": "QQ Bot channel plugin with message support, cron jobs, and proactive messaging",
   "channels": ["qqbot"],
   "extensions": ["./preload.cjs"],
-  "skills": ["skills/qqbot-channel", "skills/qqbot-remind", "skills/qqbot-upgrade"],
+  "skills": ["skills/qqbot-channel", "skills/qqbot-group", "skills/qqbot-remind", "skills/qqbot-upgrade"],
   "contracts": {
     "tools": ["qqbot_platform_api", "qqbot_remind"]
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cxyhhhhh/openclaw-qqbot",
-  "version": "2.0.0-dev.202607101321",
+  "version": "2.0.0-dev.202607101541",
   "description": "QQ Bot channel plugin for OpenClaw",
   "publishConfig": {
     "access": "public"
@@ -42,7 +42,7 @@
   },
   "dependencies": {
     "@tencent-connect/qqbot-connector": "1.2.0",
-    "@tencent-connect/qqbot-nodejs": "npm:@cxyhhhhh/qqbot-nodejs@1.0.2-dev.202607101142"
+    "@tencent-connect/qqbot-nodejs": "npm:@cxyhhhhh/qqbot-nodejs@1.0.2-dev.202607101530"
   },
   "devDependencies": {
     "@types/node": "^20.19.43",

package/skills/qqbot-group/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: qqbot-group
+description: QQ 群管理技能。查询群基础信息、群成员信息、机器人群内状态。使用 qqbot_platform_api 工具调用接口，自动鉴权。当用户需要查询群信息、查看群成员、检查机器人群内状态时使用此技能。
+metadata: {"openclaw":{"emoji":"👥","requires":{"config":["channels.qqbot"]}}}
+---
+
+# QQ 群 API 请求指导
+
+通过 `qqbot_platform_api` 工具调用群相关接口，鉴权由工具自动处理。
+
+详细字段说明见 `references/api_reference.md`。
+
+---
+
+## ⭐ 接口速查
+
+| 操作 | 方法 | 路径 |
+|------|------|------|
+| 获取机器人群内状态 | `GET` | `/v2/groups/{group_id}/bot_state` |
+| 获取群成员信息 | `GET` | `/v2/groups/{group_id}/members/{member_id}` |
+| 获取群基础信息 | `GET` | `/v2/groups/{group_id}/info` |
+
+---
+
+## 💡 调用示例
+
+### 获取机器人群内状态
+
+```json
+{
+  "method": "GET",
+  "path": "/v2/groups/G_123456789/bot_state"
+}
+```
+
+返回字段：`joined_at`（入群时间）、`allow_proactive_msg`（是否允许主动推送）、`recv_msg_setting`（`all`/`only_mention`/`mention_and_context`）、`member_role`（`member`/`owner`/`admin`）。
+
+### 获取群成员信息
+
+```json
+{
+  "method": "GET",
+  "path": "/v2/groups/G_123456789/members/o_xxxxxxxx"
+}
+```
+
+返回字段：`username`（昵称）、`member_role`、`joined_at`、`bot` 等。昵称仅在单个查询时返回。
+
+### 获取群基础信息
+
+```json
+{
+  "method": "GET",
+  "path": "/v2/groups/G_123456789/info"
+}
+```
+
+返回字段：`group_name`、`group_finger_memo`（简介）、`group_class_text`（分类）、`group_tags`（标签）、`group_member_num`（成员数）。
+
+---
+
+## 💬 @群成员
+
+发送消息时使用 `<@member_id>` 语法 @指定群成员：
+
+- 格式：`<@member_id>`，例如 `<@o_xxxxxxxx>`
+- 文本消息中直接拼接即可：`你好 <@o_xxxxxxxx>，欢迎入群！`
+
+---
+
+## ⚠️ 注意事项
+
+1. 路径占位符 `{group_id}`、`{member_id}` 需替换为实际值
+2. 返回时间格式为 RFC3339（如 `2026-06-23T22:03:09+08:00`）
+3. 群 openid 与频道 guild_id 是不同的概念，不要混淆

package/skills/qqbot-group/references/api_reference.md

@@ -0,0 +1,94 @@
+# QQ 开放平台群接口参考
+
+> 鉴权和请求头由 `qqbot_platform_api` 工具自动处理，无需手动管理。
+
+---
+
+## 接口列表
+
+### 1. 获取机器人群内状态
+
+- 方法：`GET`
+- 路径：`/v2/groups/{group_id}/bot_state`
+
+响应参数：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| joined_at | string | 入群时间（RFC3339 格式） |
+| allow_proactive_msg | bool | 是否允许主动消息推送 |
+| recv_msg_setting | string | 接收消息设置：`all`、`only_mention`、`mention_and_context` |
+| member_role | string | 群成员角色：`member`、`owner`、`admin` |
+
+响应示例：
+
+```json
+{
+  "join_timestamp": "2026-06-23T22:03:09+08:00",
+  "allow_proactive_msg": true,
+  "recv_msg_setting": "all",
+  "member_role": "admin"
+}
+```
+
+---
+
+### 2. 获取群成员信息
+
+- 方法：`GET`
+- 路径：`/v2/groups/{group_id}/members/{member_id}`
+
+响应参数：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| union_openid | string | 用户在应用/开放平台下的统一标识 |
+| user_openid | string | 用户 openid |
+| username | string | 用户昵称（仅单个查询时返回） |
+| member_role | string | 群成员角色：`member`、`owner`、`admin` |
+| joined_at | string | 入群时间（RFC3339 格式） |
+| bot | bool | 是否为机器人账号 |
+
+响应示例：
+
+```json
+{
+  "union_openid": "u_xxxxxxxx",
+  "user_openid": "o_xxxxxxxx",
+  "username": "张三",
+  "member_role": "member",
+  "joined_at": "2026-06-23T22:03:09+08:00",
+  "bot": false
+}
+```
+
+---
+
+### 3. 获取群基础信息
+
+- 方法：`GET`
+- 路径：`/v2/groups/{group_id}/info`
+
+响应参数：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| group_openid | string | 群 openid |
+| group_name | string | 群名称 |
+| group_finger_memo | string | 群简介/群公告 |
+| group_class_text | string | 群分类文案 |
+| group_tags | array[] | 群标签列表 |
+| group_member_num | int | 群成员数量 |
+
+响应示例：
+
+```json
+{
+  "group_openid": "G_123456789",
+  "group_name": "技术交流群",
+  "group_finger_memo": "专注于后端技术开发交流",
+  "group_class_text": "技术-后端开发",
+  "group_tags": ["技术交流", "后端开发", "QQ机器人"],
+  "group_member_num": 1250
+}
+```

package/src/dispatch/body-assembler.ts

@@ -298,8 +298,8 @@ function buildAgentBody(input: {
 }): string {
   const { userContent, base, isGroup, wasMentioned, history } = input;
 
-  // 斜杠命令直通：去除一切装饰
-  if (userContent.startsWith('/')) {
+  // 斜杠命令直通：去除一切装饰及首尾空白
+  if (userContent.trim().startsWith('/')) {
     return userContent;
   }
 

package/src/gateway/middleware-setup.ts

@@ -27,6 +27,7 @@ import { getPersistedRefIndexStore } from '../features/ref-index-store.js';
 import { createPolicyInjector } from '../middleware/policy-injector.js';
 import { getHistoryStore, historyGroupKey } from '../features/history-store.js';
 import { dynamicAccessControl } from '../middleware/access-control.js';
+import { stripMentionText } from '../utils/mention.js';
 
 export interface MiddlewareSetupOptions {
   /** 获取 runtime */
@@ -66,14 +67,23 @@ export function setupMiddlewares(bot: QQBot, account: ResolvedQQBotAccount, opts
 
   // 6. 群聊 @bot 门控（从 ctx.state.policy.group 读取动态配置）
   bot.use(mentionGate());
-
   // 7. 内容清洗（去 @marker、表情标签、多余空白）
-  bot.use(contentSanitizer({ parseFaceTags: true }));
+  // SDK 用 appId 匹配 @标记，但 QQ openid 不等于 appId，追加 stripMentionText 正确剥离
+  bot.use(contentSanitizer({
+    parseFaceTags: true,
+    transform: (content, ctx) => stripMentionText(content, (ctx.message as any).mentions),
+  }));
 
   // 8. 三层限流（sender / group / global）
   bot.use(rateLimiter());
 
-  // 9. 并发串行+合并（在副作用中间件之前）
+  // 9. 斜杠命令（在并发锁之前，命令匹配后直接 reply + stop，不排队）
+  //    依赖：ctx.state.policy（policyInjector, #3）、ctx.message.*（原始消息）
+  //    注意：/stop 是框架级命令，不在 qqbot 命令列表中，仍由 urgentPredicate 处理
+  const slash = slashCommand({ commands: buildCommandList(account, { getRuntime: opts.getRuntime }) });
+  bot.use(slash.middleware);
+
+  // 10. 并发串行+合并（在副作用中间件之前）
   //     - 同 peer 串行处理，避免平台 session conflict
   //     - 处理中消息暂存 buffer；完成后合并为一条，继续走完剩余中间件链
   //       （typingIndicator/quoteRef/attachmentProcessor/... 直到 bot.on("message")）
@@ -107,18 +117,18 @@ export function setupMiddlewares(bot: QQBot, account: ResolvedQQBotAccount, opts
     },
   }));
 
-  // 10. C2C 输入状态指示器
+  // 11. C2C 输入状态指示器
   bot.use(typingIndicator());
 
-  // 11. 引用消息解析（默认优先 msg_elements 获取文件名等丰富信息）
+  // 12. 引用消息解析（默认优先 msg_elements 获取文件名等丰富信息）
   bot.use(quoteRef({
     store: getPersistedRefIndexStore(account.accountId),
   }));
 
-  // 12. 附件处理（语音 STT 转录 + 图片/文件下载）
+  // 13. 附件处理（语音 STT 转录 + 图片/文件下载）
   bot.use(attachmentProcessor({ getRuntime: opts.getRuntime }));
 
-  // 13. 上下文组装（构建框架规约的 body）
+  // 14. 上下文组装（构建框架规约的 body）
   bot.use(envelopeFormatter({
     format: (ctx) => {
       const assembled = assembleBody(ctx, ctx.message as never, account, opts.getRuntime);
@@ -126,8 +136,4 @@ export function setupMiddlewares(bot: QQBot, account: ResolvedQQBotAccount, opts
       return assembled.agentBody;
     },
   }));
-
-  // 14. 斜杠命令（命令被匹配后直接回复，不再向下传递）
-  const slash = slashCommand({ commands: buildCommandList(account, { getRuntime: opts.getRuntime }) });
-  bot.use(slash.middleware);
 }