Family Calendar Aggregation & Household Assistant
Turn OpenClaw into an always-on household coordinator that aggregates family calendars into a morning briefing, monitors messages for actionable items, and manages household logistics through a shared chat interface.
Requirements
- Calendar API access, such as Google Calendar or Apple Calendar via
ical. - The
imessageskill for message monitoring (macOS only). - Telegram or Slack for the shared family chat interface.
- File system access for inventory tracking.
- Camera/photo processing for OCR of physical calendars.
How to use
This use case benefits heavily from running on a home Mac Mini, thanks to iMessage integration, Apple Calendar, and always-on availability.
Start read-only: begin with calendar reading and message monitoring before enabling write actions such as creating events or sending messages.
A shared Telegram channel gives both partners visibility into what the agent is doing, which builds trust and catches errors early.
- Calendar aggregation:
## Calendar Sources
On morning briefing (8:00 AM):
1. Fetch my Google Work Calendar (read-only OAuth)
2. Fetch shared Family Google Calendar
3. Fetch partner's calendar (shared view)
4. Check ~/Documents/school-calendars/ for any new PDFs → OCR and extract events
5. Check recent emails for calendar attachments or event invitations
Compile into a single briefing:
- Today's events (all calendars, color-coded by source)
- Upcoming 3-day lookahead for conflicts
- Any new events added since yesterday
- Weather context for outdoor events
Deliver via Telegram/Slack family channel.
- Set up ambient message monitoring, where the agent watches passively and acts when it recognizes something actionable.
## Message Monitoring (HEARTBEAT.md)
Every 15 minutes:
1. Check new iMessages across all conversations
2. Detect appointment-like patterns:
- "Your appointment is confirmed for..."
- "Can we meet on [date] at [time]?"
- "Practice moved to Saturday at 3pm"
3. When detected:
- Create calendar event with details
- Add 30-minute driving buffer before AND after
- Send confirmation to family Telegram: "Created: Dentist appointment, Tue 2pm. Added drive time 1:30-2:00 and 3:00-3:30."
- If relevant to partner, add invite
4. Detect promise/commitment patterns:
- "I'll send that over by Friday"
- "Let's do dinner next week"
→ Create calendar hold or reminder
- Maintain a household inventory that either partner can query.
## Pantry Tracking
Maintain ~/household/inventory.json with:
- Item name, quantity, location (fridge/pantry/basement)
- Last updated timestamp
- Low-stock threshold
Update methods:
- Photo: User sends photo of fridge/pantry → vision model extracts items
- Text: "We're out of eggs" / "Bought 2 gallons of milk"
- Receipt: Photo of grocery receipt → update inventory
Query: Either partner can ask via Telegram:
- "Do we have butter?" → Check inventory, respond with location and quantity
- "What's running low?" → List items below threshold
- "Generate grocery list" → Compile low-stock items + any recipe ingredients needed
Links
Source: hesamsheikh/awesome-openclaw-usecases and its contributors. License: MIT.
Copyright (c) 2026
Translation and editorial adaptation by ClawCases.
>Resources
>Related Use Cases
AI-Powered Earnings Tracker
Stay on top of earnings season across dozens of tech companies without manually checking multiple sources and remembering report dates for every AI/tech earnings report.
AI Video Editing via Chat
Describe your edit to an agent to trim videos, add music, subtitles, or crops — no timeline or GUI. Install two skills, then editing is done by conversation.
GitHub via gh: PRs, Issues, Actions and API
Drive GitHub work with gh for repositories, PRs, issues, Actions runs and API data, and keep a PR task active until it is verified as merged on GitHub.