A powerful background utility for setting precise timers, alarms, and reminders through your AI coding agent.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install timer
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 timer 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 Timer Skill?
The Timer skill provides a robust mechanism for managing time-sensitive tasks without blocking your agent's primary workflow. By running as a background process, this tool allows for the creation of multiple concurrent countdowns for everything from deep-work sessions to meeting reminders. It is an essential component of the Openclaw Skills ecosystem, designed to ensure that technical users never lose track of time during complex development cycles.
This skill is particularly useful for developers who need to bridge the gap between long-running scripts and the need for immediate human attention. It handles various time formats and provides clear feedback, making it a reliable choice for any automated environment where timing is critical.
Timer Skill Use Cases
- Running Pomodoro sessions to balance coding sprints and breaks.
- Setting alerts for time-boxed research or debugging tasks.
- Managing multiple kitchen or household timers during remote work.
- Creating reminders for upcoming calendar events or meeting starts.
- Notifying users when a specific wait period for a background process has elapsed.
How Timer Skill Works
- The agent executes a background bash command to trigger the timer script with a specified duration and label.
- The timer logic parses the input, supporting formats like seconds, minutes, hours, or HH:MM:SS.
- The process runs independently in the background, logging progress updates to the session log.
- When the countdown reaches zero, the script triggers a system notification and exits with a success code.
- The agent receives a system message indicating completion and must provide a direct response to the user to relay the alert.
Timer Skill Setup
To use this within your Openclaw Skills setup, ensure you have Node.js installed on your system. You can initiate a timer using the following command syntax:
# Example: Set a 5-minute timer with a custom message
bash background:true command:"node {baseDir}/timer.js 5m 'Time to check the deployment'"
Timer Skill Data Schema & Taxonomy
The Timer skill utilizes the following parameters and process metadata to organize its operations:
| Parameter | Description | Examples |
|---|---|---|
| Time Format | Flexible duration strings | 30s, 10m, 1h, 5:30, 1:00:00 |
| Label | Optional reminder text | 'Take a break', 'Check logs' |
| Session ID | Unique identifier for background tracking | Generated by the agent host |
| Exit Status | Process completion code | 0 (Completed), 130 (Cancelled) |
Timer Skill Advanced Features
- Support for multiple concurrent timers running as independent background sessions.
- macOS audio integration using afplay for audible completion alerts.
- Full process lifecycle management including list, poll, log, and kill actions.
- Specialized notification handling logic designed to bypass common message filters in Openclaw Skills.
- Real-time progress logging for long-duration timers.
SKILL.md
Loading
Related Openclaw Skills
PaddleOCR Document Parsing
A sophisticated document processing skill that converts images and PDFs into structured Markdown with layout preservation via the PaddleOCR API.
Reddit Spy
A stealth intelligence tool for analyzing subreddits, user patterns, and content strategies without detection or blocking.
PrepSPSC PYQ
A professional-grade API skill for searching 7,400+ Sikkim PSC previous year questions and generating difficulty-balanced mock tests for Indian government exams.
MiniMax MCP Search Skill
A powerful search and vision skill for AI agents using MiniMax MCP to fetch live web data and analyze images.
Withings Health Integration
A comprehensive health data retrieval skill that connects AI agents to the Withings API for weight, activity, and sleep analysis.
Visual Creative Prompt Generator
A sophisticated prompt engineering skill designed to turn vague visual concepts into high-fidelity, creative AI image generation instructions.
Featured*
