A high-performance utility to programmatically retrieve and decode Gmail message content, headers, and metadata.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install gws-gmail-read
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install gws-gmail-read 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 Read Skill?
The Gmail Read skill is a robust extension for the gws ecosystem within Openclaw Skills, designed to provide AI agents and developers with a streamlined way to access email content. It eliminates the complexity of manual API calls by handling intricate tasks such as multipart/alternative message parsing and automatic base64 decoding.
By providing a clean CLI interface, this skill allows for the extraction of plain text or HTML bodies, as well as critical headers like From, To, Subject, and Date. It is an essential component for building automated email processing workflows or integrating mail-reading capabilities into larger AI-driven systems.
Gmail Read Skill Use Cases
- Extracting specific email bodies for AI-driven summarization and analysis.
- Automated monitoring of transactional emails to trigger downstream workflows.
- Programmatic retrieval of email headers for security auditing and communication tracking.
- Converting HTML-only emails into clean plain text for easier data processing.
How Gmail Read Skill Works
- The user or AI agent provides a unique Gmail message ID via the CLI.
- The skill authenticates through the shared gws security framework.
- It fetches the raw message data from the Google Workspace API.
- The tool automatically decodes base64 content and selects the appropriate MIME part (Text or HTML).
- Content is rendered to the console or output as a structured JSON object for further automation.
Gmail Read Skill Setup
To use this skill, ensure the gws CLI is installed and authenticated. Follow these steps:
# Ensure gws-shared is configured for authentication
gws auth login
# To read a message by ID
gws gmail +read --id <YOUR_MESSAGE_ID>
# To see available options
gws gmail +read --help
Gmail Read Skill Data Schema & Taxonomy
The skill returns data in two primary modes: text or JSON. When using JSON format, the structure follows this schema:
| Field | Type | Description |
|---|---|---|
| id | String | The unique Gmail message identifier |
| body | String | The plain text or HTML content of the email |
| headers | Object | Key-value pairs of metadata (From, To, Subject, etc.) |
| format | String | The requested output encoding (text or json) |
Gmail Read Skill Advanced Features
- Multi-format output support (JSON/Text) for seamless integration with tools like jq.
- Automatic HTML-to-text conversion for consistent data extraction across various email types.
- Dry-run capability to validate API requests without consuming quota or executing actions.
- Deep integration with Openclaw Skills shared global flags for unified authentication management.
SKILL.md
Loading
Related Openclaw Skills
Cybersecurity Intelligence & News Aggregator
A professional-grade automated intelligence tool designed to aggregate and prioritize global cybersecurity news, vulnerabilities, and regulatory updates.
Model Usage
A technical utility to extract, summarize, and visualize per-model cost data from CodexBar's local logs for precise AI spend management.
OpenClaw Security Audit
A local security auditing tool designed to identify API key leaks, permission issues, and public exposures within your OpenClaw environment.
Feishu Smart Alarm
An AI-powered automation skill that extracts deadlines from Feishu messages and voice clips to set intelligent, context-aware reminders.
agent-selfie
An automated visual identity generator that enables AI agents to create self-portraits, avatars, and banners based on their personality and current mood.
OCMAP Pairing Auth
A specialized skill for implementing secure, one-time pairing-code authentication and trusted-device handshakes between OpenClaw gateways and desktop clients.
Featured*
