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.
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.
Tools available to OpenClaw agents
Section titled “Tools available to OpenClaw agents”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.
Use cases
Section titled “Use cases”Morning inbox digest
Section titled “Morning inbox digest”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.
Draft replies for review
Section titled “Draft replies for review”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.
Search and extract
Section titled “Search and extract”“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.
Get started
Section titled “Get started”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.