使用教程

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

平台简介

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

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

Hub 平台

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

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

DataHub

DataHub 提供实时行情数据：

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

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

安装指南

前置检查

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

openclaw --version

如果未安装，请前往 OpenClaw 官网 安装。

安装 openfinclaw 插件

在 OpenClaw 中执行以下命令：

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

安装成功后会显示插件路径。

验证安装

查看插件状态：

openclaw plugins list

测试命令：

openclaw strategy list

快速开始

行情查询（需要 API Key）

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

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

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

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

策略管理

查看排行榜：

openclaw strategy leaderboard

查看收益榜 Top 10：

openclaw strategy leaderboard returns --limit 10

查看策略详情：

openclaw strategy show 550e8400-e29b-41d4-a716-446655440001 --remote

配置 API Key

获取 API Key

从 hub.openfinclaw.ai 获取 API Key（以 fch_ 开头），一个 Key 即可使用所有功能。

配置方式

使用 OpenClaw 配置：

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

或使用环境变量：

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_klineK线/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

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 排行榜：

综合榜 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 下载策略到本地：

使用策略 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

列出本地策略：

openclaw strategy list

strategy show

查看策略详情：

查看本地策略：

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_eventsFork、发布、回测完成等关键事件
策略列表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实盘实盘运行中（预留）

常见问题

Q: API Key 在哪里获取？

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

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

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

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

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

Q: 发布策略会公开吗？

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

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

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

openclaw plugins list | grep openfinclaw

相关链接

Hub 平台排行榜策略发现获取 API Key