@tencent-connect/openclaw-qqbot 1.7.0 → 1.7.2

package/README.md

@@ -10,7 +10,7 @@
 
 **Connect your AI assistant to QQ — private chat, group chat, and rich media, all in one plugin.**
 
-### 🚀 Current Version: `v1.7.0`
+### 🚀 Current Version: `v1.7.1`
 
 [![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/)
@@ -36,7 +36,9 @@ Scan to join the QQ group chat
 
 | Feature | Description |
 |---------|-------------|
-| 🔒 **Multi-Scene** | C2C private chat, group @messages |
+| 🔒 **Multi-Scene** | C2C private chat, group chat (@mention / autonomous dual mode) |
+| 👥 **Group Fine-Tuning** | Per-group @trigger rules, tool policies, custom prompts, message filtering |
+| 🌐 **Dual Transport** | WebSocket (default) or Webhook (HTTP callback) — switch via config |
 | 🖼️ **Rich Media** | Send & receive images, voice, video, and files |
 | 🎙️ **Voice (STT/TTS)** | Speech-to-text transcription & text-to-speech replies |
 | 🔥 **One-Click Hot Upgrade** | Send `/bot-upgrade` in private chat to upgrade — no server login needed |
@@ -47,45 +49,7 @@ Scan to join the QQ group chat
 | 🛠️ **Commands** | Native OpenClaw command integration |
 | 💬 **Quoted Context** | Parses the original message a user is replying to and injects it into AI context, so the model always knows exactly which message is being referenced |
 | 📦 **Large File Support** | Auto chunked upload for large files (parallel upload with retry), up to 100 MB |
-
----
-
-## 🆚 Standalone Plugin vs OpenClaw Built-in: Which to Choose?
-
-Starting from **OpenClaw 2026.3.31**, a QQBot plugin is bundled with OpenClaw. The two plugins **cannot run at the same time** — choose one based on your needs.
-
-| Feature | This Plugin (Standalone) | OpenClaw Built-in |
-|---------|:------------------------:|:-----------------:|
-| 🔒 Multi-scene (C2C / Group) | ✅ | ✅ |
-| 🖼️ Rich media (image / voice / video / file) | ✅ | ✅ |
-| 🎙️ Voice STT / TTS | ✅ | ✅ |
-| 🔥 One-click hot upgrade (`/bot-upgrade`) | ✅ | ❌ |
-| ⏰ Scheduled push (proactive messages) | ✅ | ✅ |
-| 🔗 URL support | ✅ | ✅ |
-| ⌨️ Typing indicator | ✅ | ✅ |
-| 📝 Markdown | ✅ | ✅ |
-| 🛠️ Slash commands / native commands | ✅ | ✅ |
-| 💬 Quoted context (injected into AI) | ✅ | ✅ |
-| 📦 Large file support (up to 100MB) | ✅ | ❌ |
-| Installation | Requires separate install | Bundled, zero setup |
-| Update cadence | Independent releases, faster iteration | Ships with OpenClaw |
-
-### Which should I pick?
-
-**Choose the OpenClaw built-in plugin if you:**
-
-- Want zero-setup out of the box
-- Are just getting started and want to try QQ Bot quickly
-
-**Choose this plugin (standalone) if you:**
-
-- Want faster feature iteration and more capabilities
-
-> ⚠️ Both plugins cannot run simultaneously. If you've upgraded to OpenClaw 2026.3.31+, run the following command to install this plugin — the built-in version will be disabled automatically:
-> ```bash
-> curl -fsSL https://raw.githubusercontent.com/tencent-connect/openclaw-qqbot/main/scripts/upgrade-via-npm.sh | bash
-> ```
-> After upgrading, you'll unlock large file transfers, message reference context, and all other advanced features.
+| 🔐 **Command Execution Approval** | AI requests approval via Inline Keyboard buttons before executing commands — tap to allow or deny |
 
 ---
 
@@ -93,13 +57,9 @@ Starting from **OpenClaw 2026.3.31**, a QQBot plugin is bundled with OpenClaw. T
 
 > **Note:** This plugin serves as a **message channel** only — it relays messages between QQ and OpenClaw. Capabilities like image understanding, voice transcription, drawing, etc. depend on the **AI model** you configure and the **skills** installed in OpenClaw, not on this plugin itself.
 
-### 💬 Quoted Message Context (REFIDX)
+### 💬 Quoted Message Context
 
-QQ quote events carry index keys (e.g. `REFIDX_xxx`) instead of full original message body. The plugin now resolves these indices from a local persistent store and injects quote context into AI input, so replies better understand “which message is being quoted”.
-
-- Inbound and outbound messages with `ref_idx` are automatically indexed.
-- Store path: `~/.openclaw/qqbot/data/ref-index.jsonl` (survives gateway restart).
-- Quote body may include text + media summary (image/voice/video/file).
+When a user quotes a message in QQ, the plugin automatically parses the quoted message content and injects it into the AI context, so the model clearly knows "which message the user is replying to" and gives more accurate responses. Supports text and media messages (image/voice/video/file), and works across devices.
 
 <img width="360" src="docs/images/ref-msg.png" alt="Quoted Message Context Demo" />
 
@@ -177,6 +137,14 @@ Since v1.6.6, large file transfer is supported: images up to 20MB, videos up to
 
 <img width="360" src="docs/images/large-file-transfer.jpg" alt="Large File Transfer Demo" />
 
+### 🔐 Command Execution Approval
+
+When the AI needs to execute a command, the plugin sends an approval request via QQ message with interactive buttons — tap **✅ Allow Once**, **⭐ Always Allow**, or **❌ Deny** to control whether the command runs. 
+
+Use the `/bot-approve` command to manage the approval mode (allowlist / off / strict).
+
+<img width="360" src="docs/images/approve.png" alt="Command Execution Approval Demo" />
+
 ### 🎬 Video Sending
 
 > **You**: Send me a demo video
@@ -256,10 +224,42 @@ All commands support a `?` suffix to show usage:
 >
 > **QQBot**: 📖 /bot-upgrade usage: …
 
+#### `/bot-approve` — Approval Configuration
+
+> **You**: `/bot-approve`
+>
+> **QQBot**: 🔐 Command Execution Approval — Enable / Disable / Strict mode / Reset / View current config
+
+Manage the AI command execution approval policy. Supported subcommands:
+
+| Subcommand | Description |
+|------------|-------------|
+| `/bot-approve on` | Enable approval (allowlist mode, recommended) |
+| `/bot-approve off` | Disable approval — commands execute directly |
+| `/bot-approve always` | Strict mode — every execution requires approval |
+| `/bot-approve reset` | Restore framework defaults |
+| `/bot-approve status` | View current approval config |
+
 #### `/bot-clear-storage` — Clear files generated through QQBot conversations and downloaded resources (stored on the host running OpenClaw)
 
 `/bot-clear-storage` lists files generated by the conversation and files in the downloaded resources directory. Use `/bot-clear-storage --force` to confirm deletion.
 
+#### `/bot-group-allways` — Group Response Mode Toggle
+
+> **You**: `/bot-group-allways`
+>
+> **QQBot**: 🤖 Group autonomous mode: ❌ @mention required
+
+Toggle group @trigger behavior at runtime — changes persist instantly, no restart needed:
+
+| Subcommand | Description |
+|------------|-------------|
+| `/bot-group-allways on` | AI decides when to speak autonomously (no @ needed) |
+| `/bot-group-allways off` | Only respond when @mentioned |
+| `/bot-group-allways` (no arg) | View current setting |
+
+> ⚠️ This command modifies the account-level `defaultRequireMention`. It has lower priority than per-group `groups.{groupId}.requireMention` settings.
+
 ---
 
 ## 🚀 Getting Started
@@ -426,13 +426,180 @@ openclaw message send --channel "qqbot" \
 
 #### How It Works
 
-- When `openclaw gateway` starts, all accounts with `enabled: true` launch their own WebSocket connections
+- When `openclaw gateway` starts, all accounts with `enabled: true` launch their own connections (WebSocket or Webhook depending on `transport` config)
 - Each account maintains an independent Token cache (isolated by `appId`), preventing cross-contamination
 - Incoming message logs are prefixed with `[qqbot:accountId]` for easy debugging
 
 ---
 
-### Voice Configuration (STT / TTS)
+### Webhook Transport Mode
+
+By default, the plugin connects to QQ via **WebSocket** (outbound connection, no public IP required). You can switch to **Webhook** mode where QQ platform POSTs events to your HTTP endpoint.
+
+| | WebSocket (default) | Webhook |
+|---|---|---|
+| Connection | Plugin connects to QQ gateway | QQ platform POSTs to your server |
+| Public IP | Not required | Required |
+| Use case | Development, single instance | Production, horizontal scaling, Serverless |
+| Session resume | Supported (RESUME) | Stateless, no resume needed |
+| Signature | Built-in | Ed25519 auto-verified by plugin |
+
+#### Configuration
+
+```json
+{
+  "channels": {
+    "qqbot": {
+      "appId": "111111111",
+      "clientSecret": "your-secret",
+      "transport": "webhook",
+      "webhook": {
+        "path": "/qqbot/webhook"
+      }
+    }
+  }
+}
+```
+
+| Field | Default | Description |
+|-------|---------|-------------|
+| `transport` | `"websocket"` | `"websocket"` or `"webhook"` |
+| `webhook.path` | `"/qqbot/webhook"` | HTTP path for receiving callbacks |
+
+#### Platform Setup
+
+1. Go to [QQ Open Platform](https://q.qq.com/) → Bot Settings → Message Receiving
+2. Select **HTTP Callback**
+3. Enter your callback URL: `https://your-domain.com/qqbot/webhook`
+4. The platform sends an `op:13` validation request — the plugin handles it automatically
+5. Once validated, all events will be POSTed to your endpoint
+
+---
+
+### Group Chat Configuration
+
+The plugin provides flexible group chat controls, allowing you to customize trigger rules, tool permissions, and AI behavior per group.
+
+#### @Mention Trigger Mode (`requireMention`)
+
+By default, the bot **only responds when @mentioned** in a group. You can configure it to autonomously decide when to speak:
+
+| Mode | Config Value | Behavior |
+|------|-------------|----------|
+| **@ only** | `true` (default) | Only messages that @mention the bot trigger a reply |
+| **Autonomous** | `false` | AI decides on its own whether each message needs a reply — no @ required |
+
+**Priority chain** (highest to lowest):
+
+```
+groups.{groupOpenid}.requireMention
+  > groups."*".requireMention
+    > account-level defaultRequireMention
+      > default value true
+```
+
+**Example:**
+
+```json
+{
+  "channels": {
+    "qqbot": {
+      // Account-level default for all groups
+      "defaultRequireMention": false,
+
+      "accounts": {
+        "default": {
+          "groups": {
+            "*": {
+              // Wildcard fallback for all groups
+              "requireMention": false
+            },
+            "GROUP_OPENID": {
+              // Per-group override — this group still requires @
+              "requireMention": true
+            }
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+> **Use cases:**
+>
+> - Work groups → `requireMention: true` — avoid AI chiming in on every casual message
+> - Dedicated AI companion groups → `requireMention: false` — participate naturally like a real person
+> - Use [`/bot-group-allways`](#bot-group-allways--group-response-mode-toggle) to toggle account-level defaults at runtime
+
+#### Additional Group Config Fields
+
+Besides `requireMention`, each group supports these settings:
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `ignoreOtherMentions` | `boolean` | `false` | If enabled, messages that @mention others but not the bot are silently dropped (not recorded, no AI trigger) |
+| `toolPolicy` | `"full" \| "restricted" \| "none"` | `"restricted"` | Tool scope available to AI in this group. `full`=all tools; `restricted`=sensitive tools restricted (e.g., command execution, file ops); `none`=no tool calls allowed |
+| `prompt` | `string` | built-in default | Group-specific system prompt, appended after global systemPrompt |
+| `historyLimit` | `number` | `50` | Cached group history message count |
+
+**Full example with multiple groups:**
+
+```json
+{
+  "channels": {
+    "qqbot": {
+      "defaultRequireMention": false,
+      "accounts": {
+        "default": {
+          "groups": {
+            "*": {
+              "requireMention": true,
+              "toolPolicy": "restricted",
+              "ignoreOtherMentions": true
+            },
+            "WORK_GROUP_OPENID": {
+              "requireMention": true,
+              "toolPolicy": "none",
+              "prompt": "You are a work assistant. Only answer work-related questions."
+            },
+            "FRIEND_GROUP_OPENID": {
+              "requireMention": false,
+              "toolPolicy": "full",
+              "prompt": "You are a friend in the group. Chat casually and naturally."
+            }
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+#### Group Access Control (`groupPolicy`)
+
+Control which groups are allowed via `groupPolicy`:
+
+| Policy | Description |
+|--------|-------------|
+| `"open"` (default) | All groups are allowed |
+| `"allowlist"` | Only groups in `groupAllowFrom` are allowed |
+| `"disabled"` | Group chats are disabled entirely |
+
+```json
+{
+  "channels": {
+    "qqbot": {
+      "groupPolicy": "allowlist",
+      "groupAllowFrom": ["ALLOWED_GROUP_OPENID_1", "ALLOWED_GROUP_OPENID_2"]
+    }
+  }
+}
+```
+
+> You can also use [**`/bot-group-allways`**](#bot-group-allways--group-response-mode-toggle) to toggle account-level defaults at runtime without restarting.
+
+---
 
 #### STT (Speech-to-Text) — Transcribe Incoming Voice Messages
 

package/README.zh.md

@@ -9,7 +9,7 @@
 
 **让你的 AI 助手接入 QQ — 私聊、群聊、富媒体，一个插件全搞定。**
 
-### 🚀 当前版本： `v1.7.0`
+### 🚀 当前版本： `v1.7.1`
 
 [![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/)
@@ -31,7 +31,9 @@
 
 | 功能 | 说明 |
 |------|------|
-| 🔒 **多场景支持** | C2C 私聊、群聊 @消息 |
+| 🔒 **多场景支持** | C2C 私聊、群聊（@提及 / 自主发言双模式） |
+| 👥 **群聊精细管控** | 按群配置 @触发规则、工具权限、自定义提示词、消息过滤 |
+| 🌐 **双传输模式** | WebSocket（默认）或 Webhook（HTTP 回调）— 配置切换 |
 | 🖼️ **富媒体消息** | 支持图片、语音、视频、文件的收发 |
 | 🎙️ **语音能力 (STT/TTS)** | 语音转文字自动转录 & 文字转语音回复 |
 | 🔥 **一键热更新** | 私聊发送 `/bot-upgrade` 即可完成版本升级，无需登录服务器 |
@@ -42,6 +44,7 @@
 | 🛠️ **原生命令** | 支持 OpenClaw 原生命令 |
 | 💬 **引用上下文** | 解析用户回复的原始消息内容，注入 AI 上下文，让模型准确理解"在回复哪条消息" |
 | 📦 **大文件支持** | 大文件自动分片并行上传，最大支持 100 MB |
+| 🔐 **命令执行审批** | AI 执行命令前通过按钮消息请求审批，点击即可允许或拒绝 |
 
 ---
 
@@ -129,6 +132,14 @@ v1.6.6 起支持大文件传输：图片最大 20MB，视频最大 30MB，附件
 
 <img width="360" src="docs/images/large-file-transfer.jpg" alt="大文件传输演示" />
 
+### 🔐 命令执行审批
+
+当 AI 需要执行命令时，插件会通过 QQ 消息发送带按钮的审批请求，你可以点击 **✅ 允许一次**、**⭐ 始终允许** 或 **❌ 拒绝** 来控制命令是否执行。
+
+通过 `/bot-approve` 指令可以管理审批模式（白名单 / 关闭 / 严格模式）。
+
+<img width="360" src="docs/images/approve.png" alt="命令执行审批演示" />
+
 ### 🎬 视频发送
 
 > **你**：发一个演示视频给我
@@ -208,10 +219,44 @@ AI 可直接发送视频，支持本地文件和公网 URL。
 >
 > **QQBot**：📖 /bot-upgrade 用法：…
 
+#### `/bot-approve` — 审批配置管理
+
+> **你**：`/bot-approve`
+>
+> **QQBot**：🔐 命令执行审批配置 — 开启审批 / 关闭审批 / 严格模式 / 恢复默认 / 查看当前配置
+
+管理 AI 命令执行审批策略，支持以下子命令：
+
+| 子命令 | 说明 |
+|--------|------|
+| `/bot-approve on` | 开启审批（白名单模式，推荐） |
+| `/bot-approve off` | 关闭审批，命令直接执行 |
+| `/bot-approve always` | 严格模式，每次执行都需审批 |
+| `/bot-approve reset` | 恢复框架默认值 |
+| `/bot-approve status` | 查看当前审批配置 |
+
 #### `/bot-clear-storage` — 清理通过 QQBot 对话产生的文件以及下载的资源（保存在 OpenClaw 运行环境的主机上）
 
 `/bot-clear-storage` 列出对话产生的文件以及下载的资源目录里的文件，使用`/bot-clear-storage -- force`确定删除。
 
+#### `/bot-group-allways` — 群消息响应模式切换
+
+> **你**：`/bot-group-allways`
+>
+> **QQBot**：🤖 群自主发言状态：❌ 仅被 @ 时回复
+
+运行时动态切换群聊默认 @触发行为，修改即时持久化，无需重启：
+
+| 子命令 | 说明 |
+|--------|------|
+| `/bot-group-allways on` | AI 自主判断何时发言（无需 @） |
+| `/bot-group-allways off` | 仅在被 @ 时回复 |
+| `/bot-group-allways`（无参数） | 查看当前设置 |
+
+> ⚠️ 此指令修改账户级 `defaultRequireMention`，优先级低于具体群的 `groups.{groupId}.requireMention` 配置。
+
+---
+
 ---
 
 ## 🚀 快速开始
@@ -378,13 +423,180 @@ openclaw message send --channel "qqbot" \
 
 #### 工作原理
 
-- 启动 `openclaw gateway` 后，所有 `enabled: true` 的账户会同时启动 WebSocket 连接
+- 启动 `openclaw gateway` 后，所有 `enabled: true` 的账户会同时启动连接（WebSocket 或 Webhook，取决于 `transport` 配置）
 - 每个账户独立维护 Token 缓存（基于 `appId` 隔离），互不干扰
 - 接收消息时，日志会带上 `[qqbot:accountId]` 前缀方便排查
 
 ---
 
-### 语音能力配置（STT / TTS）
+### Webhook 传输模式
+
+默认情况下，插件通过 **WebSocket** 连接 QQ 平台（出站连接，无需公网 IP）。你也可以切换为 **Webhook** 模式，由 QQ 平台主动 POST 事件到你的 HTTP 端点。
+
+| | WebSocket（默认） | Webhook |
+|---|---|---|
+| 连接方式 | 插件主动连接 QQ 网关 | QQ 平台 POST 到你的服务器 |
+| 公网 IP | 不需要 | 需要 |
+| 适用场景 | 开发调试、单实例部署 | 生产环境、水平扩展、Serverless |
+| 会话恢复 | 支持 RESUME | 无状态，无需恢复 |
+| 签名验证 | 平台内置 | 插件自动 Ed25519 验签 |
+
+#### 配置方式
+
+```json
+{
+  "channels": {
+    "qqbot": {
+      "appId": "111111111",
+      "clientSecret": "your-secret",
+      "transport": "webhook",
+      "webhook": {
+        "path": "/qqbot/webhook"
+      }
+    }
+  }
+}
+```
+
+| 字段 | 默认值 | 说明 |
+|------|--------|------|
+| `transport` | `"websocket"` | `"websocket"` 或 `"webhook"` |
+| `webhook.path` | `"/qqbot/webhook"` | 接收回调的 HTTP 路径 |
+
+#### 平台配置步骤
+
+1. 登录 [QQ 开放平台](https://q.qq.com/) → 开发设置 → 消息接收方式
+2. 选择 **HTTP 回调**
+3. 填写回调 URL：`https://your-domain.com/qqbot/webhook`
+4. 平台发送 `op:13` 验证请求，插件自动处理签名验证
+5. 验证通过后，所有事件将以 POST 方式推送到该地址
+
+---
+
+### 群聊配置
+
+插件提供灵活的群聊管控能力，支持按群定制触发规则、工具权限和 AI 行为策略。
+
+#### @提及触发模式（requireMention）
+
+默认情况下，群聊中**必须 @机器人**才会触发 AI 回复。你可以通过配置让 AI 自主判断是否需要发言：
+
+| 模式 | 配置值 | 行为 |
+|------|--------|------|
+| **仅 @时回复** | `true`（默认） | 群消息中只有 @了机器人才会触发回复 |
+| **自主发言** | `false` | AI 自主判断每条消息是否需要回复，无需 @ |
+
+**优先级链**（从高到低）：
+
+```
+具体群 groups.{groupOpenid}.requireMention
+  > 通配符 groups."*".requireMention
+    > 账户级 defaultRequireMention
+      > 默认值 true
+```
+
+**配置示例：**
+
+```json
+{
+  "channels": {
+    "qqbot": {
+      // 账户级：所有群的默认行为
+      "defaultRequireMention": false,
+
+      "accounts": {
+        "default": {
+          "groups": {
+            "*": {
+              // 通配符：所有群的兜底规则
+              "requireMention": false
+            },
+            "GROUP_OPENID": {
+              // 单群覆盖：这个群仍然需要 @
+              "requireMention": true
+            }
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+> **使用场景举例：**
+>
+> - 工作群设为 `requireMention: true` — 避免 AI 对每条闲聊都插嘴
+> - 专属 AI 陪伴群设为 `requireMention: false` — 像真人一样自然参与对话
+> - 通过 `/bot-group-allways on|off` 指令可在运行时动态切换账户级默认值
+
+#### 其他群配置项
+
+除 `requireMention` 外，每个群还支持以下配置：
+
+| 字段 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `ignoreOtherMentions` | `boolean` | `false` | 是否忽略 @了其他人但没 @机器人的消息。开启后这类消息直接丢弃，不记录历史、不触发 AI |
+| `toolPolicy` | `"full" \| "restricted" \| "none"` | `"restricted"` | 群聊中 AI 可使用的工具范围。`full`=全部可用；`restricted`=限制敏感工具（如命令执行、文件操作）；`none`=禁止所有工具调用 |
+| `prompt` | `string` | 内置默认提示词 | 该群专属的系统提示词，会追加到全局 systemPrompt 之后 |
+| `historyLimit` | `number` | `50` | 群历史消息缓存条数 |
+
+**完整群配置示例：**
+
+```json
+{
+  "channels": {
+    "qqbot": {
+      "defaultRequireMention": false,
+      "accounts": {
+        "default": {
+          "groups": {
+            "*": {
+              "requireMention": true,
+              "toolPolicy": "restricted",
+              "ignoreOtherMentions": true
+            },
+            "WORK_GROUP_OPENID": {
+              "requireMention": true,
+              "toolPolicy": "none",
+              "prompt": "你是工作助手，只回答与工作相关的问题"
+            },
+            "FRIEND_GROUP_OPENID": {
+              "requireMention": false,
+              "toolPolicy": "full",
+              "prompt": "你是群里的朋友，轻松随意地聊天"
+            }
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+#### 群访问控制（groupPolicy）
+
+通过 `groupPolicy` 控制哪些群允许机器人加入并接收消息：
+
+| 策略 | 说明 |
+|------|------|
+| `"open"`（默认） | 所有群均可使用 |
+| `"allowlist"` | 仅 `groupAllowFrom` 白名单中的群可使用 |
+| `"disabled"` | 禁止所有群聊 |
+
+```json
+{
+  "channels": {
+    "qqbot": {
+      "groupPolicy": "allowlist",
+      "groupAllowFrom": ["ALLOWED_GROUP_OPENID_1", "ALLOWED_GROUP_OPENID_2"]
+    }
+  }
+}
+```
+
+> 也可通过 [**`/bot-group-allways`** 指令](#bot-group-allways--群消息响应模式切换) 在运行时动态切换账户级默认值，无需重启。
+
+---
 
 #### STT（语音转文字）— 自动转录用户发来的语音消息
 

package/dist/index.d.ts

@@ -15,3 +15,4 @@ export * from "./src/api.js";
 export * from "./src/config.js";
 export * from "./src/gateway.js";
 export * from "./src/outbound.js";
+export * from "./src/transport/index.js";

package/dist/index.js

@@ -24,3 +24,4 @@ export * from "./src/api.js";
 export * from "./src/config.js";
 export * from "./src/gateway.js";
 export * from "./src/outbound.js";
+export * from "./src/transport/index.js";

package/dist/src/api.d.ts

@@ -27,6 +27,8 @@ export declare class ApiError extends Error {
     /** 回包中的原始 message 字段（用于向用户展示兜底文案） */
     bizMessage?: string | undefined);
 }
+export declare const API_BASE: string;
+export declare const TOKEN_URL: string;
 /** 由 setQQBotRuntime 调用，将 api.runtime.version 注入到 User-Agent */
 export declare function setOpenClawVersion(version: string): void;
 export declare function getPluginUserAgent(): string;
@@ -132,6 +134,10 @@ export declare function sendDmMessage(accessToken: string, guildId: string, cont
     timestamp: string;
 }>;
 export declare function sendGroupMessage(accessToken: string, groupOpenid: string, content: string, msgId?: string, messageReference?: string): Promise<MessageResponse>;
+/** 发送带 Inline Keyboard 的 C2C 消息（回调型按钮，触发 INTERACTION_CREATE） */
+export declare function sendC2CMessageWithInlineKeyboard(accessToken: string, openid: string, content: string, inlineKeyboard: import("./types.js").InlineKeyboard, msgId?: string): Promise<MessageResponse>;
+/** 发送带 Inline Keyboard 的 Group 消息（回调型按钮，触发 INTERACTION_CREATE） */
+export declare function sendGroupMessageWithInlineKeyboard(accessToken: string, groupOpenid: string, content: string, inlineKeyboard: import("./types.js").InlineKeyboard, msgId?: string): Promise<MessageResponse>;
 export declare function sendProactiveC2CMessage(accessToken: string, openid: string, content: string): Promise<MessageResponse>;
 export declare function sendProactiveGroupMessage(accessToken: string, groupOpenid: string, content: string): Promise<{
     id: string;