TrueTime is a high-fidelity time management skill that provides deterministic scheduling and timezone conversion for AI agents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install truetime
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 truetime 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 TrueTime?
TrueTime is designed to eliminate the common pitfalls of AI-driven scheduling, such as timezone drift, DST confusion, and stale numeric examples. By enforcing a UTC-first calculation policy and utilizing a deterministic Node.js runtime script, this skill ensures that every timer, reminder, and cron job is scheduled with absolute precision. It is an essential component for any Openclaw Skills implementation that requires cross-timezone coordination or millisecond-level accuracy.
The skill acts as a guardrail against ambiguous time inputs, forcing agents to read the current runtime clock rather than relying on cached values. Whether you are dealing with server time, user local time, or specific IANA timezones, TrueTime provides a consistent logical workflow to verify deltas before any execution occurs.
TrueTime Use Cases
- Scheduling cross-timezone meetings and reminders with automatic DST adjustment.
- Converting complex relative time expressions like 1.5 months or 0.1 years into precise UTC timestamps.
- Synchronizing agent actions with high-accuracy NTP-sourced time to avoid server clock skew.
- Generating Chinese lunar calendar dates for cultural context or specific planning needs.
- Managing cron operations and wake-up calls with millisecond fidelity.
How TrueTime Works
- The agent extracts the user's timing intent, preserving original values and unit hints.
- Current real time is fetched from the server clock or a public NTP source.
- The relative or absolute time expression is parsed into a precise delta using the true_time.mjs helper script.
- A canonical target time is computed in UTC first to establish a reliable source of truth.
- The UTC target is converted into the user's requested timezone and server timezone for presentation.
- The system verifies that the calculated delta matches the intent before triggering any scheduled action.
TrueTime Setup
TrueTime requires a Node.js runtime within your sandbox environment. Ensure your environment is configured to run the included helper scripts.
# List available timezones
node scripts/true_time.mjs --list-timezones
# Example: Calculate time 1.5 hours from now in a specific timezone
node scripts/true_time.mjs --plus 1.5h --user-tz America/New_York
# Example: Calculate an absolute target with DST awareness
node scripts/true_time.mjs --target 2026-11-01T01:30:00 --target-tz America/Los_Angeles
TrueTime Data Schema & Taxonomy
TrueTime returns a structured data contract to ensure all downstream operations for Openclaw Skills remain consistent:
| Field | Type | Description |
|---|---|---|
now_utc |
ISO String | The current time at the moment of calculation. |
target_utc |
ISO String | The final calculated UTC timestamp for execution. |
delta_milliseconds |
Number | The exact difference between now and target in ms. |
time_source |
String | 'server' or 'ntp' depending on the configuration used. |
target_lunar |
Object | Chinese lunar calendar representation of the target date. |
target_user_tz |
String | The human-readable time in the user's local zone. |
TrueTime Advanced Features
- NTP Integration: Sync with external time servers (e.g., time.google.com) to bypass local server clock inaccuracies.
- DST Guardrails: Identifies and handles ambiguous local times during fall-back overlaps or spring-forward gaps.
- Calendar-Aware Arithmetic: Supports decimal inputs for months, years, and decades while accounting for varying month lengths and leap years.
- Lunar Calendar Awareness: Full support for Chinese lunar date fields, including lunar timezone configurations.
- Multi-Unit Support: Recognizes units ranging from milliseconds and seconds up to centuries and decades.
SKILL.md
Loading
Related Openclaw Skills
Model Alias Append
An automated transparency tool that appends the specific model alias to every AI agent response for clear attribution and configuration tracking.
Wayfound
A lightweight self-supervision skill that enables AI agents to conduct daily performance reviews and improve their long-term memory through structured reflection.
Deaddrop Agent Messaging
Deaddrop is a specialized agent-to-agent messaging platform that enables AI agents to discover each other by capability and collaborate through asynchronous communication.
Midjourney
A powerful AI art generation skill for creating, upscaling, and blending high-fidelity images through the Midjourney Discord bot.
Scrapling Web Scraping
An advanced web scraping and crawling guidance skill designed for MCP-native environments to handle everything from static HTML to complex anti-bot systems.
Qinglite Platform Integration
An automation skill for the Qinglite platform that handles secure mobile login and multi-format content publishing including articles, images, and videos.
Featured*
