@tencent-connect/openclaw-qqbot 1.7.1 → 2.0.0

package/src/commands/bot-approve.ts

@@ -0,0 +1,143 @@
+import type { SlashCommand } from '@tencent-connect/qqbot-nodejs';
+import type { PluginRuntime } from 'openclaw/plugin-sdk';
+import { getAdapters } from '../adapter/resolve.js';
+import { updateGlobalConfig, checkCommandAuth } from './config-util.js';
+
+/** 审批预设配置 */
+const PRESETS: Record<string, { security: string; ask: string; desc: string }> = {
+  on: { security: 'allowlist', ask: 'on-miss', desc: '开启审批（白名单模式）' },
+  off: { security: 'full', ask: 'off', desc: '关闭审批' },
+  always: { security: 'allowlist', ask: 'always', desc: '严格模式（每次都审批）' },
+};
+
+/** 格式化当前审批状态 */
+function formatStatus(security: string, ask: string): string {
+  const secIcon = security === 'full' ? '🟢' : security === 'allowlist' ? '🟡' : '🔴';
+  const askIcon = ask === 'off' ? '🟢' : ask === 'always' ? '🔴' : '🟡';
+  const desc =
+    security === 'deny' ? '⚠️ 当前为 deny 模式，所有命令执行被拒绝' :
+    security === 'full' && ask === 'off' ? '✅ 所有命令无需审批直接执行' :
+    security === 'allowlist' && ask === 'on-miss' ? '🛡️ 白名单命令直接执行，其余需审批' :
+    ask === 'always' ? '🔒 每次命令执行都需要人工审批' :
+    `ℹ️ security=${security}, ask=${ask}`;
+
+  return [
+    '🔐 当前审批配置',
+    '',
+    `${secIcon} 安全模式 (security): **${security}**`,
+    `${askIcon} 审批模式 (ask): **${ask}**`,
+    '',
+    desc,
+  ].join('\n');
+}
+
+/** 操作指引菜单 */
+function menuText(): string {
+  return [
+    '🔐 命令执行审批配置',
+    '',
+    '<qqbot-cmd-input text="/bot-approve on" show="/bot-approve on"/> 开启审批（白名单模式）',
+    '<qqbot-cmd-input text="/bot-approve off" show="/bot-approve off"/> 关闭审批',
+    '<qqbot-cmd-input text="/bot-approve always" show="/bot-approve always"/> 严格模式',
+    '<qqbot-cmd-input text="/bot-approve reset" show="/bot-approve reset"/> 恢复默认',
+    '<qqbot-cmd-input text="/bot-approve status" show="/bot-approve status"/> 查看当前配置',
+  ].join('\n');
+}
+
+/** /bot-approve — 管理命令执行审批配置 */
+export function botApprove(getRuntime: () => PluginRuntime): SlashCommand {
+  return {
+    name: 'bot-approve',
+    description: '管理命令执行审批配置',
+    scope: 'c2c',
+    authorized: checkCommandAuth,
+    usage: [
+      '/bot-approve            查看操作指引',
+      '/bot-approve on         开启审批（白名单模式，推荐）',
+      '/bot-approve off        关闭审批，命令直接执行',
+      '/bot-approve always     始终审批，每次执行都需审批',
+      '/bot-approve reset      恢复框架默认值',
+      '/bot-approve status     查看当前审批配置',
+    ].join('\n'),
+    handler: async (ctx) => {
+      const arg = (Array.isArray(ctx.command.args) ? ctx.command.args.join(' ') : String(ctx.command.args ?? '')).trim().toLowerCase();
+      const runtime = getRuntime();
+
+      if (!runtime) {
+        return '⚠️ runtime 不可用，无法管理审批配置。';
+      }
+
+      const adapters = getAdapters(runtime);
+
+      const loadExecConfig = () => {
+        const cfg = adapters.getConfig?.() ?? {};
+        const tools = (cfg as any).tools ?? {};
+        const exec = tools.exec ?? {};
+        return {
+          security: String(exec.security ?? 'deny'),
+          ask: String(exec.ask ?? 'on-miss'),
+        };
+      };
+
+      // 无参数 → 操作指引
+      if (!arg) {
+        return menuText();
+      }
+
+      // status → 查看当前配置
+      if (arg === 'status') {
+        const { security, ask } = loadExecConfig();
+        return [
+          formatStatus(security, ask),
+          '',
+          '<qqbot-cmd-input text="/bot-approve on" show="/bot-approve on"/> 开启审批',
+          '<qqbot-cmd-input text="/bot-approve off" show="/bot-approve off"/> 关闭审批',
+          '<qqbot-cmd-input text="/bot-approve always" show="/bot-approve always"/> 严格模式',
+          '<qqbot-cmd-input text="/bot-approve reset" show="/bot-approve reset"/> 恢复默认',
+        ].join('\n');
+      }
+
+      // on / off / always → 写入预设
+      const preset = PRESETS[arg];
+      if (preset) {
+        const error = await updateGlobalConfig(getRuntime, (cfg: any) => {
+          cfg.tools ??= {};
+          cfg.tools.exec ??= {};
+          cfg.tools.exec.security = preset.security;
+          cfg.tools.exec.ask = preset.ask;
+        });
+        if (error) return error;
+
+        if (arg === 'on') {
+          return ['✅ 审批已开启', '', '• security = allowlist', '• ask = on-miss', '', '已批准的命令自动加入白名单，下次直接执行。'].join('\n');
+        }
+        if (arg === 'off') {
+          return ['✅ 审批已关闭', '', '• security = full', '• ask = off', '', '⚠️ 所有命令将直接执行，不会弹出审批确认。'].join('\n');
+        }
+        return ['✅ 已切换为严格审批模式', '', '• security = allowlist', '• ask = always', '', '每个命令都会弹出审批按钮，需手动确认。'].join('\n');
+      }
+
+      // reset → 删除 tools.exec.security 和 tools.exec.ask
+      if (arg === 'reset') {
+        const error = await updateGlobalConfig(getRuntime, (cfg: any) => {
+          const exec = cfg.tools?.exec;
+          if (exec) {
+            delete exec.security;
+            delete exec.ask;
+            if (Object.keys(exec).length === 0) delete cfg.tools.exec;
+            if (cfg.tools && Object.keys(cfg.tools).length === 0) delete cfg.tools;
+          }
+        });
+        if (error) return error;
+
+        return ['✅ 审批配置已重置', '', '已移除 tools.exec.security 和 tools.exec.ask', '框架将使用默认值（security=deny, ask=on-miss）', '', '如需开启命令执行，请使用 /bot-approve on'].join('\n');
+      }
+
+      return [
+        `❌ 未知参数: ${arg}`,
+        '',
+        '可用选项: on | off | always | reset | status',
+      ].join('\n');
+    },
+  };
+}

package/src/commands/bot-clear-storage.ts

@@ -0,0 +1,114 @@
+import type { SlashCommand } from '@tencent-connect/qqbot-nodejs';
+import type { ResolvedQQBotAccount } from '../types.js';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { checkCommandAuth } from './config-util.js';
+import { getQQBotMediaDir } from '../utils/platform.js';
+
+const MAX_DISPLAY = 10;
+
+interface FileEntry {
+  filePath: string;
+  size: number;
+}
+
+/** 递归扫描目录下所有文件，按大小降序 */
+function scanFiles(dirPath: string): FileEntry[] {
+  const files: FileEntry[] = [];
+  if (!fs.existsSync(dirPath)) return files;
+
+  const walk = (dir: string) => {
+    let entries: fs.Dirent[];
+    try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { return; }
+    for (const entry of entries) {
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) { walk(full); }
+      else if (entry.isFile()) {
+        try { files.push({ filePath: full, size: fs.statSync(full).size }); } catch { /* skip */ }
+      }
+    }
+  };
+  walk(dirPath);
+  return files.sort((a, b) => b.size - a.size);
+}
+
+function formatSize(bytes: number): string {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  if (bytes < 1024 * 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+  return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+}
+
+/** /bot-clear-storage — 清理下载文件（两步：扫描 → --force 删除） */
+export function botClearStorage(_account: ResolvedQQBotAccount): SlashCommand {
+  const targetDir = getQQBotMediaDir('downloads');
+  const displayDir = targetDir.replace(os.homedir(), '~');
+
+  return {
+    name: 'bot-clear-storage',
+    description: '清理通过QQBot对话产生的文件以及下载的资源',
+    scope: 'c2c',
+    authorized: checkCommandAuth,
+    usage: [
+      '/bot-clear-storage',
+      '',
+      '扫描当前机器人产生的下载文件并列出明细。',
+      '确认后执行删除，释放主机磁盘空间。',
+      '',
+      '/bot-clear-storage --force   确认执行清理',
+      '',
+      '⚠️ 仅在私聊中可用。',
+    ].join('\n'),
+    handler: (ctx) => {
+      const isForce = ctx.command.raw?.trim() === '--force';
+
+      if (!isForce) {
+        // ── 第一步：扫描并展示 ──
+        const files = scanFiles(targetDir);
+        if (files.length === 0) {
+          return `✅ 当前没有需要清理的文件\n\n目录 \`${displayDir}\` 为空或不存在。`;
+        }
+
+        const totalSize = files.reduce((s, f) => s + f.size, 0);
+        const lines = [
+          `即将清理 \`${displayDir}\` 下所有文件，共 ${files.length} 个，占用 ${formatSize(totalSize)}。`,
+          '',
+          `文件概况：`,
+        ];
+
+        for (const f of files.slice(0, MAX_DISPLAY)) {
+          const rel = path.relative(targetDir, f.filePath).replace(/\\/g, '/');
+          lines.push(`  ${rel} (${formatSize(f.size)})`);
+        }
+        if (files.length > MAX_DISPLAY) {
+          lines.push(`  ...共 ${files.length} 个文件 (${formatSize(totalSize)})`);
+        }
+
+        lines.push('', '---', '', '确认清理后文件将永久删除，后续 AI 无法找回。', '‼️ <qqbot-cmd-enter text="/bot-clear-storage --force" />');
+        return lines.join('\n');
+      }
+
+      // ── 第二步：--force 执行删除 ──
+      const files = scanFiles(targetDir);
+      if (files.length === 0) {
+        return '✅ 没有需要清理的文件。';
+      }
+
+      let deleted = 0;
+      let failed = 0;
+      for (const f of files) {
+        try { fs.unlinkSync(f.filePath); deleted++; } catch { failed++; }
+      }
+
+      const parts = [`🗑️ 已删除 ${deleted} 个文件`];
+      if (failed > 0) parts.push(`，${failed} 个失败`);
+      parts.push(`\n📁 \`${displayDir}\``);
+
+      // 清理空目录
+      try { fs.rmdirSync(targetDir); } catch { /* not empty */ }
+
+      return parts.join('');
+    },
+  };
+}

package/src/commands/bot-group-always.ts

@@ -0,0 +1,62 @@
+import type { SlashCommand } from '@tencent-connect/qqbot-nodejs';
+import type { PluginRuntime } from 'openclaw/plugin-sdk';
+import type { ResolvedQQBotAccount } from '../types.js';
+import { updateAccountConfig, checkCommandAuth } from './config-util.js';
+
+/** /bot-group-always — 修改群消息默认响应模式 */
+export function botGroupAlways(account: ResolvedQQBotAccount, getRuntime: () => PluginRuntime): SlashCommand {
+  return {
+    name: ['bot-group-always', 'bot-group-allways'],
+    description: '修改群消息默认响应模式',
+    scope: 'c2c',
+    authorized: checkCommandAuth,
+    usage: [
+      '/bot-group-always on   AI 自主判断何时发言（无需 @）',
+      '/bot-group-always off  仅在被 @ 时回复',
+      '/bot-group-always      查看当前设置',
+      '',
+      '设为 on 后，AI 会自主判断每条消息是否需要回复（无需 @）。',
+      '仍可通过 groups.{groupId}.requireMention 对单个群覆盖。',
+    ].join('\n'),
+    handler: async (ctx) => {
+      const arg = (Array.isArray(ctx.command.args) ? ctx.command.args.join(' ') : String(ctx.command.args ?? '')).trim().toLowerCase();
+      const currentRequireMention = account.config.defaultRequireMention ?? true;
+
+      // 无参数 → 查看状态
+      if (!arg) {
+        return [
+          `🤖 群自主发言状态：${currentRequireMention ? '❌ 仅被 @ 时回复' : '✅ 自主判断何时发言'}`,
+          `使用 <qqbot-cmd-input text="/bot-group-always on" show="/bot-group-always on"/> 设为自主发言`,
+          `使用 <qqbot-cmd-input text="/bot-group-always off" show="/bot-group-always off"/> 设为仅被 @ 时回复`,
+        ].join('\n');
+      }
+
+      if (arg !== 'on' && arg !== 'off') {
+        return '❌ 参数错误，请使用 on 或 off\n\n示例：/bot-group-always on';
+      }
+
+      // on = 自主发言 (requireMention=false), off = 仅被 @ (requireMention=true)
+      const newRequireMention = arg === 'off';
+
+      if (newRequireMention === currentRequireMention) {
+        return `🤖 群自主发言已经是"${arg}"状态，无需操作`;
+      }
+
+      const error = await updateAccountConfig(account, getRuntime, (acfg) => {
+        (acfg as any).defaultRequireMention = newRequireMention;
+      });
+      if (error) return error;
+
+      // 更新内存中的配置
+      account.config.defaultRequireMention = newRequireMention;
+
+      return [
+        `✅ 群自主发言已设置为 ${newRequireMention ? '**off**（仅被 @ 时回复）' : '**on**（AI 自主判断何时发言）'}`,
+        '',
+        newRequireMention
+          ? '仅在被 @ 机器人才会回复。'
+          : 'AI 将自主判断群消息是否需要回复，无需被 @ 即可发言。',
+      ].join('\n');
+    },
+  };
+}

package/src/commands/bot-help.ts

@@ -0,0 +1,40 @@
+import type { SlashCommand } from '@tencent-connect/qqbot-nodejs';
+import type { ResolvedQQBotAccount } from '../types.js';
+import { getPackageVersion } from '../utils/pkg-version.js';
+
+const PLUGIN_VERSION = getPackageVersion();
+
+/** 群聊时隐藏的仅限私聊指令 */
+const GROUP_EXCLUDED = new Set([
+  'bot-upgrade', 'bot-clear-storage', 'bot-logs',
+  'bot-approve', 'bot-group-always', 'bot-group-allways', 'bot-streaming', 'bot-me',
+]);
+
+/** /bot-help — 查看所有指令以及用途 */
+export function botHelp(_account: ResolvedQQBotAccount, allCommands: () => SlashCommand[]): SlashCommand {
+  return {
+    name: 'bot-help',
+    description: '查看所有指令以及用途',
+    usage: [
+      '/bot-help',
+      '',
+      '列出所有可用的 QQBot 插件内置指令及其简要说明。',
+      '使用 /指令名 ? 可查看某条指令的详细用法。',
+    ].join('\n'),
+    handler: (ctx) => {
+      const isGroup = ctx.message.kind === 'group';
+      const lines = ['### QQBot插件内置调试指令', ''];
+
+      for (const cmd of allCommands()) {
+        const name = Array.isArray(cmd.name) ? cmd.name[0] : cmd.name;
+        if (cmd.hidden) continue;
+        if (isGroup && GROUP_EXCLUDED.has(name)) continue;
+        if (cmd.authorized && cmd.authorized(ctx as any) !== true) continue;
+        lines.push(`<qqbot-cmd-input text="/${name}" show="/${name}"/> ${cmd.description ?? ''}`);
+      }
+
+      lines.push('', `> 插件版本 v${PLUGIN_VERSION}`);
+      return lines.join('\n');
+    },
+  };
+}

package/src/commands/bot-logs.ts

@@ -0,0 +1,248 @@
+import type { SlashCommand } from '@tencent-connect/qqbot-nodejs';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import crypto from 'node:crypto';
+import { getQQBotMediaDir } from '../utils/platform.js';
+import { checkCommandAuth } from './config-util.js';
+import type { PluginRuntime } from 'openclaw/plugin-sdk';
+import { getAdapters } from '../adapter/resolve.js';
+
+
+const MAX_LINES_PER_FILE = 1000;
+const MAX_FILES = 4;
+const LOG_KEYWORDS = ['gateway', 'openclaw', 'clawdbot', 'moltbot'];
+const LOG_PATTERN = new RegExp(LOG_KEYWORDS.join('|'), 'i');
+
+interface LogFileEntry {
+  filePath: string;
+  sourceDir: string;
+  mtime: number;
+}
+
+// ── 配置日志路径 ──
+
+/** 从 openclaw.json logging.file 提取配置的日志文件路径 */
+function getConfiguredLogFiles(runtime: PluginRuntime): string[] {
+  const files: string[] = [];
+  try {
+    const cfg = getAdapters(runtime).getConfig?.() ?? {};
+    const logFile = (cfg as any)?.logging?.file;
+    if (typeof logFile === 'string') {
+      files.push(path.resolve(logFile));
+    }
+  } catch { /* config unavailable */ }
+  return files;
+}
+
+// ── 候选目录收集 ──
+
+function collectCandidateLogDirs(runtime: PluginRuntime): string[] {
+  const homeDir = os.homedir();
+  const dirs = new Set<string>();
+  const pushDir = (p: string | undefined | null) => {
+    if (!p) return;
+    try { dirs.add(path.resolve(p)); } catch { /* skip */ }
+  };
+  const pushStateDir = (stateDir: string) => {
+    if (!stateDir) return;
+    pushDir(stateDir);
+    pushDir(path.join(stateDir, 'logs'));
+  };
+
+  // 0. 从配置 logging.file 提取目录（最精确）
+  for (const logFile of getConfiguredLogFiles(runtime)) {
+    pushDir(path.dirname(logFile));
+  }
+
+  // 1. *_STATE_DIR 环境变量
+  for (const [key, value] of Object.entries(process.env)) {
+    if (!value) continue;
+    if (/STATE_DIR$/i.test(key) && /(OPENCLAW|CLAWDBOT|MOLTBOT)/i.test(key)) {
+      pushStateDir(value);
+    }
+  }
+
+  // 2. 常见状态目录
+  for (const name of LOG_KEYWORDS) {
+    pushDir(path.join(homeDir, `.${name}`));
+    pushDir(path.join(homeDir, `.${name}`, 'logs'));
+    pushDir(path.join(homeDir, name));
+    pushDir(path.join(homeDir, name, 'logs'));
+  }
+
+  // 3. home/cwd/AppData 下包含产品名的子目录
+  const searchRoots = new Set([homeDir, process.cwd(), path.dirname(process.cwd())]);
+  if (process.env.APPDATA) searchRoots.add(process.env.APPDATA);
+  if (process.env.LOCALAPPDATA) searchRoots.add(process.env.LOCALAPPDATA);
+  for (const root of searchRoots) {
+    try {
+      const entries = fs.readdirSync(root, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+        const re = LOG_PATTERN;
+        if (!re.test(entry.name)) continue;
+        const base = path.join(root, entry.name);
+        pushDir(base);
+        pushDir(path.join(base, 'logs'));
+      }
+    } catch { /* skip */ }
+  }
+
+  // 4. /var/log (Linux)
+  if (process.platform !== 'win32') {
+    for (const name of LOG_KEYWORDS) {
+      pushDir(path.join('/var/log', name));
+    }
+  }
+
+  // 5. /tmp
+  if (process.platform === 'win32') {
+    pushDir('C:\\tmp');
+    if (process.env.TEMP) pushDir(process.env.TEMP);
+    if (process.env.TMP) pushDir(process.env.TMP);
+    if (process.env.LOCALAPPDATA) pushDir(path.join(process.env.LOCALAPPDATA, 'Temp'));
+  } else {
+    pushDir('/tmp');
+  }
+  for (const name of LOG_KEYWORDS) {
+    pushDir(path.join('/tmp', name));
+    if (process.platform === 'win32' && process.env.TEMP) {
+      pushDir(path.join(process.env.TEMP, name));
+    }
+  }
+
+  // PM2
+  const pm2Home = process.env.PM2_HOME ?? path.join(homeDir, '.pm2');
+  pushDir(path.join(pm2Home, 'logs'));
+
+  return Array.from(dirs);
+}
+
+// ── 日志文件收集 ──
+
+function collectRecentLogFiles(logDirs: string[], runtime: PluginRuntime): LogFileEntry[] {
+  const candidates: LogFileEntry[] = [];
+  const dedupe = new Set<string>();
+
+  const pushFile = (filePath: string, sourceDir: string) => {
+    const normalized = path.resolve(filePath);
+    if (dedupe.has(normalized)) return;
+    try {
+      const stat = fs.statSync(normalized);
+      if (!stat.isFile() || stat.size === 0) return;
+      dedupe.add(normalized);
+      candidates.push({ filePath: normalized, sourceDir, mtime: stat.mtimeMs });
+    } catch { /* skip */ }
+  };
+
+  // 配置指定的日志文件（最高优先级）
+  for (const logFile of getConfiguredLogFiles(runtime)) {
+    pushFile(logFile, path.dirname(logFile));
+  }
+
+  for (const dir of logDirs) {
+    // 知名文件名
+    for (const name of ['gateway.log', 'gateway.err.log', 'openclaw.log', 'clawdbot.log', 'moltbot.log']) {
+      pushFile(path.join(dir, name), dir);
+    }
+    // 扫描所有 .log/.txt，按关键词过滤
+    try {
+      const entries = fs.readdirSync(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isFile()) continue;
+        if (!/\.(log|txt)$/i.test(entry.name)) continue;
+        const re = LOG_PATTERN;
+        if (!re.test(entry.name)) continue;
+        pushFile(path.join(dir, entry.name), dir);
+      }
+    } catch { /* skip */ }
+  }
+
+  return candidates.sort((a, b) => b.mtime - a.mtime);
+}
+
+// ── 命令 ──
+
+/** /bot-logs — 导出本地日志文件 */
+export function botLogs(runtime: PluginRuntime): SlashCommand {
+  return {
+    name: 'bot-logs',
+    description: '导出本地日志文件',
+    scope: 'c2c',
+    authorized: checkCommandAuth,
+    usage: [
+      '/bot-logs',
+      '',
+      `导出最近的 OpenClaw 日志文件（最多 ${MAX_FILES} 个）。`,
+      `每个文件最多保留最后 ${MAX_LINES_PER_FILE} 行，以文件形式返回。`,
+    ].join('\n'),
+    handler: async (ctx) => {
+      const logDirs = collectCandidateLogDirs(runtime);
+      const recentFiles = collectRecentLogFiles(logDirs, runtime).slice(0, MAX_FILES);
+
+      if (recentFiles.length === 0) {
+        const existingDirs = logDirs.filter((d) => { try { return fs.existsSync(d); } catch { return false; } });
+        const searched = existingDirs.length > 0
+          ? existingDirs.map((d) => `  • ${d}`).join('\n')
+          : logDirs.map((d) => `  • ${d}`).join('\n');
+        return [
+          '⚠️ 未找到日志文件',
+          '',
+          '已搜索以下路径：',
+          searched,
+        ].join('\n');
+      }
+
+      const lines: string[] = [];
+      let totalIncluded = 0;
+      let totalOriginal = 0;
+      let truncatedCount = 0;
+
+      for (const logFile of recentFiles) {
+        try {
+          const content = fs.readFileSync(logFile.filePath, 'utf8');
+          const allLines = content.split('\n');
+          const tail = allLines.slice(-MAX_LINES_PER_FILE);
+          if (tail.length > 0) {
+            const fileName = path.basename(logFile.filePath);
+            lines.push(`\n== ${fileName} (last ${tail.length}/${allLines.length}) ==`);
+            lines.push(...tail);
+            totalIncluded += tail.length;
+            totalOriginal += allLines.length;
+            if (allLines.length > MAX_LINES_PER_FILE) truncatedCount++;
+          }
+        } catch { /* skip */ }
+      }
+
+      if (lines.length === 0) {
+        return '⚠️ 找到日志文件但读取失败';
+      }
+
+      const tmpDir = getQQBotMediaDir('exports');
+      if (!fs.existsSync(tmpDir)) fs.mkdirSync(tmpDir, { recursive: true });
+      const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+      const suffix = crypto.randomBytes(4).toString('hex');
+      const tmpFile = path.join(tmpDir, `bot-logs-${timestamp}-${suffix}.txt`);
+      fs.writeFileSync(tmpFile, lines.join('\n'), 'utf8');
+
+      let summary = `${recentFiles.length} 个日志文件，共 ${totalIncluded} 行`;
+      if (truncatedCount > 0) summary += `（${truncatedCount} 个截断，原始 ${totalOriginal} 行）`;
+
+      try {
+        const senderId = ctx.message.senderId;
+        if (senderId) {
+          await ctx.bot.sendFile(
+            { scope: 'c2c', targetId: senderId, msgId: ctx.message.messageId },
+            { localPath: tmpFile },
+            { fileName: `bot-logs-${timestamp}-${suffix}.txt` },
+          );
+        }
+      } catch (err) {
+        return `📋 ${summary}\n⚠️ 文件发送失败：${err instanceof Error ? err.message : err}\n📎 ${tmpFile}`;
+      }
+
+      return `📋 ${summary}`;
+    },
+  };
+}

package/src/commands/bot-me.ts

@@ -0,0 +1,18 @@
+import type { SlashCommand } from '@tencent-connect/qqbot-nodejs';
+
+/** /bot-me — 查看发送者 OpenID（仅私聊） */
+export function botMe(): SlashCommand {
+  return {
+    name: 'bot-me',
+    description: '查看你的 OpenID（仅私聊）',
+    usage: `/bot-me
+
+查看你在当前 QQBot 应用下的唯一 OpenID。
+此 ID 用于管理员识别、访问控制等场景。`,
+    scope: 'c2c',
+    handler: (ctx) => {
+      const senderId = ctx.message.senderId ?? 'unknown';
+      return `🆔 你的 OpenID: \`${senderId}\``;
+    },
+  };
+}

package/src/commands/bot-pairing.ts

@@ -0,0 +1,57 @@
+import type { SlashCommand } from '@tencent-connect/qqbot-nodejs';
+import type { PluginRuntime } from 'openclaw/plugin-sdk';
+import { getPairingApi } from '../adapter/pairing.js';
+import { checkCommandAuth } from './config-util.js';
+
+/** /bot-pairing — DM 配对审批管理 */
+export function botPairing(_getRuntime: () => PluginRuntime): SlashCommand {
+  return {
+    name: 'bot-pairing',
+    description: '管理 DM 配对审批',
+    scope: 'c2c',
+    hidden: true,
+    usage: `/bot-pairing approve <code>
+
+批准指定配对码，允许对应用户私聊机器人。
+配对码由用户首次私聊时自动生成。`,
+    authorized: checkCommandAuth,
+    handler: async (ctx) => {
+      const args = (Array.isArray(ctx.command.args) ? ctx.command.args.join(' ') : String(ctx.command.args ?? '')).trim();
+      const parts = args.split(/\s+/);
+      const subCmd = parts[0]?.toLowerCase();
+      const code = parts[1]?.trim();
+
+      if (subCmd !== 'approve' || !code) {
+        return '⚠️ 用法: /bot-pairing approve <配对码>';
+      }
+
+      const api = getPairingApi();
+      if (!api) {
+        return '⚠️ 当前 OpenClaw 版本不支持配对审批功能。';
+      }
+
+      try {
+        const result = await api.approveCode({
+          channel: 'qqbot',
+          code,
+        });
+
+        if (!result?.id) {
+          return [
+            `⚠️ 配对码 \`${code}\` 无效或已过期。`,
+            '',
+            '每个配对码有效期为 1 小时。',
+          ].join('\n');
+        }
+
+        return [
+          '✅ 已批准用户访问。',
+          '',
+          `用户 ID: \`${result.id}\``,
+        ].join('\n');
+      } catch (err) {
+        return `❌ 审批失败: ${(err as Error).message}`;
+      }
+    },
+  };
+}