@openfinclaw/openfinclaw-strategy 2026.3.26 → 2026.3.271

package/README.md

@@ -80,7 +80,7 @@ openclaw strategy remove <name-or-id> --force
 从 https://hub.openfinclaw.ai 获取 API Key（以 `fch_` 开头），一个 Key 即可使用所有功能：
 
 ```bash
-openclaw config set plugins.entries.openfinclaw.config.apiKey YOUR_API_KEY
+openclaw config set plugins.entries.openfinclaw-strategy.config.apiKey YOUR_API_KEY
 ```
 
 或使用环境变量：

package/index.test.ts

@@ -1,7 +1,7 @@
 /**
  * Unit tests for openfinclaw plugin: registration, config resolution, and tool execution with mocked HTTP.
  */
-import type { OpenClawPluginApi } from "openfinclaw/plugin-sdk";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import plugin from "./index.js";
 
@@ -32,7 +32,7 @@ function createFakeApi(pluginConfig: Record<string, unknown>): {
 } {
   const tools = new Map<string, Tool>();
   const api = {
-    id: "openfinclaw",
+    id: "openfinclaw-strategy",
     name: "OpenFinClaw",
     source: "test",
     config: {},
@@ -66,7 +66,7 @@ describe("openfinclaw plugin", () => {
   });
 
   it("has correct plugin metadata", () => {
-    expect(plugin.id).toBe("openfinclaw");
+    expect(plugin.id).toBe("openfinclaw-strategy");
     expect(plugin.name).toBe("OpenFinClaw");
   });
 

package/index.ts

@@ -4,16 +4,20 @@ import type { Command } from "commander";
  * 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 "openclaw/plugin-sdk";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
 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",
+  id: "openfinclaw-strategy",
   name: "OpenFinClaw",
   description:
     "Unified financial tools: strategy publishing/fork/validation, market data (price/K-line/crypto/compare/search). Single API key for Hub and DataHub.",
@@ -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(
@@ -35,9 +42,13 @@ const openfinclawPlugin = {
           program,
           config,
           logger: api.logger,
+          db,
         }),
       { commands: ["strategy"] },
     );
+
+    // Start embedded dashboard HTTP server (loopback only, configurable port)
+    startHttpServer(db, config.httpPort, api.logger);
   },
 };
 

package/openclaw.plugin.json

@@ -1,10 +1,10 @@
 {
-  "id": "openfinclaw",
+  "id": "openfinclaw-strategy",
   "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": "2026.3.25",
-  "skills": ["./skills"],
+  "skills": ["."],
   "configSchema": {
     "type": "object",
     "properties": {
@@ -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.26",
+  "version": "2026.3.271",
   "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

@@ -1,7 +1,7 @@
 ---
 name: fin-price-check
 description: "Quick price lookup for any asset — stocks, crypto, indices. Use when user asks '什么价格', 'how much is', 'current price of', or any simple price query. Returns latest price, volume, and date."
-metadata: { "openclaw": { "emoji": "💰", "requires": { "extensions": ["openfinclaw"] } } }
+metadata: { "openclaw": { "emoji": "💰", "requires": { "extensions": ["openfinclaw-strategy"] } } }
 ---
 
 # Price Check

package/skills/skill-publish/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: skill-publish
 description: "Skill Publishing Agent. Use when the user wants to publish a strategy to the server, check publish/backtest status, or view backtest report. Flow: validate → zip → publish → poll verify → get report. Supports FEP v2.0 protocol."
-metadata: { "openclaw": { "requires": { "extensions": ["openfinclaw"] } } }
+metadata: { "openclaw": { "requires": { "extensions": ["openfinclaw-strategy"] } } }
 ---
 
 # Skill Publishing

package/skills/strategy-fork/SKILL.md

@@ -149,7 +149,7 @@ Agent:
 1. **API Key**: Fork 操作需要配置 API Key
 
    ```bash
-   openclaw config set plugins.entries.openfinclaw.config.apiKey YOUR_KEY
+   openclaw config set plugins.entries.openfinclaw-strategy.config.apiKey YOUR_KEY
    ```
 
 2. **同名冲突**: 如果两个策略名称相同，会自动添加短 ID 后缀区分

package/skills/strategy-pack/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: strategy-pack
 description: "Create and validate FEP v2.0 strategy packages. Use when the user wants to create a strategy pack, generate fep.yaml and strategy.py, or prepare a folder for publishing. Always validate with skill_validate before zipping and publishing."
-metadata: { "openclaw": { "requires": { "extensions": ["openfinclaw"] } } }
+metadata: { "openclaw": { "requires": { "extensions": ["openfinclaw-strategy"] } } }
 ---
 
 # 策略包生成与校验 (FEP v2.0)

package/src/cli.ts

@@ -1,7 +1,10 @@
 /**
  * CLI commands for strategy management.
  */
+import { randomUUID } from "node:crypto";
+import type { DatabaseSync } from "node:sqlite";
 import type { Command } from "commander";
+import { insertActivityLog } from "./db/repositories.js";
 import { forkStrategy, fetchStrategyInfo } from "./strategy/fork.js";
 import { listLocalStrategies, findLocalStrategy, removeLocalStrategy } from "./strategy/storage.js";
 import type { UnifiedPluginConfig, LeaderboardResponse, BoardType } from "./types.js";
@@ -12,12 +15,33 @@ type Logger = {
   error: (message: string) => void;
 };
 
+/** Log a CLI command execution to agent_activity_log. */
+function logCli(
+  db: DatabaseSync,
+  action: string,
+  params: Record<string, unknown>,
+  startMs: number,
+  error?: string,
+): void {
+  insertActivityLog(db, {
+    id: randomUUID(),
+    timestamp: new Date().toISOString(),
+    category: "strategy",
+    action: `cli:${action}`,
+    detail: error
+      ? `ERROR (${Date.now() - startMs}ms): ${error}`
+      : `OK (${Date.now() - startMs}ms)`,
+    metadata_json: JSON.stringify({ source: "cli", params }),
+  });
+}
+
 export function registerStrategyCli(params: {
   program: Command;
   config: UnifiedPluginConfig;
   logger: Logger;
+  db: DatabaseSync;
 }) {
-  const { program, config } = params;
+  const { program, config, db } = params;
 
   const root = program
     .command("strategy")
@@ -31,6 +55,7 @@ export function registerStrategyCli(params: {
     .option("-o, --offset <number>", "Offset for pagination", "0")
     .action(
       async (boardType: BoardType = "composite", options: { limit?: string; offset?: string }) => {
+        const startMs = Date.now();
         const limit = Math.min(Math.max(Number(options.limit) || 20, 1), 100);
         const offset = Math.max(Number(options.offset) || 0, 0);
 
@@ -46,6 +71,13 @@ export function registerStrategyCli(params: {
           });
 
           if (!response.ok) {
+            logCli(
+              db,
+              "leaderboard",
+              { boardType, limit, offset },
+              startMs,
+              `HTTP ${response.status}`,
+            );
             console.error(`✗ 请求失败: HTTP ${response.status}`);
             process.exitCode = 1;
             return;
@@ -92,7 +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);
         } catch (err) {
+          logCli(db, "leaderboard", { boardType, limit, offset }, startMs, String(err));
           console.error(`✗ 请求失败: ${err instanceof Error ? err.message : String(err)}`);
           process.exitCode = 1;
         }
@@ -107,6 +141,7 @@ export function registerStrategyCli(params: {
     .option("--date <date>", "Date directory (YYYY-MM-DD, default: today)")
     .option("-y, --yes", "Skip confirmation", false)
     .action(async (strategyId: string, options: { dir?: string; date?: string; yes?: boolean }) => {
+      const startMs = Date.now();
       const result = await forkStrategy(config, strategyId, {
         targetDir: options.dir,
         dateDir: options.date,
@@ -114,6 +149,7 @@ export function registerStrategyCli(params: {
       });
 
       if (result.success) {
+        logCli(db, "fork", { strategyId }, startMs);
         console.log("✓ 策略 Fork 成功！");
         console.log("");
         console.log(`  名称: ${result.sourceName}`);
@@ -124,6 +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");
         console.error(`✗ Fork 失败: ${result.error}`);
         process.exitCode = 1;
       }
@@ -135,6 +172,7 @@ export function registerStrategyCli(params: {
     .description("List all local strategies")
     .option("--json", "Output as JSON", false)
     .action(async (options: { json?: boolean }) => {
+      const startMs = Date.now();
       const strategies = await listLocalStrategies();
 
       if (options.json) {
@@ -164,6 +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);
     });
 
   // ── strategy show ──
@@ -173,9 +212,11 @@ export function registerStrategyCli(params: {
     .option("--remote", "Fetch latest info from Hub", false)
     .option("--json", "Output as JSON", false)
     .action(async (nameOrId: string, options: { remote?: boolean; json?: boolean }) => {
+      const startMs = Date.now();
       const local = await findLocalStrategy(nameOrId);
 
       if (!local && !options.remote) {
+        logCli(db, "show", { nameOrId }, startMs, "not found");
         console.error(`✗ 本地策略未找到: ${nameOrId}`);
         console.error("  使用 --remote 从 Hub 获取信息");
         process.exitCode = 1;
@@ -186,6 +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);
           if (options.json) {
             console.log(JSON.stringify({ local, hub: info }, null, 2));
             return;
@@ -196,6 +238,7 @@ export function registerStrategyCli(params: {
       }
 
       if (local) {
+        logCli(db, "show", { nameOrId }, startMs);
         if (options.json) {
           console.log(JSON.stringify(local, null, 2));
           return;
@@ -204,6 +247,7 @@ export function registerStrategyCli(params: {
         return;
       }
 
+      logCli(db, "show", { nameOrId }, startMs, "not found");
       console.error(`✗ 策略未找到: ${nameOrId}`);
       process.exitCode = 1;
     });
@@ -215,8 +259,10 @@ export function registerStrategyCli(params: {
     .description("Remove a local strategy")
     .option("-f, --force", "Force removal without confirmation", false)
     .action(async (nameOrId: string, options: { force?: boolean }) => {
+      const startMs = Date.now();
       const local = await findLocalStrategy(nameOrId);
       if (!local) {
+        logCli(db, "remove", { nameOrId }, startMs, "not found");
         console.error(`✗ 策略未找到: ${nameOrId}`);
         process.exitCode = 1;
         return;
@@ -232,8 +278,10 @@ export function registerStrategyCli(params: {
 
       const result = await removeLocalStrategy(nameOrId);
       if (result.success) {
+        logCli(db, "remove", { nameOrId }, startMs);
         console.log("✓ 策略已删除");
       } else {
+        logCli(db, "remove", { nameOrId }, startMs, result.error ?? "unknown");
         console.error(`✗ 删除失败: ${result.error}`);
         process.exitCode = 1;
       }

package/src/config.ts

@@ -2,7 +2,7 @@
  * Unified configuration resolver for OpenFinClaw plugin.
  * Supports single API key for both Hub and DataHub services.
  */
-import type { OpenClawPluginApi } from "openfinclaw/plugin-sdk";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
 import type { UnifiedPluginConfig } from "./types.js";
 
 const DEFAULT_HUB_API_URL = "https://hub.openfinclaw.ai";
@@ -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,9 +1,11 @@
+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 type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
+import { withLogging } from "../middleware/with-logging.js";
 import type { UnifiedPluginConfig, MarketType } from "../types.js";
 import { DataHubClient, guessMarket } from "./client.js";
 
@@ -29,8 +31,13 @@ const NO_KEY =
 
 /**
  * Register DataHub market data tools.
+ * @param db - SQLite database for activity logging.
  */
-export function registerDatahubTools(api: OpenClawPluginApi, config: UnifiedPluginConfig): void {
+export function registerDatahubTools(
+  api: OpenClawPluginApi,
+  config: UnifiedPluginConfig,
+  db: DatabaseSync,
+): void {
   const datahubClient = config.apiKey
     ? new DataHubClient(config.datahubGatewayUrl, config.apiKey, config.requestTimeoutMs)
     : null;
@@ -84,7 +91,7 @@ export function registerDatahubTools(api: OpenClawPluginApi, config: UnifiedPlug
           }),
         ),
       }),
-      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);
@@ -100,7 +107,7 @@ export function registerDatahubTools(api: OpenClawPluginApi, config: UnifiedPlug
         } catch (err) {
           return json({ error: err instanceof Error ? err.message : String(err) });
         }
-      },
+      }),
     },
     { names: ["fin_price"] },
   );
@@ -128,7 +135,7 @@ export function registerDatahubTools(api: OpenClawPluginApi, config: UnifiedPlug
           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);
@@ -151,7 +158,7 @@ export function registerDatahubTools(api: OpenClawPluginApi, config: UnifiedPlug
         } catch (err) {
           return json({ error: err instanceof Error ? err.message : String(err) });
         }
-      },
+      }),
     },
     { names: ["fin_kline"] },
   );
@@ -202,7 +209,7 @@ export function registerDatahubTools(api: OpenClawPluginApi, config: UnifiedPlug
         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");
@@ -231,7 +238,7 @@ export function registerDatahubTools(api: OpenClawPluginApi, config: UnifiedPlug
         } catch (err) {
           return json({ error: err instanceof Error ? err.message : String(err) });
         }
-      },
+      }),
     },
     { names: ["fin_crypto"] },
   );
@@ -249,7 +256,7 @@ export function registerDatahubTools(api: OpenClawPluginApi, config: UnifiedPlug
           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);
@@ -287,7 +294,7 @@ export function registerDatahubTools(api: OpenClawPluginApi, config: UnifiedPlug
         } catch (err) {
           return json({ error: err instanceof Error ? err.message : String(err) });
         }
-      },
+      }),
     },
     { names: ["fin_compare"] },
   );
@@ -310,7 +317,7 @@ export function registerDatahubTools(api: OpenClawPluginApi, config: UnifiedPlug
           }),
         ),
       }),
-      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);
@@ -340,7 +347,7 @@ export function registerDatahubTools(api: OpenClawPluginApi, config: UnifiedPlug
         } 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;
+  }
+}