@openfinclaw/openfinclaw-strategy 2026.3.14 → 2026.3.26

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",
@@ -49,4 +49,4 @@
       "placeholder": "http://43.134.61.136:9080"
     }
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfinclaw/openfinclaw-strategy",
-  "version": "2026.3.14",
+  "version": "2026.3.26",
   "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/skills/openfinclaw/SKILL.md

@@ -11,6 +11,7 @@ metadata:
 # OpenFinClaw
 
 统一金融工具平台，一个 API Key 即可使用所有功能：
+
 - **行情数据**: 价格查询、K线、加密市场数据、多资产对比、代码搜索
 - **策略工具**: 创建、验证、发布、Fork 策略
 - **统一认证**: 一个 API Key 访问 Hub 和 DataHub
@@ -121,13 +122,13 @@ 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` | 代码/名称搜索               | **是**       |
 
 ### 策略工具
 
@@ -145,14 +146,9 @@ export OPENFINCLAW_API_KEY=YOUR_API_KEY
 
 #### 行情数据 Skills
 
-| Skill                    | 触发场景                           | 说明                     |
-| ------------------------ | ---------------------------------- | ------------------------ |
-| `price-check`            | 快速查价、XX多少钱                 | 最简单的价格查询         |
-| `quick-quote`            | 加密市场概览、Top coins、DeFi TVL  | 市场快照                 |
-| `crypto-stablecoin-flow` | 稳定币资金流、USDT/USDC 分析       | 2-4周领先指标            |
-| `crypto-funding-arb`     | 资金费率套利、Delta中性策略        | 收益计算与风险评估       |
-| `crypto-altseason`       | 山寨季、BTC dominance、轮动时机    | 轮动阶梯与顶部信号       |
-| `cross-asset-lite`       | 多资产对比、BTC vs 黄金、跨市场    | 价格对比与相对强弱       |
+| Skill         | 触发场景           | 说明             |
+| ------------- | ------------------ | ---------------- |
+| `price-check` | 快速查价、XX多少钱 | 最简单的价格查询 |
 
 #### 策略 Skills
 
@@ -251,27 +247,22 @@ openclaw strategy show 550e8400-e29b-41d4-a716-446655440001 --remote
 
 当用户提到以下内容时，应引导阅读对应的 Skill：
 
-| 触发关键词                           | Skill                   | 说明                     |
-| ------------------------------------ | ----------------------- | ------------------------ |
-| XX多少钱、什么价格、查价             | `price-check`           | 最简单的价格查询         |
-| 加密市场、Top coins、DeFi TVL        | `quick-quote`           | 市场快照                 |
-| 稳定币、USDT、资金流                 | `crypto-stablecoin-flow`| 资金流分析               |
-| 资金费率套利、Delta中性              | `crypto-funding-arb`    | 套利分析                 |
-| 山寨季、BTC dominance、轮动          | `crypto-altseason`      | 轮动时机                 |
-| 多资产对比、BTC vs 黄金              | `cross-asset-lite`      | 跨市场对比               |
-| 创建策略、写策略、生成策略包         | `strategy-builder`      | 自然语言 → FEP v2.0      |
-| 发布策略、上传策略、提交策略         | `skill-publish`         | 验证 → 打包 → 发布       |
-| Fork 策略、下载策略、克隆策略        | `strategy-fork`         | 从 Hub Fork 策略         |
-| 策略包格式、FEP 规范、打包回测       | `strategy-pack`         | FEP v2.0 规范详解        |
+| 触发关键词                     | Skill              | 说明                |
+| ------------------------------ | ------------------ | ------------------- |
+| XX多少钱、什么价格、查价       | `price-check`      | 最简单的价格查询    |
+| 创建策略、写策略、生成策略包   | `strategy-builder` | 自然语言 → FEP v2.0 |
+| 发布策略、上传策略、提交策略   | `skill-publish`    | 验证 → 打包 → 发布  |
+| Fork 策略、下载策略、克隆策略  | `strategy-fork`    | 从 Hub Fork 策略    |
+| 策略包格式、FEP 规范、打包回测 | `strategy-pack`    | FEP v2.0 规范详解   |
 
 ## 配置选项
 
-| 配置项              | 环境变量                   | 说明             | 默认值                       |
-| ------------------- | -------------------------- | ---------------- | ---------------------------- |
-| `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`                      |
+| 配置项              | 环境变量              | 说明             | 默认值                       |
+| ------------------- | --------------------- | ---------------- | ---------------------------- |
+| `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`                      |
 
 ## 常见问题
 
@@ -307,4 +298,4 @@ openclaw plugins list | grep openfinclaw
 - **排行榜**: https://hub.openfinclaw.ai/leaderboard
 - **策略发现**: https://hub.openfinclaw.ai/discover
 - **获取 API Key**: https://hub.openfinclaw.ai/dashboard
-- **GitHub 仓库**: https://github.com/cryptoSUN2049/openFinclaw
+- **GitHub 仓库**: https://github.com/cryptoSUN2049/openFinclaw

package/skills/price-check/SKILL.md

@@ -1,8 +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"] } } }
 ---
 
 # Price Check
@@ -20,6 +19,12 @@ metadata:
 
 Market 自动检测：含 `/` → crypto；`.SH/.SZ/.HK` 或纯字母 → equity。
 
+**返回字段：**
+
+- `price`: 最新价格
+- `volume24h`: 24小时成交量（加密货币）
+- `timestamp`: 数据时间
+
 ### fin_kline — 查历史 K 线
 
 | Parameter | Type   | Required | Default | Example   |
@@ -28,13 +33,63 @@ Market 自动检测：含 `/` → crypto；`.SH/.SZ/.HK` 或纯字母 → equity
 | market    | string | No       | auto    | equity    |
 | limit     | number | No       | 30      | 10        |
 
+**返回字段：**
+
+- `bars[]`: K线数组，包含 date, open, high, low, close, volume
+
 ### fin_compare — 多资产对比
 
 | Parameter | Type   | Required | Example                     |
 | --------- | ------ | -------- | --------------------------- |
 | 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  |
+
+**触发场景：**
+
+- 用户说 "茅台多少钱" → 先搜索 `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                  |
+
+**常用端点：**
+
+| 端点                  | 用途               |
+| --------------------- | ------------------ |
+| `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)    |
 
 ## Response Guidelines
 
@@ -42,12 +97,19 @@ Market 自动检测：含 `/` → crypto；`.SH/.SZ/.HK` 或纯字母 → equity
 2. **格式清晰** — 用表格展示，包含：资产名、价格、涨跌幅
 3. **币种标注** — 加密标注 USD，A 股标注 CNY，港股标注 HKD
 4. **时间标注** — 说明数据截至时间
+5. **搜索优先** — 用户只说名称时，先用 fin_slim_search 找 symbol
 
 ## Examples
 
 **用户:** BTC 多少钱？
 **流程:** `fin_price(symbol="BTC/USDT")` → 返回 $69,552
 
+**用户:** 茅台现在什么价？
+**流程:**
+
+1. `fin_slim_search(query="茅台")` → 找到 `600519.SH`
+2. `fin_price(symbol="600519.SH")` → 返回 ¥1,856.00
+
 **用户:** 茅台和腾讯谁贵？
 **流程:** `fin_compare(symbols="600519.SH,00700.HK")` → 对比表格
 
@@ -55,4 +117,7 @@ Market 自动检测：含 `/` → crypto；`.SH/.SZ/.HK` 或纯字母 → equity
 **流程:** `fin_kline(symbol="ETH/USDT", market="crypto", limit=5)` → K 线数据
 
 **用户:** BTC 资金费率现在多少？
-**流程:** `fin_crypto(endpoint="market/funding_rate", symbol="BTC/USDT:USDT")` → 费率数据
+**流程:** `fin_crypto(endpoint="market/funding_rate", symbol="BTC/USDT:USDT")` → 费率数据
+
+**用户:** 现在 DeFi 哪个协议 TVL 最高？
+**流程:** `fin_crypto(endpoint="defi/protocols", limit=5)` → TVL 排行

package/skills/strategy-builder/SKILL.md

@@ -41,18 +41,18 @@ This skill needs **read** (read files) and **exec** (run shell commands). Ensure
 
 ### Strategy Tools (from this plugin)
 
-| Tool                   | Purpose                                    |
-| ---------------------- | ------------------------------------------ |
+| Tool                   | Purpose                                        |
+| ---------------------- | ---------------------------------------------- |
 | `skill_validate`       | Validate strategy package directory (FEP v2.0) |
-| `skill_publish`        | Publish strategy ZIP to Hub                |
-| `skill_publish_verify` | Query publish status and backtest report   |
+| `skill_publish`        | Publish strategy ZIP to Hub                    |
+| `skill_publish_verify` | Query publish status and backtest report       |
 
 ### Market Data Tools (for symbol validation)
 
-| Tool          | Purpose                                    |
-| ------------- | ------------------------------------------ |
-| `fin_price`   | Check current price, validate symbol       |
-| `fin_kline`   | Get historical K-line data                 |
+| Tool        | Purpose                              |
+| ----------- | ------------------------------------ |
+| `fin_price` | Check current price, validate symbol |
+| `fin_kline` | Get historical K-line data           |
 
 ---
 
@@ -131,28 +131,28 @@ classification:
 
 ### Identity Fields (必填)
 
-| Field        | Description                          |
-| ------------ | ------------------------------------ |
-| `id`         | 策略唯一标识（英文 + 连字符）        |
-| `name`       | 策略显示名称                         |
-| `version`    | 语义化版本号（如 `"1.0.0"`）         |
-| `style`      | `trend` | `mean-reversion` | `momentum` | `dca` | `hybrid` |
-| `visibility` | `public` | `private` | `unlisted` |
-| `summary`    | 一句话策略描述                       |
-| `description`| 详细策略说明                         |
-| `license`    | `MIT` | `CC-BY-4.0` | `proprietary` |
-| `tags`       | 标签数组，如 `[dca, btc, crypto]`    |
-| `author`     | 对象，必须包含 `name` 字段           |
-| `changelog`  | 变更日志数组                         |
+| Field         | Description                       |
+| ------------- | --------------------------------- | ---------------- | ------------- | ----- | -------- |
+| `id`          | 策略唯一标识（英文 + 连字符）     |
+| `name`        | 策略显示名称                      |
+| `version`     | 语义化版本号（如 `"1.0.0"`）      |
+| `style`       | `trend`                           | `mean-reversion` | `momentum`    | `dca` | `hybrid` |
+| `visibility`  | `public`                          | `private`        | `unlisted`    |
+| `summary`     | 一句话策略描述                    |
+| `description` | 详细策略说明                      |
+| `license`     | `MIT`                             | `CC-BY-4.0`      | `proprietary` |
+| `tags`        | 标签数组，如 `[dca, btc, crypto]` |
+| `author`      | 对象，必须包含 `name` 字段        |
+| `changelog`   | 变更日志数组                      |
 
 ### Backtest Fields (必填)
 
-| Field                  | Description              |
-| ---------------------- | ------------------------ |
-| `symbol`               | 交易品种（自动推断市场） |
-| `defaultPeriod.startDate` | 回测开始日期          |
-| `defaultPeriod.endDate`   | 回测结束日期          |
-| `initialCapital`       | 初始资金                 |
+| Field                     | Description              |
+| ------------------------- | ------------------------ |
+| `symbol`                  | 交易品种（自动推断市场） |
+| `defaultPeriod.startDate` | 回测开始日期             |
+| `defaultPeriod.endDate`   | 回测结束日期             |
+| `initialCapital`          | 初始资金                 |
 
 ### Symbol 格式
 
@@ -180,7 +180,7 @@ def compute(data, context=None):
     """
     close = data["close"].values
     current_price = float(close[-1])
-    
+
     return {
         "action": "buy",
         "amount": 100.0,
@@ -191,11 +191,11 @@ def compute(data, context=None):
 
 ### 信号返回格式
 
-| action | 必填字段      | 说明           |
-| ------ | ------------- | -------------- |
-| `buy`  | amount, price | 按金额买入     |
-| `sell` | —             | 无参数=全仓卖  |
-| `hold` | —             | 不操作         |
+| action | 必填字段      | 说明          |
+| ------ | ------------- | ------------- |
+| `buy`  | amount, price | 按金额买入    |
+| `sell` | —             | 无参数=全仓卖 |
+| `hold` | —             | 不操作        |
 
 ### Allowed Imports
 
@@ -213,14 +213,14 @@ def compute(data, context=None):
 
 Extract key dimensions:
 
-| Dimension      | Example                    |
-| -------------- | -------------------------- |
-| Asset          | BTC, ETH, AAPL             |
-| Frequency      | daily, weekly              |
-| Core idea      | buy dips, trend follow, DCA|
-| Capital        | $10,000                    |
-| Risk tolerance | 25% max drawdown           |
-| Time horizon   | 2025-01-01 to 2026-01-01   |
+| Dimension      | Example                     |
+| -------------- | --------------------------- |
+| Asset          | BTC, ETH, AAPL              |
+| Frequency      | daily, weekly               |
+| Core idea      | buy dips, trend follow, DCA |
+| Capital        | $10,000                     |
+| Risk tolerance | 25% max drawdown            |
+| Time horizon   | 2025-01-01 to 2026-01-01    |
 
 ### Step 2: Technical Design
 
@@ -277,4 +277,4 @@ Present the package and next steps:
 2. Present technical design and wait for confirmation
 3. Show generated package structure
 4. Run validation and report pass/fail
-5. End with clear next steps (publish, iterate)
+5. End with clear next steps (publish, iterate)

package/skills/strategy-pack/SKILL.md

@@ -276,10 +276,10 @@ def select(universe):
 
 ## 相关 Tools
 
-| Tool                   | 用途                                           |
-| ---------------------- | ---------------------------------------------- |
-| `skill_validate`       | 校验策略包目录格式是否符合 FEP v2.0           |
-| `skill_publish`        | 提交已打包的 ZIP 到 Hub，自动触发回测          |
-| `skill_publish_verify` | 查询发布状态与回测报告                         |
+| Tool                   | 用途                                  |
+| ---------------------- | ------------------------------------- |
+| `skill_validate`       | 校验策略包目录格式是否符合 FEP v2.0   |
+| `skill_publish`        | 提交已打包的 ZIP 到 Hub，自动触发回测 |
+| `skill_publish_verify` | 查询发布状态与回测报告                |
 
 总结：**先按本 skill 生成/补全策略包 → 用 skill_validate 校验 → 通过后再打包并 skill_publish**。

package/src/cli.ts

@@ -2,8 +2,8 @@
  * CLI commands for strategy management.
  */
 import type { Command } from "commander";
-import { forkStrategy, fetchStrategyInfo } from "./fork.js";
-import { listLocalStrategies, findLocalStrategy, removeLocalStrategy } from "./strategy-storage.js";
+import { forkStrategy, fetchStrategyInfo } from "./strategy/fork.js";
+import { listLocalStrategies, findLocalStrategy, removeLocalStrategy } from "./strategy/storage.js";
 import type { UnifiedPluginConfig, LeaderboardResponse, BoardType } from "./types.js";
 
 type Logger = {

package/src/config.ts

@@ -54,4 +54,4 @@ export function resolvePluginConfig(api: OpenClawPluginApi): UnifiedPluginConfig
     datahubGatewayUrl: datahubGatewayUrl.replace(/\/+$/, ""),
     requestTimeoutMs,
   };
-}
+}

package/src/datahub/client.ts

@@ -147,4 +147,4 @@ export function guessMarket(symbol: string): MarketType {
   if (/^\d{5,6}/.test(u)) return "equity";
   if (/^[A-Z]{1,5}$/.test(u)) return "equity";
   return "crypto";
-}
+}