A specialized utility for tracking and planning tasks around financial market trading days in the US, China, and Hong Kong.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install finance-cron
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 finance-cron 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 Finance Calendar?
Finance Calendar is a powerful tool within the Openclaw Skills ecosystem designed for developers and traders who need market-aware scheduling. It provides precise tracking of trading days across major global exchanges including the NYSE, NASDAQ, SSE, SZSE, and HKEX. By accounting for holidays and market-specific calendars, it ensures that financial tasks are only triggered when the markets are actually active.
This skill eliminates the common headache of manual holiday tracking by providing automated synchronization of trading calendars. Whether you are building an automated trading bot or a simple market alert system, Finance Calendar provides the logical foundation to determine exactly when your commands should execute based on real-world market hours.
Finance Calendar Use Cases
- Verifying if a specific date is a valid trading day before executing financial scripts.
- Generating lists of upcoming trading days for US, CN, or HK markets to plan reporting cycles.
- Syncing local holiday databases with live financial market data sources.
- Calculating the next valid execution time for market-open or market-close automation tasks.
- Integrating market-day logic into broader AI agent workflows using Openclaw Skills.
How Finance Calendar Works
- The user initializes the skill by syncing the latest market holiday data for the desired region (US, CN, or HK).
- Using the check command, the skill references the local calendar to determine if a date falls on a weekend or a market holiday.
- For scheduling, the user inputs a desired time and market; the skill then calculates the next valid trading timestamp.
- Developers can integrate this logic into the /loop command to create conditional workflows that only fire on active trading days.
- Programmatic APIs allow other agents within the Openclaw Skills environment to query market status in real-time.
Finance Calendar Setup
To get started with Finance Calendar in your environment, follow these steps:
- Sync the global trading calendars:
/finance-cron sync
- Verify the US market status for today:
/finance-cron check US
- Plan a task for the next market open:
/finance-cron add US 09:30 "echo 'Market is open'"
Finance Calendar Data Schema & Taxonomy
The skill maintains a structured database of market hours and holidays to ensure accuracy across different timezones.
| Market Code | Region | Timezone | Trading Hours (Local) |
|---|---|---|---|
| US | United States | America/New_York | 09:30 - 16:00 |
| CN | China | Asia/Shanghai | 09:30 - 15:00 |
| HK | Hong Kong | Asia/Hong_Kong | 09:30 - 16:00 |
All planned tasks are stored with metadata including the target market, the command string, and the calculated next_run_time.
Finance Calendar Advanced Features
- Multi-market synchronization support to manage global portfolios simultaneously.
- Native integration with the /loop command for robust, trading-day-aware task automation.
- Comprehensive TypeScript API for building custom extensions atop the Openclaw Skills framework.
- Automated holiday data fetching to ensure scheduling remains accurate year-after-year.
- Quiet mode execution for seamless background processing in complex automation chains.
SKILL.md
Loading
Related Openclaw Skills
Bible Q&A
A specialized AI agent skill designed to provide structured, context-aware answers to biblical questions regarding passages, figures, and themes.
Email IMAP/SMTP
A robust automation skill for interacting with email mailboxes via standard IMAP and SMTP protocols using password or OAuth2 authentication.
TRON Transaction Decoder (TronGrid)
A specialized tool for querying, decoding, and analyzing TRON blockchain transactions with granular detail on resource consumption and contract interactions.
Sermon Outline
An AI agent skill designed to generate structured, scripture-referenced sermon outlines from any passage or theme.
CN Weather Explorer
An authoritative weather retrieval skill for Openclaw Skills that fetches real-time meteorological data directly from the China Meteorological Administration.
Feedback Loop
A comprehensive framework for collecting, analyzing, and acting on user feedback to drive the continuous improvement of AI agents.
Featured*
