gws-gmail-reply for Openclaw

A command-line utility for replying to Gmail messages with automatic threading and support for attachments and HTML content.

googleworkspace-bot
v1.0.14
Apr 1, 2026
0
1.4k
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install gws-gmail-reply

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 gws-gmail-reply 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 gws-gmail-reply?

gws-gmail-reply is a specialized tool within the Openclaw Skills ecosystem designed to streamline email communication through the Google Workspace CLI. This skill simplifies the process of responding to existing email threads by automatically managing complex headers like In-Reply-To, References, and threadId. It provides developers with a robust interface to send automated or manual responses directly from terminal environments or integrated scripts.

By leveraging this skill, users can ensure their replies are perfectly integrated into existing conversations while maintaining professional formatting. Whether you are building automated notification systems or managing a high volume of communication, this component of Openclaw Skills offers the flexibility of plain text or HTML bodies, draft creation, and file attachment handling.

gws-gmail-reply Use Cases

  • Automating customer support or ticketing responses based on specific message IDs.
  • Sending rapid follow-up emails with file attachments directly from a development environment.
  • Integrating email response capabilities into CI/CD pipelines or server monitoring scripts.
  • Creating draft replies as part of a multi-step AI-driven workflow for manual review.
  • Managing high-volume transactional email replies without using the Gmail web interface.

How gws-gmail-reply Works

  1. The user initiates the skill by providing a target Gmail message ID and the desired body content.
  2. The skill analyzes the target message to retrieve threading metadata, ensuring the reply is correctly nested within the conversation.
  3. The skill processes optional flags such as --cc, --bcc, or --to to expand the recipient list.
  4. If the --html flag is present, the skill formats the body as an HTML fragment, preserving quoting styles and inline references.
  5. If attachments are provided, they are encoded and bundled into the multi-part MIME message.
  6. The final request is either dispatched immediately via the Gmail API or saved to the user's Drafts folder.

gws-gmail-reply Setup

To utilize this skill, you must have the gws binary installed and authenticated within your Openclaw Skills environment.

  1. Ensure the shared authentication configuration is generated:
gws generate-skills
  1. Verify the installation by running the help command:
gws gmail +reply --help
  1. Execute a test reply to confirm connectivity:
gws gmail +reply --message-id <YOUR_ID> --body 'Test response'

gws-gmail-reply Data Schema & Taxonomy

The skill manages data through the following parameter structure to ensure compatibility within Openclaw Skills:

Parameter Requirement Description
--message-id Required The unique Gmail message identifier for the thread.
--body Required The text or HTML content to be sent.
--attach Optional Path(s) to files to be included as attachments.
--html Optional Boolean flag to treat body content as HTML.
--draft Optional Boolean flag to save the output as a draft instead of sending.

gws-gmail-reply Advanced Features

  • Automatic threading management including In-Reply-To and References headers.
  • Intelligent quoting of original messages to maintain context in conversations.
  • Multi-file attachment support via repeated use of the --attach flag.
  • HTML formatting support with Gmail-specific CSS class preservation for quotes.
  • Dry-run capability to preview the API request payload without executing a send action.
  • Inline image preservation via cid references for high-fidelity HTML replies.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*