Last updated: April 17, 2026
This guide will help you generate a Google App Password for your Gmail account so that QClaw can connect to your email. Once connected, QClaw can help you organize, search, and manage your emails automatically.
Note: App Passwords require 2-Step Verification to be enabled on your Google account. If you haven’t set it up yet, don’t worry — we’ll walk you through it below.
Prerequisites
QClaw is installed on your computer
You have a personal Google / Gmail account
----------
Step-by-Step Guide
1. Sign in to Gmail
Open your browser and go to https://mail.google.com. Sign in with the Google account you want to connect to QClaw.
2. Enable 2-Step Verification
If you already have 2-Step Verification enabled, skip to Step 3.
2.1 Go to your Google Account security settings: https://myaccount.google.com/security
2.2 Under "How you sign in to Google", find 2-Step Verification and click on it.
2.3 Click "Turn on 2-Step Verification" and follow the prompts to verify your identity.
2.4 Once completed, you’ll see a confirmation that 2-Step Verification is now enabled.
3. Generate an App Password
3.1 Go back to your Google Account settings and search for "App passwords" in the search bar, then click the result.
3.2 In the "App name" field, type
QClaw and click "Create".
3.3 Google will generate a 16-character App Password. Copy this password.
Important: This password will only be shown once. Make sure to copy it before closing the dialog. If you lose it, you can always generate a new one
4. Connect to QClaw
4.1 Open QClaw and navigate to Connectors → Email.
4.2 Select Gmail as your email provider.
4.3 Enter your Gmail address and paste the 16-character App Password you just generated.
4.4 Click "Connect" — you’re all set!
----------
Troubleshooting
1. "App Passwords" option not showing up? — Make sure 2-Step Verification is fully enabled. It may take a few minutes to propagate.
2. Connection failed? — Double-check that you copied the full 16-character password without extra spaces. Try generating a new App Password if the issue persists.
3. Using a Google Workspace account? — Your organization administrator may need to enable "Less secure app access" or allow App Passwords in the admin console.