@ryantest/openclaw-qqbot 0.0.1

package/node_modules/ws/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "ws",
+  "version": "8.19.0",
+  "description": "Simple to use, blazing fast and thoroughly tested websocket client and server for Node.js",
+  "keywords": [
+    "HyBi",
+    "Push",
+    "RFC-6455",
+    "WebSocket",
+    "WebSockets",
+    "real-time"
+  ],
+  "homepage": "https://github.com/websockets/ws",
+  "bugs": "https://github.com/websockets/ws/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/websockets/ws.git"
+  },
+  "author": "Einar Otto Stangvik <einaros@gmail.com> (http://2x.io)",
+  "license": "MIT",
+  "main": "index.js",
+  "exports": {
+    ".": {
+      "browser": "./browser.js",
+      "import": "./wrapper.mjs",
+      "require": "./index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "browser": "browser.js",
+  "engines": {
+    "node": ">=10.0.0"
+  },
+  "files": [
+    "browser.js",
+    "index.js",
+    "lib/*.js",
+    "wrapper.mjs"
+  ],
+  "scripts": {
+    "test": "nyc --reporter=lcov --reporter=text mocha --throw-deprecation test/*.test.js",
+    "integration": "mocha --throw-deprecation test/*.integration.js",
+    "lint": "eslint . && prettier --check --ignore-path .gitignore \"**/*.{json,md,yaml,yml}\""
+  },
+  "peerDependencies": {
+    "bufferutil": "^4.0.1",
+    "utf-8-validate": ">=5.0.2"
+  },
+  "peerDependenciesMeta": {
+    "bufferutil": {
+      "optional": true
+    },
+    "utf-8-validate": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "benchmark": "^2.1.4",
+    "bufferutil": "^4.0.1",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-plugin-prettier": "^5.0.0",
+    "globals": "^16.0.0",
+    "mocha": "^8.4.0",
+    "nyc": "^15.0.0",
+    "prettier": "^3.0.0",
+    "utf-8-validate": "^6.0.0"
+  }
+}

package/node_modules/ws/wrapper.mjs

@@ -0,0 +1,8 @@
+import createWebSocketStream from './lib/stream.js';
+import Receiver from './lib/receiver.js';
+import Sender from './lib/sender.js';
+import WebSocket from './lib/websocket.js';
+import WebSocketServer from './lib/websocket-server.js';
+
+export { createWebSocketStream, Receiver, Sender, WebSocket, WebSocketServer };
+export default WebSocket;

package/openclaw.plugin.json

@@ -0,0 +1,16 @@
+{
+  "id": "openclaw-qqbot",
+  "name": "OpenClaw QQ Bot",
+  "description": "QQ Bot channel plugin with message support, cron jobs, and proactive messaging",
+  "channels": ["qqbot"],
+  "skills": ["skills/qqbot-channel", "skills/qqbot-remind", "skills/qqbot-media"],
+  "capabilities": {
+    "proactiveMessaging": true,
+    "cronJobs": true
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@ryantest/openclaw-qqbot",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "openclaw-qqbot": "./bin/qqbot-cli.js",
+    "qqbot": "./bin/qqbot-cli.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "src",
+    "skills",
+    "scripts",
+    "index.ts",
+    "tsconfig.json",
+    "openclaw.plugin.json",
+    "clawdbot.plugin.json",
+    "moltbot.plugin.json"
+  ],
+  "clawdbot": {
+    "id": "openclaw-qqbot",
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "moltbot": {
+    "id": "openclaw-qqbot",
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "openclaw": {
+    "id": "openclaw-qqbot",
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "scripts": {
+    "build": "tsc || true",
+    "dev": "tsc --watch",
+    "prepack": "npm install --omit=dev"
+  },
+  "dependencies": {
+    "mpg123-decoder": "^1.0.3",
+    "silk-wasm": "^3.7.1",
+    "ws": "^8.18.0"
+  },
+  "bundledDependencies": [
+    "mpg123-decoder",
+    "silk-wasm",
+    "ws"
+  ],
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/ws": "^8.5.0",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "clawdbot": "*",
+    "moltbot": "*",
+    "openclaw": "*"
+  },
+  "homepage": "https://github.com/tencent-connect/openclaw-qqbot",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tencent-connect/openclaw-qqbot.git"
+  },
+  "bundleDependencies": [
+    "mpg123-decoder",
+    "silk-wasm",
+    "ws"
+  ]
+}

package/scripts/cleanup-legacy-plugins.sh

@@ -0,0 +1,124 @@
+#!/bin/bash
+# qqbot 插件升级脚本
+# 用于清理旧版本插件并重新安装
+# 兼容 clawdbot 和 openclaw 两种安装
+
+set -e
+
+echo "=== qqbot 插件升级脚本 ==="
+
+# 检测使用的是 clawdbot 还是 openclaw
+detect_installation() {
+  if [ -d "$HOME/.clawdbot" ]; then
+    echo "clawdbot"
+  elif [ -d "$HOME/.openclaw" ]; then
+    echo "openclaw"
+  else
+    echo ""
+  fi
+}
+
+# 可能的扩展目录名（原仓库 qqbot + 本仓库框架推断名 openclaw-qq）
+EXTENSION_DIRS=("qqbot" "openclaw-qq" "openclaw-qqbot")
+
+# 清理指定目录的函数
+cleanup_installation() {
+  local APP_NAME="$1"
+  local APP_DIR="$HOME/.$APP_NAME"
+  local CONFIG_FILE="$APP_DIR/$APP_NAME.json"
+
+  echo ""
+  echo ">>> 处理 $APP_NAME 安装..."
+
+  # 1. 删除所有可能的旧扩展目录
+  for dir_name in "${EXTENSION_DIRS[@]}"; do
+    local ext_dir="$APP_DIR/extensions/$dir_name"
+    if [ -d "$ext_dir" ]; then
+      echo "删除旧版本插件: $ext_dir"
+      rm -rf "$ext_dir"
+    fi
+  done
+
+  # 2. 清理配置文件中所有可能的插件 ID 相关字段
+  if [ -f "$CONFIG_FILE" ]; then
+    echo "清理配置文件中的插件字段..."
+    
+    # 使用 node 处理 JSON（比 jq 更可靠处理复杂结构）
+    node -e "
+      const fs = require('fs');
+      const config = JSON.parse(fs.readFileSync('$CONFIG_FILE', 'utf8'));
+      const ids = ['qqbot', 'openclaw-qq', '@sliverp/qqbot', '@tencent-connect/qqbot', '@tencent-connect/openclaw-qq', '@tencent-connect/openclaw-qqbot', 'openclaw-qqbot'];
+      
+      for (const id of ids) {
+        // 注意: 不删除 channels.<id>，因为里面保存了用户的 appid/secret 凭证
+        // 凭证与插件版本无关，清理插件时不应清除凭证
+
+        // 删除 plugins.entries.<id>
+        if (config.plugins && config.plugins.entries && config.plugins.entries[id]) {
+          delete config.plugins.entries[id];
+          console.log('  - 已删除 plugins.entries.' + id);
+        }
+        
+        // 删除 plugins.installs.<id>
+        if (config.plugins && config.plugins.installs && config.plugins.installs[id]) {
+          delete config.plugins.installs[id];
+          console.log('  - 已删除 plugins.installs.' + id);
+        }
+
+        // 删除 plugins.allow 中的 <id>
+        if (config.plugins && Array.isArray(config.plugins.allow)) {
+          const before = config.plugins.allow.length;
+          config.plugins.allow = config.plugins.allow.filter((x) => x !== id);
+          if (config.plugins.allow.length !== before) {
+            console.log('  - 已删除 plugins.allow 项: ' + id);
+          }
+        }
+      }
+      
+      fs.writeFileSync('$CONFIG_FILE', JSON.stringify(config, null, 2));
+      console.log('配置文件已更新');
+    "
+  else
+    echo "未找到配置文件: $CONFIG_FILE"
+  fi
+}
+
+# 检测并处理所有可能的安装
+FOUND_INSTALLATION=""
+
+# 检查 clawdbot
+if [ -d "$HOME/.clawdbot" ]; then
+  cleanup_installation "clawdbot"
+  FOUND_INSTALLATION="clawdbot"
+fi
+
+# 检查 openclaw
+if [ -d "$HOME/.openclaw" ]; then
+  cleanup_installation "openclaw"
+  FOUND_INSTALLATION="openclaw"
+fi
+
+# 检查 moltbot
+if [ -d "$HOME/.moltbot" ]; then
+  cleanup_installation "moltbot"
+  FOUND_INSTALLATION="moltbot"
+fi
+
+# 如果都没找到
+if [ -z "$FOUND_INSTALLATION" ]; then
+  echo "未找到 clawdbot / openclaw / moltbot 安装目录"
+  echo "请确认已安装其中之一"
+  exit 1
+fi
+
+# 使用检测到的安装类型作为命令
+CMD="$FOUND_INSTALLATION"
+
+echo ""
+echo "=== 清理完成 ==="
+echo ""
+echo "接下来将执行以下命令重新安装插件:"
+echo "  cd /path/to/openclaw-qqbot"
+echo "  $CMD plugins install ."
+echo "  $CMD channels add --channel qqbot --token \"appid:appsecret\""
+echo "  $CMD gateway restart"

package/scripts/proactive-api-server.ts

@@ -0,0 +1,369 @@
+/**
+ * QQBot 主动消息 HTTP API 服务
+ * 
+ * 提供 RESTful API 用于：
+ * 1. 发送主动消息
+ * 2. 查询已知用户
+ * 3. 广播消息
+ * 
+ * 启动方式：
+ *   npx ts-node scripts/proactive-api-server.ts --port 3721
+ * 
+ * API 端点：
+ *   POST /send          - 发送主动消息
+ *   GET  /users         - 列出已知用户
+ *   GET  /users/stats   - 获取用户统计
+ *   POST /broadcast     - 广播消息
+ */
+
+import * as http from "node:http";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as url from "node:url";
+import {
+  sendProactiveMessageDirect,
+  listKnownUsers,
+  getKnownUsersStats,
+  getKnownUser,
+  broadcastMessage,
+} from "../src/proactive.js";
+import type { ResolvedQQBotAccount } from "../src/types.js";
+
+// 默认端口
+const DEFAULT_PORT = 3721;
+
+// 自动检测配置文件路径（兼容 openclaw / clawdbot / moltbot）
+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 normalizeAppId(raw: unknown): string {
+  if (raw === null || raw === undefined) return "";
+  return String(raw).trim();
+}
+
+// 从配置文件加载账户信息
+function loadAccount(accountId = "default"): ResolvedQQBotAccount | null {
+  const configPath = detectConfigPath();
+  
+  try {
+    // 优先从环境变量获取
+    const envAppId = process.env.QQBOT_APP_ID;
+    const envClientSecret = process.env.QQBOT_CLIENT_SECRET;
+    
+    if (!configPath || !fs.existsSync(configPath)) {
+      if (envAppId && envClientSecret) {
+        return {
+          accountId,
+          appId: normalizeAppId(envAppId),
+          clientSecret: envClientSecret,
+          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) {
+      if (envAppId && envClientSecret) {
+        return {
+          accountId,
+          appId: normalizeAppId(envAppId),
+          clientSecret: envClientSecret,
+          enabled: true,
+          secretSource: "env",
+          markdownSupport: true,
+          config: {},
+        };
+      }
+      return null;
+    }
+    
+    // 解析账户配置
+    if (accountId === "default") {
+      return {
+        accountId: "default",
+        appId: normalizeAppId(qqbot.appId ?? envAppId),
+        clientSecret: qqbot.clientSecret || envClientSecret,
+        enabled: qqbot.enabled ?? true,
+        secretSource: qqbot.clientSecret ? "config" : "env",
+        markdownSupport: qqbot.markdownSupport ?? true,
+        config: accountId === "default" ? (qqbot as Record<string, unknown>) : {},
+      };
+    }
+    
+    const accountConfig = qqbot.accounts?.[accountId];
+    if (accountConfig) {
+      return {
+        accountId,
+        appId: normalizeAppId(accountConfig.appId ?? qqbot.appId ?? envAppId),
+        clientSecret: accountConfig.clientSecret || qqbot.clientSecret || envClientSecret,
+        enabled: accountConfig.enabled ?? true,
+        secretSource: accountConfig.clientSecret ? "config" : "env",
+        markdownSupport: accountConfig.markdownSupport ?? qqbot.markdownSupport ?? true,
+        config: accountConfig,
+      };
+    }
+    
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+// 加载配置（用于 broadcastMessage）
+function loadConfig(): Record<string, unknown> {
+  const configPath = detectConfigPath();
+  try {
+    if (configPath && fs.existsSync(configPath)) {
+      return JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    }
+  } catch {}
+  return {};
+}
+
+// 解析请求体
+async function parseBody(req: http.IncomingMessage): Promise<Record<string, unknown>> {
+  return new Promise((resolve) => {
+    let body = "";
+    req.on("data", (chunk) => {
+      body += chunk;
+    });
+    req.on("end", () => {
+      try {
+        resolve(body ? JSON.parse(body) : {});
+      } catch {
+        resolve({});
+      }
+    });
+  });
+}
+
+// 发送 JSON 响应
+function sendJson(res: http.ServerResponse, statusCode: number, data: unknown) {
+  res.writeHead(statusCode, { "Content-Type": "application/json; charset=utf-8" });
+  res.end(JSON.stringify(data, null, 2));
+}
+
+// 处理请求
+async function handleRequest(req: http.IncomingMessage, res: http.ServerResponse) {
+  const parsedUrl = url.parse(req.url || "", true);
+  const pathname = parsedUrl.pathname || "/";
+  const method = req.method || "GET";
+  const query = parsedUrl.query;
+  
+  // CORS 支持
+  res.setHeader("Access-Control-Allow-Origin", "*");
+  res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+  res.setHeader("Access-Control-Allow-Headers", "Content-Type");
+  
+  if (method === "OPTIONS") {
+    res.writeHead(204);
+    res.end();
+    return;
+  }
+  
+  console.log(`[${new Date().toISOString()}] ${method} ${pathname}`);
+  
+  try {
+    // POST /send - 发送主动消息
+    if (pathname === "/send" && method === "POST") {
+      const body = await parseBody(req);
+      const { to, text, type = "c2c", accountId = "default" } = body as {
+        to?: string;
+        text?: string;
+        type?: "c2c" | "group";
+        accountId?: string;
+      };
+      
+      if (!to || !text) {
+        sendJson(res, 400, { error: "Missing required fields: to, text" });
+        return;
+      }
+      
+      const account = loadAccount(accountId);
+      if (!account) {
+        sendJson(res, 500, { error: "Failed to load account configuration" });
+        return;
+      }
+      
+      const result = await sendProactiveMessageDirect(account, to, text, type);
+      sendJson(res, result.success ? 200 : 500, result);
+      return;
+    }
+    
+    // GET /users - 列出已知用户
+    if (pathname === "/users" && method === "GET") {
+      const type = query.type as "c2c" | "group" | "channel" | undefined;
+      const accountId = query.accountId as string | undefined;
+      const limit = query.limit ? parseInt(query.limit as string, 10) : undefined;
+      
+      const users = listKnownUsers({ type, accountId, limit });
+      sendJson(res, 200, { total: users.length, users });
+      return;
+    }
+    
+    // GET /users/stats - 获取用户统计
+    if (pathname === "/users/stats" && method === "GET") {
+      const accountId = query.accountId as string | undefined;
+      const stats = getKnownUsersStats(accountId);
+      sendJson(res, 200, stats);
+      return;
+    }
+    
+    // GET /users/:openid - 获取单个用户
+    if (pathname.startsWith("/users/") && method === "GET" && pathname !== "/users/stats") {
+      const openid = pathname.slice("/users/".length);
+      const type = (query.type as string) || "c2c";
+      const accountId = (query.accountId as string) || "default";
+      
+      const user = getKnownUser(type, openid, accountId);
+      if (user) {
+        sendJson(res, 200, user);
+      } else {
+        sendJson(res, 404, { error: "User not found" });
+      }
+      return;
+    }
+    
+    // POST /broadcast - 广播消息
+    if (pathname === "/broadcast" && method === "POST") {
+      const body = await parseBody(req);
+      const { text, type = "c2c", accountId, limit } = body as {
+        text?: string;
+        type?: "c2c" | "group";
+        accountId?: string;
+        limit?: number;
+      };
+      
+      if (!text) {
+        sendJson(res, 400, { error: "Missing required field: text" });
+        return;
+      }
+      
+      const cfg = loadConfig();
+      const result = await broadcastMessage(text, cfg as any, { type, accountId, limit });
+      sendJson(res, 200, result);
+      return;
+    }
+    
+    // GET / - API 文档
+    if (pathname === "/" && method === "GET") {
+      sendJson(res, 200, {
+        name: "QQBot Proactive Message API",
+        version: "1.0.0",
+        endpoints: {
+          "POST /send": {
+            description: "发送主动消息",
+            body: {
+              to: "目标 openid (必需)",
+              text: "消息内容 (必需)",
+              type: "消息类型: c2c | group (默认 c2c)",
+              accountId: "账户 ID (默认 default)",
+            },
+          },
+          "GET /users": {
+            description: "列出已知用户",
+            query: {
+              type: "过滤类型: c2c | group | channel",
+              accountId: "过滤账户 ID",
+              limit: "限制返回数量",
+            },
+          },
+          "GET /users/stats": {
+            description: "获取用户统计",
+            query: {
+              accountId: "过滤账户 ID",
+            },
+          },
+          "GET /users/:openid": {
+            description: "获取单个用户信息",
+            query: {
+              type: "用户类型 (默认 c2c)",
+              accountId: "账户 ID (默认 default)",
+            },
+          },
+          "POST /broadcast": {
+            description: "广播消息给所有已知用户",
+            body: {
+              text: "消息内容 (必需)",
+              type: "消息类型: c2c | group (默认 c2c)",
+              accountId: "账户 ID",
+              limit: "限制发送数量",
+            },
+          },
+        },
+        notes: [
+          "只有曾经与机器人交互过的用户才能收到主动消息",
+        ],
+      });
+      return;
+    }
+    
+    // 404
+    sendJson(res, 404, { error: "Not found" });
+  } catch (err) {
+    console.error(`Error handling request: ${err}`);
+    sendJson(res, 500, { error: err instanceof Error ? err.message : String(err) });
+  }
+}
+
+// 解析命令行参数获取端口
+function getPort(): number {
+  const args = process.argv.slice(2);
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--port" && args[i + 1]) {
+      return parseInt(args[i + 1], 10) || DEFAULT_PORT;
+    }
+  }
+  return parseInt(process.env.PROACTIVE_API_PORT || "", 10) || DEFAULT_PORT;
+}
+
+// 启动服务器
+function main() {
+  const port = getPort();
+  
+  const server = http.createServer(handleRequest);
+  
+  server.listen(port, () => {
+    console.log(`
+╔═══════════════════════════════════════════════════════════════╗
+║         QQBot Proactive Message API Server                    ║
+╠═══════════════════════════════════════════════════════════════╣
+║  Server running at: http://localhost:${port.toString().padEnd(25)}║
+║                                                               ║
+║  Endpoints:                                                   ║
+║    GET  /              - API documentation                    ║
+║    POST /send          - Send proactive message               ║
+║    GET  /users         - List known users                     ║
+║    GET  /users/stats   - Get user statistics                  ║
+║    POST /broadcast     - Broadcast message                    ║
+║                                                               ║
+║  Example:                                                     ║
+║    curl -X POST http://localhost:${port}/send \\                ║
+║      -H "Content-Type: application/json" \\                    ║
+║      -d '{"to":"openid","text":"Hello!"}'                     ║
+╚═══════════════════════════════════════════════════════════════╝
+`);
+  });
+  
+  // 优雅关闭
+  process.on("SIGINT", () => {
+    console.log("\nShutting down...");
+    server.close(() => {
+      process.exit(0);
+    });
+  });
+}
+
+main();