A comprehensive football betting assistant for real-time odds scanning, expected value (EV) analysis, and professional bankroll management.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install footyclaw
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install footyclaw using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is FootyClaw?
FootyClaw is a sophisticated Openclaw Skills integration designed to transform football betting into a data-driven discipline. By leveraging real-time data from The Odds API, it automates the discovery of value bets across major global leagues including the EPL, La Liga, and Champions League.
The skill focuses on mathematical edge detection by comparing market odds against Pinnacle's fair probability. It provides a full-lifecycle workflow—from initial bankroll setup and shareholder equity tracking to advanced Expected Value (EV) calculations and Kelly Criterion-based stake sizing, ensuring users maintain professional risk management.
FootyClaw Use Cases
- Scanning major football leagues for +EV (Positive Expected Value) betting opportunities.
- Calculating optimal bet sizes using the Kelly Criterion to prevent bankroll depletion.
- Tracking betting performance with automated ledger management and visual equity curves.
- Performing fundamental analysis by cross-referencing xG data and injury reports.
- Understanding complex Asian Handicap and Over/Under market settlement rules.
How FootyClaw Works
- Bankroll Initialization: The skill captures your starting capital and shareholder structure to establish a baseline for all future calculations.
- Odds Acquisition: It utilizes
daily_scanner.pyto pull real-time market data via your ODDS_API_KEY, covering a 36-hour forward-looking window. - Edge Detection: It calculates 'Fair Probability' by removing the vig from Pinnacle's lines and identifies value where other bookmakers' odds exceed this probability.
- Risk Assessment: The system runs a fundamental analysis check (xG trends, injuries, rotation risks) to validate the mathematical edge.
- Position Sizing: Using the Kelly Criterion formula, it recommends a specific stake amount (defaulting to 1/4 Kelly) capped at 20% of the total bankroll.
- Reporting & Logging: Transactions are recorded in a session-managed ledger, and performance is visualized through SVG-based equity charts.
FootyClaw Setup
To use FootyClaw, you must configure your API credentials and initialize your bankroll within the Openclaw Skills environment:
- Obtain a free API key from The Odds API.
- Add the key to your skill secrets as
ODDS_API_KEY. - Initialize your bankroll in the chat:
# Example initialization command
Analyze tonight's games with a starting bankroll of 10000
- Run the scanner manually via CLI if needed:
python3 scripts/daily_scanner.py --bankroll 10000 --min-ev 1.0 --hours-ahead 36
FootyClaw Data Schema & Taxonomy
FootyClaw manages data through session memory and structured reference files to ensure consistency without heavy local storage requirements.
| Data Type | Description | Storage Method |
|---|---|---|
| Ledger | Daily logs of bets, odds, results, and profit/loss | Markdown Table (Conversation Memory) |
| Market Data | Real-time odds from major bookmakers | Volatile (API Fetch) |
| Analysis Framework | Guidelines for xG, injuries, and league-specific trends | references/fundamental-analysis.md |
| Betting Rules | Logic for Asian Handicap and O/U settlements | references/betting-rules.md |
| Performance Visuals | Base64 encoded SVG equity curves | In-memory generation (Stdout) |
FootyClaw Advanced Features
- No-File Charting: Generates visual performance graphs using
chart_generator.pythat outputs Base64 images directly to the UI without saving local files. - Multi-League Scanning: Simultaneous EV analysis across EPL, Bundesliga, Serie A, Ligue 1, and UEFA competitions.
- Smart Risk Control: Automatically suggests reduced stakes after a 3-day losing streak and enforces a 20% hard cap on single-bet exposure.
- Pinnacle-Weighted Modeling: Uses sharp market signals to filter out 'trap' lines from recreational bookmakers.
- Shareholder Management: Supports complex bankroll structures for betting syndicates or multi-person partnerships.
SKILL.md
Loading
Related Openclaw Skills
Cookie Policy Page Generator
A specialized tool for generating and optimizing comprehensive cookie policy pages to ensure global data privacy compliance.
Halo CLI Auth
A comprehensive authentication management skill for the Halo CLI to handle logins, profile switching, and credential diagnostics.
EasyPaper
Generate professional, structured academic papers from metadata using a powerful multi-agent Python SDK and LaTeX toolchain.
Legal Page Generator
A specialized skill for generating structured, SEO-optimized legal and compliance pages for modern web applications.
Hong Kong Coin Collection Truck Tracker
An automated query tool for locating the Hong Kong Monetary Authority's mobile coin collection fleet across various districts.
WeCom Doc and Smartsheet
A powerful automation skill for creating and managing Enterprise WeChat documents and complex smartsheets through the mcporter MCP server.
Featured*
