@openfinclaw/openfinclaw

FinClaw Commons - 量化策略开发平台插件。连接 hub.openfinclaw.ai 策略网络，支持策略创建、验证、发布、Fork。

安装

curl -fsSL https://raw.githubusercontent.com/cryptoSUN2049/openFinclaw/main/scripts/install-finclaw.sh | bash

或手动安装：

openclaw plugins install @openfinclaw/openfinclaw

快速开始（无需 API Key）

# 查看排行榜
openclaw strategy leaderboard

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

# 查看策略详情
openclaw strategy show <strategy-id> --remote

功能概览

| 功能 | 工具 | 需要 API Key | | ---------- | ---------------------- | ------------ | | 排行榜查询 | skill_leaderboard | 否 | | 策略详情 | skill_get_info | 否 | | 本地验证 | skill_validate | 否 | | 本地列表 | skill_list_local | 否 | | 策略 Fork | skill_fork | 是 | | 策略发布 | skill_publish | 是 | | 发布查询 | skill_publish_verify | 是 |

AI 工具列表

| 工具 | 说明 | API Key | | ---------------------- | -------------------------------------- | -------- | | skill_leaderboard | 查询排行榜（综合/收益/风控/人气/新星） | 不需要 | | skill_get_info | 获取 Hub 策略公开详情 | 不需要 | | skill_validate | 本地验证策略包（FEP v1.2） | 不需要 | | skill_list_local | 列出本地策略 | 不需要 | | skill_fork | 从 Hub 下载策略到本地 | 需要 | | skill_publish | 发布策略 ZIP 到 Hub，自动触发回测 | 需要 | | skill_publish_verify | 查询发布状态和回测报告 | 需要 |

CLI 命令

# 查看排行榜（无需 API Key）
openclaw strategy leaderboard
openclaw strategy leaderboard returns --limit 10

# 从 Hub Fork 策略（需要 API Key）
openclaw strategy fork <strategy-id>

# 列出本地策略
openclaw strategy list

# 查看策略详情
openclaw strategy show <name-or-id> [--remote]

# 删除本地策略
openclaw strategy remove <name-or-id> --force

排行榜类型

| 榜单类型 | 说明 | | ----------- | -------------- | | composite | 综合榜（默认） | | returns | 收益榜 | | risk | 风控榜 | | popular | 人气榜 | | rising | 新星榜 |

配置

Fork 和发布策略需要 API Key（从 https://hub.openfinclaw.ai 获取）：

openclaw config set plugins.entries.openfinclaw.config.skillApiKey YOUR_API_KEY

或使用环境变量：

export SKILL_API_KEY=YOUR_API_KEY
export SKILL_API_URL=https://hub.openfinclaw.ai

⚠️ API Key 安全提醒

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

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

配置选项

| 配置项 | 环境变量 | 说明 | 默认值 | | ------------------ | -------------------------- | ---------------------------- | ---------------------------- | | skillApiKey | SKILL_API_KEY | Hub API Key（Fork/发布需要） | 可选 | | skillApiUrl | SKILL_API_URL | Hub 服务地址 | https://hub.openfinclaw.ai | | requestTimeoutMs | SKILL_REQUEST_TIMEOUT_MS | 请求超时 | 60000 |

Skills

openfinclaw (入口)

平台入口 skill，帮助用户了解 Hub 平台、安装插件、使用工具链。

skill-publish

发布策略到 Hub：

用户: "发布我的策略到服务器"
Agent:
1. skill_validate(dirPath) → 本地验证
2. [打包 ZIP]
3. skill_publish(filePath) → 获取 submissionId
4. skill_publish_verify(submissionId) → 轮询直到完成
5. 返回回测报告

fin-strategy-builder

自然语言生成策略：

用户: "帮我创建一个 BTC 定投策略，每周买入 100 美元"
Agent:
1. 生成 fep.yaml 配置
2. 生成 scripts/strategy.py 代码
3. 可选：验证并打包

strategy-fork

从 Hub 下载策略：

用户: "帮我下载那个收益 453% 的 BTC 策略"
Agent:
1. skill_leaderboard() → 查看排行榜
2. skill_get_info(strategyId) → 查看详情
3. skill_fork(strategyId) → 下载到本地
4. 返回本地路径供编辑

本地存储

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

~/.openfinclaw/workspace/strategies/
└── 2026-03-16/
    ├── btc-adaptive-dca-34a5792f/   # Fork 来的策略
    │   ├── fep.yaml
    │   ├── scripts/strategy.py
    │   └── .fork-meta.json
    └── my-new-strategy/             # 自建策略
        └── ...

链接

• Hub 平台: https://hub.openfinclaw.ai
• 排行榜: https://hub.openfinclaw.ai/leaderboard
• 获取 API Key: https://hub.openfinclaw.ai/dashboard
• GitHub: https://github.com/cryptoSUN2049/openFinclaw

License

MIT