@openfinclaw/openfinclaw-strategy 2026.4.9 → 2026.4.11

package/README.md

@@ -14,7 +14,7 @@ openclaw plugins install @openfinclaw/openfinclaw-strategy
 ## 快速开始
 
 ```bash
-# 查看策略排行榜（无需 API Key）
+# 查看策略排行榜
 openclaw strategy leaderboard
 
 # 查看收益榜 Top 10
@@ -45,24 +45,24 @@ openclaw strategy show <strategy-id> --remote
 
 ### 策略工具
 
-| 工具名                 | 说明                       | 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` | 查询发布状态和回测报告     | **需要** |
+| 工具名                 | 说明                       | 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` | 查询发布状态和回测报告     | 需要    |
 
 ## CLI 命令
 
 ```bash
-# 查看排行榜（无需 API Key）
+# 查看排行榜
 openclaw strategy leaderboard
 openclaw strategy leaderboard returns --limit 10
 
-# 从 Hub Fork 策略（需要 API Key）
+# 从 Hub Fork 策略
 openclaw strategy fork <strategy-id>
 
 # 列出本地策略

package/SKILL.md

@@ -54,13 +54,13 @@ Agent: 使用 fin_compare 对比收益
 ### 策略管理
 
 ```bash
-# 查看排行榜（无需 API Key）
+# 查看排行榜
 openclaw strategy leaderboard
 
 # 查看收益榜 Top 10
 openclaw strategy leaderboard returns --limit 10
 
-# 查看策略详情（无需 API Key）
+# 查看策略详情
 openclaw strategy show 550e8400-e29b-41d4-a716-446655440001 --remote
 ```
 
@@ -134,10 +134,10 @@ export OPENFINCLAW_API_KEY=YOUR_API_KEY
 
 | 工具名                 | 用途                                   | 需要 API Key |
 | ---------------------- | -------------------------------------- | ------------ |
-| `skill_leaderboard`    | 查询排行榜（综合/收益/风控/人气/新星） | 否           |
-| `skill_get_info`       | 获取 Hub 策略公开详情                  | 否           |
-| `skill_validate`       | 本地验证策略包格式（FEP v2.0）         | 否           |
-| `skill_list_local`     | 列出本地已下载的策略                   | 否           |
+| `skill_leaderboard`    | 查询排行榜（综合/收益/风控/人气/新星） | **是**       |
+| `skill_get_info`       | 获取 Hub 策略公开详情                  | **是**       |
+| `skill_validate`       | 本地验证策略包格式（FEP v2.0）         | **是**       |
+| `skill_list_local`     | 列出本地已下载的策略                   | **是**       |
 | `skill_fork`           | 从 Hub 下载公开策略到本地              | **是**       |
 | `skill_publish`        | 发布策略 ZIP 到 Hub，自动触发回测      | **是**       |
 | `skill_publish_verify` | 查询发布状态和回测报告                 | **是**       |
@@ -172,7 +172,7 @@ export OPENFINCLAW_API_KEY=YOUR_API_KEY
 
 ### strategy leaderboard
 
-查看 Hub 排行榜（无需 API Key）：
+查看 Hub 排行榜：
 
 ```bash
 # 综合榜 Top 20（默认）
@@ -223,7 +223,7 @@ openclaw strategy list
 # 查看本地策略
 openclaw strategy show btc-adaptive-dca-34a5792f
 
-# 从 Hub 获取最新信息（无需 API Key）
+# 从 Hub 获取最新信息
 openclaw strategy show 550e8400-e29b-41d4-a716-446655440001 --remote
 ```
 

package/package.json

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

@@ -50,7 +50,7 @@ export function registerStrategyCli(params: {
   // ── strategy leaderboard ──
   root
     .command("leaderboard [boardType]")
-    .description("Query strategy leaderboard from Hub (no API key required)")
+    .description("Query strategy leaderboard from Hub")
     .option("-l, --limit <number>", "Number of results (max 100)", "20")
     .option("-o, --offset <number>", "Offset for pagination", "0")
     .action(
@@ -344,10 +344,18 @@ function printStrategyInfo(
   console.log("Hub:");
   console.log(`  ID: ${hub.id}`);
   console.log(`  名称: ${hub.name}`);
-  if (hub.version) console.log(`  版本: ${hub.version}`);
-  if (hub.author?.displayName) console.log(`  作者: ${hub.author.displayName}`);
-  if (hub.market) console.log(`  市场: ${hub.market}`);
-  if (hub.description) console.log(`  描述: ${hub.description}`);
+  if (hub.version) {
+    console.log(`  版本: ${hub.version}`);
+  }
+  if (hub.author?.displayName) {
+    console.log(`  作者: ${hub.author.displayName}`);
+  }
+  if (hub.market) {
+    console.log(`  市场: ${hub.market}`);
+  }
+  if (hub.description) {
+    console.log(`  描述: ${hub.description}`);
+  }
 
   if (hub.backtestResult) {
     console.log("");

package/src/scheduler/tools.ts

@@ -23,6 +23,9 @@ import type { AggregatedNewsProvider } from "./news-provider.js";
 import { formatPeriodicReportMarkdown } from "./periodic-report-builder.js";
 import { buildScanReport, formatScanReportMarkdown } from "./scan-report-builder.js";
 
+const NO_API_KEY =
+  "API key not configured. Set apiKey in plugin config or OPENFINCLAW_API_KEY env var.";
+
 /** JSON tool result helper. */
 function json(payload: unknown) {
   return {
@@ -421,6 +424,7 @@ export function registerSchedulerTools(
         "strategy_scan_history",
         "scheduler",
         async (_toolCallId, params) => {
+          if (!config.apiKey) return json({ success: false, error: NO_API_KEY });
           try {
             const db = getDb();
             const entries = queryScanHistory(db, {
@@ -489,6 +493,7 @@ export function registerSchedulerTools(
         "strategy_periodic_report",
         "scheduler",
         async (_toolCallId, params) => {
+          if (!config.apiKey) return json({ success: false, error: NO_API_KEY });
           const period = params.period === "monthly" ? "monthly" : "weekly";
           const scanId = randomUUID();
           const now = new Date();

package/src/strategy/client.ts

@@ -21,7 +21,9 @@ export async function hubApiRequest(
   }
 
   const headers: Record<string, string> = { "Content-Type": "application/json" };
-  if (config.apiKey) headers["Authorization"] = `Bearer ${config.apiKey}`;
+  if (config.apiKey) {
+    headers["Authorization"] = `Bearer ${config.apiKey}`;
+  }
 
   const response = await fetch(url.toString(), {
     method,

package/src/strategy/tools.ts

@@ -346,6 +346,7 @@ export function registerStrategyTools(
         }),
       }),
       execute: withLogging(getDb, "skill_validate", "strategy", async (_toolCallId, params) => {
+        if (!config.apiKey) return json({ success: false, error: NO_API_KEY });
         try {
           const dirPath = String(params.dirPath ?? "").trim();
           if (!dirPath)
@@ -375,7 +376,7 @@ export function registerStrategyTools(
     {
       name: "skill_leaderboard",
       label: "Get Hub leaderboard",
-      description: "Query strategy leaderboard from hub.openfinclaw.ai. No API key required.",
+      description: "Query strategy leaderboard from hub.openfinclaw.ai.",
       parameters: Type.Object({
         boardType: Type.Optional(
           Type.Unsafe<BoardType>({
@@ -390,6 +391,7 @@ export function registerStrategyTools(
         offset: Type.Optional(Type.Number({ description: "Offset for pagination" })),
       }),
       execute: withLogging(getDb, "skill_leaderboard", "strategy", async (_toolCallId, params) => {
+        if (!config.apiKey) return json({ success: false, error: NO_API_KEY });
         try {
           const boardType = (params.boardType as BoardType) || "composite";
           const limit = Math.min(Math.max(Number(params.limit) || 20, 1), 100);
@@ -401,7 +403,7 @@ export function registerStrategyTools(
 
           const response = await fetch(url.toString(), {
             method: "GET",
-            headers: { Accept: "application/json" },
+            headers: { Accept: "application/json", Authorization: `Bearer ${config.apiKey}` },
             signal: AbortSignal.timeout(config.requestTimeoutMs),
           });
 
@@ -573,6 +575,7 @@ export function registerStrategyTools(
       description: "List all strategies downloaded or created locally, organized by date.",
       parameters: Type.Object({}),
       execute: withLogging(getDb, "skill_list_local", "strategy", async () => {
+        if (!config.apiKey) return json({ success: false, error: NO_API_KEY });
         try {
           const strategies = await listLocalStrategies();
 
@@ -622,7 +625,7 @@ export function registerStrategyTools(
       name: "skill_get_info",
       label: "Get strategy info from Hub",
       description:
-        "Fetch detailed information about a strategy from hub.openfinclaw.ai. No API key required.",
+        "Fetch detailed information about a strategy from hub.openfinclaw.ai.",
       parameters: Type.Object({
         strategyId: Type.String({ description: "Strategy ID from Hub (UUID or Hub URL)" }),
       }),
@@ -631,6 +634,7 @@ export function registerStrategyTools(
         "skill_get_info",
         "strategy",
         async (_toolCallId, params) => {
+          if (!config.apiKey) return json({ success: false, error: NO_API_KEY });
           try {
             const strategyId = String(params.strategyId ?? "").trim();
             if (!strategyId) return json({ success: false, error: "strategyId is required" });