Skip to content

Connect OpenClaw to Gmail

Let an OpenClaw agent read, search, label and send email from a Gmail account, with no credentials handed to the agent.

Tags:integrations

Gmail is Google’s email service and, for most teams, the inbox where customer questions, invoices, calendar invites and vendor threads all land. It is also where a surprising amount of manual work hides: triaging what arrived overnight, finding that one attachment from March, and sending the same status update for the third time this week.

With Claworc’s External Connections, an OpenClaw agent can work inside a Gmail account on your behalf. You sign in to Google once through a popup, Composio holds the resulting token, and the agent gets an auto-generated claworc-gmail skill that tells it which Gmail tools exist and how to call them. The agent never sees a password, an OAuth token or an API key.

Composio’s Gmail toolkit exposes more than sixty actions. In practice an OpenClaw agent leans on a handful of capabilities:

  • Search and read mail — find messages with Gmail’s own search syntax (is:unread newer_than:1d from:billing@…), page through large inboxes and read the full body and attachments of any message.
  • Send email — compose and send a new message, with attachments, from the connected account.
  • Reply in a thread — answer inside an existing conversation so the reply lands where everyone on the thread expects it.
  • Save as draft — write the email but leave it in Drafts for a human to review and send.
  • Organize with labels — add or remove labels, archive, star, or mark messages as read, one at a time or in bulk.
  • Create labels and filters — set up new labels and inbox rules so future mail sorts itself automatically.

Every action goes through a small broker running next to the agent, so the agent only needs to describe what it wants done in plain language and let the skill handle the rest.

Ask the agent, on a schedule or on demand, to fetch everything unread from the last 24 hours, group it by sender and topic, and post a short summary to you. Anything that looks urgent gets starred and labeled needs-reply, so the important threads are already sorted before you open Gmail.

Point the agent at a label such as support and have it draft a reply to each new message using your knowledge base. Because it saves drafts rather than sending directly, you keep the final say. Open Drafts, skim, adjust a sentence, send.

“Find every invoice from Acme this quarter and list the amounts and due dates.” The agent searches with Gmail’s query syntax, reads the matching messages and returns a table. No more scrolling through months of mail to find the numbers for a report.

Connecting Gmail takes three steps: an admin adds a Composio API key to Claworc’s settings, you open the instance’s Settings tab, click + Add connection, pick Gmail and sign in to Google. The claworc-gmail skill appears in the instance a moment later. The full walkthrough, including the exact Composio permissions the key needs, is in the External Connections documentation.