@openfinclaw/openfinclaw-strategy 2026.3.310 → 2026.4.9

package/index.ts

@@ -12,7 +12,7 @@ import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import { registerStrategyCli } from "./src/cli.js";
 import { resolvePluginConfig } from "./src/config.js";
 import { registerDatahubTools } from "./src/datahub/tools.js";
-import { getDb } from "./src/db/db.js";
+import { closeDb, getDb } from "./src/db/db.js";
 import { createOpenFinclawGatewayProxy } from "./src/http/gateway-proxy.js";
 import { startHttpServer } from "./src/http/server.js";
 import { OPENFINCLAW_AGENT_GUIDANCE } from "./src/prompt-guidance.js";
@@ -82,6 +82,11 @@ export default definePluginEntry({
       prependSystemContext: `${OPENFINCLAW_AGENT_GUIDANCE}\n\n${tournamentPrompt}`,
     }));
 
+    // Graceful shutdown: close SQLite connection
+    process.once("beforeExit", () => {
+      closeDb();
+    });
+
     // ── Gateway Cron registration ──
     // Write cron jobs directly to ~/.openclaw/cron/jobs.json during register().
     // This ensures jobs are available immediately on both gateway startup AND
@@ -90,9 +95,9 @@ export default definePluginEntry({
     if (config.schedulerEnabled) {
       setupOpenfinclawCronJobs(config)
         .then((result) => {
-          if (result.created > 0) {
+          if (result.created > 0 || result.migrated > 0) {
             api.logger.info(
-              `[OpenFinClaw] Cron jobs registered: ${result.created} created, ${result.existing} existing`,
+              `[OpenFinClaw] Cron jobs: ${result.created} created, ${result.migrated} migrated, ${result.existing} existing`,
             );
           }
         })

package/openclaw.plugin.json

@@ -23,7 +23,7 @@
       "datahubGatewayUrl": {
         "type": "string",
         "description": "DataHub Gateway URL for market data",
-        "default": "http://43.134.61.136:9080"
+        "default": "https://datahub.openfinclaw.ai"
       },
       "requestTimeoutMs": {
         "type": "number",
@@ -69,6 +69,16 @@
         "default": "Asia/Shanghai",
         "description": "Timezone for scheduled tasks"
       },
+      "cronSessionTarget": {
+        "type": "string",
+        "default": "isolated",
+        "description": "Cron job session mode: 'isolated' (own session, won't block main chat) or 'main' (legacy, runs in main conversation)"
+      },
+      "cronDeliveryMode": {
+        "type": "string",
+        "default": "announce",
+        "description": "Cron result delivery: 'announce' (push to user's last active channel) or 'none' (silent)"
+      },
       "newsApiKey": {
         "type": "string",
         "description": "Optional API key for Finnhub or NewsAPI news provider",
@@ -101,7 +111,7 @@
     },
     "datahubGatewayUrl": {
       "label": "DataHub Gateway URL",
-      "placeholder": "http://43.134.61.136:9080"
+      "placeholder": "https://datahub.openfinclaw.ai"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfinclaw/openfinclaw-strategy",
-  "version": "2026.3.310",
+  "version": "2026.4.9",
   "description": "OpenFinClaw - Unified financial tools: market data (price/K-line/crypto/compare/search), strategy publishing, fork, and validation. Single API key for Hub and DataHub.",
   "keywords": [
     "backtest",

package/src/config.ts

@@ -6,7 +6,7 @@ import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
 import type { NewsProviderType, UnifiedPluginConfig } from "./types.js";
 
 const DEFAULT_HUB_API_URL = "https://hub.openfinclaw.ai";
-const DEFAULT_DATAHUB_GATEWAY_URL = "http://43.134.61.136:9080";
+const DEFAULT_DATAHUB_GATEWAY_URL = "https://datahub.openfinclaw.ai";
 const DEFAULT_TIMEOUT_MS = 60_000;
 
 const DEFAULT_SCAN_CRON = "0 8 * * *";
@@ -92,6 +92,29 @@ export function resolvePluginConfig(api: OpenClawPluginApi): UnifiedPluginConfig
     readEnv(["OPENFINCLAW_SCAN_TZ"]) ??
     DEFAULT_SCAN_TZ;
 
+  const cronAgentIdRaw =
+    (typeof raw?.cronAgentId === "string" ? raw.cronAgentId : undefined) ??
+    readEnv(["OPENFINCLAW_CRON_AGENT_ID"]);
+  const cronAgentId = cronAgentIdRaw?.trim() || undefined;
+
+  const VALID_SESSION_TARGETS = new Set(["isolated", "main"]);
+  const cronSessionTargetRaw =
+    (typeof raw?.cronSessionTarget === "string" ? raw.cronSessionTarget : undefined) ??
+    readEnv(["OPENFINCLAW_CRON_SESSION_TARGET"]) ??
+    "isolated";
+  const cronSessionTarget = VALID_SESSION_TARGETS.has(cronSessionTargetRaw)
+    ? cronSessionTargetRaw
+    : "isolated";
+
+  const VALID_DELIVERY_MODES = new Set(["announce", "none"]);
+  const cronDeliveryModeRaw =
+    (typeof raw?.cronDeliveryMode === "string" ? raw.cronDeliveryMode : undefined) ??
+    readEnv(["OPENFINCLAW_CRON_DELIVERY_MODE"]) ??
+    "announce";
+  const cronDeliveryMode = VALID_DELIVERY_MODES.has(cronDeliveryModeRaw)
+    ? cronDeliveryModeRaw
+    : "announce";
+
   // ── News config ──
   const newsApiKey =
     (typeof raw?.newsApiKey === "string" ? raw.newsApiKey : undefined) ??
@@ -124,6 +147,9 @@ export function resolvePluginConfig(api: OpenClawPluginApi): UnifiedPluginConfig
     weeklyReportCronExpr,
     monthlyReportCronExpr,
     scanTimezone,
+    cronAgentId,
+    cronSessionTarget,
+    cronDeliveryMode,
     newsApiKey: newsApiKey && newsApiKey.length > 0 ? newsApiKey : undefined,
     newsProvider,
     priceAlertThreshold,

package/src/db/db.ts

@@ -12,7 +12,7 @@ import { mkdirSync, unlinkSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { DatabaseSync } from "node:sqlite";
-import { ensureSchema } from "./schema.js";
+import { cleanupOldRows, ensureSchema } from "./schema.js";
 
 /** globalThis key — survives module hot-reloads within the same process. */
 const GLOBAL_DB_KEY = "__openfinclaw_db__" as const;
@@ -52,6 +52,8 @@ export function getDb(): DatabaseSync {
     ensureSchema(db);
   }
   (globalThis as Record<string, unknown>)[GLOBAL_DB_KEY] = db;
+  // Best-effort cleanup of old rows on first access each process lifecycle
+  cleanupOldRows(db);
   return db;
 }
 

package/src/db/repositories.ts

@@ -1,7 +1,12 @@
 /**
  * Data access helpers for OpenFinClaw plugin SQLite tables.
  */
-import type { DatabaseSync } from "node:sqlite";
+import type { DatabaseSync, SQLInputValue } from "node:sqlite";
+
+/** Cast unknown[] to SQLInputValue[] for db.prepare().run() spread. */
+function sqlParams(values: unknown[]): SQLInputValue[] {
+  return values as SQLInputValue[];
+}
 
 // ── Row types ─────────────────────────────────────────────────────────────
 
@@ -262,7 +267,7 @@ export function updateBacktestResult(
     }
     if (sets.length === 0) return;
     values.push(id);
-    db.prepare(`UPDATE backtest_results SET ${sets.join(", ")} WHERE id = ?`).run(...values);
+    db.prepare(`UPDATE backtest_results SET ${sets.join(", ")} WHERE id = ?`).run(...sqlParams(values));
   } catch {
     // Logging must never crash the calling tool
   }
@@ -347,7 +352,7 @@ export function updateScanHistory(
     }
     if (sets.length === 0) return;
     values.push(id);
-    db.prepare(`UPDATE scan_history SET ${sets.join(", ")} WHERE id = ?`).run(...values);
+    db.prepare(`UPDATE scan_history SET ${sets.join(", ")} WHERE id = ?`).run(...sqlParams(values));
   } catch {
     // Logging must never crash the calling tool
   }
@@ -378,7 +383,7 @@ export function queryScanHistory(
   params.push(limit, offset);
   return db
     .prepare(`SELECT * FROM scan_history ${where} ORDER BY started_at DESC LIMIT ? OFFSET ?`)
-    .all(...params) as ScanHistoryEntry[];
+    .all(...sqlParams(params)) as unknown as ScanHistoryEntry[];
 }
 
 /**
@@ -462,7 +467,7 @@ export function queryPriceAlerts(
   params.push(limit, offset);
   return db
     .prepare(`SELECT * FROM price_alerts ${where} ORDER BY created_at DESC LIMIT ? OFFSET ?`)
-    .all(...params) as PriceAlertEntry[];
+    .all(...sqlParams(params)) as unknown as PriceAlertEntry[];
 }
 
 /** Count price_alerts rows since an inclusive time bound (ISO 8601 created_at). */
@@ -488,19 +493,19 @@ export function acknowledgePriceAlert(db: DatabaseSync, id: string): void {
 export function queryActivityLog(db: DatabaseSync, limit = 50, offset = 0): ActivityLogEntry[] {
   return db
     .prepare(`SELECT * FROM agent_activity_log ORDER BY timestamp DESC LIMIT ? OFFSET ?`)
-    .all(limit, offset) as ActivityLogEntry[];
+    .all(limit, offset) as unknown as ActivityLogEntry[];
 }
 
 /** Query agent_events, newest first. */
 export function queryAgentEvents(db: DatabaseSync, limit = 50, offset = 0): AgentEventEntry[] {
   return db
     .prepare(`SELECT * FROM agent_events ORDER BY timestamp DESC LIMIT ? OFFSET ?`)
-    .all(limit, offset) as AgentEventEntry[];
+    .all(limit, offset) as unknown as AgentEventEntry[];
 }
 
 /** Query all strategies, newest first. */
 export function queryStrategies(db: DatabaseSync): StrategyRow[] {
-  return db.prepare(`SELECT * FROM strategies ORDER BY updated_at DESC`).all() as StrategyRow[];
+  return db.prepare(`SELECT * FROM strategies ORDER BY updated_at DESC`).all() as unknown as StrategyRow[];
 }
 
 /** Query backtest results, optionally filtered by strategy_id. */
@@ -508,9 +513,9 @@ export function queryBacktestResults(db: DatabaseSync, strategyId?: string): Bac
   if (strategyId) {
     return db
       .prepare(`SELECT * FROM backtest_results WHERE strategy_id = ? ORDER BY created_at DESC`)
-      .all(strategyId) as BacktestRow[];
+      .all(strategyId) as unknown as BacktestRow[];
   }
   return db
     .prepare(`SELECT * FROM backtest_results ORDER BY created_at DESC`)
-    .all() as BacktestRow[];
+    .all() as unknown as BacktestRow[];
 }

package/src/db/schema.ts

@@ -141,6 +141,23 @@ export function ensureSchema(db: DatabaseSync): void {
   // ── migrations (add columns to existing databases) ──────────────────────
 }
 
+/**
+ * Purge old rows from accumulating tables.
+ * Safe to call periodically (e.g. on plugin register or via cron).
+ * Keeps 90 days of activity logs, scan history, and acknowledged price alerts.
+ */
+export function cleanupOldRows(db: DatabaseSync): void {
+  const cutoff = new Date(Date.now() - 90 * 24 * 60 * 60 * 1000).toISOString();
+  try {
+    db.exec(`DELETE FROM agent_activity_log WHERE timestamp < '${cutoff}'`);
+    db.exec(`DELETE FROM scan_history WHERE started_at < '${cutoff}'`);
+    db.exec(`DELETE FROM price_alerts WHERE acknowledged = 1 AND created_at < '${cutoff}'`);
+    db.exec(`DELETE FROM agent_events WHERE timestamp < '${cutoff}'`);
+  } catch {
+    // Cleanup is best-effort — never crash the plugin
+  }
+}
+
 /** Add a column if it doesn't already exist (safe for repeated calls). */
 function ensureColumn(db: DatabaseSync, table: string, column: string, definition: string): void {
   const rows = db.prepare(`PRAGMA table_info(${table})`).all() as Array<{ name: string }>;

package/src/scheduler/cron-setup.ts

@@ -8,7 +8,9 @@
  * The running CronService watches the store file and picks up new jobs
  * on its next tick.
  *
- * Idempotent: safe to call multiple times (skips existing jobs by name).
+ * Idempotent: creates missing jobs and migrates legacy "main" session jobs
+ * to "isolated" so cron tasks run in their own session without blocking the
+ * user's active conversation.
  *
  * Jobs:
  * - openfinclaw:daily-scan      (0 8 * * *)       每日策略扫描
@@ -23,16 +25,21 @@ import type { UnifiedPluginConfig } from "../types.js";
 
 // ── Cron store types (mirrors src/cron/types.ts subset) ──────────────────
 
+type CronPayload =
+  | { kind: "systemEvent"; text: string }
+  | { kind: "agentTurn"; message: string };
+
 /** Minimal stored cron job shape. */
 interface StoredCronJob {
   id: string;
   name: string;
+  agentId?: string;
   enabled: boolean;
   schedule: { kind: "cron"; expr: string; tz?: string };
-  payload: { kind: "systemEvent"; text: string };
+  payload: CronPayload;
   sessionTarget: string;
   wakeMode: string;
-  delivery: { mode: string };
+  delivery: { mode: string; channel?: string; to?: string };
   createdAtMs: number;
   updatedAtMs: number;
   state: Record<string, unknown>;
@@ -43,6 +50,14 @@ interface CronStoreFile {
   jobs: StoredCronJob[];
 }
 
+/** Names managed by this plugin — used for migration detection. */
+const OPENFINCLAW_JOB_NAMES = new Set([
+  "openfinclaw:daily-scan",
+  "openfinclaw:price-monitor",
+  "openfinclaw:weekly-report",
+  "openfinclaw:monthly-report",
+]);
+
 // ── File I/O ──────────────────────────────────────────────────────────────
 
 /** Resolve default cron store path: ~/.openclaw/cron/jobs.json */
@@ -82,15 +97,26 @@ async function saveStore(storePath: string, store: CronStoreFile): Promise<void>
 function buildCronJobDefs(config: UnifiedPluginConfig): Array<{
   name: string;
   schedule: { kind: "cron"; expr: string; tz?: string };
-  payload: { kind: "systemEvent"; text: string };
+  payload: CronPayload;
+  sessionTarget: string;
+  delivery: { mode: string };
 }> {
+  const sessionTarget = config.cronSessionTarget;
+  const delivery = { mode: config.cronDeliveryMode };
+  const useAgentTurn = sessionTarget !== "main";
+
+  function makePayload(text: string): CronPayload {
+    return useAgentTurn ? { kind: "agentTurn", message: text } : { kind: "systemEvent", text };
+  }
+
   return [
     {
       name: "openfinclaw:daily-scan",
       schedule: { kind: "cron", expr: config.scanCronExpr, tz: config.scanTimezone },
-      payload: {
-        kind: "systemEvent",
-        text: [
+      sessionTarget,
+      delivery,
+      payload: makePayload(
+        [
           "[openfinclaw-strategy 每日扫描]",
           "1. 调用 strategy_daily_scan 获取策略扫描报告",
           "2. 分析每条新闻对策略的影响（利好/利空/中性）",
@@ -98,56 +124,94 @@ function buildCronJobDefs(config: UnifiedPluginConfig): Array<{
           "4. 用 skill_publish_verify 确认回测完成",
           "5. 将分析报告和建议操作发送给用户",
         ].join("\n"),
-      },
+      ),
     },
     {
       name: "openfinclaw:price-monitor",
       schedule: { kind: "cron", expr: config.monitorCronExpr, tz: config.scanTimezone },
-      payload: {
-        kind: "systemEvent",
-        text: [
+      sessionTarget,
+      delivery,
+      payload: makePayload(
+        [
           "[openfinclaw-strategy 价格监控]",
           "调用 strategy_price_monitor 检查所有策略标的的价格异动。",
           "如有告警（涨跌幅超阈值），分析可能的原因并通知用户。",
         ].join("\n"),
-      },
+      ),
     },
     {
       name: "openfinclaw:weekly-report",
       schedule: { kind: "cron", expr: config.weeklyReportCronExpr, tz: config.scanTimezone },
-      payload: {
-        kind: "systemEvent",
-        text: [
+      sessionTarget,
+      delivery,
+      payload: makePayload(
+        [
           "[openfinclaw-strategy 周报]",
           '调用 strategy_periodic_report(period="weekly") 生成策略绩效周报。',
           "汇总本周回测结果、价格告警和扫描记录，发送给用户。",
         ].join("\n"),
-      },
+      ),
     },
     {
       name: "openfinclaw:monthly-report",
       schedule: { kind: "cron", expr: config.monthlyReportCronExpr, tz: config.scanTimezone },
-      payload: {
-        kind: "systemEvent",
-        text: [
+      sessionTarget,
+      delivery,
+      payload: makePayload(
+        [
           "[openfinclaw-strategy 月报]",
           '调用 strategy_periodic_report(period="monthly") 生成策略绩效月报。',
           "汇总本月回测结果、价格告警和扫描记录，发送给用户。",
         ].join("\n"),
-      },
+      ),
     },
   ];
 }
 
+// ── Migration ─────────────────────────────────────────────────────────────
+
+/**
+ * Migrate legacy openfinclaw jobs that still use sessionTarget "main" +
+ * systemEvent payload to the new isolated agentTurn pattern.
+ * Returns the number of jobs migrated.
+ */
+function migrateLegacyJobs(
+  store: CronStoreFile,
+  defs: ReturnType<typeof buildCronJobDefs>,
+): number {
+  const defsByName = new Map(defs.map((d) => [d.name, d]));
+  let migrated = 0;
+
+  for (const job of store.jobs) {
+    if (!OPENFINCLAW_JOB_NAMES.has(job.name)) continue;
+    if (job.sessionTarget !== "main") continue;
+
+    const def = defsByName.get(job.name);
+    if (!def) continue;
+
+    job.payload = def.payload;
+    job.sessionTarget = def.sessionTarget;
+    job.delivery = def.delivery;
+    job.updatedAtMs = Date.now();
+    migrated++;
+  }
+
+  return migrated;
+}
+
 // ── Public API ────────────────────────────────────────────────────────────
 
 /**
- * Idempotently register openfinclaw cron jobs by writing to the
+ * Register and migrate openfinclaw cron jobs by writing to the
  * Gateway cron store file. Safe to call at plugin startup.
+ *
+ * - Creates missing jobs with the current config (isolated session by default).
+ * - Migrates existing legacy "main" session jobs to "isolated" + "agentTurn"
+ *   so cron tasks no longer block the user's active conversation.
  */
 export async function setupOpenfinclawCronJobs(
   config: UnifiedPluginConfig,
-): Promise<{ ok: boolean; created: number; existing: number }> {
+): Promise<{ ok: boolean; created: number; existing: number; migrated: number }> {
   const storePath = defaultStorePath();
   const store = await loadStore(storePath);
   const existingNames = new Set(store.jobs.map((j) => j.name));
@@ -160,12 +224,13 @@ export async function setupOpenfinclawCronJobs(
     store.jobs.push({
       id: randomUUID(),
       name: def.name,
+      agentId: config.cronAgentId,
       enabled: true,
       schedule: def.schedule,
       payload: def.payload,
-      sessionTarget: "main",
+      sessionTarget: def.sessionTarget,
       wakeMode: "now",
-      delivery: { mode: "none" },
+      delivery: def.delivery,
       createdAtMs: now,
       updatedAtMs: now,
       state: {},
@@ -173,9 +238,11 @@ export async function setupOpenfinclawCronJobs(
     created++;
   }
 
-  if (created > 0) {
+  const migrated = migrateLegacyJobs(store, defs);
+
+  if (created > 0 || migrated > 0) {
     await saveStore(storePath, store);
   }
 
-  return { ok: true, created, existing: existingNames.size };
+  return { ok: true, created, existing: existingNames.size, migrated };
 }

package/src/types.ts

@@ -552,6 +552,12 @@ export interface UnifiedPluginConfig {
   monthlyReportCronExpr: string;
   /** 调度时区 */
   scanTimezone: string;
+  /** 定时任务绑定的专用 agent id；未设置时沿用默认 agent */
+  cronAgentId: string | undefined;
+  /** Cron session 模式："isolated"（独立 session，不阻塞主对话）或 "main"（旧行为） */
+  cronSessionTarget: string;
+  /** Cron 投递模式："announce"（推送到用户最近活跃频道）或 "none" */
+  cronDeliveryMode: string;
 
   // ── 新闻源配置 ────────────────────────────────────────────
   /** 外部新闻 API Key（Finnhub 或 NewsAPI） */