@openfinclaw/openfinclaw-strategy 2026.3.273 → 2026.3.275

package/SKILL.md

@@ -7,6 +7,7 @@ metadata:
     requires:
       extensions: ["openfinclaw-strategy"]
 ---
+
 # OpenFinClaw
 
 统一金融工具平台，一个 API Key 即可使用所有功能：
@@ -121,42 +122,42 @@ export OPENFINCLAW_API_KEY=YOUR_API_KEY
 
 ### 行情数据工具
 
-| 工具名              | 用途                        | 需要 API Key |
-| ------------------- | --------------------------- | ------------ |
-| `fin_price`       | 价格查询（股票/加密/指数）  | **是** |
-| `fin_kline`       | K线/OHLCV 数据              | **是** |
-| `fin_crypto`      | 加密市场数据（21个端点）    | **是** |
-| `fin_compare`     | 多资产价格对比（2-5个资产） | **是** |
-| `fin_slim_search` | 代码/名称搜索               | **是** |
+| 工具名            | 用途                        | 需要 API Key |
+| ----------------- | --------------------------- | ------------ |
+| `fin_price`       | 价格查询（股票/加密/指数）  | **是**       |
+| `fin_kline`       | K线/OHLCV 数据              | **是**       |
+| `fin_crypto`      | 加密市场数据（21个端点）    | **是**       |
+| `fin_compare`     | 多资产价格对比（2-5个资产） | **是**       |
+| `fin_slim_search` | 代码/名称搜索               | **是**       |
 
 ### 策略工具
 
-| 工具名                   | 用途                                   | 需要 API Key |
-| ------------------------ | -------------------------------------- | ------------ |
+| 工具名                 | 用途                                   | 需要 API Key |
+| ---------------------- | -------------------------------------- | ------------ |
 | `skill_leaderboard`    | 查询排行榜（综合/收益/风控/人气/新星） | 否           |
 | `skill_get_info`       | 获取 Hub 策略公开详情                  | 否           |
 | `skill_validate`       | 本地验证策略包格式（FEP v2.0）         | 否           |
 | `skill_list_local`     | 列出本地已下载的策略                   | 否           |
-| `skill_fork`           | 从 Hub 下载公开策略到本地              | **是** |
-| `skill_publish`        | 发布策略 ZIP 到 Hub，自动触发回测      | **是** |
-| `skill_publish_verify` | 查询发布状态和回测报告                 | **是** |
+| `skill_fork`           | 从 Hub 下载公开策略到本地              | **是**       |
+| `skill_publish`        | 发布策略 ZIP 到 Hub，自动触发回测      | **是**       |
+| `skill_publish_verify` | 查询发布状态和回测报告                 | **是**       |
 
 ### Skills（指导文档）
 
 #### 行情数据 Skills
 
-| Skill           | 触发场景           | 说明             |
-| --------------- | ------------------ | ---------------- |
+| Skill         | 触发场景           | 说明             |
+| ------------- | ------------------ | ---------------- |
 | `price-check` | 快速查价、XX多少钱 | 最简单的价格查询 |
 
 #### 策略 Skills
 
-| Skill                | 触发场景                 | 说明                             |
-| -------------------- | ------------------------ | -------------------------------- |
-| `strategy-builder` | 创建新策略、生成策略代码 | 自然语言 → FEP v2.0 策略包      |
+| Skill              | 触发场景                 | 说明                          |
+| ------------------ | ------------------------ | ----------------------------- |
+| `strategy-builder` | 创建新策略、生成策略代码 | 自然语言 → FEP v2.0 策略包    |
 | `skill-publish`    | 发布策略到服务器         | 验证 → 打包 → 发布 → 查询回测 |
-| `strategy-fork`    | 下载/克隆 Hub 策略       | Fork → 本地编辑 → 发布新版本   |
-| `strategy-pack`    | 创建回测策略包           | 生成 fep.yaml + strategy.py      |
+| `strategy-fork`    | 下载/克隆 Hub 策略       | Fork → 本地编辑 → 发布新版本  |
+| `strategy-pack`    | 创建回测策略包           | 生成 fep.yaml + strategy.py   |
 
 ### 典型工作流
 
@@ -186,8 +187,8 @@ openclaw strategy leaderboard popular --offset 20 --limit 20
 
 **榜单类型**：
 
-| 榜单类型      | 说明           | 排序依据         |
-| ------------- | -------------- | ---------------- |
+| 榜单类型    | 说明           | 排序依据         |
+| ----------- | -------------- | ---------------- |
 | `composite` | 综合榜（默认） | FCS 综合分       |
 | `returns`   | 收益榜         | 收益率           |
 | `risk`      | 风控榜         | 风控分           |
@@ -252,8 +253,8 @@ openclaw strategy show 550e8400-e29b-41d4-a716-446655440001 --remote
 
 看板包含 4 个标签页：
 
-| 标签页   | 数据来源               | 说明                           |
-| -------- | ---------------------- | ------------------------------ |
+| 标签页   | 数据来源             | 说明                           |
+| -------- | -------------------- | ------------------------------ |
 | 活动日志 | `agent_activity_log` | 所有 12 个工具的每次执行记录   |
 | 事件流   | `agent_events`       | Fork、发布、回测完成等关键事件 |
 | 策略列表 | `strategies`         | 本地策略生命周期状态           |
@@ -261,8 +262,8 @@ openclaw strategy show 550e8400-e29b-41d4-a716-446655440001 --remote
 
 **REST API**（供前端或其他工具调用）：
 
-| 端点                          | 说明                     |
-| ----------------------------- | ------------------------ |
+| 端点                        | 说明                     |
+| --------------------------- | ------------------------ |
 | `GET /api/activity-log`     | 工具调用日志（分页）     |
 | `GET /api/agent-events`     | 事件流（分页）           |
 | `GET /api/strategies`       | 策略列表                 |
@@ -283,19 +284,19 @@ openclaw strategy show 550e8400-e29b-41d4-a716-446655440001 --remote
 
 当用户提到以下内容时，应引导阅读对应的 Skill：
 
-| 触发关键词                     | Skill                | 说明                 |
-| ------------------------------ | -------------------- | -------------------- |
-| XX多少钱、什么价格、查价       | `price-check`      | 最简单的价格查询     |
+| 触发关键词                     | Skill              | 说明                |
+| ------------------------------ | ------------------ | ------------------- |
+| XX多少钱、什么价格、查价       | `price-check`      | 最简单的价格查询    |
 | 创建策略、写策略、生成策略包   | `strategy-builder` | 自然语言 → FEP v2.0 |
-| 发布策略、上传策略、提交策略   | `skill-publish`    | 验证 → 打包 → 发布 |
-| Fork 策略、下载策略、克隆策略  | `strategy-fork`    | 从 Hub Fork 策略     |
-| 策略包格式、FEP 规范、打包回测 | `strategy-pack`    | FEP v2.0 规范详解    |
+| 发布策略、上传策略、提交策略   | `skill-publish`    | 验证 → 打包 → 发布  |
+| Fork 策略、下载策略、克隆策略  | `strategy-fork`    | 从 Hub Fork 策略    |
+| 策略包格式、FEP 规范、打包回测 | `strategy-pack`    | FEP v2.0 规范详解   |
 
 ## 配置选项
 
-| 配置项                | 环境变量                  | 说明             | 默认值                         |
-| --------------------- | ------------------------- | ---------------- | ------------------------------ |
-| `apiKey`            | `OPENFINCLAW_API_KEY`   | 统一 API Key     | 必填                           |
+| 配置项              | 环境变量                | 说明             | 默认值                       |
+| ------------------- | ----------------------- | ---------------- | ---------------------------- |
+| `apiKey`            | `OPENFINCLAW_API_KEY`   | 统一 API Key     | 必填                         |
 | `hubApiUrl`         | `HUB_API_URL`           | Hub 服务地址     | `https://hub.openfinclaw.ai` |
 | `datahubGatewayUrl` | `DATAHUB_GATEWAY_URL`   | DataHub 网关地址 | `http://43.134.61.136:9080`  |
 | `requestTimeoutMs`  | `REQUEST_TIMEOUT_MS`    | 请求超时（毫秒） | `60000`                      |

package/index.ts

@@ -16,6 +16,9 @@ import { 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";
+import { setupOpenfinclawCronJobs } from "./src/scheduler/cron-setup.js";
+import { AggregatedNewsProvider, createNewsProviders } from "./src/scheduler/news-provider.js";
+import { registerSchedulerTools } from "./src/scheduler/tools.js";
 import { registerStrategyTools } from "./src/strategy/tools.js";
 
 const openfinclawPlugin = {
@@ -28,14 +31,17 @@ const openfinclawPlugin = {
   register(api: OpenClawPluginApi) {
     const config = resolvePluginConfig(api);
 
-    // Initialise SQLite database (creates tables on first run)
-    const db = getDb();
-
     // Register DataHub market data tools (fin_price, fin_kline, fin_crypto, fin_compare, fin_slim_search)
-    registerDatahubTools(api, config, db);
+    // DB init is lazy — getDb is called at tool execution time, not here.
+    registerDatahubTools(api, config, getDb);
 
     // Register strategy tools (skill_publish, skill_validate, skill_fork, skill_leaderboard, etc.)
-    registerStrategyTools(api, config, db);
+    registerStrategyTools(api, config, getDb);
+
+    // Register scheduler tools (strategy_daily_scan, strategy_scan_history)
+    const newsProviders = createNewsProviders(config);
+    const newsProvider = new AggregatedNewsProvider(newsProviders);
+    registerSchedulerTools(api, config, getDb, newsProvider);
 
     // Register CLI commands
     api.registerCli(
@@ -44,7 +50,7 @@ const openfinclawPlugin = {
           program,
           config,
           logger: api.logger,
-          db,
+          getDb,
         }),
       { commands: ["strategy"] },
     );
@@ -67,6 +73,25 @@ const openfinclawPlugin = {
     api.on("before_prompt_build", async () => ({
       prependSystemContext: OPENFINCLAW_AGENT_GUIDANCE,
     }));
+
+    // ── Gateway Cron registration ──
+    // Register cron jobs on gateway_start (writes to ~/.openclaw/cron/jobs.json)
+    if (config.schedulerEnabled) {
+      api.on("gateway_start", async () => {
+        try {
+          const result = await setupOpenfinclawCronJobs(config);
+          if (result.created > 0) {
+            api.logger.info(
+              `[OpenFinClaw] Cron jobs registered: ${result.created} created, ${result.existing} existing`,
+            );
+          }
+        } catch (err) {
+          api.logger.info(
+            `[OpenFinClaw] Cron setup failed: ${err instanceof Error ? err.message : String(err)}`,
+          );
+        }
+      });
+    }
   },
 };
 

package/openclaw.plugin.json

@@ -38,6 +38,53 @@
         "minimum": 1024,
         "maximum": 65535,
         "description": "Dashboard HTTP server port (loopback only)"
+      },
+      "schedulerEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable scheduled tasks (daily scan, price monitor, reports)"
+      },
+      "scanCronExpr": {
+        "type": "string",
+        "default": "0 8 * * *",
+        "description": "Cron expression for daily strategy scan"
+      },
+      "monitorCronExpr": {
+        "type": "string",
+        "default": "*/30 * * * *",
+        "description": "Cron expression for price monitoring"
+      },
+      "weeklyReportCronExpr": {
+        "type": "string",
+        "default": "0 20 * * 0",
+        "description": "Cron expression for weekly report"
+      },
+      "monthlyReportCronExpr": {
+        "type": "string",
+        "default": "0 20 1 * *",
+        "description": "Cron expression for monthly report"
+      },
+      "scanTimezone": {
+        "type": "string",
+        "default": "Asia/Shanghai",
+        "description": "Timezone for scheduled tasks"
+      },
+      "newsApiKey": {
+        "type": "string",
+        "description": "Optional API key for Finnhub or NewsAPI news provider",
+        "sensitive": true
+      },
+      "newsProvider": {
+        "type": "string",
+        "default": "coingecko",
+        "description": "News provider: coingecko (free, no key), finnhub, or newsapi"
+      },
+      "priceAlertThreshold": {
+        "type": "number",
+        "default": 5,
+        "minimum": 0.1,
+        "maximum": 100,
+        "description": "Price change alert threshold in percent"
       }
     }
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfinclaw/openfinclaw-strategy",
-  "version": "2026.3.273",
+  "version": "2026.3.275",
   "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/cli.ts

@@ -17,13 +17,13 @@ type Logger = {
 
 /** Log a CLI command execution to agent_activity_log. */
 function logCli(
-  db: DatabaseSync,
+  getDb: () => DatabaseSync,
   action: string,
   params: Record<string, unknown>,
   startMs: number,
   error?: string,
 ): void {
-  insertActivityLog(db, {
+  insertActivityLog(getDb(), {
     id: randomUUID(),
     timestamp: new Date().toISOString(),
     category: "strategy",
@@ -39,9 +39,9 @@ export function registerStrategyCli(params: {
   program: Command;
   config: UnifiedPluginConfig;
   logger: Logger;
-  db: DatabaseSync;
+  getDb: () => DatabaseSync;
 }) {
-  const { program, config, db } = params;
+  const { program, config, getDb } = params;
 
   const root = program
     .command("strategy")
@@ -72,7 +72,7 @@ export function registerStrategyCli(params: {
 
           if (!response.ok) {
             logCli(
-              db,
+              getDb,
               "leaderboard",
               { boardType, limit, offset },
               startMs,
@@ -101,7 +101,7 @@ export function registerStrategyCli(params: {
             const perf = s.performance || {};
             const returnStr =
               typeof perf.returnSincePublish === "number"
-                ? `收益: ${(perf.returnSincePublish * 100).toFixed(1)}%`
+                ? `收益: ${perf.returnSincePublish.toFixed(1)}%`
                 : "收益: --";
             const sharpeStr =
               typeof perf.sharpeRatio === "number"
@@ -109,7 +109,7 @@ export function registerStrategyCli(params: {
                 : "夏普: --";
             const ddStr =
               typeof perf.maxDrawdown === "number"
-                ? `回撤: ${(perf.maxDrawdown * 100).toFixed(1)}%`
+                ? `回撤: ${perf.maxDrawdown.toFixed(1)}%`
                 : "回撤: --";
             const author = s.author?.displayName || "未知";
 
@@ -124,9 +124,9 @@ export function registerStrategyCli(params: {
           console.log("");
           console.log("使用 openclaw strategy show <id> --remote 查看详情");
           console.log("使用 openclaw strategy fork <id> 下载策略（需要 API Key）");
-          logCli(db, "leaderboard", { boardType, limit, offset }, startMs);
+          logCli(getDb, "leaderboard", { boardType, limit, offset }, startMs);
         } catch (err) {
-          logCli(db, "leaderboard", { boardType, limit, offset }, startMs, String(err));
+          logCli(getDb, "leaderboard", { boardType, limit, offset }, startMs, String(err));
           console.error(`✗ 请求失败: ${err instanceof Error ? err.message : String(err)}`);
           process.exitCode = 1;
         }
@@ -149,7 +149,7 @@ export function registerStrategyCli(params: {
       });
 
       if (result.success) {
-        logCli(db, "fork", { strategyId }, startMs);
+        logCli(getDb, "fork", { strategyId }, startMs);
         console.log("✓ 策略 Fork 成功！");
         console.log("");
         console.log(`  名称: ${result.sourceName}`);
@@ -160,7 +160,7 @@ export function registerStrategyCli(params: {
         console.log(`  验证: openfinclaw strategy validate ${result.localPath}`);
         console.log(`  发布: openfinclaw strategy publish ${result.localPath}`);
       } else {
-        logCli(db, "fork", { strategyId }, startMs, result.error ?? "unknown");
+        logCli(getDb, "fork", { strategyId }, startMs, result.error ?? "unknown");
         console.error(`✗ Fork 失败: ${result.error}`);
         process.exitCode = 1;
       }
@@ -202,7 +202,7 @@ export function registerStrategyCli(params: {
           s.displayName.length > 20 ? s.displayName.slice(0, 17) + "..." : s.displayName;
         console.log(`  ${name.padEnd(40)} ${displayName.padEnd(20)} ${typeLabel}`);
       }
-      logCli(db, "list", { count: strategies.length }, startMs);
+      logCli(getDb, "list", { count: strategies.length }, startMs);
     });
 
   // ── strategy show ──
@@ -216,7 +216,7 @@ export function registerStrategyCli(params: {
       const local = await findLocalStrategy(nameOrId);
 
       if (!local && !options.remote) {
-        logCli(db, "show", { nameOrId }, startMs, "not found");
+        logCli(getDb, "show", { nameOrId }, startMs, "not found");
         console.error(`✗ 本地策略未找到: ${nameOrId}`);
         console.error("  使用 --remote 从 Hub 获取信息");
         process.exitCode = 1;
@@ -227,7 +227,7 @@ export function registerStrategyCli(params: {
         const infoResult = await fetchStrategyInfo(config, local.sourceId);
         if (infoResult.success && infoResult.data) {
           const info = infoResult.data;
-          logCli(db, "show", { nameOrId, remote: true }, startMs);
+          logCli(getDb, "show", { nameOrId, remote: true }, startMs);
           if (options.json) {
             console.log(JSON.stringify({ local, hub: info }, null, 2));
             return;
@@ -238,7 +238,7 @@ export function registerStrategyCli(params: {
       }
 
       if (local) {
-        logCli(db, "show", { nameOrId }, startMs);
+        logCli(getDb, "show", { nameOrId }, startMs);
         if (options.json) {
           console.log(JSON.stringify(local, null, 2));
           return;
@@ -247,7 +247,7 @@ export function registerStrategyCli(params: {
         return;
       }
 
-      logCli(db, "show", { nameOrId }, startMs, "not found");
+      logCli(getDb, "show", { nameOrId }, startMs, "not found");
       console.error(`✗ 策略未找到: ${nameOrId}`);
       process.exitCode = 1;
     });
@@ -262,7 +262,7 @@ export function registerStrategyCli(params: {
       const startMs = Date.now();
       const local = await findLocalStrategy(nameOrId);
       if (!local) {
-        logCli(db, "remove", { nameOrId }, startMs, "not found");
+        logCli(getDb, "remove", { nameOrId }, startMs, "not found");
         console.error(`✗ 策略未找到: ${nameOrId}`);
         process.exitCode = 1;
         return;
@@ -278,10 +278,10 @@ export function registerStrategyCli(params: {
 
       const result = await removeLocalStrategy(nameOrId);
       if (result.success) {
-        logCli(db, "remove", { nameOrId }, startMs);
+        logCli(getDb, "remove", { nameOrId }, startMs);
         console.log("✓ 策略已删除");
       } else {
-        logCli(db, "remove", { nameOrId }, startMs, result.error ?? "unknown");
+        logCli(getDb, "remove", { nameOrId }, startMs, result.error ?? "unknown");
         console.error(`✗ 删除失败: ${result.error}`);
         process.exitCode = 1;
       }

package/src/config.ts

@@ -3,12 +3,20 @@
  * Supports single API key for both Hub and DataHub services.
  */
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
-import type { UnifiedPluginConfig } from "./types.js";
+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_TIMEOUT_MS = 60_000;
 
+const DEFAULT_SCAN_CRON = "0 8 * * *";
+const DEFAULT_MONITOR_CRON = "*/30 * * * *";
+const DEFAULT_WEEKLY_CRON = "0 20 * * 0";
+const DEFAULT_MONTHLY_CRON = "0 20 1 * *";
+const DEFAULT_SCAN_TZ = "Asia/Shanghai";
+const DEFAULT_ALERT_THRESHOLD = 5;
+const VALID_NEWS_PROVIDERS = new Set<NewsProviderType>(["coingecko", "finnhub", "newsapi"]);
+
 function readEnv(keys: string[]): string | undefined {
   for (const key of keys) {
     const value = process.env[key]?.trim();
@@ -55,11 +63,67 @@ export function resolvePluginConfig(api: OpenClawPluginApi): UnifiedPluginConfig
       ? Math.floor(httpPortNum)
       : 18792;
 
+  // ── Scheduler config ──
+  const schedulerEnabled =
+    (raw?.schedulerEnabled ?? readEnv(["OPENFINCLAW_SCHEDULER_ENABLED"])) !== "false";
+
+  const scanCronExpr =
+    (typeof raw?.scanCronExpr === "string" ? raw.scanCronExpr : undefined) ??
+    readEnv(["OPENFINCLAW_SCAN_CRON"]) ??
+    DEFAULT_SCAN_CRON;
+
+  const monitorCronExpr =
+    (typeof raw?.monitorCronExpr === "string" ? raw.monitorCronExpr : undefined) ??
+    readEnv(["OPENFINCLAW_MONITOR_CRON"]) ??
+    DEFAULT_MONITOR_CRON;
+
+  const weeklyReportCronExpr =
+    (typeof raw?.weeklyReportCronExpr === "string" ? raw.weeklyReportCronExpr : undefined) ??
+    readEnv(["OPENFINCLAW_WEEKLY_CRON"]) ??
+    DEFAULT_WEEKLY_CRON;
+
+  const monthlyReportCronExpr =
+    (typeof raw?.monthlyReportCronExpr === "string" ? raw.monthlyReportCronExpr : undefined) ??
+    readEnv(["OPENFINCLAW_MONTHLY_CRON"]) ??
+    DEFAULT_MONTHLY_CRON;
+
+  const scanTimezone =
+    (typeof raw?.scanTimezone === "string" ? raw.scanTimezone : undefined) ??
+    readEnv(["OPENFINCLAW_SCAN_TZ"]) ??
+    DEFAULT_SCAN_TZ;
+
+  // ── News config ──
+  const newsApiKey =
+    (typeof raw?.newsApiKey === "string" ? raw.newsApiKey : undefined) ??
+    readEnv(["OPENFINCLAW_NEWS_API_KEY"]);
+
+  const newsProviderRaw =
+    (typeof raw?.newsProvider === "string" ? raw.newsProvider : undefined) ??
+    readEnv(["OPENFINCLAW_NEWS_PROVIDER"]) ??
+    "coingecko";
+  const newsProvider: NewsProviderType = VALID_NEWS_PROVIDERS.has(newsProviderRaw as NewsProviderType)
+    ? (newsProviderRaw as NewsProviderType)
+    : "coingecko";
+
+  // ── Alert config ──
+  const alertThresholdRaw = raw?.priceAlertThreshold ?? readEnv(["OPENFINCLAW_ALERT_THRESHOLD"]);
+  const priceAlertThreshold =
+    Number(alertThresholdRaw) > 0 ? Number(alertThresholdRaw) : DEFAULT_ALERT_THRESHOLD;
+
   return {
     apiKey: apiKey && apiKey.length > 0 ? apiKey : undefined,
     hubApiUrl: hubApiUrl.replace(/\/$/, ""),
     datahubGatewayUrl: datahubGatewayUrl.replace(/\/+$/, ""),
     requestTimeoutMs,
     httpPort,
+    schedulerEnabled,
+    scanCronExpr,
+    monitorCronExpr,
+    weeklyReportCronExpr,
+    monthlyReportCronExpr,
+    scanTimezone,
+    newsApiKey: newsApiKey && newsApiKey.length > 0 ? newsApiKey : undefined,
+    newsProvider,
+    priceAlertThreshold,
   };
 }

package/src/datahub/tools.ts

@@ -1,8 +1,8 @@
-import type { DatabaseSync } from "node:sqlite";
 /**
  * DataHub market data tools registration.
  * Tools: fin_price, fin_kline, fin_crypto, fin_compare, fin_slim_search
  */
+import type { DatabaseSync } from "node:sqlite";
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
 import { withLogging } from "../middleware/with-logging.js";
@@ -31,12 +31,12 @@ const NO_KEY =
 
 /**
  * Register DataHub market data tools.
- * @param db - SQLite database for activity logging.
+ * @param getDb - Lazy database getter (called at execution time, not registration).
  */
 export function registerDatahubTools(
   api: OpenClawPluginApi,
   config: UnifiedPluginConfig,
-  db: DatabaseSync,
+  getDb: () => DatabaseSync,
 ): void {
   const datahubClient = config.apiKey
     ? new DataHubClient(config.datahubGatewayUrl, config.apiKey, config.requestTimeoutMs)
@@ -91,7 +91,7 @@ export function registerDatahubTools(
           }),
         ),
       }),
-      execute: withLogging(db, "fin_price", "market-data", async (_id, params) => {
+      execute: withLogging(getDb, "fin_price", "market-data", async (_id, params) => {
         try {
           if (!datahubClient) return json({ error: NO_KEY });
           const symbol = String(params.symbol);
@@ -135,7 +135,7 @@ export function registerDatahubTools(
           Type.Number({ description: "Number of bars to return (default: 30)" }),
         ),
       }),
-      execute: withLogging(db, "fin_kline", "market-data", async (_id, params) => {
+      execute: withLogging(getDb, "fin_kline", "market-data", async (_id, params) => {
         try {
           if (!datahubClient) return json({ error: NO_KEY });
           const symbol = String(params.symbol);
@@ -209,7 +209,7 @@ export function registerDatahubTools(
         end_date: Type.Optional(Type.String({ description: "End date (YYYY-MM-DD)" })),
         limit: Type.Optional(Type.Number({ description: "Max results (default: 20)" })),
       }),
-      execute: withLogging(db, "fin_crypto", "market-data", async (_id, params) => {
+      execute: withLogging(getDb, "fin_crypto", "market-data", async (_id, params) => {
         try {
           if (!datahubClient) return json({ error: NO_KEY });
           const endpoint = String(params.endpoint ?? "coin/market");
@@ -256,7 +256,7 @@ export function registerDatahubTools(
           description: "Comma-separated symbols (2-5). Example: BTC/USDT,ETH/USDT,600519.SH",
         }),
       }),
-      execute: withLogging(db, "fin_compare", "market-data", async (_id, params) => {
+      execute: withLogging(getDb, "fin_compare", "market-data", async (_id, params) => {
         try {
           if (!datahubClient) return json({ error: NO_KEY });
           const raw = String(params.symbols);
@@ -279,7 +279,7 @@ export function registerDatahubTools(
                 symbol: sym,
                 market,
                 price: ticker.last,
-                weekChange: Math.round(weekChange * 100) / 100,
+                weekChange: parseFloat(weekChange.toFixed(2)),
               };
             }),
           );
@@ -317,7 +317,7 @@ export function registerDatahubTools(
           }),
         ),
       }),
-      execute: withLogging(db, "fin_slim_search", "market-data", async (_id, params) => {
+      execute: withLogging(getDb, "fin_slim_search", "market-data", async (_id, params) => {
         try {
           if (!datahubClient) return json({ error: NO_KEY });
           const q = String(params.query);

package/src/db/db.ts

@@ -1,4 +1,4 @@
-import { mkdirSync } from "node:fs";
+import { mkdirSync, unlinkSync } from "node:fs";
 /**
  * SQLite database singleton for OpenFinClaw plugin.
  * Database path: ~/.openfinclaw/workspace/openfinclaw-plugin.db
@@ -9,15 +9,11 @@ import { mkdirSync } from "node:fs";
  * a second DatabaseSync connection while the old HTTP server still
  * holds a reference to the first one via the old module scope.
  */
-import { createRequire } from "node:module";
 import { homedir } from "node:os";
 import { join } from "node:path";
-import type { DatabaseSync } from "node:sqlite";
+import { DatabaseSync } from "node:sqlite";
 import { ensureSchema } from "./schema.js";
 
-// Use createRequire to load the built-in node:sqlite in an ESM context.
-const _require = createRequire(import.meta.url);
-
 /** globalThis key — survives module hot-reloads within the same process. */
 const GLOBAL_DB_KEY = "__openfinclaw_db__" as const;
 
@@ -40,10 +36,21 @@ export function getDb(): DatabaseSync {
   if (existing) return existing;
 
   // node:sqlite is available in Node 22+
-  const { DatabaseSync } = _require("node:sqlite") as typeof import("node:sqlite");
   const dbPath = resolveDbPath();
-  const db = new DatabaseSync(dbPath);
-  ensureSchema(db);
+  let db: DatabaseSync;
+  try {
+    db = new DatabaseSync(dbPath);
+    ensureSchema(db);
+  } catch (err) {
+    // If the file is corrupted ("file is not a database"), delete and retry once.
+    try {
+      unlinkSync(dbPath);
+    } catch {
+      // File may already be gone — ignore.
+    }
+    db = new DatabaseSync(dbPath);
+    ensureSchema(db);
+  }
   (globalThis as Record<string, unknown>)[GLOBAL_DB_KEY] = db;
   return db;
 }