Skip to content

0xdippo/tool-daily-briefing

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Daily Briefing

Personalized morning briefing for OpenClaw agents — tuned entirely by config.

Generates a morning briefing from sources you configure: news by topic, weather, calendar, tasks, and platform alerts (Reddit, X, email, iMessage, Discord). Config-as-personality — you only see what you turn on.


Features

🗞️ News

  • Topic-based search (no API key needed, uses web search)
  • Configurable story count
  • Auto-deduplication across topics
  • Source diversity

☀️ Weather

  • No API key required
  • Just needs your city
  • Current conditions + forecast

📅 Calendar

  • Lookahead window (configurable)
  • Event summaries
  • Integration guide included

✅ Tasks

  • Points at a local file on disk
  • Supports plain text or JSON format
  • Shows what's due soon

🌐 Platform Alerts (Optional)

Each platform is opt-in with setup guide:

  • Reddit: Monitor subreddits for new posts/mentions
  • X (Twitter): Track mentions, DMs, keyword searches
  • Email: Unread count, VIP senders
  • iMessage: Recent messages, unread count
  • Discord: Server notifications, DMs, mentions

Tone Styles

Choose how you want your briefing to sound:

Tone Style Best For
casual Emoji, friendly language Relaxed morning read
professional Clean, structured, no fluff Work context, shared briefings
terse Just the hits, minimal prose Quick scan, time-crunched mornings

Quick Start

  1. Install the skill:

    openclaw skills install daily-briefing.skill
  2. Copy the sample config:

    cp skills/daily-briefing/assets/sample-briefing-config.json config/briefing-config.json
  3. Edit your config — enable sources, set your city, pick a tone

  4. Generate your first briefing:

    Tell your agent: "generate my briefing" or "brief me"
    

Configuration

Create config/briefing-config.json:

{
  "briefing": {
    "tone": "casual",
    "showSetupNeeded": true
  },
  "sources": {
    "news": {
      "enabled": true,
      "topics": ["AI", "startups", "crypto"],
      "maxStories": 5
    },
    "weather": {
      "enabled": true,
      "location": "San Francisco, CA"
    },
    "calendar": {
      "enabled": false,
      "lookaheadHours": 24
    },
    "tasks": {
      "enabled": false,
      "source": "tasks.txt"
    },
    "platforms": {
      "reddit": {
        "enabled": true,
        "subreddits": ["LocalLLaMA", "OpenAI"]
      },
      "twitter": { "enabled": false },
      "email": { "enabled": false },
      "imessage": { "enabled": false },
      "discord": { "enabled": false }
    }
  }
}

See references/config-schema.md for full options.


Setup Needed Section

If any enabled source isn't connected yet, the briefing ends with a Setup Needed section:

📋 Setup Needed
To get the most out of your briefing, connect these sources:

• Reddit: Run 'setup reddit' to authorize access
• Calendar: Add your Google Calendar credentials (see references/access-setup.md)

Always friendly, never a wall of text. Just the next step.


What's Included

Package Contents

  • SKILL.md: Quick start + tuning guide
  • scripts/: News fetcher, weather, platform integrations, briefing formatter
  • references/:
    • config-schema.md: Full config spec
    • access-setup.md: Per-source connection guides
    • news-fetching.md: Search algorithm details
    • briefing-format.md: Output format rules by tone
  • assets/sample-briefing-config.json: Realistic starter config

Triggers

The skill responds to:

  • "daily briefing"
  • "morning briefing"
  • "brief me"
  • "what's happening today"
  • "morning report"
  • "morning summary"
  • "set up my briefing"

Tuning Your Briefing

Want to… Do this
Change topics Edit sources.news.topics in your config
Limit story count Set sources.news.maxStories
Switch tone Change briefing.tone to casual, professional, or terse
Add weather Set sources.weather.enabled: true + your city
Add tasks Point sources.tasks.source at your task file
Add a platform Enable it in config, then follow the setup guide

Platform Integration

Each platform has optional setup in references/access-setup.md:

  • Reddit: OAuth app credentials
  • Twitter/X: API tokens (or cookie-based scraping fallback)
  • Email: IMAP credentials or Gmail API
  • iMessage: macOS only, requires local database access
  • Discord: Bot token or webhook URL
  • Calendar: Google Calendar API or iCal URLs

All are opt-in. Start with news + weather, add platforms when ready.


Examples

Casual Tone

☀️ Good morning!

🗞️ News You Care About
• AI: OpenAI announces GPT-5 with reasoning capabilities
• Startups: Y Combinator W24 batch raises $500M total
• Crypto: Bitcoin breaks $60k amid ETF approval rumors

☀️ Weather: San Francisco, CA
Currently 58°F, partly cloudy. High of 65°F today.

✅ Tasks Due Soon
• Finish quarterly report (due tomorrow)
• Call dentist to reschedule

🎯 You're all set!

Professional Tone

Daily Briefing — February 6, 2026

News
• OpenAI announces GPT-5 with enhanced reasoning capabilities
• Y Combinator W24 batch companies raise $500M in total funding
• Bitcoin surpasses $60,000 amid renewed ETF approval speculation

Weather: San Francisco, CA
Current: 58°F, partly cloudy
Forecast: High 65°F, low 52°F

Tasks
• Quarterly report due February 7
• Reschedule dentist appointment

Terse Tone

News: GPT-5 announced | YC W24 raises $500M | BTC >$60k
Weather: 58°F → 65°F, partly cloudy
Tasks: Quarterly report (tomorrow), call dentist

License

MIT


Contributing

Contributions welcome! This skill is part of the openclaw-skills collection.

To contribute:

  1. Fork this repo
  2. Make your changes
  3. Test with your OpenClaw agent
  4. Submit a PR with description

Support


Built with ❤️ for the OpenClaw community

About

Generates a morning briefing from sources you configure: news by topic, weather, calendar, tasks, and platform alerts (Reddit, X, email, iMessage, Discord). Config-as-personality — you only see what you turn on.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors