A specialized utility for Openclaw Skills that enforces correct local time reporting and prevents the common error of treating UTC as local time.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install agent-timezone-lock
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 agent-timezone-lock 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 Agent Timezone Lock?
The Agent Timezone Lock is a critical utility designed to eliminate temporal confusion within your AI workflows. By integrating this into your Openclaw Skills ecosystem, you ensure that your agent remains aware of the user's specific local time rather than defaulting to system UTC. This skill actively patches agent instructions and provides dedicated scripts to validate and report time accurately, making it indispensable for time-sensitive automation and scheduling tasks.
By establishing a source of truth for temporal data, this skill prevents the classic UTC-as-local mistake that often makes AI agents appear broken or unreliable. It acts as a bridge between raw system timestamps and the user's actual context, ensuring every time-related interaction is precise and context-aware.
Agent Timezone Lock Use Cases
- Preventing agents from providing incorrect meeting times due to UTC offsets.
- Correcting timestamps from external APIs, system logs, or cron jobs into a human-readable local format.
- Maintaining consistent time awareness during heartbeat integrations and periodic status checks within Openclaw Skills.
- Providing users with a simple /timezone command to verify or update their current environment settings.
How Agent Timezone Lock Works
- The skill initializes by reading the specific IANA timezone string defined in the USER.md configuration file.
- It executes a setup script to generate a persistent configuration and update the agent's standing instructions in AGENTS.md.
- Whenever a time-related query is triggered, the agent calls a specialized Python script to fetch the verified local time.
- The system actively monitors for UTC traps, such as timestamps ending in Z or +00:00, and converts them before the agent reports them.
- It performs drift detection during heartbeats to ensure the agent's internal clock remains synchronized with the user's reality.
Agent Timezone Lock Setup
To get started with this component of your Openclaw Skills, ensure your USER.md contains a valid IANA timezone string:
# Example USER.md entry:
# Timezone: America/New_York
# Run the initialization script to configure the agent:
python3 /opt/openclaw/workspace/skills/timezone/scripts/timezone_setup.py
Agent Timezone Lock Data Schema & Taxonomy
| File | Description |
|---|---|
| USER.md | Primary source for the IANA timezone string (e.g., Timezone: Europe/London). |
| tz_config.json | Persistent storage for the validated timezone configuration used by scripts. |
| now.py | The execution script used to fetch and format the current local time. |
| AGENTS.md | Updated with standing rules to prioritize local time over UTC guesses. |
Agent Timezone Lock Advanced Features
- Interactive /timezone command for real-time configuration updates and verification within the Openclaw Skills environment.
- Automatic UTC trap detection that flags ambiguous timestamps from APIs or system logs.
- Self-correction logic that identifies time drift during agent heartbeats to maintain accuracy.
- Strict IANA validation during setup to prevent runtime errors caused by invalid timezone abbreviations like EST or PST.
SKILL.md
Loading
Related Openclaw Skills
Dogs API Breed Encyclopedia
A structured dog breed encyclopedia providing detailed attributes, temperament data, and random facts via the Model Context Protocol.
Pipeworx Domain Search
A specialized search tool for identifying registered domain names across various TLDs using the Domainsdb.info database.
QWeather: Real-time Weather and Alerts
A comprehensive weather integration providing real-time conditions, multi-day forecasting, and severe weather alerts via the QWeather API.
GOG Cleanup Reminder
Automate the identification of inactive GOG games and sync cleanup tasks directly to Apple Reminders and your inbox.
Pipeworx D&D 5th Edition
A comprehensive reference tool providing programmatic access to D&D 5th Edition SRD data including spells, monsters, and character classes.
Pipeworx DNS
A high-performance DNS lookup utility that enables AI agents to query domain records and resolve IP addresses through secure DNS-over-HTTPS.
Featured*
