Kai — Connect Google Workspace to your OpenClaw agent

Temporary setup page for Gmail, Calendar, Drive, Docs, and Sheets access via gws.

VM status: Kai’s VM already has gws, the OAuth client config, and OpenClaw Google Workspace skills installed.

Security: Never paste your Google password, 2FA code, OAuth URL code, or token into Telegram or any chat. Only sign in on Google’s official pages in your own browser.

Why this page does not have a “Sign in” button

The gws CLI uses a localhost OAuth callback on the machine where gws is running. If you open the login URL from your laptop/phone, Google redirects to localhost on that device, not the VM. So the safe and reliable approach is: authenticate locally, then copy the exported credential file to the VM.

Step 1 — Install gws on your own computer

npm install -g @googleworkspace/cli

Step 2 — Get the OAuth client config

Ask Eric/Eddie for the client_secret.json file, or download/create the Desktop OAuth client in Google Cloud Console. Save it here on your own computer:

~/.config/gws/client_secret.json

Step 3 — Sign in locally

gws auth login -s drive,gmail,calendar,sheets,docs

Complete the Google consent screen in your browser.

Step 4 — Verify locally

gws auth status
gws drive files list --params '{"pageSize": 5}'

Step 5 — Export credentials for the VM

The exported file grants Google Workspace access. Treat it like a password. Send it only through a secure channel to Eric/Eddie for installation on the VM, or copy it yourself if you have a secure transfer path.

gws auth export --unmasked > gws-credentials.json
chmod 600 gws-credentials.json

What Eddie will do after receiving the exported file

Install it on Kai’s VM as:

/home/eric_tang_inhom_io/.config/gws/credentials.json

Then verify:

gws auth status
gws drive files list --params '{"pageSize": 5}'

After setup

You can ask your OpenClaw agent to help manage Gmail, Calendar, Drive, Docs, and Sheets.