Reminder

Name: Reminder
Rating: 3.5 (1 reviews)
Author: ShaneTanDev

By ShaneTanDev 👁 7 views ▲ 0 votes

Cross-channel reminder & todo plugin for OpenClaw

GitHub

Install

npm install
```

Configuration Example

{
  "plugins": {
    "allow": ["reminder"],
    "entries": {
      "reminder": { "enabled": true, "config": {} }
    },
    "installs": {
      "reminder": {
        "source": "path",
        "sourcePath": "/Users/<you>/.openclaw/extensions/reminder",
        "installPath": "/Users/<you>/.openclaw/extensions/reminder",
        "version": "1.0.0",
        "installedAt": "2026-01-01T00:00:00.000Z"
      }
    }
  }
}

README

# openclaw-reminder

Cross-channel reminder & todo plugin for [OpenClaw](https://openclaw.ai).

## Features

- **Multi-user profiles** — bind your name from any channel; same profile works across Discord, Telegram, Feishu, Slack, etc.
- **Unified item model** — no distinction between reminders and todos; items with a time get advance notifications, items without time appear in a daily digest
- **Timed notifications** — 1h / 30min / 10min before due
- **Important items** — ping every 2 hours to all bound channels until completed
- **Daily digest** — untimed items delivered at 7:00 AM in your timezone
- **Cross-platform identity** — link the same profile across platforms via a 6-char one-time Link Code
- **Google Calendar sync** — optional, via `gws` CLI (requires admin approval)
- **Zero LLM dependency** — all commands are intercepted before the agent via `before_dispatch` hook; no inference cost

## Installation

```bash
cd ~/.openclaw/extensions
git clone https://github.com/shanexintan/openclaw-reminder reminder
cd reminder
npm install
```

Then register in `~/.openclaw/openclaw.json`:

```json
{
  "plugins": {
    "allow": ["reminder"],
    "entries": {
      "reminder": { "enabled": true, "config": {} }
    },
    "installs": {
      "reminder": {
        "source": "path",
        "sourcePath": "/Users/<you>/.openclaw/extensions/reminder",
        "installPath": "/Users/<you>/.openclaw/extensions/reminder",
        "version": "1.0.0",
        "installedAt": "2026-01-01T00:00:00.000Z"
      }
    }
  }
}
```

Restart the gateway: `openclaw gateway restart`

## Commands

Send any of these in any bound channel:

| Command | Description |
|---------|-------------|
| `绑定 <Name>` | Create or join a profile |
| `绑定 <Name> <CODE>` | Join an existing profile via Link Code |
| `生成绑定码` | Generate a 6-char Link Code (5-min TTL) |
| `提醒我 <item> [time]` | Add a reminder |
| `todo <item>` | Add a todo (no time) |
| `完成 <id>` | Mark item as done |
| `我的清单` | List all pending items |
| `设置时区 <tz>` | Set timezone (e.g. `Asia/Shanghai`) |
| `绑定日历` | Request Google Calendar sync |
| `我的信息` | Show profile info |

## Admin CLI

```bash
node cli.js list-profiles
node cli.js list-pending          # pending calendar approvals
node cli.js approve-calendar <name>
node cli.js list-items <name>
node cli.js force-notify <item_id>
```

## Data

The SQLite database is stored at `~/.openclaw/reminder/reminder.db` (outside the extension directory, survives updates).

## License

MIT

channels