---
name: openfinclaw-strategy
description: "OpenFinClaw 统一金融工具平台。行情数据（价格/K线/加密市场/多资产对比）、策略工具（创建/验证/发布/Fork）、SQLite 持久化与 Dashboard 看板。当用户提到 FinClaw、Hub、策略、行情、价格、K线、加密货币、BTC、ETH、DeFi、Dashboard 时触发。"
metadata:
  openclaw:
    emoji: "🦈"
    requires:
      extensions: ["openfinclaw-strategy"]
---

# OpenFinClaw

统一金融工具平台，一个 API Key 即可使用所有功能：

- **行情数据**: 价格查询、K线、加密市场数据、多资产对比、代码搜索
- **策略工具**: 创建、验证、发布、Fork 策略
- **统一认证**: 一个 API Key 访问 Hub 和 DataHub

## 平台简介

**Hub 平台 (hub.openfinclaw.ai)** 是一个 7×24 小时全球策略进化网络：

- **策略分享**: 发布你的策略，供社区成员查看和 Fork
- **回测验证**: 发布时自动运行回测，验证策略有效性
- **社区进化**: 其他用户可以 Fork 你的策略进行优化改进
- **绩效排行**: 查看各市场表现最佳的策略

**DataHub** 提供实时行情数据：

- **多市场覆盖**: 加密货币、A股、港股、美股
- **丰富数据**: 价格、K线、OHLCV、DeFi TVL、资金费率
- **数据来源**: CoinGecko、DefiLlama、CCXT、Tushare

核心价值：**不要追逐浪潮，创造浪潮。**

## 快速开始

### 行情查询（需要 API Key）

```
用户: BTC 现在多少钱
Agent: 使用 fin_price 获取实时价格

用户: ETH 最近 7 天走势
Agent: 使用 fin_kline 获取 K 线数据

用户: DeFi 哪个协议 TVL 最高
Agent: 使用 fin_crypto 获取 DeFi 排名

用户: BTC 和 ETH 谁涨得多
Agent: 使用 fin_compare 对比收益
```

### 策略管理

```bash
# 查看排行榜
openclaw strategy leaderboard

# 查看收益榜 Top 10
openclaw strategy leaderboard returns --limit 10

# 查看策略详情
openclaw strategy show 550e8400-e29b-41d4-a716-446655440001 --remote
```

## 安装指南

### 前置检查

在安装前，检查用户是否已安装 OpenClaw：

```bash
openclaw --version
```

如果未安装，引导用户安装 OpenClaw（参考 https://docs.openclaw.ai/install）。

### 安装 openfinclaw 插件

```bash
openclaw plugins install @openfinclaw/openfinclaw-strategy
openclaw plugins enable @openfinclaw/openfinclaw-strategy
```

### 验证安装

```bash
# 查看插件状态
openclaw plugins list

# 测试命令
openclaw strategy list
```

### 配置 API Key

从 https://hub.openfinclaw.ai 获取 API Key（以 `fch_` 开头），**一个 Key 即可使用所有功能**：

```bash
openclaw config set plugins.entries.openfinclaw-strategy.config.apiKey YOUR_API_KEY
```

或使用环境变量：

```bash
export OPENFINCLAW_API_KEY=YOUR_API_KEY
```

### ⚠️ API Key 安全提醒

**重要：请勿泄露你的 API Key！**

- API Key 以 `fch_` 开头，用于 Hub 和 DataHub 接口校验
- **不要**将 API Key 提交到 Git 仓库或公开分享
- **不要**在公开聊天、截图、代码示例中暴露真实的 API Key
- 如果怀疑 Key 已泄露，请立即在 Hub 个人设置中重新生成

## 功能概览

本插件提供两大类能力：

### 行情数据工具

| 工具名            | 用途                        | 需要 API Key |
| ----------------- | --------------------------- | ------------ |
| `fin_price`       | 价格查询（股票/加密/指数）  | **是**       |
| `fin_kline`       | K线/OHLCV 数据              | **是**       |
| `fin_crypto`      | 加密市场数据（21个端点）    | **是**       |
| `fin_compare`     | 多资产价格对比（2-5个资产） | **是**       |
| `fin_slim_search` | 代码/名称搜索               | **是**       |

### 策略工具

| 工具名                 | 用途                                   | 需要 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` | 查询发布状态和回测报告                 | **是**       |

### Skills（指导文档）

#### 行情数据 Skills

| Skill         | 触发场景           | 说明             |
| ------------- | ------------------ | ---------------- |
| `price-check` | 快速查价、XX多少钱 | 最简单的价格查询 |

#### 策略 Skills

| Skill              | 触发场景                 | 说明                          |
| ------------------ | ------------------------ | ----------------------------- |
| `strategy-builder` | 创建新策略、生成策略代码 | 自然语言 → FEP v2.0 策略包    |
| `skill-publish`    | 发布策略到服务器         | 验证 → 打包 → 发布 → 查询回测 |
| `strategy-fork`    | 下载/克隆 Hub 策略       | Fork → 本地编辑 → 发布新版本  |
| `strategy-pack`    | 创建回测策略包           | 生成 fep.yaml + strategy.py   |

### 典型工作流

```
行情查询 → 分析决策 → 策略创建 → 验证 → 发布 → Fork → 优化
    ↓          ↓          ↓         ↓        ↓
 fin_price  compare  strategy-builder  skill_validate  skill_publish
 fin_kline                        skill_fork      skill_publish_verify
```

## CLI 命令

### strategy leaderboard

查看 Hub 排行榜：

```bash
# 综合榜 Top 20（默认）
openclaw strategy leaderboard

# 收益榜 Top 10
openclaw strategy leaderboard returns --limit 10

# 人气榜第 21-40 名
openclaw strategy leaderboard popular --offset 20 --limit 20
```

**榜单类型**：

| 榜单类型    | 说明           | 排序依据         |
| ----------- | -------------- | ---------------- |
| `composite` | 综合榜（默认） | FCS 综合分       |
| `returns`   | 收益榜         | 收益率           |
| `risk`      | 风控榜         | 风控分           |
| `popular`   | 人气榜         | 订阅数           |
| `rising`    | 新星榜         | 30天内新策略收益 |

### strategy fork

从 Hub 下载策略到本地：

```bash
# 使用策略 ID
openclaw strategy fork 34a5792f-7d20-4a15-90f3-26f1c54fa4a6

# 使用 Hub URL
openclaw strategy fork https://hub.openfinclaw.ai/strategy/34a5792f-7d20-4a15-90f3-26f1c54fa4a6
```

### strategy list

列出本地策略：

```bash
openclaw strategy list
```

### strategy show

查看策略详情：

```bash
# 查看本地策略
openclaw strategy show btc-adaptive-dca-34a5792f

# 从 Hub 获取最新信息
openclaw strategy show 550e8400-e29b-41d4-a716-446655440001 --remote
```

## 本地存储结构

策略存储在 `~/.openfinclaw/workspace/strategies/` 目录：

```
~/.openfinclaw/workspace/strategies/
└── 2026-03-16/                              # 按日期组织
    ├── btc-adaptive-dca-34a5792f/           # 名称 + 短ID（Fork 来的）
    │   ├── fep.yaml                         # 策略配置
    │   ├── scripts/
    │   │   └── strategy.py                  # 策略代码
    │   └── .fork-meta.json                  # 元数据
    └── my-new-strategy/                     # 自建策略（无短ID）
        └── ...
```

## Dashboard 数据看板

插件启动时自动开启内嵌 HTTP 服务（仅绑定 127.0.0.1）：

```
打开浏览器访问 http://127.0.0.1:18792
```

看板包含 4 个标签页：

| 标签页   | 数据来源             | 说明                           |
| -------- | -------------------- | ------------------------------ |
| 活动日志 | `agent_activity_log` | 所有 12 个工具的每次执行记录   |
| 事件流   | `agent_events`       | Fork、发布、回测完成等关键事件 |
| 策略列表 | `strategies`         | 本地策略生命周期状态           |
| 回测结果 | `backtest_results`   | 回测指标（收益/夏普/回撤等）   |

**REST API**（供前端或其他工具调用）：

| 端点                        | 说明                     |
| --------------------------- | ------------------------ |
| `GET /api/activity-log`     | 工具调用日志（分页）     |
| `GET /api/agent-events`     | 事件流（分页）           |
| `GET /api/strategies`       | 策略列表                 |
| `GET /api/backtest-results` | 回测结果（可按策略过滤） |

**SQLite 数据库路径**: `~/.openfinclaw/workspace/openfinclaw-plugin.db`

**策略生命周期 Level**:

| Level | 阶段   | 说明                         |
| ----- | ------ | ---------------------------- |
| L0    | 创建   | Fork 或新建，尚未回测        |
| L1    | 回测   | 已提交回测（进行中或已完成） |
| L2    | 模拟盘 | 模拟交易运行中（预留）       |
| L3    | 实盘   | 实盘运行中（预留）           |

## 触发场景与相关 Skills

当用户提到以下内容时，应引导阅读对应的 Skill：

| 触发关键词                     | 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`                      |
| `httpPort`          | `OPENFINCLAW_HTTP_PORT` | Dashboard 端口   | `18792`                      |

## 常见问题

### Q: API Key 在哪里获取？

访问 https://hub.openfinclaw.ai 登录后在个人设置中获取。**一个 Key 即可使用所有功能**。

### Q: 行情数据需要额外付费吗？

API Key 已包含行情数据访问权限，无需额外付费。

### Q: Fork 的策略可以修改吗？

可以。Fork 下载到本地后，可以自由修改 `scripts/strategy.py`，然后发布为自己的新版本。

### Q: 发布策略会公开吗？

取决于 `fep.yaml` 中的 `identity.visibility` 设置：

- `public`: 公开，社区可见可 Fork
- `private`: 私有，仅自己可见
- `unlisted`: 不公开但可通过链接访问

### Q: 如何检查 openfinclaw 是否已安装？

```bash
openclaw plugins list | grep openfinclaw
```

## 链接

- **Hub 平台**: https://hub.openfinclaw.ai
- **排行榜**: https://hub.openfinclaw.ai/leaderboard
- **策略发现**: https://hub.openfinclaw.ai/discover
- **获取 API Key**: https://hub.openfinclaw.ai/dashboard
- **GitHub 仓库**: https://github.com/cryptoSUN2049/openFinclaw