Gmail
Email Messaging & SocialInstall Command
npx clawhub@latest install gmail
Installation Guide
Make sure Node.js 22+ and OpenClaw are installed. Run openclaw --version in your terminal to verify.
Run the install command above in your terminal. ClawHub will automatically download and install Gmail to the ~/.openclaw/skills/ directory.
Run openclaw skills list to check your installed skills and confirm Gmail appears in the list.
Follow the configuration instructions in the description below to add skill settings to ~/.config/openclaw/openclaw.json5.
~/.openclaw/skills/ or the skills/ directory in your project root. Make sure the folder contains a SKILL.md file.
Detailed Description
The Gmail skill lets OpenClaw directly manage your Gmail inbox, using natural language to send and receive emails, search messages, manage labels, and more, dramatically improving email handling efficiency.
Core Features
- Read Emails: Search and read email content by criteria, supporting Gmail search syntax
- Send Emails: Compose and send emails with CC, BCC, and HTML body support
- Attachment Handling: Read email attachment contents or add attachments when sending emails
- Label Management: Automatically add labels to emails, archive, and mark as read
- Draft Management: Create and edit email drafts
Configuration
You need to create OAuth credentials in Google Cloud Console and authorize them before use. The first run after installation will guide you through the authorization flow.
{
skills: {
gmail: {
credentialsPath: "~/.openclaw/gmail-creds.json",
maxResults: 10,
autoLabel: true
}
}
}
Use Cases
- "Find that email from John last week about the project progress"
- "Send a meeting notification email to the entire marketing department"
- "Are there any important emails I need to reply to today?"
- "Archive all emails from [email protected]"
Security Notes
Email credentials are stored locally and are never uploaded to any third-party server. It is recommended to only grant the necessary permission scopes and regularly check OAuth authorization status.