A privacy-focused AI skill providing direct local IMAP and SMTP access to Gmail using Google App Passwords without third-party proxies.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install gmail-local
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 gmail-local 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 Local?
Gmail Local is a robust integration designed for users who prioritize privacy and security when interacting with email through AI agents. By leveraging direct IMAP and SMTP protocols, this skill ensures that your communications stay between your local host and Google servers, bypasssing external proxies or third-party routing services found in other Openclaw Skills.
Built with a strict trust boundary, it utilizes local environment variables and secure file handling to manage credentials. This makes it an ideal choice for developers and power users who need to automate email workflows while maintaining absolute control over their sensitive Gmail data and authentication tokens.
Gmail Local Use Cases
- Searching and reading unread inbox messages directly from a local terminal or AI interface.
- Sending authenticated emails with manual confirmation gates to prevent accidental automated outbound mail.
- Managing Gmail communication in environments where third-party mail proxies are restricted or prohibited.
- Building custom email automation workflows that require high-security handling of Google App Passwords.
How Gmail Local Works
- The skill connects directly to imap.gmail.com:993 for retrieving and searching mail metadata.
- For sending emails, it establishes a secure connection to smtp.gmail.com:465.
- It retrieves the Google App Password from a restricted 0600 permission file on the local filesystem.
- Every write or send operation requires the agent to pass a specific confirmation flag, ensuring a human-in-the-loop safety check.
- The skill processes IMAP queries to filter messages and presents body previews to the AI agent for context-aware processing.
Gmail Local Setup
First, generate a Google App Password at Google Account Security.
Create a secure local file to store your password:
install -m 600 /dev/null ~/.openclaw/gmail-app-password
echo "YOUR_APP_PASSWORD" > ~/.openclaw/gmail-app-password
Configure the environment variables for your Openclaw Skills deployment:
openclaw config set env.vars.GMAIL_ADDRESS [email protected]
openclaw config set env.vars.GMAIL_APP_PASSWORD_FILE ~/.openclaw/gmail-app-password
openclaw gateway restart
Gmail Local Data Schema & Taxonomy
The skill utilizes a local helper script and specific environment variables to manage data flow:
| Variable | Requirement | Description |
|---|---|---|
| GMAIL_ADDRESS | Required | Your full Gmail address for login. |
| GMAIL_APP_PASSWORD_FILE | Required | Path to the 0600 file containing your App Password. |
| Python 3 | Dependency | Required to execute the underlying mail scripts. |
All mail content is processed in-memory and is not stored locally by the skill beyond the scope of the current session.
Gmail Local Advanced Features
- Direct IMAP search integration supporting complex queries like 'UNSEEN' or specific sender filters.
- Mandatory --confirm-send flag for all outbound communication to enforce safety and prevent spam.
- Local credential isolation ensuring that app passwords are never logged, committed to git, or echoed in shell history.
- Explicit support for 0600 file permissions to meet high-security compliance standards for Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Used Car Selling Kit
A comprehensive, security-first framework for preparing, listing, and safely handovers during a private vehicle sale.
Worktree Manager
A comprehensive orchestrator for managing isolated Docker-based development environments and Git worktrees with automated database snapshots and proxy routing.
New Dog Adoption Preparation Kit
A comprehensive readiness and decompression toolkit for prospective and new dog owners to ensure a safe, structured transition for adopted pets.
Divorce Logistics Planner
A practical administrative assistant designed to help individuals navigate the non-legal and non-financial logistics of household separation and divorce.
Defold Game Engine
A professional-grade development skill for building high-performance 2D games using the Defold engine and Lua script.
Funeral Planning Coordination Kit
A pragmatic, logistics-focused coordination kit for managing the complex scheduling, notifications, and documentation required for funeral or memorial services.
Featured*
