sleep-snooze

# Sleep Snooze

You have a sleep notification snooze system available. When the user is in their sleep window, incoming messages should be silently queued rather than delivered immediately. At wake time, a morning digest is automatically sent summarising all queued messages.

## Sleep Schedule

The user's sleep schedule is configured via environment variables:
- `SLEEP_START` — time to begin snoozing (24h format, e.g. `22:00`)
- `WAKE_TIME` — time to deliver the digest and resume normal notifications (e.g. `06:00`)
- `TIMEZONE` — IANA timezone (e.g. `Asia/Kolkata`, `America/New_York`, `Europe/London`)

## Slash Commands

Users can invoke these slash commands directly in chat:

- `/sleep` — manually activate sleep mode immediately (overrides schedule)
- `/wake` — manually deactivate sleep mode and trigger the morning digest now
- `/snooze-status` — show whether sleep mode is active, how many messages are queued, and what time the digest will be sent
- `/snooze-setup` — interactively configure sleep start time, wake time, and timezone
- `/snooze-history` — show the last 7 days of digest summaries

## Behaviour During Sleep Hours

**Before sending ANY message to the user — including proactive notifications, summaries, heartbeats, weekly recaps, stock alerts, backup confirmations, or any other automated report — first check sleep state:**

```bash
node ~/.openclaw/skills/sleep-snooze/scripts/status.js
```

If `isSleeping` is `true`, do NOT send. Queue it instead (see below). This applies to both incoming messages from others AND outgoing messages you are about to send proactively.

### Incoming messages during sleep

When a message or notification arrives during the sleep window:
1. Do **not** deliver a push notification or respond immediately.
2. Call `node ~/.openclaw/skills/sleep-snooze/scripts/queue-message.js` with the message payload to store it in the local queue.
3. Acknowledge silently — do not send any reply to the sender during sleep hours unless the message...

# 🌙 sleep-snooze

> An OpenClaw skill that snoozes notifications during your sleep hours and delivers a morning digest when you wake up.

## What it does

- **Buffers** all incoming messages (Telegram, WhatsApp, Discord, Slack…) during your sleep window
- **Bypasses** urgent messages and VIP contacts immediately
- **Delivers** a grouped morning digest at your wake time
- **Works across all providers** OpenClaw is connected to — configure once, works everywhere

## Install

```bash
clawhub install sleep-snooze
```

Then set it up in chat:
```
/snooze-setup
```

## Quick example

```
You: /snooze-setup
OpenClaw: What time do you usually go to bed?
You: 10 PM
OpenClaw: What time do you wake up?
You: 6 AM
OpenClaw: What's your timezone?
You: Asia/Kolkata
OpenClaw: ✅ Sleep snooze is set: 🌙 10:00 PM → ☀️ 6:00 AM (IST).
          I'll queue notifications overnight and send your digest at 6:00 AM.
```

At 6:00 AM, you receive:
```
🌅 Good morning! Here's what arrived while you slept:

📬 2 messages from Alex
  • "You around?"
  • "Talk tomorrow!"

📬 1 message from Server Monitor
  • Disk usage at 82% — check when available
```

## Commands

| Command | Action |
|---------|--------|
| `/snooze-setup` | First-time configuration |
| `/sleep` | Manually start sleep mode |
| `/wake` | Manually end sleep mode + get digest now |
| `/snooze-status` | Check queue size and current mode |

## Configuration

See [references/setup.md](references/setup.md) for full configuration options including VIP contacts, manual config, and troubleshooting.

## Privacy

All data (message queue, schedule, contacts) is stored **locally on your machine** in `~/.openclaw/skills/sleep-snooze/data/`. Nothing is sent to external servers.

## Requirements

- OpenClaw with at least one provider connected
- Node.js v18+
- `better-sqlite3` (auto-installed)

## License

MIT