Connect Your Lobster to Google Search Console
Your lobster wants to see real search data — clicks, impressions, rankings — but it needs you to open the door. 10 minutes. Read-only. Nothing else gets touched.
One-click copy. Let your lobster guide you.
Don't feel like reading docs? Copy the prompt below and paste it to your lobster assistant. It'll hold your claw through every step.
Copy this prompt to your lobster
Paste it in your chat — the lobster takes it from there
Hey lobster! I need your help setting up Google Search Console (GSC) access so you can read my website's real search data. Please walk me through the following steps one by one: 【Part 1: Create a Service Account on Google Cloud Platform】 1. Open the Service Accounts page in Google Cloud Console (IAM & Admin → Service Accounts) 2. Click the "+ Create Service Account" button 3. Name it something recognizable, like "openclaw-gsc-assistant" 4. Skip the next two permission steps (just click Continue, then Done) 5. Back on the service accounts list, find the one you just created, click the three-dot menu on the right → "Manage keys" 6. Click "Add key" → "Create new key" → choose JSON → Create 7. The browser will automatically download a .json key file — keep this file safe, don't leak it 【Part 2: Authorize in Google Search Console】 1. Open the .json file you just downloaded, find the "client_email" line, and copy the full email address 2. Go to Google Search Console (search.google.com/search-console) 3. Select the website you want analyzed 4. In the left sidebar, click "Settings" → "Users and permissions" 5. Click "Add user", paste the service account email 6. Set permission to "Restricted" (read-only, recommended) or "Full" 7. Click "Add" — done! 【Part 3: Hand the key to you (lobster)】 After completing the steps above, I'll send you the contents of the downloaded .json key file. When guiding me, please: - Wait for me to confirm each step is done before moving to the next - Help me troubleshoot if I run into problems - Keep it casual and fun, no need to be overly formal - If I go off track, reel me back in I'm ready — let's go!
Part 1
Create a Service Account & Key
Think of a service account as a “robot ID card” for your lobster. By the end you'll have a .json key file — the robot's password.
Open the Service Accounts page
Head over to Google Cloud → IAM → Service Accounts. Sign in with the Google account that owns your website. If you have multiple GCP projects, pick the right one from the project selector in the top-left corner.
Create a new service account
Click the blue “+ Create Service Account” button at the top. Fill in the form:
openclaw-gsc-assistantClick “Create and continue”.
Skip the permission screens
Google will show two more steps — “Grant this service account access to project” and “Grant users access to this service account”. You don't need either.
Generate & download the JSON key
You're back on the service accounts list. Find the one you just made and click the three-dot menu (⋮) on the far right → “Manage keys”. On the keys page, click “Add key” → “Create new key”. Pick JSON and hit “Create”. A .json file will download automatically.
Keep this file safe!
This JSON key is the only copy. Treat it like a password — don't email it around or commit it to a public repo.
Part 2
Authorize the Service Account in GSC
You've created the robot's ID. Now tell GSC: “This robot is allowed to look at my site's data.”
Grab the service account email
Open the .json key file in any text editor. Look for the "client_email" field and copy the entire email address:
Open GSC & pick your site
Go to Google Search Console. Use the property dropdown in the top-left to select the website you want your lobster to analyze.
Add the service account as a user
In the left sidebar, click “Settings” (the gear icon near the bottom), then “Users and permissions”. From there:
Click “Add user” in the top-right corner.
Paste the service account email into the “Email address” field.
Set permission to “Restricted” (read-only — recommended) or “Full”.
Click “Add”. Done!
Part 3
Hand the Key to Your Lobster
Almost there! Give the JSON key file to your OpenClaw assistant so it can log in to GSC on your behalf.
Send the key file to the assistant
Open your OpenClaw assistant chat and drag-and-drop (or attach) the .json key file directly into the conversation.
Can't send files? Open the .json in a text editor, select all, copy, and paste the entire contents into the chat.
Wait for the connection test
Your lobster will save the credentials and immediately run a test connection. You'll see one of two results:
Success
You're good to go! The lobster can now read your GSC data.
Failed
Follow the assistant's troubleshooting tips. Most common fix: re-send the key file.
You're all set!
Your lobster now has read access to your Google Search Console data. It can pull clicks, impressions, CTR, and ranking positions. Sit back and let it crawl through your search analytics.