A powerful Model Context Protocol skill for retrieving formatted system time, managing global timezones, and calculating precise time intervals.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install system-time
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 system-time 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 System Time?
The System Time skill is a robust utility designed to provide AI agents with comprehensive temporal awareness. Part of the Openclaw Skills library, it bridges the gap between raw system clocks and actionable data, supporting a vast array of international standards including ISO 8601, Unix timestamps, and localized formatting.
By leveraging this skill, developers can ensure their agents accurately handle cross-timezone coordination and time-sensitive logic. Whether you need to fetch the current time in Tokyo or calculate the exact duration between two historical events, this skill provides the necessary technical infrastructure through a standardized Model Context Protocol interface.
System Time Use Cases
- Retrieving the current system date and time in specific formats like ISO 8601 or localized Chinese.
- Converting between global timezones such as Asia/Shanghai, America/New_York, and Europe/London for international scheduling.
- Calculating the precise duration or difference between two specific timestamps or dates in days, hours, and minutes.
- Synchronizing scheduled tasks, reminders, and automated triggers within an AI agent workflow.
- Transforming raw Unix timestamps into human-readable structures for data analysis and logging.
How System Time Works
- The AI agent triggers the get_current_time tool, passing optional parameters for desired formatting (e.g., iso, timestamp, or full) and timezone.
- The skill accesses the system clock via Node.js and processes the request using the @modelcontextprotocol/sdk.
- If detailed information is required, the get_time_info tool decomposes the temporal data into granular components like milliseconds and day-of-the-week.
- For interval logic, the calculate_time_diff tool parses start and end points to return a structured breakdown of the elapsed time.
System Time Setup
To integrate this skill into your environment, ensure you have Node.js and TypeScript installed. Follow these steps to prepare the Openclaw Skills environment:
# Install dependencies
npm install
# Build the TypeScript project
npm run build
After building, configure your MCP-compliant host (such as Claude Desktop or a custom agent) to point to the resulting build directory to enable the time tools.
System Time Data Schema & Taxonomy
The skill organizes time data into structured outputs. Below is a summary of the metadata and parameters used:
| Parameter | Type | Description |
|---|---|---|
| format | String | Options: iso, date, time, datetime, full, timestamp, detailed |
| timezone | String | IANA timezone string (e.g., "Asia/Tokyo") |
| start_time | String/Number | ISO string or Unix timestamp for calculations |
| end_time | String/Number | Ending point for difference calculation (defaults to now) |
| time_info | Object | Contains year, month, day, weekday, hours, minutes, seconds, and ms |
System Time Advanced Features
- Multi-format support including standard ISO 8601 and detailed Chinese localized strings with weekday names.
- Global timezone conversion support for all IANA-standard locations.
- High-precision temporal data including millisecond-level detail for technical auditing.
- Automatic unit conversion for time differences, capable of handling complex spans from seconds to multiple days.
- Full compatibility with the Openclaw Skills ecosystem for cross-agent collaboration and automated workflows.
SKILL.md
Loading
Related Openclaw Skills
WebSocket Reconnect
A sophisticated WebSocket management tool providing automated recovery through exponential backoff, jittered retries, and circuit breaker patterns.
HTTP Retry + Circuit Breaker Skill
A robust HTTP client extension for Openclaw Skills that implements exponential backoff retries and circuit breaker patterns to drastically reduce API failure rates.
Batch Processing DataLoader
Eliminate N+1 query overhead by batching and caching database or API requests into efficient single operations.
Claude Code Launcher
A terminal automation skill that launches Claude Code and automatically enables Remote Control for seamless multi-device coding sessions.
ATXP: Agent Infrastructure & Paid Tools
ATXP provides a unified infrastructure for AI agents to manage identity, fund wallets, and access a suite of paid API tools including web search and media generation.
ATXP: Agent Infrastructure & Paid Tools
A comprehensive infrastructure layer providing AI agents with a funded identity, wallet, and access to a suite of paid productivity and generative tools.
Featured*
