@ryantest/openclaw-qqbot 0.0.1

package/scripts/send-proactive.ts

@@ -0,0 +1,293 @@
+#!/usr/bin/env npx ts-node
+/**
+ * QQBot 主动消息 CLI 工具
+ * 
+ * 使用示例：
+ *   # 发送私聊消息
+ *   npx ts-node scripts/send-proactive.ts --to "用户openid" --text "你好！"
+ *   
+ *   # 发送群聊消息
+ *   npx ts-node scripts/send-proactive.ts --to "群组openid" --type group --text "群公告"
+ *   
+ *   # 列出已知用户
+ *   npx ts-node scripts/send-proactive.ts --list
+ *   
+ *   # 列出群聊用户
+ *   npx ts-node scripts/send-proactive.ts --list --type group
+ *   
+ *   # 广播消息
+ *   npx ts-node scripts/send-proactive.ts --broadcast --text "系统公告" --type c2c --limit 10
+ */
+
+import { 
+  sendProactiveMessageDirect,
+  listKnownUsers, 
+  getKnownUsersStats,
+  broadcastMessage,
+} from "../src/proactive.js";
+import type { ResolvedQQBotAccount } from "../src/types.js";
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+// 解析命令行参数
+function parseArgs(): Record<string, string | boolean> {
+  const args: Record<string, string | boolean> = {};
+  const argv = process.argv.slice(2);
+  
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg.startsWith("--")) {
+      const key = arg.slice(2);
+      const nextArg = argv[i + 1];
+      if (nextArg && !nextArg.startsWith("--")) {
+        args[key] = nextArg;
+        i++;
+      } else {
+        args[key] = true;
+      }
+    }
+  }
+  
+  return args;
+}
+
+function normalizeAppId(raw: unknown): string {
+  if (raw === null || raw === undefined) return "";
+  return String(raw).trim();
+}
+
+function detectConfigPath(): string | null {
+  const home = process.env.HOME || "/home/ubuntu";
+  for (const app of ["openclaw", "clawdbot", "moltbot"]) {
+    const p = path.join(home, `.${app}`, `${app}.json`);
+    if (fs.existsSync(p)) return p;
+  }
+  return null;
+}
+
+// 从配置文件加载账户信息
+function loadAccount(accountId = "default"): ResolvedQQBotAccount | null {
+  const configPath = detectConfigPath();
+  
+  try {
+    if (!configPath || !fs.existsSync(configPath)) {
+      // 尝试从环境变量获取
+      const appId = process.env.QQBOT_APP_ID;
+      const clientSecret = process.env.QQBOT_CLIENT_SECRET;
+      
+      if (appId && clientSecret) {
+        return {
+          accountId,
+          appId: normalizeAppId(appId),
+          clientSecret,
+          enabled: true,
+          secretSource: "env",
+          markdownSupport: true,
+          config: {},
+        };
+      }
+      
+      console.error("配置文件不存在且环境变量未设置");
+      return null;
+    }
+    
+    const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    const qqbot = config.channels?.qqbot;
+    
+    if (!qqbot) {
+      console.error("配置中没有 qqbot 配置");
+      return null;
+    }
+    
+    // 解析账户配置
+    if (accountId === "default") {
+      return {
+        accountId: "default",
+        appId: normalizeAppId(qqbot.appId ?? process.env.QQBOT_APP_ID),
+        clientSecret: qqbot.clientSecret || process.env.QQBOT_CLIENT_SECRET,
+        enabled: qqbot.enabled ?? true,
+        secretSource: qqbot.clientSecret ? "config" : "env",
+        markdownSupport: qqbot.markdownSupport ?? true,
+        config: qqbot,
+      };
+    }
+    
+    const accountConfig = qqbot.accounts?.[accountId];
+    if (accountConfig) {
+      return {
+        accountId,
+        appId: normalizeAppId(accountConfig.appId ?? qqbot.appId ?? process.env.QQBOT_APP_ID),
+        clientSecret: accountConfig.clientSecret || qqbot.clientSecret || process.env.QQBOT_CLIENT_SECRET,
+        enabled: accountConfig.enabled ?? true,
+        secretSource: accountConfig.clientSecret ? "config" : "env",
+        markdownSupport: accountConfig.markdownSupport ?? qqbot.markdownSupport ?? true,
+        config: accountConfig,
+      };
+    }
+    
+    console.error(`账户 ${accountId} 不存在`);
+    return null;
+  } catch (err) {
+    console.error(`加载配置失败: ${err}`);
+    return null;
+  }
+}
+
+async function main() {
+  const args = parseArgs();
+  
+  // 显示帮助
+  if (args.help || args.h) {
+    console.log(`
+QQBot 主动消息 CLI 工具
+
+用法:
+  npx ts-node scripts/send-proactive.ts [选项]
+
+选项:
+  --to <openid>      目标用户或群组的 openid
+  --text <message>   要发送的消息内容
+  --type <type>      消息类型: c2c (私聊) 或 group (群聊)，默认 c2c
+  --account <id>     账户 ID，默认 default
+  
+  --list             列出已知用户
+  --stats            显示用户统计
+  --broadcast        广播消息给所有已知用户
+  --limit <n>        限制数量
+  
+  --help, -h         显示帮助
+
+示例:
+  # 发送私聊消息
+  npx ts-node scripts/send-proactive.ts --to "0Eda5EA7-xxx" --text "你好！"
+  
+  # 发送群聊消息
+  npx ts-node scripts/send-proactive.ts --to "A1B2C3D4" --type group --text "群公告"
+  
+  # 列出最近 10 个私聊用户
+  npx ts-node scripts/send-proactive.ts --list --type c2c --limit 10
+  
+  # 广播消息
+  npx ts-node scripts/send-proactive.ts --broadcast --text "系统公告" --limit 5
+`);
+    return;
+  }
+  
+  const accountId = (args.account as string) || "default";
+  const type = (args.type as "c2c" | "group") || "c2c";
+  const limit = args.limit ? parseInt(args.limit as string, 10) : undefined;
+  
+  // 列出已知用户
+  if (args.list) {
+    const users = listKnownUsers({ 
+      type: args.type as "c2c" | "group" | "channel" | undefined,
+      accountId: args.account as string | undefined,
+      limit,
+    });
+    
+    if (users.length === 0) {
+      console.log("没有已知用户");
+      return;
+    }
+    
+    console.log(`\n已知用户列表 (共 ${users.length} 个):\n`);
+    console.log("类型\t\tOpenID\t\t\t\t\t\t昵称\t\t最后交互时间");
+    console.log("─".repeat(100));
+    
+    for (const user of users) {
+      const lastTime = new Date(user.lastInteractionAt).toLocaleString();
+      console.log(`${user.type}\t\t${user.openid.slice(0, 20)}...\t${user.nickname || "-"}\t\t${lastTime}`);
+    }
+    return;
+  }
+  
+  // 显示统计
+  if (args.stats) {
+    const stats = getKnownUsersStats(args.account as string | undefined);
+    console.log(`\n用户统计:`);
+    console.log(`  总计: ${stats.total}`);
+    console.log(`  私聊: ${stats.c2c}`);
+    console.log(`  群聊: ${stats.group}`);
+    console.log(`  频道: ${stats.channel}`);
+    return;
+  }
+  
+  // 广播消息
+  if (args.broadcast) {
+    if (!args.text) {
+      console.error("请指定消息内容 (--text)");
+      process.exit(1);
+    }
+    
+    // 加载配置用于广播
+    const configPath = detectConfigPath();
+    let cfg: Record<string, unknown> = {};
+    try {
+      if (configPath && fs.existsSync(configPath)) {
+        cfg = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+      }
+    } catch {}
+    
+    console.log(`\n开始广播消息...\n`);
+    const result = await broadcastMessage(args.text as string, cfg as any, {
+      type,
+      accountId,
+      limit,
+    });
+    
+    console.log(`\n广播完成:`);
+    console.log(`  发送总数: ${result.total}`);
+    console.log(`  成功: ${result.success}`);
+    console.log(`  失败: ${result.failed}`);
+    
+    if (result.failed > 0) {
+      console.log(`\n失败详情:`);
+      for (const r of result.results) {
+        if (!r.result.success) {
+          console.log(`  ${r.to}: ${r.result.error}`);
+        }
+      }
+    }
+    return;
+  }
+  
+  // 发送单条消息
+  if (args.to && args.text) {
+    const account = loadAccount(accountId);
+    if (!account) {
+      console.error("无法加载账户配置");
+      process.exit(1);
+    }
+    
+    console.log(`\n发送消息...`);
+    console.log(`  目标: ${args.to}`);
+    console.log(`  类型: ${type}`);
+    console.log(`  内容: ${args.text}`);
+    
+    const result = await sendProactiveMessageDirect(
+      account,
+      args.to as string,
+      args.text as string,
+      type
+    );
+    
+    if (result.success) {
+      console.log(`\n✅ 发送成功!`);
+      console.log(`  消息ID: ${result.messageId}`);
+      console.log(`  时间戳: ${result.timestamp}`);
+    } else {
+      console.log(`\n❌ 发送失败: ${result.error}`);
+      process.exit(1);
+    }
+    return;
+  }
+  
+  // 没有有效参数
+  console.error("请指定操作。使用 --help 查看帮助。");
+  process.exit(1);
+}
+
+main().catch((err) => {
+  console.error(`执行失败: ${err}`);
+  process.exit(1);
+});

package/scripts/set-markdown.sh

@@ -0,0 +1,156 @@
+#!/bin/bash
+
+# qqbot markdown 配置脚本
+# 用于单独设置是否启用 markdown 消息格式
+# 直接编辑 JSON 配置文件，避免框架验证拒绝未注册的 channel
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+cd "$SCRIPT_DIR"
+
+# 自动检测 CLI 配置文件（兼容 openclaw / clawdbot / moltbot）
+OPENCLAW_CONFIG=""
+for app in openclaw clawdbot moltbot; do
+    cfg="$HOME/.$app/$app.json"
+    if [ -f "$cfg" ]; then
+        OPENCLAW_CONFIG="$cfg"
+        break
+    fi
+done
+
+if [ -z "$OPENCLAW_CONFIG" ]; then
+    echo "❌ 未找到 openclaw / clawdbot / moltbot 配置文件"
+    echo "  请先运行 openclaw onboard 初始化配置"
+    exit 1
+fi
+
+show_help() {
+    echo "用法: $0 [选项]"
+    echo ""
+    echo "选项:"
+    echo "  enable, on, yes      启用 markdown 消息格式"
+    echo "  disable, off, no     禁用 markdown 消息格式（使用纯文本）"
+    echo "  status               显示当前 markdown 配置状态"
+    echo "  -h, --help           显示帮助信息"
+    echo ""
+    echo "示例:"
+    echo "  $0 enable            启用 markdown"
+    echo "  $0 disable           禁用 markdown"
+    echo "  $0 status            查看当前状态"
+    echo "  $0                   交互式选择"
+    echo ""
+    echo "⚠️  注意: 启用 markdown 需要在 QQ 开放平台申请 markdown 消息权限"
+    echo "         如果没有权限，消息将无法正常发送！"
+}
+
+set_markdown_value() {
+    local value="$1"
+    node -e "
+      const fs = require('fs');
+      const cfg = JSON.parse(fs.readFileSync('$OPENCLAW_CONFIG', 'utf-8'));
+      if (!cfg.channels) cfg.channels = {};
+      if (!cfg.channels.qqbot) cfg.channels.qqbot = {};
+      cfg.channels.qqbot.markdownSupport = $value;
+      fs.writeFileSync('$OPENCLAW_CONFIG', JSON.stringify(cfg, null, 4) + '\n');
+    "
+}
+
+enable_markdown() {
+    echo "✅ 启用 markdown 消息格式..."
+    set_markdown_value true
+    echo ""
+    echo "markdown 已启用。"
+    echo "⚠️  请确保您已在 QQ 开放平台申请了 markdown 消息权限。"
+}
+
+disable_markdown() {
+    echo "❌ 禁用 markdown 消息格式（使用纯文本）..."
+    set_markdown_value false
+    echo ""
+    echo "markdown 已禁用，将使用纯文本格式发送消息。"
+}
+
+show_status() {
+    echo "当前 markdown 配置状态:"
+    echo "  配置文件: $OPENCLAW_CONFIG"
+    echo ""
+    current=$(node -e "
+      const cfg = JSON.parse(require('fs').readFileSync('$OPENCLAW_CONFIG', 'utf-8'));
+      console.log(cfg.channels?.qqbot?.markdownSupport ?? '未设置');
+    " 2>/dev/null || echo "未设置")
+    if [ "$current" = "true" ]; then
+        echo "  状态: ✅ 已启用"
+        echo ""
+        echo "  ⚠️  请确保您已在 QQ 开放平台申请了 markdown 消息权限。"
+    elif [ "$current" = "false" ]; then
+        echo "  状态: ❌ 已禁用（纯文本模式）"
+    else
+        echo "  状态: 未设置（默认: 禁用）"
+    fi
+}
+
+interactive_select() {
+    echo "========================================="
+    echo "  qqbot markdown 配置"
+    echo "========================================="
+    echo ""
+    show_status
+    echo ""
+    echo "-----------------------------------------"
+    echo ""
+    echo "是否启用 markdown 消息格式？"
+    echo ""
+    echo "⚠️  注意: 启用 markdown 需要在 QQ 开放平台申请 markdown 消息权限"
+    echo "         如果没有权限，消息将无法正常发送！"
+    echo ""
+    echo "  1) 启用 markdown"
+    echo "  2) 禁用 markdown（纯文本）"
+    echo "  3) 取消"
+    echo ""
+    read -t 10 -p "请选择 [1-3] (默认: 2): " choice || choice="2"
+    
+    case "$choice" in
+        1)
+            echo ""
+            enable_markdown
+            ;;
+        2|"")
+            echo ""
+            disable_markdown
+            ;;
+        3)
+            echo "已取消。"
+            exit 0
+            ;;
+        *)
+            echo "无效选择，已取消。"
+            exit 1
+            ;;
+    esac
+}
+
+# 主逻辑
+case "${1:-}" in
+    enable|on|yes)
+        enable_markdown
+        ;;
+    disable|off|no)
+        disable_markdown
+        ;;
+    status)
+        show_status
+        ;;
+    -h|--help)
+        show_help
+        ;;
+    "")
+        interactive_select
+        ;;
+    *)
+        echo "未知选项: $1"
+        echo ""
+        show_help
+        exit 1
+        ;;
+esac

package/scripts/test-sendmedia.ts

@@ -0,0 +1,116 @@
+/**
+ * 测试 sendMedia 路径：语音、视频、文件
+ * 用法：npx tsx scripts/test-sendmedia.ts <openid>
+ */
+import { sendMedia } from "../src/outbound.js";
+import type { ResolvedQQBotAccount } from "../src/types.js";
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+const LOG_FILE = "/tmp/test-sendmedia-output.log";
+
+function log(msg: string) {
+  const line = msg + "\n";
+  process.stdout.write(line);
+  fs.appendFileSync(LOG_FILE, line);
+}
+
+function normalizeAppId(raw: unknown): string {
+  if (raw === null || raw === undefined) return "";
+  return String(raw).trim();
+}
+
+function detectConfigPath(): string | null {
+  const home = process.env.HOME || "/home/ubuntu";
+  for (const app of ["openclaw", "clawdbot", "moltbot"]) {
+    const p = path.join(home, `.${app}`, `${app}.json`);
+    if (fs.existsSync(p)) return p;
+  }
+  return null;
+}
+
+function loadAccount(): ResolvedQQBotAccount | null {
+  const configPath = detectConfigPath();
+  try {
+    if (!configPath || !fs.existsSync(configPath)) {
+      const appId = process.env.QQBOT_APP_ID;
+      const clientSecret = process.env.QQBOT_CLIENT_SECRET;
+      if (appId && clientSecret) {
+        return { accountId: "default", appId: normalizeAppId(appId), clientSecret, enabled: true, secretSource: "env", markdownSupport: true, config: {} };
+      }
+      return null;
+    }
+    const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    const qqbot = config.channels?.qqbot;
+    if (!qqbot) return null;
+    return {
+      accountId: "default",
+      appId: normalizeAppId(qqbot.appId ?? process.env.QQBOT_APP_ID),
+      clientSecret: qqbot.clientSecret || process.env.QQBOT_CLIENT_SECRET,
+      enabled: qqbot.enabled ?? true,
+      secretSource: qqbot.clientSecret ? "config" as const : "env" as const,
+      markdownSupport: qqbot.markdownSupport ?? true,
+      config: qqbot,
+    };
+  } catch (err) {
+    return null;
+  }
+}
+
+function sleep(ms: number) { return new Promise(r => setTimeout(r, ms)); }
+
+async function main() {
+  // 清空日志
+  fs.writeFileSync(LOG_FILE, "");
+
+  const openid = process.argv[2];
+  if (!openid) { log("用法: npx tsx scripts/test-sendmedia.ts <openid>"); process.exit(1); }
+
+  const account = loadAccount();
+  if (!account) { log("无法加载账户配置"); process.exit(1); }
+
+  const to = `c2c:${openid}`;
+  log(`目标: ${to}\n`);
+
+  // ===== 1. 语音 =====
+  log("==================================================");
+  log("TEST 1: 语音 (本地 WAV 文件)");
+  log("==================================================");
+  const wavPath = "/tmp/test-voice.wav";
+  if (fs.existsSync(wavPath)) {
+    const r1 = await sendMedia({ to, text: "测试语音 sendMedia", mediaUrl: wavPath, account });
+    log("结果: " + JSON.stringify(r1, null, 2));
+  } else {
+    log("跳过: /tmp/test-voice.wav 不存在");
+  }
+
+  await sleep(2000);
+
+  // ===== 2. 视频 =====
+  log("\n==================================================");
+  log("TEST 2: 视频 (公网 MP4 URL)");
+  log("==================================================");
+  const videoUrl = "https://www.w3schools.com/html/mov_bbb.mp4";
+  const r2 = await sendMedia({ to, text: "测试视频 sendMedia", mediaUrl: videoUrl, account });
+  log("结果: " + JSON.stringify(r2, null, 2));
+
+  await sleep(2000);
+
+  // ===== 3. 文件 =====
+  log("\n==================================================");
+  log("TEST 3: 文件 (本地 TXT 文件)");
+  log("==================================================");
+  const txtPath = "/tmp/test-doc.txt";
+  if (fs.existsSync(txtPath)) {
+    const r3 = await sendMedia({ to, text: "测试文件 sendMedia", mediaUrl: txtPath, account });
+    log("结果: " + JSON.stringify(r3, null, 2));
+  } else {
+    log("跳过: /tmp/test-doc.txt 不存在");
+  }
+
+  log("\n==================================================");
+  log("全部测试完成");
+  log("==================================================");
+}
+
+main().catch(err => { log("脚本异常: " + err); process.exit(1); });