@openfinclaw/openfinclaw-strategy 0.0.11 → 0.1.1

package/openclaw.plugin.json

@@ -1,20 +1,28 @@
 {
   "id": "openfinclaw",
   "name": "OpenFinClaw",
-  "description": "Skill publishing and strategy validation tools. Publish strategy ZIPs to remote server with automatic backtest.",
+  "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",
   "skills": ["./skills"],
   "configSchema": {
     "type": "object",
     "properties": {
-      "skillApiUrl": {
+      "apiKey": {
         "type": "string",
-        "description": "Skill API base URL (e.g. https://hub.openfinclaw.ai). No trailing slash.",
+        "minLength": 1,
+        "description": "API Key for Hub and DataHub (fch_ prefix). Also accepted via OPENFINCLAW_API_KEY env var.",
+        "sensitive": true
+      },
+      "hubApiUrl": {
+        "type": "string",
+        "description": "Hub API URL",
         "default": "https://hub.openfinclaw.ai"
       },
-      "skillApiKey": {
+      "datahubGatewayUrl": {
         "type": "string",
-        "description": "API key for skill server (fch_ prefix, 68 chars). Required for publishing."
+        "description": "DataHub Gateway URL for market data",
+        "default": "http://43.134.61.136:9080"
       },
       "requestTimeoutMs": {
         "type": "number",
@@ -26,10 +34,19 @@
     }
   },
   "uiHints": {
-    "skillApiKey": { "label": "Skill API Key", "sensitive": true },
-    "skillApiUrl": {
-      "label": "Skill Server URL",
+    "apiKey": {
+      "label": "API Key",
+      "help": "统一 API Key（用于 Hub 和 DataHub）。从 hub.openfinclaw.ai 获取。",
+      "sensitive": true,
+      "placeholder": "fch_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+    },
+    "hubApiUrl": {
+      "label": "Hub API URL",
       "placeholder": "https://hub.openfinclaw.ai"
+    },
+    "datahubGatewayUrl": {
+      "label": "DataHub Gateway URL",
+      "placeholder": "http://43.134.61.136:9080"
     }
   }
 }

package/package.json

@@ -1,14 +1,17 @@
 {
   "name": "@openfinclaw/openfinclaw-strategy",
-  "version": "0.0.11",
-  "description": "OpenFinClaw - Financial tools for OpenClaw: strategy builder, remote backtest",
+  "version": "0.1.1",
+  "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",
     "crypto",
     "financial",
+    "ohlcv",
     "openclaw",
     "openfinclaw",
+    "price",
     "strategy",
+    "ticker",
     "trading"
   ],
   "homepage": "https://github.com/cryptoSUN2049/openFinclaw#readme",
@@ -16,7 +19,7 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/cryptoSUN2049/openFinclaw.git",
-    "directory": "extensions/openfinclaw"
+    "directory": "extensions/openfinclaw-strategy"
   },
   "files": [
     "skills",
@@ -37,9 +40,12 @@
   "devDependencies": {
     "@types/adm-zip": "^0.5.8"
   },
+  "peerDependencies": {
+    "openclaw": ">=2026.1.0"
+  },
   "openclaw": {
     "extensions": [
       "./index.ts"
     ]
   }
-}
+}

package/skills/openfinclaw/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: openfinclaw
-description: "FinClaw Commons 入口 - 量化策略开发平台。帮助用户安装插件、了解 Hub 平台、使用策略工具链（创建、验证、发布、Fork）。当用户提到 FinClaw、Hub、策略发布、策略下载、量化策略时触发。"
+description: "OpenFinClaw 入口 - 统一金融工具平台。行情数据（价格/K线/加密市场/多资产对比）、策略工具（创建/验证/发布/Fork）。当用户提到 FinClaw、Hub、策略、行情、价格、K线、加密货币、BTC、ETH、DeFi 时触发。"
 metadata:
   openclaw:
     emoji: "🦈"
@@ -8,9 +8,13 @@ metadata:
       extensions: ["openfinclaw"]
 ---
 
-# FinClaw Commons
+# OpenFinClaw
 
-量化策略开发平台，连接 **hub.openfinclaw.ai** 策略网络。用户可以创建、验证、发布、Fork 策略，参与社区策略进化。
+统一金融工具平台，一个 API Key 即可使用所有功能：
+
+- **行情数据**: 价格查询、K线、加密市场数据、多资产对比、代码搜索
+- **策略工具**: 创建、验证、发布、Fork 策略
+- **统一认证**: 一个 API Key 访问 Hub 和 DataHub
 
 ## 平台简介
 
@@ -21,29 +25,45 @@ metadata:
 - **社区进化**: 其他用户可以 Fork 你的策略进行优化改进
 - **绩效排行**: 查看各市场表现最佳的策略
 
+**DataHub** 提供实时行情数据：
+
+- **多市场覆盖**: 加密货币、A股、港股、美股
+- **丰富数据**: 价格、K线、OHLCV、DeFi TVL、资金费率
+- **数据来源**: CoinGecko、DefiLlama、CCXT、Tushare
+
 核心价值：**不要追逐浪潮，创造浪潮。**
 
 ## 快速开始
 
-安装完成后，你可以立即开始（无需 API Key）：
+### 行情查询（需要 API Key）
+
+```
+用户: BTC 现在多少钱
+Agent: 使用 fin_price 获取实时价格
+
+用户: ETH 最近 7 天走势
+Agent: 使用 fin_kline 获取 K 线数据
+
+用户: DeFi 哪个协议 TVL 最高
+Agent: 使用 fin_crypto 获取 DeFi 排名
+
+用户: BTC 和 ETH 谁涨得多
+Agent: 使用 fin_compare 对比收益
+```
+
+### 策略管理
 
 ```bash
-# 1. 查看排行榜（无需 API Key）
+# 查看排行榜（无需 API Key）
 openclaw strategy leaderboard
 
-# 2. 查看收益榜 Top 10
+# 查看收益榜 Top 10
 openclaw strategy leaderboard returns --limit 10
 
-# 3. 查看策略详情（无需 API Key）
+# 查看策略详情（无需 API Key）
 openclaw strategy show 550e8400-e29b-41d4-a716-446655440001 --remote
 ```
 
-或者直接告诉 Agent 你想做什么：
-
-- "帮我看看排行榜有什么好策略" → Agent 会使用 `skill_leaderboard`
-- "这个策略收益怎么样" → Agent 会使用 `skill_get_info`
-- "帮我 Fork 这个策略" → Agent 会使用 `skill_fork`（需要配置 API Key）
-
 ## 安装指南
 
 ### 前置检查
@@ -58,16 +78,11 @@ openclaw --version
 
 ### 安装 openfinclaw 插件
 
-**OpenClaw (推荐):**
-
 ```bash
 openclaw plugins install @openfinclaw/openfinclaw-strategy
-
 openclaw plugins enable @openfinclaw/openfinclaw-strategy
 ```
 
-安装成功后会显示插件路径，如 `~/.openclaw/extensions/openfinclaw`。
-
 ### 验证安装
 
 ```bash
@@ -80,44 +95,42 @@ openclaw strategy list
 
 ### 配置 API Key
 
-从 https://hub.openfinclaw.ai 获取 API Key（以 `fch_` 开头）：
+从 https://hub.openfinclaw.ai 获取 API Key（以 `fch_` 开头），**一个 Key 即可使用所有功能**：
 
 ```bash
-openclaw config set plugins.entries.openfinclaw.config.skillApiKey YOUR_API_KEY
+openclaw config set plugins.entries.openfinclaw.config.apiKey YOUR_API_KEY
 ```
 
 或使用环境变量：
 
 ```bash
-export SKILL_API_KEY=YOUR_API_KEY
+export OPENFINCLAW_API_KEY=YOUR_API_KEY
 ```
 
 ### ⚠️ API Key 安全提醒
 
-**重要：请勿泄露你的 Hub API Key！**
+**重要：请勿泄露你的 API Key！**
 
-- API Key 以 `fch_` 开头，仅用于 hub.openfinclaw.ai 接口校验
+- API Key 以 `fch_` 开头，用于 Hub 和 DataHub 接口校验
 - **不要**将 API Key 提交到 Git 仓库或公开分享
 - **不要**在公开聊天、截图、代码示例中暴露真实的 API Key
 - 如果怀疑 Key 已泄露，请立即在 Hub 个人设置中重新生成
 
-配置建议：
-
-```bash
-# 推荐：使用环境变量（不会写入配置文件）
-export SKILL_API_KEY=your_api_key_here
-
-# 或使用 OpenClaw 配置（存储在本地配置文件，注意权限）
-openclaw config set plugins.entries.openfinclaw.config.skillApiKey YOUR_API_KEY
-```
-
 ## 功能概览
 
-本插件提供两类能力：
+本插件提供两大类能力：
+
+### 行情数据工具
 
-### Tools（工具）
+| 工具名            | 用途                        | 需要 API Key |
+| ----------------- | --------------------------- | ------------ |
+| `fin_price`       | 价格查询（股票/加密/指数）  | **是**       |
+| `fin_kline`       | K线/OHLCV 数据              | **是**       |
+| `fin_crypto`      | 加密市场数据（21个端点）    | **是**       |
+| `fin_compare`     | 多资产价格对比（2-5个资产） | **是**       |
+| `fin_slim_search` | 代码/名称搜索               | **是**       |
 
-Agent 可直接调用的函数：
+### 策略工具
 
 | 工具名                 | 用途                                   | 需要 API Key |
 | ---------------------- | -------------------------------------- | ------------ |
@@ -131,7 +144,13 @@ Agent 可直接调用的函数：
 
 ### Skills（指导文档）
 
-定义 Agent 在特定场景下的行为规范，位于 `skills/` 目录：
+#### 行情数据 Skills
+
+| Skill         | 触发场景           | 说明             |
+| ------------- | ------------------ | ---------------- |
+| `price-check` | 快速查价、XX多少钱 | 最简单的价格查询 |
+
+#### 策略 Skills
 
 | Skill              | 触发场景                 | 说明                          |
 | ------------------ | ------------------------ | ----------------------------- |
@@ -143,10 +162,10 @@ Agent 可直接调用的函数：
 ### 典型工作流
 
 ```
-创建策略 → 验证 → 发布 → Fork → 优化 → 再次发布
-    ↓         ↓        ↓        ↓
- strategy-builder  skill_publish  skill_fork
-               skill_validate  skill_publish_verify
+行情查询 → 分析决策 → 策略创建 → 验证 → 发布 → Fork → 优化
+    ↓          ↓          ↓         ↓        ↓
+ fin_price  compare  strategy-builder  skill_validate  skill_publish
+ fin_kline                        skill_fork      skill_publish_verify
 ```
 
 ## CLI 命令
@@ -186,12 +205,6 @@ openclaw strategy fork 34a5792f-7d20-4a15-90f3-26f1c54fa4a6
 
 # 使用 Hub URL
 openclaw strategy fork https://hub.openfinclaw.ai/strategy/34a5792f-7d20-4a15-90f3-26f1c54fa4a6
-
-# 指定日期目录
-openclaw strategy fork 34a5792f-7d20-4a15-90f3-26f1c54fa4a6 --date 2026-03-01
-
-# 自定义路径
-openclaw strategy fork 34a5792f-7d20-4a15-90f3-26f1c54fa4a6 --dir ./my-strategies/
 ```
 
 ### strategy list
@@ -200,17 +213,6 @@ openclaw strategy fork 34a5792f-7d20-4a15-90f3-26f1c54fa4a6 --dir ./my-strategie
 
 ```bash
 openclaw strategy list
-openclaw strategy list --json
-```
-
-输出示例：
-
-```
-2026-03-16/
-  btc-adaptive-dca-34a5792f    BTC Adaptive DCA      (forked)
-  my-test-strategy              My Test Strategy      (created)
-2026-03-15/
-  eth-momentum-7e8a9b2c        ETH Momentum          (forked)
 ```
 
 ### strategy show
@@ -225,14 +227,6 @@ openclaw strategy show btc-adaptive-dca-34a5792f
 openclaw strategy show 550e8400-e29b-41d4-a716-446655440001 --remote
 ```
 
-### strategy remove
-
-删除本地策略：
-
-```bash
-openclaw strategy remove btc-adaptive-dca-34a5792f --force
-```
-
 ## 本地存储结构
 
 策略存储在 `~/.openfinclaw/workspace/strategies/` 目录：
@@ -253,26 +247,32 @@ openclaw strategy remove btc-adaptive-dca-34a5792f --force
 
 当用户提到以下内容时，应引导阅读对应的 Skill：
 
-| 触发关键词                     | Skill 目录         | 说明                                    |
-| ------------------------------ | ------------------ | --------------------------------------- |
-| 创建策略、写策略、生成策略包   | `strategy-builder` | 自然语言 → FEP v2.0 策略包              |
-| 发布策略、上传策略、提交策略   | `skill-publish`    | 验证 → 打包 → 发布到 Hub → 查询回测报告 |
-| 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 规范详解   |
 
 ## 配置选项
 
-| 配置项             | 环境变量                   | 说明             | 默认值                       |
-| ------------------ | -------------------------- | ---------------- | ---------------------------- |
-| `skillApiKey`      | `SKILL_API_KEY`            | Hub API Key      | 必填                         |
-| `skillApiUrl`      | `SKILL_API_URL`            | Hub 服务地址     | `https://hub.openfinclaw.ai` |
-| `requestTimeoutMs` | `SKILL_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`                      |
 
 ## 常见问题
 
 ### Q: API Key 在哪里获取？
 
-访问 https://hub.openfinclaw.ai 登录后在个人设置中获取。
+访问 https://hub.openfinclaw.ai 登录后在个人设置中获取。**一个 Key 即可使用所有功能**。
+
+### Q: 行情数据需要额外付费吗？
+
+API Key 已包含行情数据访问权限，无需额外付费。
 
 ### Q: Fork 的策略可以修改吗？
 

package/skills/price-check/SKILL.md

@@ -0,0 +1,118 @@
+---
+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"] } } }
+---
+
+# Price Check
+
+最简单的查价工具 — 一个 symbol 返回最新价格。
+
+## Tools
+
+### fin_price — 查当前价
+
+| Parameter | Type   | Required | Example    |
+| --------- | ------ | -------- | ---------- |
+| symbol    | string | Yes      | BTC/USDT   |
+| market    | string | No       | crypto     |
+
+Market 自动检测：含 `/` → crypto；`.SH/.SZ/.HK` 或纯字母 → equity。
+
+**返回字段：**
+- `price`: 最新价格
+- `volume24h`: 24小时成交量（加密货币）
+- `timestamp`: 数据时间
+
+### fin_kline — 查历史 K 线
+
+| Parameter | Type   | Required | Default | Example   |
+| --------- | ------ | -------- | ------- | --------- |
+| symbol    | string | Yes      | —       | 600519.SH |
+| 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
+
+1. **简洁至上** — 用户问价格，直接给数字，不需要长篇分析
+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")` → 对比表格
+
+**用户:** ETH 最近 5 天走势
+**流程:** `fin_kline(symbol="ETH/USDT", market="crypto", limit=5)` → K 线数据
+
+**用户:** BTC 资金费率现在多少？
+**流程:** `fin_crypto(endpoint="market/funding_rate", symbol="BTC/USDT:USDT")` → 费率数据
+
+**用户:** 现在 DeFi 哪个协议 TVL 最高？
+**流程:** `fin_crypto(endpoint="defi/protocols", limit=5)` → TVL 排行

package/skills/skill-publish/SKILL.md

@@ -68,13 +68,13 @@ Before publishing, **always check** `identity.visibility` in the strategy's `fep
 
 The plugin requires configuration:
 
-- `skillApiUrl`: Server URL (default: `https://hub.openfinclaw.ai`)
-- `skillApiKey`: API key with `fch_` prefix (68 chars)
+- `hubApiUrl`: Server URL (default: `https://hub.openfinclaw.ai`)
+- `apiKey`: API key with `fch_` prefix
 
 Configure via:
 
-- Plugin config: `skillApiUrl`, `skillApiKey`
-- Environment: `SKILL_API_URL`, `SKILL_API_KEY`
+- Plugin config: `hubApiUrl`, `apiKey`
+- Environment: `HUB_API_URL`, `OPENFINCLAW_API_KEY`
 
 ### ⚠️ API Key Security