Setup Guide

Why Your OpenClaw Can't Help You Yet

Most people set up OpenClaw and stop there. But without its own identity, your AI is locked out of the tools that actually matter.

This guide gives your AI a real Google identity in about 15 minutes. No coding. No experience needed.

By Johann Sathianathenâ€ĸFeb 18, 2026â€ĸ15 min setup

🤔 Think about it this way

You just hired an incredibly capable employee. They can write, research, analyze data, manage your calendar, monitor your website, and send emails on your behalf.

But you never gave them a company email. You never added them to your tools. They're sitting at their desk with no access to anything.

That's what most people do with OpenClaw. They set it up, connect Telegram or Discord, and wonder why it can't do more. The fix takes 15 minutes.

What You Unlock

One Gmail account gives your AI access to the entire Google ecosystem:

📊

Google Analytics

Your AI can check traffic, conversions, and trends on demand

🔍

Search Console

Monitor rankings, indexing issues, and search performance

📅

Google Calendar

Schedule meetings, check availability, set reminders

📄

Google Docs

Draft, edit, and organize documents

📁

Google Drive

Access, upload, and manage files

📧

Gmail (Send/Receive)

Send emails, read responses, manage inbox

â„šī¸
Why a separate account? You don't want your AI reading your personal emails or having access to your main Google account. A dedicated account means you control exactly what it can see, and you can revoke access instantly.

The Setup

1

📧Create a Dedicated Gmail Account

Your AI needs its own identity, separate from your personal accounts.

Go to accounts.google.com/signup and create a new Google account.

Naming convention

Pick something that makes it clear this is your AI's account:

  • yourname.openclaw@gmail.com
  • yourcompany.ai@gmail.com
  • botname.agent@gmail.com
💡
Use a real name on the account (like your name or company name). Some Google services flag accounts with obviously fake names.
2

🔐Enable 2FA and Create an App Password

App passwords let OpenClaw send emails without exposing your main password.

Google requires 2-step verification before you can create app passwords. This is actually good security.

Step 2a: Enable 2-Step Verification

  1. Sign into your new Gmail account
  2. Go to myaccount.google.com/security
  3. Click 2-Step Verification → Get started
  4. Add your phone number and verify

Step 2b: Create an App Password

  1. Go to myaccount.google.com/apppasswords
  2. Name it something like OpenClaw
  3. Click Create
  4. Copy the 16-character password (you won't see it again)
âš ī¸
Save this password somewhere safe. You'll need it in the next step. Google only shows it once.
3

âš™ī¸Add the Email to OpenClaw Config

This connects your AI to its new email so it can send and receive messages.

Add the email credentials to your OpenClaw configuration. You can do this through the config file or environment variables.

Option A: Environment variables (recommended)

Add to your .env file
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=yourname.openclaw@gmail.com
SMTP_PASS=your-16-char-app-password
IMAP_HOST=imap.gmail.com
IMAP_PORT=993
IMAP_USER=yourname.openclaw@gmail.com
IMAP_PASS=your-16-char-app-password

Option B: OpenClaw config

Add to openclaw.json
{
  "email": {
    "smtp": {
      "host": "smtp.gmail.com",
      "port": 587,
      "user": "yourname.openclaw@gmail.com",
      "pass": "your-16-char-app-password"
    },
    "imap": {
      "host": "imap.gmail.com",
      "port": 993,
      "user": "yourname.openclaw@gmail.com",
      "pass": "your-16-char-app-password"
    }
  }
}
Restart OpenClaw
openclaw gateway restart
✅
Your AI can now send and receive emails. Try asking it to send you a test email to verify it works.
đŸ’Ŧ

Stuck on a step? Join the community and get help from other AI operators.

Join the community →
4

🔍Add Your AI to Google Search Console

Your AI can monitor your site's SEO, check indexing, and spot issues automatically.

Google Search Console shows how your site performs in Google Search. Adding your AI's email gives it read access to all your data.

  1. Go to search.google.com/search-console
  2. Select your property (or add one if you haven't)
  3. Go to Settings → Users and permissions
  4. Click Add user
  5. Enter your AI's email: yourname.openclaw@gmail.com
  6. Set permission to Full (or Restricted if you prefer read-only)
💡
What your AI can do now: Check which pages are indexed, find crawl errors, see which keywords drive traffic, submit URLs for indexing, and monitor Core Web Vitals.
5

📊Connect Google Analytics

Your AI can check traffic, conversions, and user behavior without you lifting a finger.

Same process as Search Console. Add your AI as a user so it can pull analytics data.

  1. Go to analytics.google.com
  2. Click Admin (gear icon, bottom left)
  3. Under your property, click Property Access Management
  4. Click the + button → Add users
  5. Enter your AI's email
  6. Set role to Viewer (read-only is usually enough)
â„šī¸
Pro tip: Give it Viewer access first. You can always upgrade to Editor later if you want your AI to create custom reports or annotations.
6

📅Share Google Calendar

Your AI can check your schedule, create events, and manage your time.

Share your calendar with your AI's email so it can see your availability and schedule meetings.

  1. Go to calendar.google.com
  2. Hover over your calendar name on the left → click the three dots → Settings and sharing
  3. Scroll to Share with specific people or groups
  4. Click Add people and groups
  5. Enter your AI's email
  6. Set permission to Make changes to events
💡
Alternative: iCal URL. If you only need read access, you can use the secret iCal address instead (Settings → Integrate calendar → Secret address in iCal format). No email sharing needed.
🚀

Halfway there! Join the community to share your setup and get feedback from other builders.

Join the community →
7

📁Share Google Drive and Docs

Your AI can access, create, and organize documents and files.

You can share individual files, folders, or your entire Drive with your AI's account.

Share a folder (recommended)

  1. Create a folder in Google Drive called something like AI Workspace
  2. Right-click → Share
  3. Enter your AI's email
  4. Set to Editor

Anything you drop in this folder, your AI can access. Clean separation between your personal files and what your AI can see.

âš ī¸
Don't share your entire Drive. Create a dedicated folder and share only that. Better security, cleaner organization.
8

✅Test Everything Works

Verify each connection before you rely on it.

Ask your AI to test each service. Here are some prompts to try:

Test prompts for your AI
# Email
"Send a test email to my personal email"

# Search Console
"Check if my site has any indexing issues"

# Analytics
"What was my website traffic this week?"

# Calendar
"What's on my calendar tomorrow?"

# Drive
"List the files in my AI Workspace folder"
✅
If something doesn't work: Double-check the sharing permissions. The most common issue is the email address having a typo, or the permission level being too restrictive.
đŸŽ¯

Almost done! Join the community and connect with other operators who have already set this up.

Join the community →

🚀 What's Next?

Now that your AI has an identity, here are some things you can do:

  • Weekly SEO reports: Have your AI check Search Console every Monday and send you a summary
  • Daily traffic digests: Get a morning briefing with yesterday's analytics
  • Calendar management: Let your AI schedule, reschedule, and manage your meetings
  • Document drafting: Your AI can create and edit Google Docs directly
  • Automated emails: Follow-ups, client updates, newsletters
âš ī¸
Security reminder: Treat your AI's credentials like you'd treat any employee's. Use app passwords (never your main password), give minimum necessary permissions, and review access periodically. Already set up security? Check our Security 101 guide.

Questions? Need help with setup?

Join the AI Operators Community →