← Back to Skills Marketplace
205
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install openclaw-mail-agent
Description
Set up AI-powered Gmail monitoring in OpenClaw. Watches inbox via Google Pub/Sub and pushes important emails to Telegram. Use when the user wants to install...
Usage Guidance
This plugin appears to do what it says: watch Gmail via Pub/Sub, classify messages with an LLM, and forward important ones to Telegram. Before installing: 1) Confirm you trust the GitHub source (homepage provided). 2) Understand it requires GCP setup (projects, Pub/Sub topic/subscription, IAM grant for gmail-api-push) and Google credentials (ADC or a credentials JSON). 3) The plugin optionally sends email excerpts to an external LLM — do not supply an API key if you are uncomfortable sending potentially sensitive email content to that service. 4) The SKILL.md asks you to install and configure gog for Gmail auth, but the plugin uses Google ADC at runtime — gog is helpful for interactive setup but not strictly used by the code. 5) Note the small version/label inconsistencies in metadata and SKILL.md; verify you are installing the intended release. If you proceed, limit the credential scope where possible and review the plugin's repository (or run in a controlled environment) if you need higher assurance.
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-mail-agent
Version: 0.1.3
The mail-agent skill bundle is a legitimate tool for monitoring Gmail and sending notifications to Telegram. The code in index.ts correctly implements Gmail history polling via Google Pub/Sub, uses an LLM for email classification, and delivers alerts through the OpenClaw Telegram runtime. The SKILL.md provides transparent setup instructions using standard tools like gcloud and gog, and the plugin configuration follows OpenClaw's security model for handling API keys and credentials.
Capability Assessment
Purpose & Capability
The plugin's stated purpose (Gmail → Pub/Sub → classify → Telegram) matches the code and install requirements. It requires gcloud (used for ADC and creating resources) and asks the user to install gog in SKILL.md, but the runtime code uses google.auth.GoogleAuth / ADC rather than invoking gog itself — so gog is useful for interactive Gmail CLI setup but is not strictly required by the plugin code. There are also small version mismatches across metadata/SKILL.md/install URL (registry version 0.1.3 vs SKILL.md 0.2.0 and install URL v0.2.1) which are not fatal but worth noting.
Instruction Scope
SKILL.md guides the user through gcloud, Pub/Sub, enabling Gmail API, and installing the plugin. Those steps are in-scope. The instructions require creating cloud resources, granting Gmail Pub/Sub publisher role, and supplying credentials (ADC or a credentials JSON). They also instruct storing an LLM API key in plugin config; the plugin will send email snippets (up to 500 chars) to the configured LLM endpoint. The instructions do not attempt to read unrelated system files or exfiltrate data to unexpected endpoints beyond the configurable LLM URL.
Install Mechanism
The declared install steps use Homebrew formulas (steipete/tap/gogcli and google-cloud-sdk) and installing the plugin from a GitHub release tarball — standard, traceable sources. No downloads from ad-hoc servers or URL shorteners are used.
Credentials
The skill does not request environment variables but does ask you to supply Google credentials (via ADC or credentialsPath) and optionally an OpenAI-compatible API key (llmApiKey) stored in plugin config. These credentials are proportional to the functionality, but storing an LLM API key and sending email content to an external model are privacy-sensitive actions you should review.
Persistence & Privilege
The skill is not marked always:true and runs only when installed and configured. It registers its own service within OpenClaw and does not request elevated platform-wide privileges or modify other skills' configs.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-mail-agent - After installation, invoke the skill by name or use
/openclaw-mail-agent - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.3
- Added version, homepage, and rich metadata fields to SKILL.md.
- Updated plugin install step to reference version 0.2.1.
- Documented required dependencies (gog, gcloud) with install instructions.
- No changes to core setup instructions or workflow.
v0.1.2
openclaw-mail-agent v0.1.2 changelog
- Updated install instructions in documentation to use the latest plugin release archive URL (`refs/tags/v0.2.0.tar.gz`).
- No changes to plugin logic; documentation improvements only.
v0.1.1
openclaw-mail-agent 0.1.1
- Documentation (SKILL.md) reflowed and reformatted for consistency.
- No functional or behavioral changes; only documentation updated.
v0.1.0
- Initial release of mail-agent for OpenClaw.
- Guides users step-by-step to set up AI-powered Gmail monitoring using Google Pub/Sub.
- Pushes important Gmail messages to Telegram after classification.
- Includes checks for prerequisites, troubleshooting guidance, and reconfiguration steps.
- Provides commands for installation, setup, and uninstallation.
Metadata
Frequently Asked Questions
What is Mail Agent?
Set up AI-powered Gmail monitoring in OpenClaw. Watches inbox via Google Pub/Sub and pushes important emails to Telegram. Use when the user wants to install... It is an AI Agent Skill for Claude Code / OpenClaw, with 205 downloads so far.
How do I install Mail Agent?
Run "/install openclaw-mail-agent" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Mail Agent free?
Yes, Mail Agent is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Mail Agent support?
Mail Agent is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Mail Agent?
It is built and maintained by nanaco (@nanaco666); the current version is v0.1.3.
More Skills