@openclaw/qqbot 2026.6.11-beta.2 → 2026.7.1-beta.1

package/skills/qqbot-remind/SKILL.md

@@ -1,16 +1,16 @@
 ---
 name: qqbot-remind
-description: QQBot scheduled reminders. Create, list, and cancel one-time or recurring reminders when a QQ conversation involves reminders, alarms, or scheduled tasks.
+description: QQBot scheduled reminders. Use only for explicit user requests to create, list, or cancel one-time or recurring QQ reminders; ask for missing time, content, or timezone before scheduling.
 metadata: { "openclaw": { "emoji": "⏰", "requires": { "config": ["channels.qqbot"] } } }
 ---
 
 # QQ Bot 定时提醒
 
-## ⚠️ 强制规则
+## ⚠️ 意图规则
 
-**当用户提到「提醒」「闹钟」「定时」「X分钟/小时后」「每天X点」「叫我」等任何涉及延时或定时的请求时，你必须调用工具，绝对不能只用自然语言回复说"好的，我会提醒你"！**
+只有当用户明确要求创建、查询或取消提醒/闹钟/定时任务时，才调用工具。闲聊、假设、解释提醒功能、讨论将来计划但未要求创建提醒时，不要调用工具。
 
-你没有内存或后台线程，口头承诺"到时候提醒"是无效的——只有调用工具才能真正注册定时任务。
+如果用户确实要求提醒，你没有内存或后台线程，口头承诺"到时候提醒"是无效的——必须调用工具才能真正注册定时任务。时间、提醒内容、目标会话或时区不清楚时先追问；不要替用户猜测。
 
 ---
 
@@ -18,13 +18,14 @@ metadata: { "openclaw": { "emoji": "⏰", "requires": { "config": ["channels.qqb
 
 **第一步**：调用 `qqbot_remind` 工具，传入简单参数：
 
-| 参数      | 说明                                         | 示例                               |
-| --------- | -------------------------------------------- | ---------------------------------- |
-| `action`  | 操作类型                                     | `"add"` / `"list"` / `"remove"`    |
-| `content` | 提醒内容                                     | `"喝水"`                           |
-| `to`      | 目标地址（可选，系统自动获取，通常无需填写） | —                                  |
-| `time`    | 时间（相对时间或 cron 表达式）               | `"5m"` / `"1h30m"` / `"0 8 * * *"` |
-| `jobId`   | 任务 ID（仅 remove）                         | `"xxx"`                            |
+| 参数       | 说明                                         | 示例                                        |
+| ---------- | -------------------------------------------- | ------------------------------------------- |
+| `action`   | 操作类型                                     | `"add"` / `"list"` / `"remove"`             |
+| `content`  | 提醒内容                                     | `"喝水"`                                    |
+| `to`       | 目标地址（可选，系统自动获取，通常无需填写） | —                                           |
+| `time`     | 时间（相对时间或 cron 表达式）               | `"5m"` / `"1h30m"` / `"0 8 * * *"`          |
+| `timezone` | IANA 时区（周期提醒建议明确传入）            | `"Asia/Shanghai"` / `"America/Los_Angeles"` |
+| `jobId`    | 任务 ID（仅 remove）                         | `"xxx"`                                     |
 
 **第二步**：根据 `qqbot_remind` 的返回结果，回复用户。`qqbot_remind` 会直接创建、查询或取消 Gateway cron 任务；成功后不要再调用 `cron` 工具。
 
@@ -92,7 +93,7 @@ metadata: { "openclaw": { "emoji": "⏰", "requires": { "config": ["channels.qqb
   "action": "add",
   "job": {
     "name": "{任务名}",
-    "schedule": { "kind": "cron", "expr": "0 8 * * *", "tz": "Asia/Shanghai" },
+    "schedule": { "kind": "cron", "expr": "0 8 * * *", "tz": "{用户确认的 IANA 时区}" },
     "sessionTarget": "isolated",
     "wakeMode": "now",
     "payload": {
@@ -124,7 +125,7 @@ metadata: { "openclaw": { "emoji": "⏰", "requires": { "config": ["channels.qqb
 | 每周末上午10点 | `"0 10 * * 0,6"` |
 | 每小时整点     | `"0 * * * *"`    |
 
-> 周期提醒必须加 `"tz": "Asia/Shanghai"`。
+> 周期提醒应使用用户明确提供、用户资料/会话中可信可得，或用户确认过的 IANA 时区。无法判断时先追问；不要把所有用户都假定在同一时区。
 
 ---
 
@@ -141,7 +142,7 @@ metadata: { "openclaw": { "emoji": "⏰", "requires": { "config": ["channels.qqb
 | "修改提醒时间"      | `remove` → `add` | —               |
 | "提醒我"（无时间）  | **需追问**       | —               |
 
-纯相对时间（"5分钟后"、"1小时后"）可直接计算，无需确认。时间模糊或缺失时需追问。
+纯相对时间（"5分钟后"、"1小时后"）可直接计算，无需确认。时间、日期、周期、内容或时区模糊/缺失时需追问。周期提醒在回复中说明解释后的本地时间和时区。
 
 ---
 

package/dist/target-parser-BdCUmxK7.js

@@ -1,285 +0,0 @@
-import { c as getPlatformAdapter } from "./string-normalize-R_0cKO7Q.js";
-import { a as formatErrorMessage, n as debugLog, r as debugWarn } from "./log-SDfMMBWe.js";
-import * as fs$1 from "node:fs";
-import * as os$1 from "node:os";
-import * as path$1 from "node:path";
-//#region extensions/qqbot/src/engine/utils/platform.ts
-/**
-* Cross-platform path and detection helpers for core/ modules.
-*
-* Provides home/data/media directory helpers, platform detection,
-* silk-wasm availability checks — all without importing `openclaw/plugin-sdk`.
-* The temp-directory fallback is delegated to the PlatformAdapter.
-*/
-/**
-* Resolve the current user's OS home directory safely across platforms.
-*
-* Priority:
-* 1. `os.homedir()`
-* 2. `$HOME` or `%USERPROFILE%`
-* 3. PlatformAdapter.getTempDir() as a last resort
-*
-* This is the *operating-system* home and intentionally ignores
-* `OPENCLAW_HOME`. QQ Bot still checks this tree for legacy state imports and
-* media-path remaps from older releases.
-*/
-function getHomeDir() {
-	try {
-		const home = os$1.homedir();
-		if (home && fs$1.existsSync(home)) return home;
-	} catch {}
-	const envHome = process.env.HOME || process.env.USERPROFILE;
-	if (envHome && fs$1.existsSync(envHome)) return envHome;
-	return getPlatformAdapter().getTempDir();
-}
-/**
-* Resolve the effective OpenClaw home directory.
-*
-* Mirrors the contract from core (`src/infra/home-dir.ts::resolveEffectiveHomeDir`)
-* so QQ Bot media roots live under the same tree the rest of OpenClaw treats as
-* `~`. The extension cannot import the core helper directly (it is a separate
-* package with `openclaw` as a peer dependency), so this re-implements the
-* minimal contract:
-*
-* 1. `OPENCLAW_HOME` when set (with `~` / `~/...` expanded against the OS home).
-* 2. Otherwise fall back to {@link getHomeDir} so existing single-home
-*    deployments are unaffected.
-*
-* Empty / `"undefined"` / `"null"` strings are treated as unset to match how
-* core normalizes the variable.
-*/
-function resolveOpenClawHome() {
-	const raw = process.env.OPENCLAW_HOME?.trim();
-	if (!raw || raw === "undefined" || raw === "null") return getHomeDir();
-	if (raw === "~" || raw.startsWith("~/") || raw.startsWith("~\\")) {
-		const osHome = getHomeDir();
-		if (raw === "~") return osHome;
-		return path$1.join(osHome, raw.slice(2));
-	}
-	return raw;
-}
-/**
-* Return a legacy path under `~/.openclaw/qqbot` without creating it.
-*
-* Current QQ Bot runtime state lives in plugin SQLite KV. This path remains for
-* legacy imports and media-path remaps from older releases.
-*/
-function getQQBotDataPath(...subPaths) {
-	return path$1.join(getHomeDir(), ".openclaw", "qqbot", ...subPaths);
-}
-/** Return a path under `~/.openclaw/qqbot`, creating it on demand. */
-function getQQBotDataDir(...subPaths) {
-	const dir = getQQBotDataPath(...subPaths);
-	if (!fs$1.existsSync(dir)) fs$1.mkdirSync(dir, { recursive: true });
-	return dir;
-}
-/**
-* Return a path under `<openclaw-home>/.openclaw/media/qqbot` without creating it.
-*
-* Unlike `getQQBotDataPath`, this lives under OpenClaw's core media allowlist
-* so downloaded images and audio can be accessed by framework media tooling.
-* The base honors `OPENCLAW_HOME` (when set) so files written by agents into
-* the OpenClaw-managed media tree are reachable by this plugin even when
-* `HOME` and `OPENCLAW_HOME` differ (Docker, multi-user hosts). Fixes #83562.
-*/
-function getQQBotMediaPath(...subPaths) {
-	return path$1.join(resolveOpenClawHome(), ".openclaw", "media", "qqbot", ...subPaths);
-}
-/** Return a path under `<openclaw-home>/.openclaw/media/qqbot`, creating it on demand. */
-function getQQBotMediaDir(...subPaths) {
-	const dir = getQQBotMediaPath(...subPaths);
-	if (!fs$1.existsSync(dir)) fs$1.mkdirSync(dir, { recursive: true });
-	return dir;
-}
-/**
-* Return `<openclaw-home>/.openclaw/media`, OpenClaw's shared media root.
-*
-* This mirrors the directory that core's `buildMediaLocalRoots` exposes as an
-* allowlisted location (see `openclaw/src/media/local-roots.ts`). Using it as a
-* QQ Bot payload root lets the plugin trust framework-produced files that live
-* in sibling subdirectories such as `outbound/` (written by
-* `saveMediaBuffer(..., "outbound", ...)`) or `inbound/`, while still keeping
-* the check anchored to a single, well-known directory. Like
-* {@link getQQBotMediaPath}, the base honors `OPENCLAW_HOME`.
-*/
-function getOpenClawMediaDir() {
-	return path$1.join(resolveOpenClawHome(), ".openclaw", "media");
-}
-function isWindows() {
-	return process.platform === "win32";
-}
-/** Return the preferred temporary directory. */
-function getTempDir() {
-	return getPlatformAdapter().getTempDir();
-}
-let silkWasmAvailable = null;
-/** Check whether silk-wasm can run in the current environment. */
-async function checkSilkWasmAvailable() {
-	if (silkWasmAvailable !== null) return silkWasmAvailable;
-	try {
-		const { isSilk } = await import("silk-wasm");
-		isSilk(new Uint8Array(0));
-		silkWasmAvailable = true;
-		debugLog("[platform] silk-wasm: available");
-	} catch (err) {
-		silkWasmAvailable = false;
-		debugWarn(`[platform] silk-wasm: NOT available (${formatErrorMessage(err)})`);
-	}
-	return silkWasmAvailable;
-}
-/** Expand `~` to the current user's home directory. */
-function expandTilde(p) {
-	if (!p) return p;
-	if (p === "~") return getHomeDir();
-	if (p.startsWith("~/") || p.startsWith("~\\")) return path$1.join(getHomeDir(), p.slice(2));
-	return p;
-}
-/** Normalize a user-provided path by trimming, stripping `file://`, and expanding `~`. */
-function normalizePath(p) {
-	let result = p.trim();
-	if (result.startsWith("file://")) {
-		result = result.slice(7);
-		try {
-			result = decodeURIComponent(result);
-		} catch {}
-	}
-	return expandTilde(result);
-}
-/** Return true when the string looks like a local filesystem path rather than a URL. */
-function isLocalPath(p) {
-	if (!p) return false;
-	if (p.startsWith("file://")) return true;
-	if (p === "~" || p.startsWith("~/") || p.startsWith("~\\")) return true;
-	if (p.startsWith("/")) return true;
-	if (/^[a-zA-Z]:[\\/]/.test(p)) return true;
-	if (p.startsWith("\\\\")) return true;
-	if (p.startsWith("./") || p.startsWith("../")) return true;
-	if (p.startsWith(".\\") || p.startsWith("..\\")) return true;
-	return false;
-}
-function isPathWithinRoot(candidate, root) {
-	const relative = path$1.relative(root, candidate);
-	return relative === "" || !relative.startsWith("..") && !path$1.isAbsolute(relative);
-}
-/** Remap legacy or hallucinated QQ Bot local media paths to real files when possible. */
-function resolveQQBotLocalMediaPath(p) {
-	const normalized = normalizePath(p);
-	if (!isLocalPath(normalized) || fs$1.existsSync(normalized)) return normalized;
-	const osHomeDir = getHomeDir();
-	const openclawHomeDir = resolveOpenClawHome();
-	const mediaRoot = getQQBotMediaPath();
-	const dataRoot = getQQBotDataPath();
-	const candidateRoots = [
-		...Array.from(new Set([path$1.join(osHomeDir, ".openclaw", "workspace", "qqbot"), path$1.join(openclawHomeDir, ".openclaw", "workspace", "qqbot")])).map((from) => ({
-			from,
-			to: mediaRoot
-		})),
-		{
-			from: dataRoot,
-			to: mediaRoot
-		},
-		{
-			from: mediaRoot,
-			to: dataRoot
-		}
-	];
-	for (const { from, to } of candidateRoots) {
-		if (!isPathWithinRoot(normalized, from)) continue;
-		const relative = path$1.relative(from, normalized);
-		const candidate = path$1.join(to, relative);
-		if (fs$1.existsSync(candidate)) {
-			debugWarn(`[platform] Remapped missing QQBot media path ${normalized} -> ${candidate}`);
-			return candidate;
-		}
-	}
-	return normalized;
-}
-/**
-* Resolve a structured-payload local file path and enforce that it stays within
-* QQ Bot-owned storage roots.
-*/
-function resolveQQBotPayloadLocalFilePath(p) {
-	const candidate = resolveQQBotLocalMediaPath(p);
-	if (!candidate.trim()) return null;
-	const resolvedCandidate = path$1.resolve(candidate);
-	if (!fs$1.existsSync(resolvedCandidate)) return null;
-	const canonicalCandidate = fs$1.realpathSync(resolvedCandidate);
-	const allowedRoots = [getOpenClawMediaDir(), getQQBotMediaPath()];
-	for (const root of allowedRoots) {
-		const resolvedRoot = path$1.resolve(root);
-		if (isPathWithinRoot(canonicalCandidate, fs$1.existsSync(resolvedRoot) ? fs$1.realpathSync(resolvedRoot) : resolvedRoot)) return canonicalCandidate;
-	}
-	return null;
-}
-//#endregion
-//#region extensions/qqbot/src/engine/messaging/target-parser.ts
-/**
-* Parse a qqbot target string into a structured delivery target.
-*
-* Supported formats:
-* - `qqbot:c2c:openid` → C2C direct message
-* - `qqbot:group:groupid` → Group message
-* - `qqbot:channel:channelid` → Channel message
-* - `c2c:openid` → C2C (without qqbot: prefix)
-* - `group:groupid` → Group (without qqbot: prefix)
-* - `channel:channelid` → Channel (without qqbot: prefix)
-* - `openid` → C2C (bare openid, default)
-*
-* @param to - Raw target string.
-* @returns Parsed target with type and id.
-* @throws {Error} When the target format is invalid.
-*/
-function parseTarget(to) {
-	const id = to.replace(/^qqbot:/i, "");
-	if (id.startsWith("c2c:")) {
-		const userId = id.slice(4);
-		if (!userId) throw new Error(`Invalid c2c target format: ${to} - missing user ID`);
-		return {
-			type: "c2c",
-			id: userId
-		};
-	}
-	if (id.startsWith("group:")) {
-		const groupId = id.slice(6);
-		if (!groupId) throw new Error(`Invalid group target format: ${to} - missing group ID`);
-		return {
-			type: "group",
-			id: groupId
-		};
-	}
-	if (id.startsWith("channel:")) {
-		const channelId = id.slice(8);
-		if (!channelId) throw new Error(`Invalid channel target format: ${to} - missing channel ID`);
-		return {
-			type: "channel",
-			id: channelId
-		};
-	}
-	if (!id) throw new Error(`Invalid target format: ${to} - empty ID after removing qqbot: prefix`);
-	return {
-		type: "c2c",
-		id
-	};
-}
-/**
-* Normalize a QQ Bot target string into the canonical `qqbot:...` form.
-*
-* Returns `undefined` when the target does not look like a QQ Bot address.
-*/
-function normalizeTarget(target) {
-	const id = target.replace(/^qqbot:/i, "");
-	if (id.startsWith("c2c:") || id.startsWith("group:") || id.startsWith("channel:")) return `qqbot:${id}`;
-	if (/^[0-9a-fA-F]{32}$/.test(id)) return `qqbot:c2c:${id}`;
-	if (/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.test(id)) return `qqbot:c2c:${id}`;
-}
-/**
-* Return true when the string looks like a QQ Bot target ID.
-*/
-function looksLikeQQBotTarget(id) {
-	if (/^qqbot:(c2c|group|channel):/i.test(id)) return true;
-	if (/^(c2c|group|channel):/i.test(id)) return true;
-	if (/^[0-9a-fA-F]{32}$/.test(id)) return true;
-	return /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.test(id);
-}
-//#endregion
-export { getHomeDir as a, getQQBotMediaDir as c, isLocalPath as d, isWindows as f, checkSilkWasmAvailable as i, getQQBotMediaPath as l, resolveQQBotPayloadLocalFilePath as m, normalizeTarget as n, getQQBotDataDir as o, normalizePath as p, parseTarget as r, getQQBotDataPath as s, looksLikeQQBotTarget as t, getTempDir as u };