mail-summary（邮件摘要）

name: mail-summary description: Fetch Gmail emails from the last 24h, rank by importance, summarize into bullet points, and auto-create Google Calendar events for detected meetings.

Email & Calendar Assistant Skill

Description

This skill reads Gmail emails, ranks them by importance, summarizes each email into bullet points, and creates Google Calendar events if an email contains a meeting or interview that is not already on the calendar.

Capabilities

• Read emails (read-only)
• Rank emails by importance
• Summarize emails into bullet points
• Detect meeting/interview emails
• Create Google Calendar events (only when not already added)
• Auto-refreshes Google OAuth token as needed for uninterrupted access.

Installation

Via ClawHub (recommended):

clawhub install mail-summary

Manual:

git clone https://github.com/Russidan-Nadee/mail-summary.git ~/.openclaw/workspace/skills/mail-summary

Setup Instructions (First-Time Only)

Step 1 — Get Google API credentials

1. Go to Google Cloud Console
2. Create a new project (or select existing one)
3. In the left sidebar, go to APIs & Services → click Enable APIs and Services
4. Search and enable each of the following:

- Gmail API - Google Calendar API

1. In the left sidebar, go to APIs & Services → OAuth consent screen

- Click Get Started - Fill in App name and User support email → click Save and Continue - Under Audience → click Add Users → add your Google email → click Save

1. In the left sidebar, go to APIs & Services → Credentials
2. Click Create Credentials → OAuth client ID
3. Under Application type select Desktop app
4. Give it a name (e.g. Mail Summary) → click Create
5. Click Download JSON → you'll get a file named client_secret_*.json

Step 2 — Connect to the agent

1. Send the client_secret_*.json file to the agent as an attachment

- Via Telegram: send as a file (not photo) in your Clawdbot chat - Via Claude Desktop: drag and drop the file into the chat - Via other platforms: attach the file the same way you attach any document

1. The agent will print an authorization URL — click it to open in your browser
2. Log in with your Google account and click Allow
3. Your browser will redirect to a localhost page showing an error — this is normal
4. Copy the full URL from your browser address bar (starts with http://localhost/?...)
5. Paste that URL back to the agent

Step 3 — Done!

The agent will confirm: *"Auth complete. I can now access your Gmail and Google Calendar."*

From now on just say: "Summarize today's important emails"

Configuration

This skill uses a config.yaml file in the project root for runtime configuration. You can edit this file to control timezone, retry behavior, and logging level.

Example config.yaml:

timezone: Asia/Bangkok    # Timezone for calendar events (e.g. Asia/Bangkok, UTC, Asia/Tokyo)
max_retries: 5            # Max retry attempts for authentication and API calls
log_level: INFO           # Logging level: DEBUG, INFO, WARNING, ERROR, CRITICAL

Agent Instructions

See agent/instructions.md for full agent instructions (commands, auth setup, behavior).