@openfinclaw/openfinclaw-strategy 2026.3.25 → 2026.3.27

package/index.ts

@@ -1,16 +1,20 @@
+import type { Command } from "commander";
 /**
  * OpenFinClaw — Unified financial tools plugin.
  * Features:
  * - Strategy tools: publish, validate, fork, leaderboard
  * - Market data tools: price, K-line, crypto data, compare, search
+ * - SQLite persistence: all tool executions logged; domain tables for strategies and backtests
+ * - Dashboard: embedded HTTP server at http://127.0.0.1:<httpPort> (default 18792)
  * Supports FEP v2.0 protocol for strategy packages.
  */
-import type { OpenClawPluginApi } from "openfinclaw/plugin-sdk";
-import type { Command } from "commander";
-import { registerDatahubTools } from "./src/datahub/tools.js";
-import { registerStrategyTools } from "./src/strategy/tools.js";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 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 { startHttpServer } from "./src/http/server.js";
+import { registerStrategyTools } from "./src/strategy/tools.js";
 
 const openfinclawPlugin = {
   id: "openfinclaw",
@@ -22,11 +26,14 @@ 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);
+    registerDatahubTools(api, config, db);
 
     // Register strategy tools (skill_publish, skill_validate, skill_fork, skill_leaderboard, etc.)
-    registerStrategyTools(api, config);
+    registerStrategyTools(api, config, db);
 
     // Register CLI commands
     api.registerCli(
@@ -38,7 +45,10 @@ const openfinclawPlugin = {
         }),
       { commands: ["strategy"] },
     );
+
+    // Start embedded dashboard HTTP server (loopback only, configurable port)
+    startHttpServer(db, config.httpPort, api.logger);
   },
 };
 
-export default openfinclawPlugin;
+export default openfinclawPlugin;

package/openclaw.plugin.json

@@ -3,7 +3,7 @@
   "name": "OpenFinClaw",
   "description": "Unified financial tools: market data (price/K-line/crypto/compare/search), strategy publishing, fork, and validation. Single API key for Hub and DataHub.",
   "kind": "financial",
-  "version": "0.1.0",
+  "version": "2026.3.25",
   "skills": ["./skills"],
   "configSchema": {
     "type": "object",
@@ -30,6 +30,13 @@
         "minimum": 5000,
         "maximum": 300000,
         "description": "HTTP request timeout in milliseconds"
+      },
+      "httpPort": {
+        "type": "number",
+        "default": 18792,
+        "minimum": 1024,
+        "maximum": 65535,
+        "description": "Dashboard HTTP server port (loopback only)"
       }
     }
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfinclaw/openfinclaw-strategy",
-  "version": "2026.3.25",
+  "version": "2026.3.27",
   "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",
@@ -34,7 +34,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@sinclair/typebox": "^0.34.0",
+    "@sinclair/typebox": "0.34.48",
     "adm-zip": "^0.5.16"
   },
   "devDependencies": {

package/skills/price-check/SKILL.md

@@ -12,14 +12,15 @@ metadata: { "openclaw": { "emoji": "💰", "requires": { "extensions": ["openfin
 
 ### fin_price — 查当前价
 
-| Parameter | Type   | Required | Example    |
-| --------- | ------ | -------- | ---------- |
-| symbol    | string | Yes      | BTC/USDT   |
-| market    | string | No       | crypto     |
+| Parameter | Type   | Required | Example  |
+| --------- | ------ | -------- | -------- |
+| symbol    | string | Yes      | BTC/USDT |
+| market    | string | No       | crypto   |
 
 Market 自动检测：含 `/` → crypto；`.SH/.SZ/.HK` 或纯字母 → equity。
 
 **返回字段：**
+
 - `price`: 最新价格
 - `volume24h`: 24小时成交量（加密货币）
 - `timestamp`: 数据时间
@@ -33,6 +34,7 @@ Market 自动检测：含 `/` → crypto；`.SH/.SZ/.HK` 或纯字母 → equity
 | limit     | number | No       | 30      | 10        |
 
 **返回字段：**
+
 - `bars[]`: K线数组，包含 date, open, high, low, close, volume
 
 ### fin_compare — 多资产对比
@@ -42,50 +44,52 @@ Market 自动检测：含 `/` → crypto；`.SH/.SZ/.HK` 或纯字母 → equity
 | symbols   | string | Yes      | BTC/USDT,ETH/USDT,600519.SH |
 
 **返回字段：**
+
 - `comparison[]`: 每个资产的 price, weekChange（周涨跌幅）
 
 ### fin_slim_search — 搜索代码
 
 当用户只说公司/币种名称，不确定 symbol 时使用：
 
-| Parameter | Type   | Required | Example   |
-| --------- | ------ | -------- | --------- |
-| query     | string | Yes      | 茅台      |
-| market    | string | No       | equity    |
+| Parameter | Type   | Required | Example |
+| --------- | ------ | -------- | ------- |
+| query     | string | Yes      | 茅台    |
+| market    | string | No       | equity  |
 
 **触发场景：**
+
 - 用户说 "茅台多少钱" → 先搜索 `query="茅台"` → 找到 `600519.SH` → 再查价格
 - 用户说 "特斯拉股价" → 先搜索 `query="特斯拉"` → 找到 `TSLA` → 再查价格
 
 ### fin_crypto — 加密市场数据
 
-| Parameter | Type   | Required | Example                      |
-| --------- | ------ | -------- | ---------------------------- |
-| endpoint  | string | Yes      | market/funding_rate          |
-| symbol    | string | No       | BTC/USDT:USDT                |
-| limit     | number | No       | 20                           |
+| Parameter | Type   | Required | Example             |
+| --------- | ------ | -------- | ------------------- |
+| endpoint  | string | Yes      | market/funding_rate |
+| symbol    | string | No       | BTC/USDT:USDT       |
+| limit     | number | No       | 20                  |
 
 **常用端点：**
 
-| 端点                    | 用途                 |
-| ----------------------- | -------------------- |
-| `market/ticker`         | 单币种行情           |
-| `market/tickers`        | 多币种行情           |
-| `market/funding_rate`   | 资金费率             |
-| `coin/market`           | CoinGecko 币种排行   |
-| `coin/trending`         | 热门币种             |
-| `defi/protocols`        | DeFi 协议 TVL 排行   |
-| `defi/yields`           | DeFi 收益率          |
+| 端点                  | 用途               |
+| --------------------- | ------------------ |
+| `market/ticker`       | 单币种行情         |
+| `market/tickers`      | 多币种行情         |
+| `market/funding_rate` | 资金费率           |
+| `coin/market`         | CoinGecko 币种排行 |
+| `coin/trending`       | 热门币种           |
+| `defi/protocols`      | DeFi 协议 TVL 排行 |
+| `defi/yields`         | DeFi 收益率        |
 
 ## Symbol 格式速查
 
-| 格式               | 市场   | 示例                     |
-| ------------------ | ------ | ------------------------ |
-| `XXX/YYY`          | Crypto | `BTC/USDT`, `ETH/BTC`    |
-| `6位数.SZ/SH`      | A股    | `000001.SZ`, `600519.SH` |
-| `5位数.HK`         | 港股   | `00700.HK`, `00941.HK`   |
-| `1-5大写字母`      | 美股   | `AAPL`, `NVDA`, `TSLA`   |
-| `000xxx.SH`        | 指数   | `000300.SH` (沪深300)    |
+| 格式          | 市场   | 示例                     |
+| ------------- | ------ | ------------------------ |
+| `XXX/YYY`     | Crypto | `BTC/USDT`, `ETH/BTC`    |
+| `6位数.SZ/SH` | A股    | `000001.SZ`, `600519.SH` |
+| `5位数.HK`    | 港股   | `00700.HK`, `00941.HK`   |
+| `1-5大写字母` | 美股   | `AAPL`, `NVDA`, `TSLA`   |
+| `000xxx.SH`   | 指数   | `000300.SH` (沪深300)    |
 
 ## Response Guidelines
 
@@ -101,7 +105,8 @@ Market 自动检测：含 `/` → crypto；`.SH/.SZ/.HK` 或纯字母 → equity
 **流程:** `fin_price(symbol="BTC/USDT")` → 返回 $69,552
 
 **用户:** 茅台现在什么价？
-**流程:** 
+**流程:**
+
 1. `fin_slim_search(query="茅台")` → 找到 `600519.SH`
 2. `fin_price(symbol="600519.SH")` → 返回 ¥1,856.00
 
@@ -115,4 +120,4 @@ Market 自动检测：含 `/` → crypto；`.SH/.SZ/.HK` 或纯字母 → equity
 **流程:** `fin_crypto(endpoint="market/funding_rate", symbol="BTC/USDT:USDT")` → 费率数据
 
 **用户:** 现在 DeFi 哪个协议 TVL 最高？
-**流程:** `fin_crypto(endpoint="defi/protocols", limit=5)` → TVL 排行
+**流程:** `fin_crypto(endpoint="defi/protocols", limit=5)` → TVL 排行

package/src/config.ts

@@ -48,10 +48,18 @@ export function resolvePluginConfig(api: OpenClawPluginApi): UnifiedPluginConfig
       ? Math.floor(Number(timeoutRaw))
       : DEFAULT_TIMEOUT_MS;
 
+  const httpPortRaw = raw?.httpPort ?? readEnv(["OPENFINCLAW_HTTP_PORT"]);
+  const httpPortNum = Number(httpPortRaw);
+  const httpPort =
+    Number.isFinite(httpPortNum) && httpPortNum >= 1024 && httpPortNum <= 65535
+      ? Math.floor(httpPortNum)
+      : 18792;
+
   return {
     apiKey: apiKey && apiKey.length > 0 ? apiKey : undefined,
     hubApiUrl: hubApiUrl.replace(/\/$/, ""),
     datahubGatewayUrl: datahubGatewayUrl.replace(/\/+$/, ""),
     requestTimeoutMs,
+    httpPort,
   };
 }

package/src/datahub/tools.ts

@@ -1,11 +1,13 @@
+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 } from "@sinclair/typebox";
-import type { OpenClawPluginApi } from "openfinclaw/plugin-sdk";
-import { DataHubClient, guessMarket } from "./client.js";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { withLogging } from "../middleware/with-logging.js";
 import type { UnifiedPluginConfig, MarketType } from "../types.js";
+import { DataHubClient, guessMarket } from "./client.js";
 
 /** JSON tool result helper. */
 function json(payload: unknown) {
@@ -24,14 +26,17 @@ function pick(params: Record<string, unknown>, ...keys: string[]): Record<string
   return out;
 }
 
-const NO_KEY = "API key not configured. Set apiKey in plugin config or OPENFINCLAW_API_KEY env var.";
+const NO_KEY =
+  "API key not configured. Set apiKey in plugin config or OPENFINCLAW_API_KEY env var.";
 
 /**
  * Register DataHub market data tools.
+ * @param db - SQLite database for activity logging.
  */
 export function registerDatahubTools(
   api: OpenClawPluginApi,
   config: UnifiedPluginConfig,
+  db: DatabaseSync,
 ): void {
   const datahubClient = config.apiKey
     ? new DataHubClient(config.datahubGatewayUrl, config.apiKey, config.requestTimeoutMs)
@@ -86,7 +91,7 @@ export function registerDatahubTools(
           }),
         ),
       }),
-      async execute(_id: string, params: Record<string, unknown>) {
+      execute: withLogging(db, "fin_price", "market-data", async (_id, params) => {
         try {
           if (!datahubClient) return json({ error: NO_KEY });
           const symbol = String(params.symbol);
@@ -102,7 +107,7 @@ export function registerDatahubTools(
         } catch (err) {
           return json({ error: err instanceof Error ? err.message : String(err) });
         }
-      },
+      }),
     },
     { names: ["fin_price"] },
   );
@@ -130,7 +135,7 @@ export function registerDatahubTools(
           Type.Number({ description: "Number of bars to return (default: 30)" }),
         ),
       }),
-      async execute(_id: string, params: Record<string, unknown>) {
+      execute: withLogging(db, "fin_kline", "market-data", async (_id, params) => {
         try {
           if (!datahubClient) return json({ error: NO_KEY });
           const symbol = String(params.symbol);
@@ -153,7 +158,7 @@ export function registerDatahubTools(
         } catch (err) {
           return json({ error: err instanceof Error ? err.message : String(err) });
         }
-      },
+      }),
     },
     { names: ["fin_kline"] },
   );
@@ -204,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)" })),
       }),
-      async execute(_id: string, params: Record<string, unknown>) {
+      execute: withLogging(db, "fin_crypto", "market-data", async (_id, params) => {
         try {
           if (!datahubClient) return json({ error: NO_KEY });
           const endpoint = String(params.endpoint ?? "coin/market");
@@ -233,7 +238,7 @@ export function registerDatahubTools(
         } catch (err) {
           return json({ error: err instanceof Error ? err.message : String(err) });
         }
-      },
+      }),
     },
     { names: ["fin_crypto"] },
   );
@@ -251,7 +256,7 @@ export function registerDatahubTools(
           description: "Comma-separated symbols (2-5). Example: BTC/USDT,ETH/USDT,600519.SH",
         }),
       }),
-      async execute(_id: string, params: Record<string, unknown>) {
+      execute: withLogging(db, "fin_compare", "market-data", async (_id, params) => {
         try {
           if (!datahubClient) return json({ error: NO_KEY });
           const raw = String(params.symbols);
@@ -289,7 +294,7 @@ export function registerDatahubTools(
         } catch (err) {
           return json({ error: err instanceof Error ? err.message : String(err) });
         }
-      },
+      }),
     },
     { names: ["fin_compare"] },
   );
@@ -312,7 +317,7 @@ export function registerDatahubTools(
           }),
         ),
       }),
-      async execute(_id: string, params: Record<string, unknown>) {
+      execute: withLogging(db, "fin_slim_search", "market-data", async (_id, params) => {
         try {
           if (!datahubClient) return json({ error: NO_KEY });
           const q = String(params.query);
@@ -342,8 +347,8 @@ export function registerDatahubTools(
         } catch (err) {
           return json({ error: err instanceof Error ? err.message : String(err) });
         }
-      },
+      }),
     },
     { names: ["fin_slim_search"] },
   );
-}
+}

package/src/db/db.ts

@@ -0,0 +1,44 @@
+import { mkdirSync } from "node:fs";
+/**
+ * SQLite database singleton for OpenFinClaw plugin.
+ * Database path: ~/.openfinclaw/workspace/openfinclaw-plugin.db
+ */
+import { createRequire } from "node:module";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import type { 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);
+
+let _db: DatabaseSync | null = null;
+
+/** Resolve the database file path under ~/.openfinclaw/workspace/. */
+function resolveDbPath(): string {
+  const base = join(homedir(), ".openfinclaw", "workspace");
+  mkdirSync(base, { recursive: true });
+  return join(base, "openfinclaw-plugin.db");
+}
+
+/**
+ * Get (or lazily initialise) the SQLite database singleton.
+ * Calls ensureSchema on first access to create missing tables.
+ */
+export function getDb(): DatabaseSync {
+  if (_db) return _db;
+  // node:sqlite is available in Node 22+
+  const { DatabaseSync } = _require("node:sqlite") as typeof import("node:sqlite");
+  const dbPath = resolveDbPath();
+  _db = new DatabaseSync(dbPath);
+  ensureSchema(_db);
+  return _db;
+}
+
+/** Close the database (used in tests / graceful shutdown). */
+export function closeDb(): void {
+  if (_db) {
+    _db.close();
+    _db = null;
+  }
+}