reminders

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Reminders Skill

提醒Skill

Set and manage one-time or recurring reminders. Stores all data locally in SQLite. No external APIs required.

设置和管理一次性或周期性提醒，所有数据本地存储在SQLite中，无需调用外部API。

Features

特性

One-time reminders: Set reminders for specific dates/times
Recurring reminders: Daily, weekly, or monthly recurring reminders
Natural language parsing: "in 2 hours", "tomorrow", "14:30"
Snooze functionality: Temporarily dismiss reminders
Daemon mode: Check for due reminders (for cron/systemd integration)
SQLite storage: All data stored locally

一次性提醒：为特定日期/时间设置提醒
周期性提醒：支持每日、每周、每月维度的重复提醒
自然语言解析：支持“2小时后”、“明天”、“14:30”这类自然表述
贪睡功能：暂时关闭提醒延后触发
守护进程模式：自动检查到期提醒（可与cron/systemd集成）
SQLite存储：所有数据均存储在本地

Capabilities

功能说明

Add a one-time reminder

添加一次性提醒

bash

npx reminders add "<datetime>" "<message>"

Datetime formats:

```
"2026-02-15 14:00"
```
- Specific date and time
```
"tomorrow"
```
- Tomorrow at current time
```
"in 2 hours"
```
- Relative time
```
"in 30 minutes"
```
- Relative time in minutes
```
"in 3 days"
```
- Relative time in days
```
"14:30"
```
- Today at specific time (or tomorrow if passed)

Examples:

bash

npx reminders add "in 30 minutes" "Call mom"
npx reminders add "tomorrow" "Dentist appointment"
npx reminders add "2026-02-15 09:00" "Team meeting"
npx reminders add "14:30" "Standup meeting"

bash

npx reminders add "<datetime>" "<message>"

支持的日期时间格式：

```
"2026-02-15 14:00"
```
- 明确的日期和时间
```
"tomorrow"
```
- 明天的同一时间
```
"in 2 hours"
```
- 相对时间（小时级）
```
"in 30 minutes"
```
- 相对时间（分钟级）
```
"in 3 days"
```
- 相对时间（天级）
```
"14:30"
```
- 今日的指定时间（如果当前时间已过则默认明天同时间）

示例：

bash

npx reminders add "in 30 minutes" "Call mom"
npx reminders add "tomorrow" "Dentist appointment"
npx reminders add "2026-02-15 09:00" "Team meeting"
npx reminders add "14:30" "Standup meeting"

Add a recurring reminder

添加周期性提醒

bash

npx reminders recurring <type> "<time>" "<message>"

Types:

daily

weekly

monthly

Examples:

bash

npx reminders recurring daily "09:00" "Take vitamins"
npx reminders recurring weekly "Monday 10:00" "Weekly review"
npx reminders recurring monthly "1st 12:00" "Pay rent"

bash

npx reminders recurring <type> "<time>" "<message>"

类型可选值：

daily

weekly

monthly

示例：

bash

npx reminders recurring daily "09:00" "Take vitamins"
npx reminders recurring weekly "Monday 10:00" "Weekly review"
npx reminders recurring monthly "1st 12:00" "Pay rent"

List reminders

列出提醒

bash

npx reminders list                    # List pending reminders
npx reminders list --all              # Include completed
npx reminders list --limit 20         # Limit results

bash

npx reminders list                    # 列出待触发的提醒
npx reminders list --all              # 包含已完成的提醒
npx reminders list --limit 20         # 限制返回结果数量

List due reminders

列出来期提醒

bash

npx reminders due                     # Show reminders that are due now

bash

npx reminders due                     # 展示当前已到期的提醒

Get reminder details

获取提醒详情

bash

npx reminders get <id>

bash

npx reminders get <id>

Complete a reminder

标记提醒为已完成

bash

npx reminders complete <id>

For recurring reminders, this schedules the next occurrence. For one-time reminders, it moves to history.

bash

npx reminders complete <id>

对于周期性提醒，该操作会自动调度下一次触发时间；对于一次性提醒，该操作会将其移入历史记录。

Snooze a reminder

延后提醒（贪睡）

bash

npx reminders snooze <id> <minutes>

Example:

bash

npx reminders snooze 123 30          # Snooze for 30 minutes

bash

npx reminders snooze <id> <minutes>

示例：

bash

npx reminders snooze 123 30          # 延后30分钟触发

Delete a reminder

删除提醒

bash

npx reminders delete <id>

bash

npx reminders delete <id>

View history

查看历史记录

bash

npx reminders history                 # Show completed reminders
npx reminders history --limit 50      # Show last 50

bash

npx reminders history                 # 展示已完成的提醒
npx reminders history --limit 50      # 仅展示最近50条

View statistics

查看统计数据

bash

npx reminders stats                   # Show pending, completed, overdue counts

bash

npx reminders stats                   # 展示待处理、已完成、逾期的提醒数量

Daemon mode

守护进程模式

Check for due reminders (for use with cron or systemd):

bash

npx reminders daemon                  # Output JSON with due reminders

Cron example:

cron

undefined

检查到期提醒（供cron或systemd集成使用）：

bash

npx reminders daemon                  # 输出包含到期提醒的JSON数据

Cron配置示例：

cron

undefined

Check for reminders every minute

每分钟检查一次提醒

- - - - /usr/bin/node /path/to/dist/cli.js daemon | some-notifier

undefined

- - - - /usr/bin/node /path/to/dist/cli.js daemon | some-notifier

undefined

Health check

健康检查

bash

npx reminders health                  # Check database status

bash

npx reminders health                  # 检查数据库运行状态

Test natural language parsing

测试自然语言解析

bash

npx reminders parse "in 2 hours"      # Test how a datetime string is parsed

bash

npx reminders parse "in 2 hours"      # 测试日期时间字符串的解析结果

Storage

存储说明

SQLite database at

~/.openclaw/skills/reminders/reminders.db

```
reminders
```
- All active reminders with schedule info
```
history
```
- Completed one-time reminders

SQLite数据库存储路径为

~/.openclaw/skills/reminders/reminders.db

，包含两张表：

```
reminders
```
- 存储所有待触发的提醒及调度信息
```
history
```
- 存储已完成的一次性提醒

API Usage

API使用方法

typescript

import { RemindersSkill } from '@openclaw/reminders';

const reminders = new RemindersSkill();

// Add a one-time reminder
const reminder = await reminders.addReminder({
  message: "Call mom",
  scheduledAt: new Date("2026-02-15T14:00:00"),
});

// Parse natural language datetime
const when = reminders.parseNaturalDateTime("in 2 hours");
await reminders.addReminder({
  message: "Take a break",
  scheduledAt: when,
});

// Add recurring reminder
await reminders.addRecurringReminder({
  message: "Take vitamins",
  type: "daily",
});

// List due reminders
const due = await reminders.getDueReminders();

// Complete a reminder
await reminders.completeReminder(reminder.id);

// Snooze for 30 minutes
await reminders.snoozeReminder(reminder.id, 30);

// Close connection
await reminders.close();

typescript

import { RemindersSkill } from '@openclaw/reminders';

const reminders = new RemindersSkill();

// 添加一次性提醒
const reminder = await reminders.addReminder({
  message: "Call mom",
  scheduledAt: new Date("2026-02-15T14:00:00"),
});

// 解析自然语言格式的时间
const when = reminders.parseNaturalDateTime("in 2 hours");
await reminders.addReminder({
  message: "Take a break",
  scheduledAt: when,
});

// 添加周期性提醒
await reminders.addRecurringReminder({
  message: "Take vitamins",
  type: "daily",
});

// 列出来期提醒
const due = await reminders.getDueReminders();

// 标记提醒为已完成
await reminders.completeReminder(reminder.id);

// 延后30分钟触发
await reminders.snoozeReminder(reminder.id, 30);

// 关闭数据库连接
await reminders.close();

No External Dependencies

无外部依赖

This skill works entirely offline:

No API keys required
No external services
All data stored in local SQLite
Natural language parsing is done locally

本Skill完全支持离线运行：

无需API密钥
不依赖外部服务
所有数据存储在本地SQLite中
自然语言解析全部在本地完成