@openfinclaw/openfinclaw-strategy 2026.3.275 → 2026.3.276

package/index.ts

@@ -75,22 +75,24 @@ const openfinclawPlugin = {
     }));
 
     // ── Gateway Cron registration ──
-    // Register cron jobs on gateway_start (writes to ~/.openclaw/cron/jobs.json)
+    // Write cron jobs directly to ~/.openclaw/cron/jobs.json during register().
+    // This ensures jobs are available immediately on both gateway startup AND
+    // hot-reload (plugin install without restart). The CronService picks up
+    // file changes on its next tick.
     if (config.schedulerEnabled) {
-      api.on("gateway_start", async () => {
-        try {
-          const result = await setupOpenfinclawCronJobs(config);
+      setupOpenfinclawCronJobs(config)
+        .then((result) => {
           if (result.created > 0) {
             api.logger.info(
               `[OpenFinClaw] Cron jobs registered: ${result.created} created, ${result.existing} existing`,
             );
           }
-        } catch (err) {
+        })
+        .catch((err) => {
           api.logger.info(
             `[OpenFinClaw] Cron setup failed: ${err instanceof Error ? err.message : String(err)}`,
           );
-        }
-      });
+        });
     }
   },
 };

package/package.json

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

@@ -101,7 +101,9 @@ export function resolvePluginConfig(api: OpenClawPluginApi): UnifiedPluginConfig
     (typeof raw?.newsProvider === "string" ? raw.newsProvider : undefined) ??
     readEnv(["OPENFINCLAW_NEWS_PROVIDER"]) ??
     "coingecko";
-  const newsProvider: NewsProviderType = VALID_NEWS_PROVIDERS.has(newsProviderRaw as NewsProviderType)
+  const newsProvider: NewsProviderType = VALID_NEWS_PROVIDERS.has(
+    newsProviderRaw as NewsProviderType,
+  )
     ? (newsProviderRaw as NewsProviderType)
     : "coingecko";
 

package/src/db/repositories.ts

@@ -325,7 +325,18 @@ export function insertScanHistory(db: DatabaseSync, entry: ScanHistoryEntry): vo
 export function updateScanHistory(
   db: DatabaseSync,
   id: string,
-  patch: Partial<Pick<ScanHistoryEntry, "completed_at" | "status" | "strategies_scanned" | "news_found" | "actions_taken" | "summary" | "detail_json">>,
+  patch: Partial<
+    Pick<
+      ScanHistoryEntry,
+      | "completed_at"
+      | "status"
+      | "strategies_scanned"
+      | "news_found"
+      | "actions_taken"
+      | "summary"
+      | "detail_json"
+    >
+  >,
 ): void {
   try {
     const sets: string[] = [];
@@ -350,7 +361,9 @@ export function queryScanHistory(
   const { limit = 20, offset = 0, scanType } = opts;
   if (scanType) {
     return db
-      .prepare(`SELECT * FROM scan_history WHERE scan_type = ? ORDER BY started_at DESC LIMIT ? OFFSET ?`)
+      .prepare(
+        `SELECT * FROM scan_history WHERE scan_type = ? ORDER BY started_at DESC LIMIT ? OFFSET ?`,
+      )
       .all(scanType, limit, offset) as ScanHistoryEntry[];
   }
   return db
@@ -403,7 +416,9 @@ export function queryPriceAlerts(
   const { limit = 50, offset = 0, strategyId } = opts;
   if (strategyId) {
     return db
-      .prepare(`SELECT * FROM price_alerts WHERE strategy_id = ? ORDER BY created_at DESC LIMIT ? OFFSET ?`)
+      .prepare(
+        `SELECT * FROM price_alerts WHERE strategy_id = ? ORDER BY created_at DESC LIMIT ? OFFSET ?`,
+      )
       .all(strategyId, limit, offset) as PriceAlertEntry[];
   }
   return db

package/src/scheduler/news-provider.ts

@@ -1,3 +1,4 @@
+import { guessMarket } from "../datahub/client.js";
 /**
  * External news providers for strategy symbol monitoring.
  *
@@ -10,7 +11,6 @@
  */
 import type { MarketType } from "../types.js";
 import type { NewsItem, NewsProvider, SymbolNewsResult } from "./types.js";
-import { guessMarket } from "../datahub/client.js";
 
 // ── CoinGecko Trending (no key required) ─────────────────────────────────
 

package/src/scheduler/scan-report-builder.ts

@@ -101,7 +101,9 @@ export function formatScanReportMarkdown(report: ScanReport): string {
     for (const sd of entry.symbolData) {
       if (sd.currentPrice != null) {
         const change =
-          sd.priceChange24h != null ? ` (24h ${sd.priceChange24h >= 0 ? "+" : ""}${sd.priceChange24h.toFixed(1)}%)` : "";
+          sd.priceChange24h != null
+            ? ` (24h ${sd.priceChange24h >= 0 ? "+" : ""}${sd.priceChange24h.toFixed(1)}%)`
+            : "";
         lines.push(`- ${sd.symbol} 当前价格: $${sd.currentPrice.toFixed(2)}${change}`);
       }
 
@@ -127,7 +129,9 @@ export function formatScanReportMarkdown(report: ScanReport): string {
   if (strategiesWithNews.length > 0) {
     lines.push("### 需要关注的策略");
     for (const e of strategiesWithNews) {
-      lines.push(`- ${e.strategyName}: ${e.significantNewsCount} 条相关新闻，建议分析影响并考虑是否需要优化`);
+      lines.push(
+        `- ${e.strategyName}: ${e.significantNewsCount} 条相关新闻，建议分析影响并考虑是否需要优化`,
+      );
     }
   } else {
     lines.push("### 汇总");

package/src/scheduler/tools.ts

@@ -6,6 +6,7 @@ import { randomUUID } from "node:crypto";
 import type { DatabaseSync } from "node:sqlite";
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
+import { DataHubClient } from "../datahub/client.js";
 import {
   insertScanHistory,
   queryBacktestResults,
@@ -13,7 +14,6 @@ import {
   queryStrategies,
   updateScanHistory,
 } from "../db/repositories.js";
-import { DataHubClient } from "../datahub/client.js";
 import { withLogging } from "../middleware/with-logging.js";
 import type { UnifiedPluginConfig } from "../types.js";
 import type { AggregatedNewsProvider } from "./news-provider.js";
@@ -200,56 +200,61 @@ export function registerSchedulerTools(
       parameters: Type.Object({
         scanType: Type.Optional(
           Type.String({
-            description:
-              "Filter by type: daily_scan, price_monitor, weekly_report, monthly_report",
+            description: "Filter by type: daily_scan, price_monitor, weekly_report, monthly_report",
           }),
         ),
         limit: Type.Optional(Type.Number({ description: "Max results (default 10)" })),
       }),
-      execute: withLogging(getDb, "strategy_scan_history", "scheduler", async (_toolCallId, params) => {
-        try {
-          const db = getDb();
-          const entries = queryScanHistory(db, {
-            scanType: params.scanType ? String(params.scanType) : undefined,
-            limit: Number(params.limit) || 10,
-          });
+      execute: withLogging(
+        getDb,
+        "strategy_scan_history",
+        "scheduler",
+        async (_toolCallId, params) => {
+          try {
+            const db = getDb();
+            const entries = queryScanHistory(db, {
+              scanType: params.scanType ? String(params.scanType) : undefined,
+              limit: Number(params.limit) || 10,
+            });
 
-          if (entries.length === 0) {
-            return {
-              content: [
-                {
-                  type: "text" as const,
-                  text: "暂无扫描记录。调用 strategy_daily_scan 执行首次扫描。",
-                },
-              ],
-              details: { success: true, entries: [] },
-            };
-          }
+            if (entries.length === 0) {
+              return {
+                content: [
+                  {
+                    type: "text" as const,
+                    text: "暂无扫描记录。调用 strategy_daily_scan 执行首次扫描。",
+                  },
+                ],
+                details: { success: true, entries: [] },
+              };
+            }
 
-          const lines: string[] = [];
-          lines.push(`## 扫描历史 (最近 ${entries.length} 条)`);
-          lines.push("");
+            const lines: string[] = [];
+            lines.push(`## 扫描历史 (最近 ${entries.length} 条)`);
+            lines.push("");
 
-          for (const e of entries) {
-            const date = e.started_at.slice(0, 16).replace("T", " ");
-            const status = e.status === "completed" ? "OK" : e.status === "failed" ? "FAIL" : "...";
-            lines.push(
-              `- [${status}] ${date} | ${e.scan_type} | 策略: ${e.strategies_scanned} | 新闻: ${e.news_found}`,
-            );
-            if (e.summary) lines.push(`  ${e.summary}`);
-          }
+            for (const e of entries) {
+              const date = e.started_at.slice(0, 16).replace("T", " ");
+              const status =
+                e.status === "completed" ? "OK" : e.status === "failed" ? "FAIL" : "...";
+              lines.push(
+                `- [${status}] ${date} | ${e.scan_type} | 策略: ${e.strategies_scanned} | 新闻: ${e.news_found}`,
+              );
+              if (e.summary) lines.push(`  ${e.summary}`);
+            }
 
-          return {
-            content: [{ type: "text" as const, text: lines.join("\n") }],
-            details: { success: true, entries },
-          };
-        } catch (err) {
-          return json({
-            success: false,
-            error: err instanceof Error ? err.message : String(err),
-          });
-        }
-      }),
+            return {
+              content: [{ type: "text" as const, text: lines.join("\n") }],
+              details: { success: true, entries },
+            };
+          } catch (err) {
+            return json({
+              success: false,
+              error: err instanceof Error ? err.message : String(err),
+            });
+          }
+        },
+      ),
     },
     { names: ["strategy_scan_history"] },
   );

package/src/strategy/tools.ts

@@ -204,122 +204,131 @@ export function registerStrategyTools(
           Type.String({ description: "Backtest task ID from skill_publish response" }),
         ),
       }),
-      execute: withLogging(getDb, "skill_publish_verify", "strategy", async (_toolCallId, params) => {
-        try {
-          const submissionId = String(params.submissionId ?? "").trim() || undefined;
-          const backtestTaskId = String(params.backtestTaskId ?? "").trim() || undefined;
+      execute: withLogging(
+        getDb,
+        "skill_publish_verify",
+        "strategy",
+        async (_toolCallId, params) => {
+          try {
+            const submissionId = String(params.submissionId ?? "").trim() || undefined;
+            const backtestTaskId = String(params.backtestTaskId ?? "").trim() || undefined;
 
-          if (!submissionId && !backtestTaskId) {
-            return json({
-              success: false,
-              error: "Either submissionId or backtestTaskId is required",
-            });
-          }
+            if (!submissionId && !backtestTaskId) {
+              return json({
+                success: false,
+                error: "Either submissionId or backtestTaskId is required",
+              });
+            }
 
-          if (!config.apiKey) {
-            return json({
-              success: false,
-              error: NO_API_KEY,
-            });
-          }
+            if (!config.apiKey) {
+              return json({
+                success: false,
+                error: NO_API_KEY,
+              });
+            }
 
-          const searchParams: Record<string, string> = {};
-          if (submissionId) searchParams.submissionId = submissionId;
-          if (backtestTaskId) searchParams.backtestTaskId = backtestTaskId;
+            const searchParams: Record<string, string> = {};
+            if (submissionId) searchParams.submissionId = submissionId;
+            if (backtestTaskId) searchParams.backtestTaskId = backtestTaskId;
 
-          const { status, data } = await hubApiRequest(config, "GET", "/skill/publish/verify", {
-            searchParams,
-          });
+            const { status, data } = await hubApiRequest(config, "GET", "/skill/publish/verify", {
+              searchParams,
+            });
 
-          if (status >= 200 && status < 300) {
-            const resp = data as Record<string, unknown>;
-
-            // Update backtest result metrics and strategy level
-            const verifyStrategyId = resp.entryId as string | undefined;
-            if (resp.backtestStatus === "completed" && backtestTaskId) {
-              const report = resp.backtestReport as Record<string, unknown> | undefined;
-              const perf = report?.performance as Record<string, unknown> | undefined;
-              updateBacktestResult(getDb(), backtestTaskId, {
-                status: "completed",
-                total_return: typeof perf?.totalReturn === "number" ? perf.totalReturn : undefined,
-                sharpe: typeof perf?.sharpe === "number" ? perf.sharpe : undefined,
-                sortino: typeof perf?.sortino === "number" ? perf.sortino : undefined,
-                max_drawdown: typeof perf?.maxDrawdown === "number" ? perf.maxDrawdown : undefined,
-                win_rate: typeof perf?.winRate === "number" ? perf.winRate : undefined,
-                profit_factor:
-                  typeof perf?.profitFactor === "number" ? perf.profitFactor : undefined,
-                total_trades: typeof perf?.totalTrades === "number" ? perf.totalTrades : undefined,
-                final_equity: typeof perf?.finalEquity === "number" ? perf.finalEquity : undefined,
-                equity_curve: Array.isArray(report?.equity_curve)
-                  ? JSON.stringify(report.equity_curve)
-                  : undefined,
-                trade_journal: Array.isArray(report?.trade_journal)
-                  ? JSON.stringify(report.trade_journal)
-                  : undefined,
-                monthly_returns:
-                  report?.monthly_returns && typeof report.monthly_returns === "object"
-                    ? JSON.stringify(report.monthly_returns)
+            if (status >= 200 && status < 300) {
+              const resp = data as Record<string, unknown>;
+
+              // Update backtest result metrics and strategy level
+              const verifyStrategyId = resp.entryId as string | undefined;
+              if (resp.backtestStatus === "completed" && backtestTaskId) {
+                const report = resp.backtestReport as Record<string, unknown> | undefined;
+                const perf = report?.performance as Record<string, unknown> | undefined;
+                updateBacktestResult(getDb(), backtestTaskId, {
+                  status: "completed",
+                  total_return:
+                    typeof perf?.totalReturn === "number" ? perf.totalReturn : undefined,
+                  sharpe: typeof perf?.sharpe === "number" ? perf.sharpe : undefined,
+                  sortino: typeof perf?.sortino === "number" ? perf.sortino : undefined,
+                  max_drawdown:
+                    typeof perf?.maxDrawdown === "number" ? perf.maxDrawdown : undefined,
+                  win_rate: typeof perf?.winRate === "number" ? perf.winRate : undefined,
+                  profit_factor:
+                    typeof perf?.profitFactor === "number" ? perf.profitFactor : undefined,
+                  total_trades:
+                    typeof perf?.totalTrades === "number" ? perf.totalTrades : undefined,
+                  final_equity:
+                    typeof perf?.finalEquity === "number" ? perf.finalEquity : undefined,
+                  equity_curve: Array.isArray(report?.equity_curve)
+                    ? JSON.stringify(report.equity_curve)
                     : undefined,
-                tearsheet_html:
-                  typeof report?.tearsheet_html === "string" ? report.tearsheet_html : undefined,
-                completed_at: new Date().toISOString(),
-              });
-              // Backtest completed → strategy stays at L1
-              if (verifyStrategyId) updateStrategyLevel(getDb(), verifyStrategyId, "L1");
-            } else if (resp.backtestStatus === "failed" && backtestTaskId) {
-              updateBacktestResult(getDb(), backtestTaskId, {
-                status: "failed",
-                completed_at: new Date().toISOString(),
-              });
-              // Backtest failed → revert to L0
-              if (verifyStrategyId) updateStrategyLevel(getDb(), verifyStrategyId, "L0");
-            }
-
-            const lines: string[] = [];
-            lines.push("发布验证结果：");
-            lines.push(`- Slug: ${resp.slug ?? "(未知)"}`);
-            lines.push(`- Version: ${resp.version ?? "(未知)"}`);
-            lines.push(`- Backtest Status: ${resp.backtestStatus ?? "(未知)"}`);
+                  trade_journal: Array.isArray(report?.trade_journal)
+                    ? JSON.stringify(report.trade_journal)
+                    : undefined,
+                  monthly_returns:
+                    report?.monthly_returns && typeof report.monthly_returns === "object"
+                      ? JSON.stringify(report.monthly_returns)
+                      : undefined,
+                  tearsheet_html:
+                    typeof report?.tearsheet_html === "string" ? report.tearsheet_html : undefined,
+                  completed_at: new Date().toISOString(),
+                });
+                // Backtest completed → strategy stays at L1
+                if (verifyStrategyId) updateStrategyLevel(getDb(), verifyStrategyId, "L1");
+              } else if (resp.backtestStatus === "failed" && backtestTaskId) {
+                updateBacktestResult(getDb(), backtestTaskId, {
+                  status: "failed",
+                  completed_at: new Date().toISOString(),
+                });
+                // Backtest failed → revert to L0
+                if (verifyStrategyId) updateStrategyLevel(getDb(), verifyStrategyId, "L0");
+              }
 
-            if (resp.backtestStatus === "completed" && resp.backtestReport) {
-              const perf = (resp.backtestReport as Record<string, unknown>).performance as
-                | Record<string, unknown>
-                | undefined;
-              if (perf) {
-                lines.push("");
-                lines.push("回测报告摘要：");
-                if (typeof perf.totalReturn === "number")
-                  lines.push(`- 总收益率: ${(perf.totalReturn * 100).toFixed(2)}%`);
-                if (typeof perf.sharpe === "number")
-                  lines.push(`- 夏普比率: ${perf.sharpe.toFixed(3)}`);
-                if (typeof perf.maxDrawdown === "number")
-                  lines.push(`- 最大回撤: ${(perf.maxDrawdown * 100).toFixed(2)}%`);
-                if (typeof perf.winRate === "number")
-                  lines.push(`- 胜率: ${(perf.winRate * 100).toFixed(1)}%`);
+              const lines: string[] = [];
+              lines.push("发布验证结果：");
+              lines.push(`- Slug: ${resp.slug ?? "(未知)"}`);
+              lines.push(`- Version: ${resp.version ?? "(未知)"}`);
+              lines.push(`- Backtest Status: ${resp.backtestStatus ?? "(未知)"}`);
+
+              if (resp.backtestStatus === "completed" && resp.backtestReport) {
+                const perf = (resp.backtestReport as Record<string, unknown>).performance as
+                  | Record<string, unknown>
+                  | undefined;
+                if (perf) {
+                  lines.push("");
+                  lines.push("回测报告摘要：");
+                  if (typeof perf.totalReturn === "number")
+                    lines.push(`- 总收益率: ${(perf.totalReturn * 100).toFixed(2)}%`);
+                  if (typeof perf.sharpe === "number")
+                    lines.push(`- 夏普比率: ${perf.sharpe.toFixed(3)}`);
+                  if (typeof perf.maxDrawdown === "number")
+                    lines.push(`- 最大回撤: ${(perf.maxDrawdown * 100).toFixed(2)}%`);
+                  if (typeof perf.winRate === "number")
+                    lines.push(`- 胜率: ${(perf.winRate * 100).toFixed(1)}%`);
+                }
               }
+
+              return {
+                content: [{ type: "text" as const, text: lines.join("\n") }],
+                details: { success: true, ...resp },
+              };
             }
 
-            return {
-              content: [{ type: "text" as const, text: lines.join("\n") }],
-              details: { success: true, ...resp },
-            };
+            return json({
+              success: false,
+              status,
+              error:
+                (data as { code?: string; message?: string })?.message ??
+                (data as { detail?: string })?.detail ??
+                data,
+            });
+          } catch (err) {
+            return json({
+              success: false,
+              error: err instanceof Error ? err.message : String(err),
+            });
           }
-
-          return json({
-            success: false,
-            status,
-            error:
-              (data as { code?: string; message?: string })?.message ??
-              (data as { detail?: string })?.detail ??
-              data,
-          });
-        } catch (err) {
-          return json({
-            success: false,
-            error: err instanceof Error ? err.message : String(err),
-          });
-        }
-      }),
+        },
+      ),
     },
     { names: ["skill_publish_verify"] },
   );