email-summary – OpenClaw Skill

---

name: email-summary description: Fetches recent emails from Gmail and provides concise summaries. Use when the user wants to check emails, get email summaries, or review their inbox. homepage: https://github.com/yourusername/email-summary-skill user-invocable: true metadata: openclaw: requires: bins: - python3 env: - GMAIL_CREDENTIALS_PATH os: - darwin - linux - win32

Email Summary Skill

This skill fetches recent emails from your Gmail account and provides AI-powered summaries.

How it works

When invoked, this skill will:

1. Authenticate with Gmail API using credentials at $GMAIL_CREDENTIALS_PATH
2. Fetch recent emails (default: last 10 unread emails)
3. Summarize each email with:
   • Sender and subject
   • Key points from the email body
   • Recommended actions or responses
4. Present results in an organized, easy-to-scan format

Instructions for the Agent

When this skill is invoked:

1. First, verify that the Gmail API credentials exist at the path specified in $GMAIL_CREDENTIALS_PATH environment variable
2. Run the helper script located at {baseDir}/scripts/fetch_emails.py with the appropriate arguments:
   • Default: python3 {baseDir}/scripts/fetch_emails.py --count 10
   • With arguments: python3 {baseDir}/scripts/fetch_emails.py $ARGUMENTS
3. Parse the JSON output from the script
4. For each email, provide a concise summary including:
   • From: Sender name and email
   • Subject: Email subject line
   • Summary: 2-3 sentence summary of key points
   • Action: Suggested action (reply, archive, flag for follow-up, etc.)
5. Present all summaries in a well-formatted list

Usage Examples

/email-summary

Fetches and summarizes the last 10 unread emails.

/email-summary --count 20

Fetches and summarizes the last 20 unread emails.

/email-summary --all

Fetches and summarizes all unread emails.

Setup Requirements

Before using this skill, ensure:

• Gmail API credentials are configured
• Environment variable GMAIL_CREDENTIALS_PATH points to your credentials JSON file
• Python 3 and required packages are installed (see setup guide in README.md)

Email Summary Skill for OpenClaw

AI-powered email summarization skill that fetches your Gmail messages and provides concise, actionable summaries.

Features

• Fetch recent unread emails from Gmail
• AI-generated summaries with key points
• Suggested actions for each email
• Configurable number of emails to fetch
• Secure OAuth2 authentication

Installation

1. Install Python Dependencies

pip install google-auth google-auth-oauthlib google-auth-httplib2 google-api-python-client

2. Set Up Gmail API Credentials

1. Go to Google Cloud Console
2. Create a new project (or select an existing one)
3. Enable the Gmail API:
   • Navigate to "APIs & Services" > "Library"
   • Search for "Gmail API"
   • Click "Enable"
4. Create OAuth2 credentials:
   • Go to "APIs & Services" > "Credentials"
   • Click "Create Credentials" > "OAuth client ID"
   • Choose "Desktop app" as application type
   • Download the credentials JSON file
5. Save the credentials file to a secure location (e.g., ~/.config/gmail/credentials.json)

3. Set Environment Variable

Add this to your shell configuration (~/.zshrc, ~/.bashrc, etc.):

export GMAIL_CREDENTIALS_PATH="$HOME/.config/gmail/credentials.json"

Reload your shell:

source ~/.zshrc  # or ~/.bashrc

4. Install the Skill

Option A: Install to OpenClaw local skills

cp -r email-summary ~/.openclaw/skills/

Option B: Install to workspace

# In your OpenClaw workspace directory
cp -r email-summary ./skills/

First-Time Setup

The first time you run the skill, you'll need to authorize access:

1. A browser window will open automatically
2. Sign in to your Google account
3. Grant permissions to access Gmail (read-only)
4. The authorization token will be saved for future use

Usage

In OpenClaw, use the /email-summary command:

Fetch last 10 unread emails (default)

/email-summary

Fetch specific number of emails

/email-summary --count 20

Fetch all unread emails

/email-summary --all

Output Format

The skill provides structured summaries:

📧 Email Summary (10 unread messages)

1. From: john@example.com
   Subject: Q1 Budget Review Meeting
   Summary: John is requesting your attendance at the quarterly budget
   review scheduled for next Tuesday at 2 PM. He's asking for department
   expense reports to be submitted beforehand.
   Action: ✅ Reply to confirm attendance and submit expense report

2. From: newsletter@techcompany.com
   Subject: Weekly Tech Digest
   Summary: Latest updates on AI developments, new framework releases,
   and upcoming tech conferences.
   Action: 📚 Archive (informational newsletter)
...

Security & Privacy

• Your credentials are stored locally on your machine
• The skill uses read-only Gmail API access
• No emails are sent to external servers (except OpenClaw's AI for summarization)
• OAuth tokens are saved in token.json next to your credentials file

Troubleshooting

"GMAIL_CREDENTIALS_PATH not set"

Make sure you've exported the environment variable and restarted OpenClaw.

"Credentials file not found"

Verify the path in GMAIL_CREDENTIALS_PATH is correct and the file exists.

"Required packages not installed"

Run the pip install command from Installation step 1.

Authentication browser doesn't open

The script will print a URL - copy and paste it into your browser manually.

Publishing to ClawHub

To share this skill on ClawHub:

1. Create a GitHub repository for your skill
2. Ensure all files are included (SKILL.md, scripts/, README.md)
3. Update the homepage field in SKILL.md with your repo URL
4. Visit ClawHub and follow their publishing guidelines
5. Submit your skill for review

License

MIT License - feel free to modify and share!

Contributing

Contributions welcome! Please submit issues and pull requests on GitHub.