A high-reliability Gmail automation skill designed for AI agents to manage mailboxes, compose emails, and verify message delivery without manual selector hunting.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install surfagent-gmail
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 surfagent-gmail 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?
The Gmail skill is a specialized operating module for AI agents, designed to handle the complexities of the Gmail platform with precision. Part of the broader Openclaw Skills ecosystem, it moves beyond fragile browser selectors by using deterministic task runners and adapter state tools. This ensures that agents can interact with dynamic compose surfaces and rich-text editors without burning excessive tokens or failing due to Gmail-specific security features like Trusted Types.
By prioritizing Openclaw Skills native verbs, this module allows agents to perform mailbox triage, verify sent messages, and maintain tab hygiene automatically. It is the definitive way to give an AI agent reliable, professional-grade control over email workflows while ensuring every action is backed by verifiable proof of success.
Gmail Use Cases
- Automated inbox triage with urgency and action-signal scoring
- Reliable email composition and reply flows within active threads
- Continuous monitoring of specific labels such as Sent, Drafts, or Spam
- Multi-layered verification of message delivery and content rendering
- Maintaining workspace efficiency by managing duplicate Gmail tabs
How Gmail Works
- The agent confirms the current Gmail state or specific mailbox label to establish a baseline.
- It selects the most efficient deterministic task runner, such as compose or triage, to perform the action.
- The skill verifies that the target UI surface is real and actionable before attempting input.
- It fills or extracts data using Gmail-specific adapters that bypass common browser automation blockers.
- A triple-layer proof check is performed: confirming the compose dialog state, capturing the send alert, and verifying the final render in the Sent folder.
- The skill automatically enforces tab hygiene, collapsing duplicate Gmail instances into a single working tab.
Gmail Setup
To utilize this skill, ensure the core browser-operations skill is also active in your environment. The Gmail skill integrates directly with the SurfAgent adapter framework.
# Add the Gmail skill to your agent configuration
surfagent skill add gmail
# Verify adapter connectivity
gmail_health_check
Gmail Data Schema & Taxonomy
| Data Category | Description |
|---|---|
| Mailbox State | Tracks the current label, active thread, and tab count. |
| Task Runners | Deterministic functions for composing, replying, and triaging. |
| Proof Layers | Validates compose state, send confirmation, and rendered output. |
| Thread Metadata | Heuristic scores for urgency and required actions during triage. |
Gmail Advanced Features
- Triple-layer proof rules (compose, send, and render) to ensure 100% reliability.
- Support for Trusted Types to prevent editor rejection during rich-content injection.
- Heuristic mailbox triage for intelligent ranking of visible email threads.
- Deterministic task runners that reduce token consumption by avoiding full DOM reads.
- Automated tab hygiene to prevent state confusion across multiple browser tabs.
SKILL.md
Loading
Related Openclaw Skills
Real Estate Storyline & Marketing Agent
A high-end real estate branding tool that transforms project data into evocative storylines and comprehensive marketing assets.
Breakfast Included Hotel Finder
A specialized travel search skill that identifies hotels with included breakfast to save travelers time and money.
Quick Getaway: 3-Day Trip Planner
A professional travel orchestration skill that automates 3-day itinerary planning, flight searching, and hotel booking through real-time CLI data.
SurfAgent MCP Selection
A strategic routing guide for Openclaw Skills that determines the most efficient automation layer for browser-based tasks.
Browser Operations
A foundational skill for AI agents to navigate the web with human-like precision, strict tab discipline, and token-efficient perception.
Super GitHub
An AI-native GitHub assistant utilizing vector search and LLM architecture to provide semantic search and proactive repo monitoring.
Featured*
