stef-openclaw-skills/docs/google-workspace.md

google-workspace integration

Google Workspace helper CLI for Gmail and Google Calendar.

What this integration is for

• Show mailbox identity/profile
• Send email
• Search mail
• Search calendar events
• Create calendar events

Runtime

• node
• dependency: googleapis

Install inside the integration folder if needed:

cd integrations/google-workspace
npm install

Auth and defaults

Default impersonation:

• stefano@fiorinis.com

Key lookup order:

1. GW_KEY_PATH
2. ~/.openclaw/workspace/.clawdbot/credentials/google-workspace/service-account.json
3. ~/.clawdbot/credentials/google-workspace/service-account.json

Optional env:

• GW_IMPERSONATE
• GW_KEY_PATH

Commands

node integrations/google-workspace/gw.js whoami
node integrations/google-workspace/gw.js send --to "user@example.com" --subject "Hello" --body "Hi there"
node integrations/google-workspace/gw.js send --to "user@example.com" --subject "Report" --body "Attached is the PDF." --attach /tmp/report.pdf
node integrations/google-workspace/gw.js search-mail --query "from:someone@example.com newer_than:7d" --max 10
node integrations/google-workspace/gw.js search-calendar --timeMin 2026-03-17T00:00:00-05:00 --timeMax 2026-03-18T00:00:00-05:00 --max 20
node integrations/google-workspace/gw.js create-event --summary "Meeting" --start 2026-03-20T09:00:00-05:00 --end 2026-03-20T10:00:00-05:00

Attachments

• send now supports one or more --attach /path/to/file arguments.
• Attachment content type is inferred from the filename extension; PDF attachments are sent as application/pdf.
• The default impersonation remains stefano@fiorinis.com, so this is the correct helper for actions explicitly performed on Stefano's behalf.