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:

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 is tagged as urgent (see Urgency Rules below).

Outgoing messages you generate during sleep

When you (or any agent) are about to send a proactive message — status updates, recaps, reports, heartbeats — use gate.js instead of sending directly. It handles the sleep check and queuing automatically:

node ~/.openclaw/skills/sleep-snooze/scripts/gate.js \
  --provider <provider> \
  --sender-id <agent-id> \
  --sender-name "<Agent Name>" \
  --message "<full message text>"

Exit codes:

• 0 — sleeping, message was queued — do NOT send
• 2 — sleeping but urgent — send with 🚨 prefix
• 3 — awake — send normally

Use gate.js for ALL outgoing messages. It checks the actual current time against the schedule, so it works even if the sleep-mode cron did not run.

Urgency Rules