@leoqlin/openclaw-qqbot 1.6.10 → 1.6.11

package/dist/src/api.d.ts

@@ -27,7 +27,9 @@ export declare class ApiError extends Error {
     /** 回包中的原始 message 字段（用于向用户展示兜底文案） */
     bizMessage?: string | undefined);
 }
-export declare const PLUGIN_USER_AGENT: string;
+/** 由 setQQBotRuntime 调用，将 api.runtime.version 注入到 User-Agent */
+export declare function setOpenClawVersion(version: string): void;
+export declare function getPluginUserAgent(): string;
 /** 出站消息元信息（结构化存储，不做预格式化） */
 export interface OutboundMeta {
     /** 消息文本内容 */
@@ -102,7 +104,7 @@ export declare const UPLOAD_PREPARE_FALLBACK_CODE = 40093002;
 export declare function getGatewayUrl(accessToken: string): Promise<string>;
 /** 回应按钮交互（INTERACTION_CREATE），避免客户端按钮持续 loading */
 export declare function acknowledgeInteraction(accessToken: string, interactionId: string, code?: 0 | 1 | 2 | 3 | 4 | 5, data?: Record<string, unknown>): Promise<void>;
-/** 获取插件版本号（从 package.json 读取，和 PLUGIN_USER_AGENT 同源） */
+/** 获取插件版本号（从 package.json 读取，和 getPluginUserAgent() 同源） */
 export declare function getApiPluginVersion(): string;
 export interface MessageResponse {
     id: string;

package/dist/src/api.js

@@ -41,11 +41,20 @@ export class ApiError extends Error {
 const API_BASE = "https://api.sgroup.qq.com";
 const TOKEN_URL = "https://bots.qq.com/app/getAppAccessToken";
 // ============ Plugin User-Agent ============
-// 格式: QQBotPlugin/{version} (Node/{nodeVersion}; {os})
-// 示例: QQBotPlugin/1.6.0 (Node/22.14.0; darwin)
+// 格式: QQBotPlugin/{version} (Node/{nodeVersion}; {os}; OpenClaw/{openclawVersion})
+// 示例: QQBotPlugin/1.6.0 (Node/22.14.0; darwin; OpenClaw/2026.3.31)
 import { getPackageVersion } from "./utils/pkg-version.js";
 const _pluginVersion = getPackageVersion(import.meta.url);
-export const PLUGIN_USER_AGENT = `QQBotPlugin/${_pluginVersion} (Node/${process.versions.node}; ${os.platform()})`;
+// 初始值为 "unknown"，由 setQQBotRuntime 注入后更新为真实版本
+let _openclawVersion = "unknown";
+/** 由 setQQBotRuntime 调用，将 api.runtime.version 注入到 User-Agent */
+export function setOpenClawVersion(version) {
+    if (version)
+        _openclawVersion = version;
+}
+export function getPluginUserAgent() {
+    return `QQBotPlugin/${_pluginVersion} (Node/${process.versions.node}; ${os.platform()}; OpenClaw/${_openclawVersion})`;
+}
 // 运行时配置
 let currentMarkdownSupport = false;
 let onMessageSentHook = null;
@@ -117,7 +126,7 @@ export async function getAccessToken(appId, clientSecret) {
  */
 async function doFetchToken(appId, clientSecret) {
     const requestBody = { appId, clientSecret };
-    const requestHeaders = { "Content-Type": "application/json", "User-Agent": PLUGIN_USER_AGENT };
+    const requestHeaders = { "Content-Type": "application/json", "User-Agent": getPluginUserAgent() };
     // 打印请求信息（隐藏敏感信息）
     log.info(`[qqbot-api:${appId}] >>> POST ${TOKEN_URL} [secret: ${clientSecret.slice(0, 6)}...len=${clientSecret.length}]`);
     let response;
@@ -215,7 +224,7 @@ export async function apiRequest(accessToken, method, path, body, timeoutMs) {
     const headers = {
         Authorization: `QQBot ${accessToken}`,
         "Content-Type": "application/json",
-        "User-Agent": PLUGIN_USER_AGENT,
+        "User-Agent": getPluginUserAgent(),
     };
     const isFileUpload = path.includes("/files");
     const timeout = timeoutMs ?? (isFileUpload ? FILE_UPLOAD_TIMEOUT : DEFAULT_API_TIMEOUT);
@@ -466,7 +475,7 @@ export async function getGatewayUrl(accessToken) {
 export async function acknowledgeInteraction(accessToken, interactionId, code = 0, data) {
     await apiRequest(accessToken, "PUT", `/interactions/${interactionId}`, { code, ...(data ? { data } : {}) });
 }
-/** 获取插件版本号（从 package.json 读取，和 PLUGIN_USER_AGENT 同源） */
+/** 获取插件版本号（从 package.json 读取，和 getPluginUserAgent() 同源） */
 export function getApiPluginVersion() {
     return _pluginVersion;
 }

package/dist/src/gateway.js

@@ -2,7 +2,7 @@ import WebSocket from "ws";
 import path from "node:path";
 import fs from "node:fs";
 import { MSG_TYPE_QUOTE } from "./types.js";
-import { getAccessToken, getGatewayUrl, sendC2CMessage, sendChannelMessage, sendGroupMessage, clearTokenCache, initApiConfig, startBackgroundTokenRefresh, stopBackgroundTokenRefresh, sendC2CInputNotify, onMessageSent, PLUGIN_USER_AGENT, acknowledgeInteraction, getApiPluginVersion, setApiLogger } from "./api.js";
+import { getAccessToken, getGatewayUrl, sendC2CMessage, sendChannelMessage, sendGroupMessage, clearTokenCache, initApiConfig, startBackgroundTokenRefresh, stopBackgroundTokenRefresh, sendC2CInputNotify, onMessageSent, getPluginUserAgent, acknowledgeInteraction, getApiPluginVersion, setApiLogger } from "./api.js";
 import { loadSession, saveSession, clearSession } from "./session-store.js";
 import { recordKnownUser, flushKnownUsers } from "./known-users.js";
 import { getQQBotRuntime } from "./runtime.js";
@@ -591,7 +591,7 @@ export async function startGateway(ctx) {
             log?.info(`[qqbot:${account.accountId}] ✅ Access token obtained successfully`);
             const gatewayUrl = await getGatewayUrl(accessToken);
             log?.info(`[qqbot:${account.accountId}] Connecting to ${gatewayUrl}`);
-            const ws = new WebSocket(gatewayUrl, { headers: { "User-Agent": PLUGIN_USER_AGENT } });
+            const ws = new WebSocket(gatewayUrl, { headers: { "User-Agent": getPluginUserAgent() } });
             currentWs = ws;
             const pluginRuntime = getQQBotRuntime();
             // 群历史消息缓存：非@消息写入此 Map，被@时一次性注入上下文后清空

package/dist/src/runtime.js

@@ -1,6 +1,9 @@
+import { setOpenClawVersion } from "./api.js";
 let runtime = null;
 export function setQQBotRuntime(next) {
     runtime = next;
+    // 将框架版本注入 User-Agent（runtime 注入后才能拿到准确版本）
+    setOpenClawVersion(next.version);
 }
 export function getQQBotRuntime() {
     if (!runtime) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leoqlin/openclaw-qqbot",
-  "version": "1.6.10",
+  "version": "1.6.11",
   "publishConfig": {
     "access": "public"
   },