Gmail Recent Digest for Openclaw

An automated utility for Openclaw Skills that retrieves recent unread Gmail messages and generates a concise, summarized digest.

2p1c
v1.1.4
Mar 6, 2026
0
909
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install gmail-summarize

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install gmail-summarize using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Gmail Recent Digest?

The Gmail Recent Digest skill is a powerful automation tool designed for Openclaw Skills to help users stay on top of their inbox without leaving their terminal or agent environment. By connecting to Gmail via secure IMAP protocols, it scans for unread messages from today and yesterday, providing a high-level overview of incoming communications.

This skill is optimized for speed and clarity, synthesizing email content into one-sentence summaries. It ensures that developers and power users can quickly triage their correspondence, making it an essential component of any workflow powered by Openclaw Skills.

Gmail Recent Digest Use Cases

  • Users asking the AI agent to "check my Gmail" or "summarize my emails".
  • Automated daily or hourly email briefings triggered via cron jobs.
  • Quick triage of unread messages using the Openclaw Skills framework.
  • Multilingual environments where email bodies need to be summarized and translated for consistency.

How Gmail Recent Digest Works

  1. The skill triggers a Python 3 execution of the fetch_unseen.py script within the workspace.
  2. It establishes an IMAP connection using provided credentials to access the Gmail server.
  3. The script filters for unread messages received within the current and previous calendar days.
  4. Email metadata (sender, subject, date) and the body (up to 2000 characters) are retrieved and parsed into JSON.
  5. Each email body is condensed into a single-sentence summary, which is then translated into Chinese.
  6. A structured digest is returned via the MessageTool, following strict formatting rules without additional conversational filler.

Gmail Recent Digest Setup

To deploy this skill within Openclaw Skills, you must provide IMAP credentials. Use environment variables for the highest level of security.

Environment Variables

export IMAP_USERNAME="[email protected]"
export IMAP_PASSWORD="your-app-password"
export IMAP_HOST="imap.gmail.com"
export IMAP_PORT="993"
export IMAP_MAX_BODY_CHARS="2000"

Configuration File (Optional)

Alternatively, you can use a JSON configuration file located at ~/.config/gmail-summarize/config.json:

{
  "email": {
    "imapHost": "imap.gmail.com",
    "imapPort": 993,
    "imapUsername": "[email protected]",
    "imapPassword": "your-app-password",
    "maxBodyChars": 2000
  }
}

Gmail Recent Digest Data Schema & Taxonomy

The skill processes and outputs data according to the following structure:

Property Format Description
sender String The original sender information as found in the email header.
subject String The original subject line of the email.
date String The timestamp of the message.
body String Truncated message content used for summary generation.
digest Markdown A formatted list item: [date] sender | subject — summary.

Gmail Recent Digest Advanced Features

  • Support for IMAP_MAX_BODY_CHARS to control data transfer and processing costs within Openclaw Skills.
  • Automatic Chinese translation of email body summaries while preserving original sender and subject text.
  • Dual credential management supporting both environment variables and secure local JSON configurations.
  • Zero-filler output mode designed specifically for seamless integration into larger agentic workflows.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*