@cxyhhhhh/openclaw-qqbot 2.0.0-dev.202607081621 → 2.0.0-dev.202607082155

package/index.ts

@@ -14,7 +14,7 @@ import { qqbotPlugin } from './src/channel.js';
 import { setQQBotRuntime } from './src/runtime.js';
 import { registerPlatformTool } from './src/tools/platform.js';
 import { registerRemindTool } from './src/tools/remind.js';
-import { verifyRuntimeContract } from './src/runtime-adapter/contract-check.js';
+import { verifyRuntimeContract } from './src/adapter/contract.js';
 
 let registered = false;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cxyhhhhh/openclaw-qqbot",
-  "version": "2.0.0-dev.202607081621",
+  "version": "2.0.0-dev.202607082155",
   "description": "QQ Bot channel plugin for OpenClaw",
   "publishConfig": {
     "access": "public"
@@ -41,7 +41,7 @@
     "lint:runtime": "npx tsx src/runtime-adapter/lint-runtime-access.ts"
   },
   "dependencies": {
-    "@tencent-connect/qqbot-nodejs": "npm:@tencent/qqbot-nodejs@0.0.0-dev.8a6be470",
+    "@tencent-connect/qqbot-nodejs": "npm:@cxyhhhhh/qqbot-nodejs@1.0.2-dev.202607081646",
     "@tencent-connect/qqbot-connector": "1.2.0"
   },
   "devDependencies": {

package/skills/qqbot-channel/SKILL.md

@@ -1,13 +1,34 @@
 ---
 name: qqbot-channel
-description: QQ 频道管理技能。查询频道列表、子频道、成员、发帖、公告、日程等操作。使用 qqbot_platform_api 工具代理 QQ 开放平台 HTTP 接口，自动处理 Token 鉴权。当用户需要查看频道、管理子频道、查询成员、发布帖子/公告/日程时使用此技能。
+description: QQ 频道管理技能（非QQ群）。查询频道列表、子频道、成员、发帖、公告、日程等操作。使用 qqbot_platform_api 工具代理 QQ 开放平台 HTTP 接口，自动处理 Token 鉴权。仅用于 QQ 频道（Guild/Channel）。触发条件：用户提到「频道」「子频道」「guild」「channel」「帖子」「日程」「公告」。
 metadata: {"openclaw":{"emoji":"📡","requires":{"config":["channels.qqbot"]}}}
 ---
 
 # QQ 频道 API 请求指导
 
+> **本 Skill 仅处理 QQ 频道（Guild/Channel）操作。** 频道 ID 为纯数字，API 路径为 `/guilds/...` 和 `/channels/...`。
+
 `qqbot_platform_api` 是 QQ 开放平台统一 HTTP API 网关，**自动填充鉴权 Token**。你只需要指定 HTTP 方法、API 路径、请求体和查询参数即可调用频道相关接口。
 
+---
+
+## 🔀 适用范围（必读）
+
+QQ 频道是类似 Discord 的社区产品，层级结构为 **频道（Guild） → 子频道（Channel）**：
+
+| 层级 | 中文名 | 英文 | API 路径 | ID 格式 |
+|------|--------|------|----------|---------|
+| 顶层 | 频道 | Guild | `/guilds/{guild_id}` | 纯数字（如 `123456`） |
+| 次级 | 子频道 | Channel | `/channels/{channel_id}` | 纯数字（如 `789012`） |
+
+**核心特征**：
+- 频道内可以创建多个子频道（文字、语音、论坛、直播等）
+- 支持发帖、公告、日程等功能
+- 频道成员通过 `/guilds/{guild_id}/members` 管理
+- ID 为纯数字格式，API 路径以 `/guilds/` 或 `/channels/` 开头
+
+**触发关键词**：频道、子频道、guild、channel、帖子、日程、公告、论坛、频道成员
+
 ## 📚 详细参考文档
 
 每个接口的完整参数说明、返回值结构和枚举值定义：
@@ -251,13 +272,14 @@ metadata: {"openclaw":{"emoji":"📡","requires":{"config":["channels.qqbot"]}}}
 
 ## ⚠️ 注意事项
 
-1. **路径中的占位符**（如 `{guild_id}`、`{channel_id}`）必须替换为实际值
-2. **query 参数的值必须为字符串类型**，如 `{ "limit": "100" }` 而非 `{ "limit": 100 }`
-3. **成员列表翻页**时可能返回重复成员，需按 `user.id` 去重
-4. **公告**的两种类型（消息公告和推荐子频道公告）会互相顶替
-5. **日程**的时间戳为毫秒级字符串
-6. **删除操作不可逆**，请谨慎使用
-7. **论坛操作**仅私域机器人可用
-8. **子频道分组**（type=4）的 `position` 必须 >= 2
-9. **日程操作**有频率限制：单个管理员每天 10 次，单个频道每天 100 次
-10. **头像/图标展示**：成员 `user.avatar` 和频道 `icon` 等图片 URL 必须使用 Markdown 图片语法 `![描述](URL)` 展示，禁止作为纯文本或超链接展示
+1. **适用范围**：本 Skill 仅处理 QQ 频道（Guild/Channel）操作，API 路径以 `/guilds/` 或 `/channels/` 开头，ID 为纯数字
+2. **路径中的占位符**（如 `{guild_id}`、`{channel_id}`）必须替换为实际的纯数字 ID
+3. **query 参数的值必须为字符串类型**，如 `{ "limit": "100" }` 而非 `{ "limit": 100 }`
+4. **成员列表翻页**时可能返回重复成员，需按 `user.id` 去重
+5. **公告**的两种类型（消息公告和推荐子频道公告）会互相顶替
+6. **日程**的时间戳为毫秒级字符串
+7. **删除操作不可逆**，请谨慎使用
+8. **论坛操作**仅私域机器人可用
+9. **子频道分组**（type=4）的 `position` 必须 >= 2
+10. **日程操作**有频率限制：单个管理员每天 10 次，单个频道每天 100 次
+11. **头像/图标展示**：成员 `user.avatar` 和频道 `icon` 等图片 URL 必须使用 Markdown 图片语法 `![描述](URL)` 展示，禁止作为纯文本或超链接展示

package/src/{runtime-adapter/contract-check.ts → adapter/contract.ts}

@@ -16,13 +16,6 @@ interface ApiProbe {
 }
 
 const REQUIRED: ApiProbe[] = [
-  {
-    name: 'channel.inbound.run',
-    probe: (rt) => {
-      const c = (rt as any).channel;
-      return typeof c?.inbound?.run === 'function' || typeof c?.turn?.run === 'function';
-    },
-  },
   {
     name: 'channel.reply.dispatchReplyWithBufferedBlockDispatcher',
     probe: (rt) => typeof (rt as any).channel?.reply?.dispatchReplyWithBufferedBlockDispatcher === 'function',
@@ -30,6 +23,10 @@ const REQUIRED: ApiProbe[] = [
 ];
 
 const OPTIONAL: ApiProbe[] = [
+  { name: 'channel.inbound.run (degraded)', probe: (rt) => {
+    const c = (rt as any).channel;
+    return typeof c?.inbound?.run === 'function' || typeof c?.turn?.run === 'function';
+  }},
   { name: 'channel.inbound.buildContext', probe: (rt) => typeof (rt as any).channel?.inbound?.buildContext === 'function' },
   { name: 'channel.reply.formatAgentEnvelope', probe: (rt) => typeof (rt as any).channel?.reply?.formatAgentEnvelope === 'function' },
   { name: 'channel.text.chunkMarkdownText', probe: (rt) => typeof (rt as any).channel?.text?.chunkMarkdownText === 'function' },

package/src/{runtime-adapter/gateway-runtime.ts → adapter/gateway.ts}

@@ -17,9 +17,8 @@ export interface ApprovalGatewayClient {
 export function loadApprovalGatewayRuntime(): {
   createOperatorApprovalsGatewayClient: (...args: any[]) => Promise<ApprovalGatewayClient>;
 } | null {
-  const currentFile = __filename;
-  const req = createRequire(currentFile);
-  const pluginRoot = path.resolve(path.dirname(currentFile), '..', '..');
+  const req = createRequire(__filename);
+  const pluginRoot = path.resolve(path.dirname(__filename), '..', '..');
   const fs = req('node:fs') as typeof import('node:fs');
 
   const tryLoadFromRoot = (root: string) => {

package/src/{runtime-adapter → adapter}/index.ts

@@ -2,7 +2,7 @@
  * Runtime Adapter — 隔离 OpenClaw 框架 API 变更对插件核心逻辑的冲击。
  *
  * 所有 `runtime.channel.*` / `runtime.config.*` 访问 **必须** 经由本模块导出的函数。
- * 禁止在 runtime-adapter/ 外直接使用 `(runtime as any).channel.*`。
+ * 禁止在 adapter/ 外直接使用 `(runtime as any).channel.*`。
  *
  * 设计原则：
  *   1. Capability Probe — 按候选 API 路径探测，兼容多版本框架
@@ -10,6 +10,6 @@
  *   3. 单一 resolve 入口 — 一次 resolve，全程复用缓存
  */
 
-export { verifyRuntimeContract, type ContractResult } from './contract-check.js';
+export { verifyRuntimeContract, type ContractResult } from './contract.js';
 export { resolveRuntimeAdapters, getAdapters, type RuntimeAdapters } from './resolve.js';
-export { loadApprovalGatewayRuntime, type ApprovalGatewayClient } from './gateway-runtime.js';
+export { loadApprovalGatewayRuntime, type ApprovalGatewayClient } from './gateway.js';

package/src/{runtime-adapter/lint-runtime-access.ts → adapter/lint.ts}

@@ -1,8 +1,8 @@
 /**
- * Lint: 检测 runtime-adapter/ 外部直接访问 runtime.channel.* 的代码
+ * Lint: 检测 adapter/ 外部直接访问 runtime.channel.* 的代码
  *
  * 运行方式：
- *   npx tsx src/runtime-adapter/lint-runtime-access.ts
+ *   npx tsx src/adapter/lint-runtime-access.ts
  *
  * 退出码：
  *   0 = 无违规
@@ -21,7 +21,7 @@ import * as path from 'node:path';
 // ── 配置 ──
 
 const SRC_ROOT = path.resolve(import.meta.dirname, '..');
-const ADAPTER_DIR = path.resolve(SRC_ROOT, 'runtime-adapter');
+const ADAPTER_DIR = path.resolve(SRC_ROOT, 'adapter');
 
 /** 匹配直接使用 runtime.channel / runtime.config / (runtime as any) 的模式 */
 const VIOLATION_PATTERNS: RegExp[] = [
@@ -36,7 +36,7 @@ const VIOLATION_PATTERNS: RegExp[] = [
 const BYPASS_MARKER = '@adapter-bypass';
 
 /** 排除的目录/文件 */
-const EXCLUDE_DIRS = ['runtime-adapter', 'node_modules', 'dist', 'tests'];
+const EXCLUDE_DIRS = ['adapter', 'node_modules', 'dist', 'tests'];
 const EXCLUDE_FILES = ['types.ts', 'types-augment.d.ts', 'openclaw-plugin-sdk.d.ts'];
 
 // ── 扫描逻辑 ──
@@ -50,7 +50,7 @@ interface Violation {
 
 function shouldExclude(filePath: string): boolean {
   const relative = path.relative(SRC_ROOT, filePath);
-  // 排除 runtime-adapter 自身
+  // 排除 adapter 自身
   if (filePath.startsWith(ADAPTER_DIR)) return true;
   // 排除配置的目录
   for (const dir of EXCLUDE_DIRS) {
@@ -123,7 +123,7 @@ function main(): void {
   }
 
   if (allViolations.length === 0) {
-    console.log('✅ No direct runtime access found outside runtime-adapter/');
+    console.log('✅ No direct runtime access found outside adapter/');
     process.exit(0);
   }
 
@@ -132,7 +132,7 @@ function main(): void {
     console.error(`  ${v.file}:${v.line}`);
     console.error(`    ${v.content}`);
     console.error(`    → matched: ${v.pattern}`);
-    console.error(`    → fix: use runtime-adapter or add "// @adapter-bypass: <reason>"\n`);
+    console.error(`    → fix: use adapter or add "// @adapter-bypass: <reason>"\n`);
   }
   console.error(
     `\nTo bypass a specific line, add an inline comment:\n` +

package/src/adapter/media.ts

@@ -0,0 +1,112 @@
+/**
+ * 远程媒体下载（动态加载 plugin-sdk/media-runtime，降级到 fetch）
+ *
+ * 新版本 openclaw 有 openclaw/plugin-sdk/media-runtime（含 SSRF 防护/重试/大小限制），
+ * 旧版本不可用时降级到原生 fetch 直连。
+ */
+import { createRequire } from 'node:module';
+import * as dns from 'node:dns';
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import * as crypto from 'node:crypto';
+import { getQQBotMediaDir } from '../utils/platform.js';
+
+const req = createRequire(__filename);
+
+type SaveRemoteMedia = (opts: {
+  url: string;
+  subdir?: string;
+  originalFilename?: string;
+  maxBytes?: number;
+  timeoutMs?: number;
+}) => Promise<{ path: string }>;
+
+let _save: SaveRemoteMedia | null | undefined;
+
+export function downloadRemoteMedia(opts: {
+  url: string;
+  subdir?: string;
+  originalFilename?: string;
+  maxBytes?: number;
+  timeoutMs?: number;
+}): Promise<{ path: string }> {
+  if (_save === undefined) {
+    try {
+      const mod = req('openclaw/plugin-sdk/media-runtime') as { saveRemoteMedia: SaveRemoteMedia };
+      _save = mod.saveRemoteMedia;
+    } catch {
+      _save = null;
+    }
+  }
+  return _save ? _save(opts) : downloadViaFetch(opts);
+}
+
+// ── SSRF 防护 ──
+
+const PRIVATE_RANGES: Array<[netmask: bigint, prefix: number]> = [
+  [0x0A000000n, 8],      // 10.0.0.0/8
+  [0xAC100000n, 12],     // 172.16.0.0/12
+  [0xC0A80000n, 16],     // 192.168.0.0/16
+  [0x7F000000n, 8],      // 127.0.0.0/8
+  [0xA9FE0000n, 16],     // 169.254.0.0/16
+  [0xE0000000n, 4],      // 224.0.0.0/4 (multicast)
+];
+
+function ipToBigInt(ip: string): bigint {
+  return ip.split('.').reduce((acc, octet) => (acc << 8n) | BigInt(Number(octet)), 0n);
+}
+
+function isPrivateIP(ip: string): boolean {
+  const val = ipToBigInt(ip);
+  return PRIVATE_RANGES.some(([mask, prefix]) => (val >> (32n - BigInt(prefix))) === (mask >> (32n - BigInt(prefix))));
+}
+
+async function assertSafeHostname(hostname: string): Promise<void> {
+  const addresses = await dns.promises.resolve4(hostname).catch(() => []);
+  if (addresses.length === 0) throw new Error(`DNS resolution failed: ${hostname}`);
+  for (const addr of addresses) {
+    if (isPrivateIP(addr)) {
+      throw new Error(`SSRF blocked: ${hostname} resolves to private IP ${addr}`);
+    }
+  }
+}
+
+// ── 降级 fetch ──
+
+/** 降级：原生 fetch 直连（含 SSRF 防护、大小限制） */
+async function downloadViaFetch(opts: {
+  url: string;
+  subdir?: string;
+  originalFilename?: string;
+  maxBytes?: number;
+  timeoutMs?: number;
+}): Promise<{ path: string }> {
+  const parsed = new URL(opts.url);
+  if (parsed.protocol !== 'https:') {
+    throw new Error(`Only HTTPS allowed: ${parsed.protocol}`);
+  }
+  await assertSafeHostname(parsed.hostname);
+
+  const dir = getQQBotMediaDir(opts.subdir ?? 'downloads');
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+
+  const resp = await fetch(opts.url, {
+    signal: AbortSignal.timeout(opts.timeoutMs ?? 120_000),
+  });
+  if (!resp.ok) throw new Error(`Download HTTP ${resp.status}`);
+
+  const maxBytes = opts.maxBytes ?? 500 * 1024 * 1024;
+  const buf = Buffer.from(await resp.arrayBuffer());
+  if (buf.length > maxBytes) throw new Error(`Download exceeds ${(maxBytes / 1024 / 1024).toFixed(0)}MB`);
+
+  const ext = opts.originalFilename
+    ? path.extname(opts.originalFilename) || '.bin'
+    : '.bin';
+  const name = opts.originalFilename
+    ? path.basename(opts.originalFilename, path.extname(opts.originalFilename))
+    : 'download';
+  const rand = crypto.randomBytes(4).toString('hex');
+  const filePath = path.join(dir, `${name}_${Date.now()}_${rand}${ext}`);
+  fs.writeFileSync(filePath, buf);
+  return { path: filePath };
+}

package/src/adapter/setup.ts

@@ -0,0 +1,55 @@
+/**
+ * Setup 工具动态加载（plugin-sdk/setup + plugin-sdk/setup-tools）
+ *
+ * 新版本 openclaw 有这些导出，旧版本可能缺失。
+ * 不可用时提供最小降级实现。
+ */
+import { createRequire } from 'node:module';
+
+const req = createRequire(__filename);
+
+let _setup: typeof import('openclaw/plugin-sdk/setup') | null | undefined;
+let _tools: typeof import('openclaw/plugin-sdk/setup-tools') | null | undefined;
+
+function loadSetup() {
+  if (_setup !== undefined) return _setup;
+  try { _setup = req('openclaw/plugin-sdk/setup'); } catch { _setup = null; }
+  return _setup;
+}
+
+function loadTools() {
+  if (_tools !== undefined) return _tools;
+  try { _tools = req('openclaw/plugin-sdk/setup-tools'); } catch { _tools = null; }
+  return _tools;
+}
+
+export type { ChannelSetupWizard } from 'openclaw/plugin-sdk/setup';
+
+export const DEFAULT_ACCOUNT_ID = 'default';
+
+export function createStandardChannelSetupStatus(
+  ...args: Parameters<NonNullable<typeof _setup>['createStandardChannelSetupStatus']>
+): ReturnType<NonNullable<typeof _setup>['createStandardChannelSetupStatus']> {
+  const mod = loadSetup();
+  if (mod) return mod.createStandardChannelSetupStatus(...args);
+  return {
+    channelLabel: args[0]?.channelLabel ?? 'QQ Bot',
+    configuredLabel: 'Configured',
+    unconfiguredLabel: 'Not configured',
+    resolveConfigured: () => false,
+  } as unknown as ReturnType<NonNullable<typeof _setup>['createStandardChannelSetupStatus']>;
+}
+
+export function setSetupChannelEnabled(
+  ...args: Parameters<NonNullable<typeof _setup>['setSetupChannelEnabled']>
+): void {
+  loadSetup()?.setSetupChannelEnabled?.(...args);
+}
+
+export function formatDocsLink(
+  ...args: Parameters<NonNullable<typeof _tools>['formatDocsLink']>
+): ReturnType<NonNullable<typeof _tools>['formatDocsLink']> {
+  const mod = loadTools();
+  if (mod) return mod.formatDocsLink(...args);
+  return (args[1] ? `${args[1]}: ${args[0]}` : args[0]) as ReturnType<NonNullable<typeof _tools>['formatDocsLink']>;
+}

package/src/adapter/workspace.ts

@@ -0,0 +1,29 @@
+/**
+ * Agent workspace 目录解析（动态加载 plugin-sdk/health）
+ *
+ * 新版本 openclaw 有 openclaw/plugin-sdk/health 导出，
+ * 旧版本不可用时 fallback 到 QQ Bot media 目录。
+ */
+import { createRequire } from 'node:module';
+import { getQQBotMediaDir } from '../utils/platform.js';
+
+const req = createRequire(__filename);
+
+let health: {
+  resolveAgentWorkspaceDir: (cfg: any, agentId: string) => string;
+  resolveDefaultAgentId: (cfg: any) => string;
+} | null = null;
+
+export function resolveAgentWorkspace(cfg: any, agentId?: string): string {
+  if (!health) {
+    try {
+      health = req('openclaw/plugin-sdk/health') as typeof health;
+    } catch {
+      health = null;
+    }
+  }
+  if (health) {
+    return health.resolveAgentWorkspaceDir(cfg, agentId ?? health.resolveDefaultAgentId(cfg));
+  }
+  return getQQBotMediaDir();
+}

package/src/bot-instance.ts

@@ -15,7 +15,7 @@ const PLUGIN_VERSION = getPackageVersion();
 let _openclawVersion = 'unknown';
 
 export function setOpenClawVersion(version: string): void {
-  _openclawVersion = version;
+  if (version) _openclawVersion = version;
 }
 
 export function getOpenClawVersion(): string {

package/src/channel.ts

@@ -24,7 +24,7 @@ import {
   resolveGroupConfig,
 } from './config.js';
 import { getQQBotRuntime, tryGetQQBotRuntime } from './runtime.js';
-import { getAdapters } from './runtime-adapter/resolve.js';
+import { getAdapters } from './adapter/resolve.js';
 import { sendText, getGateway } from './outbound/outbound-service.js';
 import { sendMedia } from './outbound/media-send.js';
 import type { PluginLogger } from './utils/plugin-logger.js';

package/src/commands/bot-approve.ts

@@ -1,6 +1,6 @@
 import type { SlashCommand } from '@tencent-connect/qqbot-nodejs';
 import type { PluginRuntime } from 'openclaw/plugin-sdk';
-import { getAdapters } from '../runtime-adapter/resolve.js';
+import { getAdapters } from '../adapter/resolve.js';
 import { updateGlobalConfig, checkCommandAuth } from './config-util.js';
 
 /** 审批预设配置 */

package/src/commands/bot-logs.ts

@@ -5,7 +5,7 @@ import os from 'node:os';
 import { getQQBotMediaDir } from '../utils/platform.js';
 import { checkCommandAuth } from './config-util.js';
 import type { PluginRuntime } from 'openclaw/plugin-sdk';
-import { getAdapters } from '../runtime-adapter/resolve.js';
+import { getAdapters } from '../adapter/resolve.js';
 
 
 const MAX_LINES_PER_FILE = 1000;

package/src/commands/bot-pairing.ts

@@ -1,6 +1,6 @@
 import type { SlashCommand } from '@tencent-connect/qqbot-nodejs';
 import type { PluginRuntime } from 'openclaw/plugin-sdk';
-import { getPairingApi } from '../runtime-adapter/pairing-runtime.js';
+import { getPairingApi } from '../adapter/pairing.js';
 import { checkCommandAuth } from './config-util.js';
 
 /** /bot-pairing — DM 配对审批管理 */

package/src/commands/config-util.ts

@@ -1,7 +1,7 @@
 import type { ResolvedQQBotAccount } from '../types.js';
 import type { SlashCommandHandlerContext } from '@tencent-connect/qqbot-nodejs';
 import type { PluginRuntime } from 'openclaw/plugin-sdk';
-import { getAdapters } from '../runtime-adapter/resolve.js';
+import { getAdapters } from '../adapter/resolve.js';
 
 /**
  * 命令授权检查（用于 SlashCommand.authorized 回调）。

package/src/dispatch/body-assembler.ts

@@ -24,7 +24,7 @@ import type {
 } from '@tencent-connect/qqbot-nodejs';
 import type { ResolvedQQBotAccount } from '../types.js';
 import type { ProcessedAttachments } from '../middleware/attachment.js';
-import { getAdapters } from '../runtime-adapter/resolve.js';
+import { getAdapters } from '../adapter/resolve.js';
 
 // ── 协议常量 ─────────────────────────────
 const QUOTE_BEGIN = '[Quoted message begins]';

package/src/dispatch/dispatch.ts

@@ -21,7 +21,7 @@ import { deliverReply, type DeliverPayload, type DeliverInfo, type DeliverContex
 
 import { DeliverDebouncer } from '../outbound/debounce.js';
 import { StreamingController, shouldUseStreaming } from '../outbound/streaming-controller.js';
-import { getAdapters } from '../runtime-adapter/resolve.js';
+import { getAdapters } from '../adapter/resolve.js';
 import { clearGroupHistory } from '../features/history-store.js';
 
 
@@ -41,11 +41,6 @@ export async function dispatchToOpenClaw(
 
   dlog?.debug(`received sender=${envelope.senderId} scope=${envelope.chatScope} msgId=${envelope.messageId}`);
 
-  if (!adapters.inboundRun) {
-    dlog?.error(`runtime adapter inboundRun not available (openclaw=${adapters.version})`);
-    return;
-  }
-
   if (!adapters.dispatchReply) {
     dlog?.error(`runtime adapter dispatchReply not available (openclaw=${adapters.version})`);
     return;
@@ -162,46 +157,80 @@ export async function dispatchToOpenClaw(
     dlog?.debug(`streaming enabled for ${envelope.senderId}`);
   }
 
-  await adapters.inboundRun({
-    channel: 'qqbot',
-    accountId: route.accountId,
-    raw: envelope,
-    adapter: {
-      ingest: (raw: any) => ({
-        id: envelope.messageId,
-        rawText: assembled.rawBody,
-        textForAgent: assembled.agentBody,
-        textForCommands: assembled.rawBody,
-        raw,
-      }),
-      resolveTurn: (_input: unknown, _eventClass: unknown, _preflight: unknown) => ({
-        channel: 'qqbot',
-        accountId: route.accountId,
-        routeSessionKey: route.sessionKey,
-        storePath,
-        ctxPayload,
-        recordInboundSession: adapters.recordInboundSession,
-        record: {
-          onRecordError: (err: unknown) => {
-            dlog?.error(`Session record error: ${err}`);
-          },
+  if (!adapters.inboundRun) {
+    // 低版本：手动 session + dispatchReply 直调
+    if (adapters.recordInboundSession) {
+      try {
+        await adapters.recordInboundSession({
+          storePath,
+          sessionKey: route.sessionKey,
+          ctx: ctxPayload,
+        });
+      } catch { /* best-effort */ }
+    }
+    await adapters.dispatchReply!({
+      ctx: ctxPayload,
+      cfg,
+      dispatcherOptions: {
+        deliver: async (payload: DeliverPayload, info?: DeliverInfo) => {
+          await deliverReply(payload, info, deliverCtx);
         },
-        runDispatch: () => {
-          let blockDelivered = false;
-          const deliveredMediaUrls = new Set<string>();
-          return adapters.dispatchReply!({
-            ctx: ctxPayload,
-            cfg,
-            dispatcherOptions: {
-              deliver: async (payload: DeliverPayload, info?: DeliverInfo) => {
-                try {
-                  const kind = (info as any)?.kind as string | undefined;
-                  dlog?.debug(`deliver kind=${kind ?? 'none'} textLen=${payload.text?.length ?? 0} audioAsVoice=${payload.audioAsVoice ?? false} mediaUrl=${payload.mediaUrl?.slice(0, 60) ?? 'none'} mediaUrls=${payload.mediaUrls?.length ?? 0}`);
+      },
+      ...(streamingController
+        ? {
+            replyOptions: {
+              onPartialReply: async (p: { text?: string }) => {
+                if (p.text) await streamingController.onPartialReply(p.text);
+              },
+            },
+          }
+        : {}),
+    });
+    if (streamingController && !streamingController.isTerminal) {
+      await streamingController.finalize();
+    }
+    if (debouncer) await debouncer.flushAll();
+  } else {
+    await adapters.inboundRun!({
+      channel: 'qqbot',
+      accountId: route.accountId,
+      raw: envelope,
+      adapter: {
+        ingest: (raw: any) => ({
+          id: envelope.messageId,
+          rawText: assembled.rawBody,
+          textForAgent: assembled.agentBody,
+          textForCommands: assembled.rawBody,
+          raw,
+        }),
+        resolveTurn: (_input: unknown, _eventClass: unknown, _preflight: unknown) => ({
+          channel: 'qqbot',
+          accountId: route.accountId,
+          routeSessionKey: route.sessionKey,
+          storePath,
+          ctxPayload,
+          recordInboundSession: adapters.recordInboundSession,
+          record: {
+            onRecordError: (err: unknown) => {
+              dlog?.error(`Session record error: ${err}`);
+            },
+          },
+          runDispatch: () => {
+            let blockDelivered = false;
+            const deliveredMediaUrls = new Set<string>();
+            return adapters.dispatchReply!({
+              ctx: ctxPayload,
+              cfg,
+              dispatcherOptions: {
+                deliver: async (payload: DeliverPayload, info?: DeliverInfo) => {
+                  try {
+                    const kind = (info as any)?.kind as string | undefined;
+                    dlog?.debug(`deliver kind=${kind ?? 'none'} textLen=${payload.text?.length ?? 0} audioAsVoice=${payload.audioAsVoice ?? false} mediaUrl=${payload.mediaUrl?.slice(0, 60) ?? 'none'} mediaUrls=${payload.mediaUrls?.length ?? 0}`);
 
-                  // ── block 带音频/媒体时优先发送（不发送文本，留流式处理） ──
-                  if (kind === 'block') {
-                    if (payload.audioAsVoice) {
-                      // TTS 语音：走完整 deliverReply（voice intent 消费文本）
+                    // ── block 带音频/媒体时优先发送（不发送文本，留流式处理） ──
+                    if (kind === 'block') {
+                      if (payload.audioAsVoice) {
+                        // TTS 语音：走完整 deliverReply（voice intent 消费文本）
                       await deliverReply(payload, info, deliverCtx);
                     } else {
                       // 普通媒体（图片等）：只发媒体，文本留给流式
@@ -296,7 +325,8 @@ export async function dispatchToOpenClaw(
       }),
     },
   });
-
+  }
+ 
   dlog?.debug(`inboundRun completed sessionKey=${route.sessionKey}`);
 
   // 群消息回复后清空历史缓存（避免下次 @ 时重复组包）

package/src/features/approval-handler.ts

@@ -14,7 +14,7 @@ import { getBotForAccount } from "../bot-instance.js";
 import type { PluginLogger } from '../utils/plugin-logger.js';
 import type { InlineKeyboard, KeyboardButton } from "../types.js";
 
-import { loadApprovalGatewayRuntime, type ApprovalGatewayClient } from '../runtime-adapter/gateway-runtime.js';
+import { loadApprovalGatewayRuntime, type ApprovalGatewayClient } from '../adapter/gateway.js';
 type EventFrame = {
   event: string;
   payload: unknown;

package/src/gateway/event-handlers.ts

@@ -15,7 +15,7 @@ import { runWithRequestContext } from '../request-context.js';
 import { getApprovalHandler } from '../features/approval-handler.js';
 import { recordKnownUser } from '../features/proactive.js';
 import { cacheMsgId } from '../features/msgid-cache.js';
-import { getAdapters } from '../runtime-adapter/resolve.js';
+import { getAdapters } from '../adapter/resolve.js';
 import { resolveGroupConfigFromAccount, resolveGroupPolicy, resolveMentionPatterns } from '../config.js';
 import { getPackageVersion } from '../utils/pkg-version.js';
 import { getOpenClawVersion } from '../bot-instance.js';

package/src/gateway/lifecycle.ts

@@ -11,7 +11,7 @@ import type { OpenClawConfig } from 'openclaw/plugin-sdk/core';
 import type { ResolvedQQBotAccount } from '../types.js';
 import { DEFAULT_ACCOUNT_ID, resolveQQBotAccount, applyQQBotAccountConfig } from '../config.js';
 import { getQQBotRuntime } from '../runtime.js';
-import { getAdapters } from '../runtime-adapter/resolve.js';
+import { getAdapters } from '../adapter/resolve.js';
 import { QQBotGateway } from './qqbot-gateway.js';
 import { createPluginLogger } from '../utils/plugin-logger.js';
 import type { PluginLogger } from '../utils/plugin-logger.js';