Gmail Lead Desk for Openclaw

A standalone sales and customer support Gmail automation tool that connects OAuth, scans leads, drafts replies, and archives threads through the AISA gateway.

aisadocs
v1.0.1
May 28, 2026
0
714
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install gmail-lead-desk

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 gmail-lead-desk 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 Lead Desk?

Gmail Lead Desk is a highly specialized automation agent designed to streamline sales and customer service operations directly within your inbox. Utilizing the AISA gateway, this developer-friendly skill simplifies interaction with the Gmail API, enabling intelligent lead triage, automated draft generation, and thread archiving without requiring external integrations.

By leveraging Openclaw Skills, developers and AI agents can execute precise, whitelisted email actions securely. It empowers teams to transition from manual inbox monitoring to structured, semi-automated pipelines where customer intents are swiftly parsed and responded to with draft templates, ensuring higher responsiveness and zero missed opportunities.

Gmail Lead Desk Use Cases

  • OAuth-secured Gmail integration: Connect or reconnect Gmail accounts quickly and securely using an automated OAuth flow.
  • Unread lead scanning: Pull and filter unread sales inquiries waiting for a response, structuring them into clean lists.
  • Thread summarization: Generate CRM-ready summaries of complex customer support threads including user intent, budget, timeline, and actions.
  • Sales template drafting: Auto-generate template replies based on thread contexts, routing them directly into your drafts folder for human review.
  • Smart archiving: Automatically categorize, label, and batch-archive won deals or resolved customer tickets to maintain a clean inbox.

How Gmail Lead Desk Works

  1. Identity and Connection Verification: The workflow starts by checking if the AISA_API_KEY environment variable is configured and asking the user for their target Gmail address.
  2. OAuth Authentication (Workflow 0): If no active connection exists, it initiates an OAuth flow, polling until the account status turns active.
  3. Scanning and Filtering (Workflow A): Executes the GMAIL_FETCH_EMAILS tool with a sales query to detect unanswered, high-priority customer threads.
  4. Context Summarization (Workflow B): Reads the thread contents and returns organized structured fields outlining client needs and next steps.
  5. Draft Generation (Workflow C): Generates contextual replies via GMAIL_CREATE_EMAIL_DRAFT, ensuring the message remains in draft status unless an explicit command is issued to send it.
  6. Batch Archive & Categorization (Workflow D): Resolves custom label IDs and batch-modifies messages, relocating them to specific folders.

Gmail Lead Desk Setup

Configure your environment with your AISA gateway credentials before using this skill with other Openclaw Skills.

export AISA_API_KEY=\"your-key\"

Ensure that you have your target user identity (your Gmail address) ready. Run the connection pre-flight checks, and execute Workflow 0 to initialize the OAuth link if the account is not already ACTIVE.

Gmail Lead Desk Data Schema & Taxonomy

This skill interacts with the AISA backend and organizes email metadata into structured formats for CRM systems and workflows.

Thread Summary Data Schema

Property Format Description
customer String Sender identity and domain
need String Context of the inquiry or problem statement
budget/timeline String Identified budgetary or scheduling details (unverified if inferred)
next action String Recommended developer or sales follow-up step
attachments List Document references attached to the thread

Tool Whitelist Reference

  • GMAIL_FETCH_EMAILS: Query and retrieve message sets.
  • GMAIL_FETCH_MESSAGE_BY_THREAD_ID: Detailed chronological fetch of thread messages.
  • GMAIL_CREATE_EMAIL_DRAFT: Safe, non-sending draft builder.
  • GMAIL_BATCH_MODIFY_MESSAGES: Bulk label and archive execution (max 5 samples per batch for safety).

Gmail Lead Desk Advanced Features

  • Draft-First Safety Strategy: Enforces a strict draft-only default where no email is sent directly unless the user explicitly triggers a confirmation command.
  • State Polling and Auto-Recovery: Integrates OAuth link polling with automatic timeouts (~2 minutes) to recover from browser-level disconnects.
  • Dynamic Label Creation: Automates label detection and dynamically creates custom labels (GMAIL_CREATE_LABEL) if missing from the user's Gmail environment.
  • Rate Limiting and Backoff: Implements concurrency controls (limit <= 10) and handles 429 exceptions to maintain system stability and respect API limits.
  • Unified Agent Compatibility: Designed to run seamlessly across modular AI environments, including Openclaw Skills, Claude Code, and Hermes.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*