@openclaw/qqbot 2026.5.1-beta.1 → 2026.5.2-beta.1

package/openclaw.plugin.json

@@ -6,6 +6,12 @@
   "channels": [
     "qqbot"
   ],
+  "contracts": {
+    "tools": [
+      "qqbot_channel_api",
+      "qqbot_remind"
+    ]
+  },
   "channelEnvVars": {
     "qqbot": [
       "QQBOT_APP_ID",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/qqbot",
-  "version": "2026.5.1-beta.1",
+  "version": "2026.5.2-beta.1",
   "private": false,
   "description": "OpenClaw QQ Bot channel plugin",
   "repository": {
@@ -21,7 +21,7 @@
     "openclaw": "workspace:*"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.4.27"
+    "openclaw": ">=2026.5.2-beta.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -50,10 +50,10 @@
       "minHostVersion": ">=2026.4.10"
     },
     "compat": {
-      "pluginApi": ">=2026.4.27"
+      "pluginApi": ">=2026.5.2-beta.1"
     },
     "build": {
-      "openclawVersion": "2026.5.1-beta.1"
+      "openclawVersion": "2026.5.2-beta.1"
     },
     "bundle": {
       "includeInCore": false

package/src/engine/ref/store.ts

@@ -206,19 +206,3 @@ export function flushRefIndex(): void {
     compactFile();
   }
 }
-
-/** Return ref-index stats for diagnostics. */
-export function getRefIndexStats(): {
-  size: number;
-  maxEntries: number;
-  totalLinesOnDisk: number;
-  filePath: string;
-} {
-  const store = loadFromFile();
-  return {
-    size: store.size,
-    maxEntries: MAX_ENTRIES,
-    totalLinesOnDisk,
-    filePath: getRefIndexFile(),
-  };
-}

package/src/engine/session/known-users.ts

@@ -13,7 +13,7 @@ import { debugLog, debugError } from "../utils/log.js";
 import { getQQBotDataDir, getQQBotDataPath } from "../utils/platform.js";
 
 /** Persisted record for a user who has interacted with the bot. */
-export interface KnownUser {
+interface KnownUser {
   openid: string;
   type: ChatScope;
   nickname?: string;
@@ -135,120 +135,3 @@ export function recordKnownUser(user: {
   isDirty = true;
   saveUsersToFile();
 }
-
-/** Look up one known user. */
-export function getKnownUser(
-  accountId: string,
-  openid: string,
-  type: ChatScope = "c2c",
-  groupOpenid?: string,
-): KnownUser | undefined {
-  return loadUsersFromFile().get(makeUserKey({ accountId, openid, type, groupOpenid }));
-}
-
-/** List known users with optional filtering and sorting. */
-export function listKnownUsers(options?: {
-  accountId?: string;
-  type?: ChatScope;
-  activeWithin?: number;
-  limit?: number;
-  sortBy?: "lastSeenAt" | "firstSeenAt" | "interactionCount";
-  sortOrder?: "asc" | "desc";
-}): KnownUser[] {
-  let users = Array.from(loadUsersFromFile().values());
-  if (options?.accountId) {
-    users = users.filter((u) => u.accountId === options.accountId);
-  }
-  if (options?.type) {
-    users = users.filter((u) => u.type === options.type);
-  }
-  if (options?.activeWithin) {
-    const cutoff = Date.now() - options.activeWithin;
-    users = users.filter((u) => u.lastSeenAt >= cutoff);
-  }
-  const sortBy = options?.sortBy ?? "lastSeenAt";
-  const sortOrder = options?.sortOrder ?? "desc";
-  users.sort((a, b) => {
-    const aV = a[sortBy] ?? 0;
-    const bV = b[sortBy] ?? 0;
-    return sortOrder === "asc" ? aV - bV : bV - aV;
-  });
-  if (options?.limit && options.limit > 0) {
-    users = users.slice(0, options.limit);
-  }
-  return users;
-}
-
-/** Return summary stats for known users. */
-export function getKnownUsersStats(accountId?: string): {
-  totalUsers: number;
-  c2cUsers: number;
-  groupUsers: number;
-  activeIn24h: number;
-  activeIn7d: number;
-} {
-  const users = listKnownUsers({ accountId });
-  const now = Date.now();
-  const day = 86400000;
-  return {
-    totalUsers: users.length,
-    c2cUsers: users.filter((u) => u.type === "c2c").length,
-    groupUsers: users.filter((u) => u.type === "group").length,
-    activeIn24h: users.filter((u) => now - u.lastSeenAt < day).length,
-    activeIn7d: users.filter((u) => now - u.lastSeenAt < 7 * day).length,
-  };
-}
-
-/** Remove one user record. */
-export function removeKnownUser(
-  accountId: string,
-  openid: string,
-  type: ChatScope = "c2c",
-  groupOpenid?: string,
-): boolean {
-  const cache = loadUsersFromFile();
-  const key = makeUserKey({ accountId, openid, type, groupOpenid });
-  if (cache.has(key)) {
-    cache.delete(key);
-    isDirty = true;
-    saveUsersToFile();
-    debugLog(`[known-users] Removed user ${openid}`);
-    return true;
-  }
-  return false;
-}
-
-/** Clear all user records, optionally scoped to one account. */
-export function clearKnownUsers(accountId?: string): number {
-  const cache = loadUsersFromFile();
-  let count = 0;
-  if (accountId) {
-    for (const [key, user] of cache.entries()) {
-      if (user.accountId === accountId) {
-        cache.delete(key);
-        count++;
-      }
-    }
-  } else {
-    count = cache.size;
-    cache.clear();
-  }
-  if (count > 0) {
-    isDirty = true;
-    doSaveUsersToFile();
-    debugLog(`[known-users] Cleared ${count} users`);
-  }
-  return count;
-}
-
-/** Return all groups in which a user has interacted. */
-export function getUserGroups(accountId: string, openid: string): string[] {
-  return listKnownUsers({ accountId, type: "group" })
-    .filter((u) => u.openid === openid && u.groupOpenid)
-    .map((u) => u.groupOpenid!);
-}
-
-/** Return all recorded members for one group. */
-export function getGroupMembers(accountId: string, groupOpenid: string): KnownUser[] {
-  return listKnownUsers({ accountId, type: "group" }).filter((u) => u.groupOpenid === groupOpenid);
-}

package/src/engine/session/session-store.ts

@@ -62,16 +62,6 @@ function getCandidateSessionPaths(accountId: string): string[] {
   return primaryPath === legacyPath ? [primaryPath] : [primaryPath, legacyPath];
 }
 
-function isSessionFileName(file: string): boolean {
-  return file.startsWith("session-") && file.endsWith(".json");
-}
-
-function readSessionStateFile(file: string): { filePath: string; state: SessionState } {
-  const filePath = path.join(getSessionDir(), file);
-  const data = fs.readFileSync(filePath, "utf-8");
-  return { filePath, state: JSON.parse(data) as SessionState };
-}
-
 /** Load a saved session, rejecting expired or mismatched appId entries. */
 export function loadSession(accountId: string, expectedAppId?: string): SessionState | null {
   try {
@@ -212,73 +202,3 @@ export function clearSession(accountId: string): void {
     );
   }
 }
-
-/** Update only lastSeq on the persisted session. */
-export function updateLastSeq(accountId: string, lastSeq: number): void {
-  const existing = loadSession(accountId);
-  if (existing?.sessionId) {
-    saveSession({ ...existing, lastSeq });
-  }
-}
-
-/** Load all saved sessions from disk. */
-export function getAllSessions(): SessionState[] {
-  const sessions = new Map<string, SessionState>();
-  try {
-    const sessionDir = getSessionDir();
-    if (!fs.existsSync(sessionDir)) {
-      return [];
-    }
-    const files = fs.readdirSync(sessionDir);
-
-    for (const file of files) {
-      if (isSessionFileName(file)) {
-        try {
-          const { state } = readSessionStateFile(file);
-          if (typeof state.accountId !== "string" || !state.accountId) {
-            continue;
-          }
-          const existing = sessions.get(state.accountId);
-          if (!existing || (state.savedAt ?? 0) >= (existing.savedAt ?? 0)) {
-            sessions.set(state.accountId, state);
-          }
-        } catch {}
-      }
-    }
-  } catch {}
-  return [...sessions.values()];
-}
-
-/** Remove expired session files from disk. */
-export function cleanupExpiredSessions(): number {
-  let cleaned = 0;
-  try {
-    const sessionDir = getSessionDir();
-    if (!fs.existsSync(sessionDir)) {
-      return 0;
-    }
-    const now = Date.now();
-    const files = fs.readdirSync(sessionDir);
-
-    for (const file of files) {
-      if (isSessionFileName(file)) {
-        const filePath = path.join(sessionDir, file);
-        try {
-          const { state } = readSessionStateFile(file);
-
-          if (now - state.savedAt > SESSION_EXPIRE_TIME) {
-            fs.unlinkSync(filePath);
-            cleaned++;
-            debugLog(`[session-store] Cleaned expired session: ${file}`);
-          }
-        } catch {
-          try {
-            fs.unlinkSync(filePath);
-            cleaned++;
-          } catch {}
-        }
-      }
-    }
-  } catch {}
-  return cleaned;
-}

package/src/engine/utils/platform-storage-laziness.test.ts

@@ -38,14 +38,12 @@ describe("qqbot storage laziness", () => {
 
     const qqbotRoot = path.join(homeDir, ".openclaw", "qqbot");
 
-    const sessionStore = await import("../session/session-store.js");
+    await import("../session/session-store.js");
     await import("../session/known-users.js");
     await import("../ref/store.js");
     const { loadCredentialBackup } = await import("../config/credential-backup.js");
 
     expect(loadCredentialBackup("default")).toBeNull();
-    expect(sessionStore.getAllSessions()).toEqual([]);
-    expect(sessionStore.cleanupExpiredSessions()).toBe(0);
     expect(fs.existsSync(qqbotRoot)).toBe(false);
   });
 

package/dist/.boundary-tsc.stamp

@@ -1 +0,0 @@
-2026-04-29T11:29:16.564Z