A natural-language personal assistant that captures events into a git-synced workspace and schedules automated Telegram notifications.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install reminder
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 reminder 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 Reminder Secretary?
The Reminder Secretary is a lightweight yet powerful tool designed to transform how you manage your time within the Openclaw Skills ecosystem. By interpreting natural language in both English and Chinese, it allows you to quickly log meetings, deadlines, and birthdays without fumbling through complex calendar interfaces.
What sets this skill apart is its commitment to data sovereignty and portability. It separates execution logic from your personal data, storing all captured events in a structured YAML file within your workspace. This architecture ensures that your schedule remains easily searchable, human-readable, and perfectly synced across devices using Git or claw-roam. Whether you are managing professional milestones or personal anniversaries, this skill provides a seamless bridge between conversation and organization.
Reminder Secretary Use Cases
- Scheduling recurring work meetings or one-off client calls using simple chat commands.
- Tracking birthdays, including complex lunar calendar conversions, with automated annual reminders.
- Setting multi-stage alerts for project deadlines (e.g., 24 hours and 1 hour before).
- Querying your upcoming agenda for the next week during a morning routine.
- Maintaining a decentralized, version-controlled record of all personal and professional commitments.
How Reminder Secretary Works
- The skill parses natural language input to identify the event title, date, time, and any recurrence patterns.
- If the input is ambiguous—such as relative dates like next Friday—the agent asks minimal clarifying questions to resolve the exact timestamp.
- The structured data is written to the events.yml file located in the user's local workspace directory.
- Using the integrated Openclaw Skills cron system, the skill schedules precise Telegram notifications based on the user's preferred offsets.
- Users can query the agent at any time to summarize upcoming events, which are then read and formatted from the local storage.
Reminder Secretary Setup
To get started with the Reminder Secretary, configure your environment variables and prepare your workspace directory:
# Set your preferred timezone
export REMINDER_TZ="Asia/Shanghai"
# Configure notification triggers (minutes before event)
export REMINDER_OFFSETS_MINUTES="1440,60,10"
# Create the workspace storage path
mkdir -p ~/.openclaw/workspace/reminders/
Reminder Secretary Data Schema & Taxonomy
All data is organized in a clear YAML schema to facilitate easy backups and manual edits if necessary.
| Attribute | Description |
|---|---|
| title | The descriptive name of the reminder or event |
| start_datetime | The resolved date and time in ISO 8601 format |
| notes | Optional context or additional details provided by the user |
| offsets | Integer list of minutes before the event to send Telegram alerts |
| repeat | Recurrence settings such as weekly, monthly, yearly, or lunar |
Data is saved locally at: ~/.openclaw/workspace/reminders/events.yml
Reminder Secretary Advanced Features
- Full support for lunar calendar birthdays with intelligent leap month handling.
- Git-ready data structure for seamless synchronization via claw-roam across multiple machines.
- Multi-language natural language processing for English and Chinese command recognition.
- Integrated cron management that automatically removes or updates jobs when events are modified.
- Flexible query system that generates on-demand summaries of upcoming daily or weekly plans.
SKILL.md
Loading
Related Openclaw Skills
Knowledge Base Collector
A versatile tool for archiving URLs and screenshots into a tag-first, searchable personal knowledge base.
DB Read-Only Skill
A secure interface for executing read-only SQL queries against PostgreSQL and MySQL databases without risk of data modification.
Claw Roam
A Git-powered synchronization engine to keep your AI agent workspace consistent across local machines and remote servers.
Bitfinex Lending Monitor
Automate the monitoring and reporting of Bitfinex funding interest and wallet balances through secure API integration.
Seedance 3x3 Optimizer
An AI-powered script optimizer that converts narrative plots into structured 9-segment visual scripts specifically for Seedance video generation.
Fence Quote Calculator
A precision material takeoff tool for calculating fencing components including posts, rails, pickets, and hardware for wood, vinyl, and aluminum projects.
Featured*
