← 返回 Skills 市场
botaocai

FootyClaw: AI Quant Betting Agent

作者 botaocai · GitHub ↗ · v1.0.4 · MIT-0
cross-platform ⚠ suspicious
249
总下载
1
收藏
0
当前安装
5
版本数
在 OpenClaw 中安装
/install footyclaw
功能描述
FootyClaw — 足球投注全流程助手。覆盖赛事信息抓取、足彩玩法规则、赔率获取(需用户提供 The Odds API Key)、基本面分析、EV期望值计算、Kelly公式仓位管理、最终下注方案推荐、 账本记账与资金曲线生成。 触发词:分析今晚比赛、查赔率、找投注机会、今天有什么场、EV分析、Kelly仓位、...
使用说明 (SKILL.md)

\r \r ---\r name: footyclaw\r description: >\r FootyClaw — 足球投注全流程助手。覆盖赛事信息抓取、足彩玩法规则、赔率获取(通过环境变量\r ODDS_API_KEY 读取密钥)、基本面分析、EV期望值计算、Kelly公式仓位管理、最终下注方案推荐、\r 账本记账与资金曲线生成。\r 触发词:分析今晚比赛、查赔率、找投注机会、今天有什么场、EV分析、Kelly仓位、\r 下注推荐、记账、更新账本、出账本图表、足彩、亚盘、大小球、欧盘。\r ---\r \r

⚽ FootyClaw — 足球投注全流程 Skill\r

\r

0. 快速开始\r

\r 用户首次使用时询问:\r

  1. 初始资金池金额(本金)\r
  2. 股东结构(若多人合伙,记录各人出资比例)\r \r

密钥安全规范:API 密钥通过环境变量 ODDS_API_KEY 获取,由 Skill\r 平台 secrets 机制自动注入。不要在对话中询问、打印或以任何方式暴露用户的\r 明文密钥。 若环境变量缺失,提示用户到 Skill 设置页面配置 ODDS_API_KEY\r (免费注册:https://the-odds-api.com)。\r \r ---\r \r

1. 标准分析流程\r

\r

Step 1 — 读取资金池\r

从会话记忆中获取当前资金池余额(首次使用时由用户提供初始金额)\r \r

Step 2 — 拉取赔率\r

python3 scripts/daily_scanner.py \r --bankroll \x3C资金池> --min-ev 1.0 --hours-ahead 36\r (脚本自动从环境变量 ODDS_API_KEY 读取密钥,无需手动传入)\r \r 扫描覆盖:英超/西甲/德甲/意甲/法甲/欧冠/欧联/欧协联\r \r

Step 3 — EV 计算(核心规则)\r

必须用 Pinnacle 公平概率 vs 其他 bookmaker 赔率:\r

  1. 提取 Pinnacle 对同一市场的两个结果配对去 vig\r
  2. 公平概率 fp = (1/o1) / (1/o1 + 1/o2)\r
  3. EV% = fp×(odds-1) - (1-fp)\r
  4. 绝不用 Pinnacle 对 Pinnacle 算 EV(会得到虚假 100%+)\r
  5. 排除:matchbook/betfair_ex/williamhill/betonlineag\r \r EV 阈值:\x3C1% 不投 | 1-3% 可投 | 3-5% 好机会 | >5% 需核实\r \r

Step 4 — 基本面核查\r

详见 references/fundamental-analysis.md:\r

  • xG/xGA 数据趋势\r
  • 近期主客场分开统计\r
  • 伤病/停赛情况\r
  • 轮换风险(国际赛周/欧战密集期)\r
  • 赔率移动方向(跟随 sharp money)\r \r

Step 5 — 仓位计算\r

Kelly = (fp×(odds-1) - (1-fp)) / (odds-1)\r 推荐注额 = Kelly × fraction × 资金池\r

  • fraction 默认 1/4 Kelly,可按用户风险偏好调整\r
  • 正 EV 机会不足时不强行凑负 EV 注\r
  • 单注上限:资金池 20%(风控硬性上限)\r
  • 连续亏损 3 日:建议降低仓位直至盈利\r \r

Step 6 — 输出下注方案\r

企业微信不渲染 Markdown 表格,必须用纯文本格式:\r \r 📅 周X(MM-DD)|总注 ¥X,000\r \r 🏴 主队 vs 客队 | HH:MM\r 投注项 @赔率 | EV +X.X% | ¥X,000 | 赢 +¥X,000\r \r 三天总注 ¥X,000 | 期望 +¥XXX | 全中 +¥X,000\r \r ---\r \r

2. 盘口规则速查\r

\r 亚盘让球:\r

  • X.0:赢全赢,平退款,输全输\r
  • X.25:赢全赢,平=半输,输全输\r
  • X.5:赢全赢,平/输全输(无退款)\r
  • X.75:赢1球=半赢,赢2球+=全赢,平/输全输\r \r 大小球 Under 方向:\r
  • U2.25:2球半赢,3球+全输\r
  • U2.5:2球以下全赢,3球+全输\r
  • U2.75:3球半赢,4球+全输\r
  • U3.0:3球退款,4球+全输\r Over 方向完全相反。\r \r 盈利计算:\r
  • 全赢:注额 × (赔率 - 1)\r
  • 半赢:注额 × (赔率 - 1) × 0.5\r
  • BTTS/DNB:见 references/betting-rules.md\r \r ---\r \r

3. 账本记账(纯对话,零文件写入)\r

\r 账本数据由大模型会话记忆维护,每次记账直接在对话框打印 Markdown 表格:\r | Day | 日期 | 注数 | 中/总 | 盈亏 | 期末资金 | 备注 |\r 用户可随时说"出账本"查看完整表格。\r \r 盈利计算规则:\r

  • 欧盘独赢盈利 = 注额 × (欧赔 - 1)\r
  • 亚盘盈利 = 注额 × HK赔率(HK赔率 = 欧赔 - 1)\r
  • 股东权益按出资比例分配\r \r 资金曲线图:python3 scripts/chart_generator.py\r 脚本从 stdin 读取账本 Markdown 表格,在内存中生成 SVG,输出 Base64 编码的\r \x3Cimg> 标签到 stdout,可直接嵌入对话框显示,不写任何本地文件。\r \r ---\r \r

4. 联赛特性速查\r

\r 英超 soccer_epl:~2.7球,平局率26%,主场优势弱\r 西甲 soccer_spain_la_liga:~2.5球,技术流,强队让球有价值\r 德甲 soccer_germany_bundesliga:~3.2球,高进球,大球多\r 意甲 soccer_italy_serie_a:~2.5球,防守为主,BTTS No多\r 法甲 soccer_france_ligue_one:~2.4球,PSG碾压,非PSG小球多\r 欧冠 soccer_uefa_champs_league:~2.9球,首回合保守\r \r ---\r \r

5. 参考文件索引\r

\r

  • references/betting-rules.md — 完整盘口规则\r
  • references/fundamental-analysis.md — 基本面分析框架\r
  • scripts/daily_scanner.py — 全联赛 EV 扫描\r
  • scripts/ev_calculator.py — EV + Kelly 计算\r
  • scripts/fetch_odds.py — 单联赛赔率拉取\r
  • scripts/chart_generator.py — 账本图表生成(stdin→Base64 img,零文件写入)\r
安全使用建议
This skill appears to implement what it claims (odds fetch, EV/Kelly calc, charting) and only needs a single external API key (The Odds API). However: - The registry metadata does NOT list ODDS_API_KEY even though SKILL.md and all scripts read it. Ask the publisher to correct the metadata before installing so the platform can surface the secret requirement properly. - The skill source/homepage is missing and the owner ID is unknown; prefer published skills with clear provenance. If you proceed, review the bundled scripts yourself or run them in a sandbox first. - The skill uses conversation memory to store the ledger (no local files). Consider that bankroll amounts, shareholder ratios, and bet history may persist in the agent platform — ensure you trust the platform's memory/retention and secrets handling. - Confirm the skill's network permission is limited to api.the-odds-api.com (SKILL.md declares this). If the platform allows you to inspect or restrict network hosts, enforce that limit. Practical next steps before enabling: verify the ODDS_API_KEY will be provided via the platform's secrets mechanism (and not pasted into chat), request corrected registry metadata listing the env var, inspect the bundled scripts locally, and if possible run them in an isolated environment to confirm they only call the Odds API and do not leak data elsewhere. Also be mindful of legal and financial risks of automated betting assistance.
功能分析
Type: OpenClaw Skill Name: footyclaw Version: 1.0.4 The FootyClaw skill is a football betting assistant that fetches odds, calculates Expected Value (EV), and manages a betting ledger. It uses standard Python libraries (urllib, subprocess, base64) to interact with a legitimate external API (api.the-odds-api.com) and process data. The code follows security best practices by explicitly instructing the AI agent not to leak the ODDS_API_KEY secret and by generating charts in-memory (Base64 SVG) rather than writing to the local filesystem. No indicators of data exfiltration, malicious execution, or harmful prompt injection were found.
能力评估
Purpose & Capability
The scripts and SKILL.md implement a coherent football-betting assistant (fetch odds, compute EV/Kelly, generate charts). However the registry metadata claims 'Required env vars: none' while SKILL.md and all scripts require ODDS_API_KEY — an explicit metadata mismatch that undermines trust/provenance.
Instruction Scope
Runtime instructions are narrowly scoped to: read a bankroll from conversation memory, call local scripts, and fetch odds from api.the-odds-api.com. The SKILL.md explicitly warns not to print secrets. The scripts do not read unrelated system files or call unexpected external endpoints.
Install Mechanism
No install spec and all code is bundled with the skill (no downloads or extract). That reduces install-time risk; included Python scripts are plain and readable with no obfuscated logic.
Credentials
The skill legitimately requires one external API credential (ODDS_API_KEY) to function. That is proportionate to the purpose, but the registry metadata fails to declare it, while SKILL.md lists it under secrets and scripts read it from environment — this inconsistency is a red flag. Also ledger data is kept in conversation memory (not files), which may persist in the platform and could expose financial details if not managed.
Persistence & Privilege
The skill does not request always:true and has no install-time persistence or system-wide config changes. It runs user-invoked scripts and uses the platform secrets/network permission model as documented in SKILL.md.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install footyclaw
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /footyclaw 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.4
**Improved security for API key management; no changes to functionality.** - API 密钥现在通过环境变量 ODDS_API_KEY 自动注入,不再需用户在对话中手动输入或明文传递密钥 - 若环境变量缺失,将提示用户前往 Skill 设置页面配置密钥 - 明确禁止在对话中询问、打印或暴露密钥,提升用户安全 - 其他核心功能流程和规则未变化
v1.0.3
Version 1.0.3 - 增加 The Odds API 外网访问权限声明(network 权限,限定 api.the-odds-api.com:443)。 - 账本数据和资金池全部采用对话记忆维护,移除本地文件读写,所有记账操作直接在对话窗口输出。 - “出账本”命令,账本表格实时打印;资金曲线图由 chart_generator.py 脚本读取 Markdown 表,通过内存方式生成 Base64 图片。 - 资金池余额来源改为用户首次输入与会话记忆,不再读取本地文件。 - 文档同步调整,明确所有账本与资金操作纯会话、无本地存储方式。 - 其余分析/推荐/规则流程保持不变。
v1.0.2
- Added explicit secrets and permissions sections to declare ODDS_API_KEY as a secret and enable file system access. - No changes to code or main functionality.
v1.0.1
Version 1.0.1 - 新增了 ODDS_API_KEY 为显式必填项,添加至 credentials 字段,详细说明用途及获取方式。 - 其余功能与描述未变。
v1.0.0
Footyclaw 1.0.0 — 足球投注全流程助手正式发布: - 提供赛事信息抓取、足彩玩法规则、赔率获取(支持 The Odds API)、基本面分析、EV 期望值计算与 Kelly 仓位管理。 - 支持多联赛(英/西/德/意/法/欧战)投注机会自动筛选与推荐,输出纯文本下注方案。 - 内置资金池记录、账本记账及资金曲线生成功能,支持股东结构分红。 - EV 计算严格对比 Pinnacle 与其他主流博彩,内含详细风控与投注建议分级。 - 提供亚盘、大小球、欧盘规则与各大联赛特性速查。
元数据
Slug footyclaw
版本 1.0.4
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 5
常见问题

FootyClaw: AI Quant Betting Agent 是什么?

FootyClaw — 足球投注全流程助手。覆盖赛事信息抓取、足彩玩法规则、赔率获取(需用户提供 The Odds API Key)、基本面分析、EV期望值计算、Kelly公式仓位管理、最终下注方案推荐、 账本记账与资金曲线生成。 触发词:分析今晚比赛、查赔率、找投注机会、今天有什么场、EV分析、Kelly仓位、... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 249 次。

如何安装 FootyClaw: AI Quant Betting Agent?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install footyclaw」即可一键安装,无需额外配置。

FootyClaw: AI Quant Betting Agent 是免费的吗?

是的,FootyClaw: AI Quant Betting Agent 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

FootyClaw: AI Quant Betting Agent 支持哪些平台?

FootyClaw: AI Quant Betting Agent 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 FootyClaw: AI Quant Betting Agent?

由 botaocai(@botaocai)开发并维护,当前版本 v1.0.4。

💬 留言讨论