An intelligent background daemon for Openclaw Skills that automates QuantConnect backtest monitoring, equity tracking, and forensic diagnosis.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install backtest-poller
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 backtest-poller 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 Backtest Poller?
The Backtest Poller is a specialized background process designed to eliminate the need for manual monitoring of long-running QuantConnect backtests. As a sophisticated addition to the library of Openclaw Skills, it functions as a persistent daemon that survives terminal disconnections, ensuring your trading strategies are monitored from start to finish. It prioritizes API efficiency and data integrity, making it a critical tool for developers building automated trading systems.
By integrating this skill into your workflow, you leverage an adaptive polling system that dynamically adjusts its frequency based on the backtest's progress. This ensures high-resolution tracking during critical phases while conserving API quota during steady-state execution. The Backtest Poller represents a significant productivity boost for quantitative researchers using Openclaw Skills.
Backtest Poller Use Cases
- Automating the lifecycle of QuantConnect backtests from submission to forensic analysis.
- Implementing early-stop logic to terminate failing strategies when drawdown thresholds are breached.
- Running long-duration backtests in the background without maintaining an active terminal session.
- Batch processing backtest results with automated downloads and system notifications.
How Backtest Poller Works
- The user initiates a backtest via the CLI, which automatically spawns the poller daemon as a nohup background process.
- The poller initializes a file-locked state.json to track the PID and backtest metadata securely.
- Adaptive polling begins, with intervals ranging from 30 to 180 seconds based on the current progress percentage reported by the QuantConnect API.
- During each poll, the daemon evaluates live drawdown; if it exceeds user-defined limits after 20% progress, the backtest is permanently deleted to save time.
- Upon completion, the poller automatically downloads order logs and result JSONs, runs a forensic diagnosis, and triggers a macOS system notification.
Backtest Poller Setup
To get started with this skill in your Openclaw Skills environment, configure your QuantConnect credentials as environment variables:
export QC_USER_ID="your_user_id"
export QC_API_TOKEN="your_api_token"
export QC_PROJECT_ID="your_project_id"
Start the background daemon manually or via a submission:
python3 cli.py start-poller
Backtest Poller Data Schema & Taxonomy
The skill maintains a structured data hierarchy to ensure consistency across the Openclaw Skills ecosystem:
| Data Component | Format | Description |
|---|---|---|
| state.json | JSON | Centralized state file containing PID, polling status, and backtest tracking metrics. |
| results/ | Directory | Local storage for downloaded orders.csv and result.json files for each backtest. |
| diagnosis.txt | Text | Generated forensic report including order counts, ROI, and windfall analysis. |
| Logs | Text | Poller daemon logs accessible via the CLI for debugging. |
Backtest Poller Advanced Features
- Adaptive Polling Logic: Reduces API call volume by over 80% by scaling frequency relative to backtest progress.
- Concurrency Protection: Uses fcntl.flock to prevent race conditions between the CLI and the background daemon.
- Automated OrderForensics: Built-in diagnostic suite that extracts actionable insights immediately after a backtest finishes.
- Resilient Background Execution: Optimized for Openclaw Skills to persist across shell restarts using nohup and PID tracking.
- Native Notifications: Integrated macOS osascript support for real-time status alerts.
SKILL.md
Loading
Related Openclaw Skills
QC Deep Feature Forensics
A 12-dimensional technical feature attribution engine that identifies the market microstructure conditions separating winning trades from losing ones.
IMAP IDLE Email Notifier
A real-time email monitoring skill that uses IMAP IDLE to push instant notifications to Feishu.
Cognitive Memory System
An intelligent multi-store memory system for AI agents featuring human-like encoding, reflection cycles, and decay-based forgetting.
Fund Investment Advisory Assistant (fin-advisor)
A specialized AI investment assistant that delivers professional fund analysis, market comparisons, and data-driven decision support.
QC Backtest Master
A streamlined pipeline for automating QuantConnect backtest lifecycles from local strategy files to detailed cloud result downloads.
AI Video Editor (Sparki)
An AI-powered video processing skill that automates editing, resizing, and highlight generation for social media platforms.
Featured*
