Integrate with Google Workspace

The gog skill lets your NemoClaw agent interact with Google Workspace services such as Gmail, Google Calendar, and Google Drive. Once configured, you can ask your agent to search emails, schedule meetings, or access files in natural language. This guide uses Google Calendar as the example.

Prerequisites

• NemoClaw installed and running on Olares.
• A Google Workspace or personal Google account.
• Admin access to the Google Cloud Console to create an OAuth application.

Step 1: Create a Google Cloud OAuth application

1. Go to the Google Cloud Console and sign in with your Google account.

2. Navigate to Console, and create a new project or select an existing one.

3. Navigate to APIs and services > Library.

4. From the filter on the left, select Google Workspace and enable the Google Workspace APIs you need. For example:

   • Gmail API
   • Google Drive API
   • Google Calendar API
   • Google People API (for contacts)
   • Google Sheets API and Google Docs API

5. If this is your first time configuring OAuth, navigate to APIs and services > OAuth consent screen, and follow the on-screen instructions to set up the OAuth consent screen first.

   Personal Google accounts

   If you use a personal Gmail account (not a Google Workspace organization), select External for Audience. After publishing the app, go to Audience > Test users and add your own email address. Without this step, authentication will fail for unauthorized users.

6. Go to APIs and services > Credentials, click Create credentials, and select OAuth client ID.

7. For Application type, select Web application.

8. Configure the authorized origins and redirect URIs:

   • Authorized JavaScript origins: Your OpenClaw Web UI URL. You can copy it directly from the address bar. For example, https://d38aad901.laresprime.olares.com.
   • Authorized redirect URIs: Your OpenClaw Web UI URL with /oauth2/callback appended. For example, https://d38aad901.laresprime.olares.com/oauth2/callback.

   

9. Click Create, then click Download JSON to save the client secrets file.

Step 2: Install the gog skill

1. Open the NemoClaw CLI app from Launchpad.

2. Connect to the runtime sandbox:

   nemoclaw my-assistant connect

3. Run the skills configuration wizard:

   openclaw config --section skills

4. Follow the prompts to configure your installation. Use the arrow keys to navigate and press Enter to confirm.

   Settings	Option
   Where will the Gateway run	Local (this machine)
   Configure skills now	Yes
   Install missing skill dependencies	Navigate to the skill gog, press Space to select it, then press Enter.
   Set [API_KEY] for [skill]	Select No for all these settings.

5. Open the chat page in the OpenClaw Web UI and run /reset to start a new session so the agent picks up the newly installed skill. If you've configured channels such as Discord, also run /reset in each channel conversation.

   TIP

   You can also install skills from the OpenClaw Web UI. Go to Skills, search for gog in ClawHub, and click Install.

Step 3: Authenticate with Google

1. Upload the downloaded JSON file to the directory that NemoClaw can access:

   a. Open Files and navigate to Data/nemoclaw/openclaw-config/inbox/.

   b. Upload the JSON file.

   

2. In the NemoClaw CLI sandbox, add the credentials file, and use Tab to autocomplete the name of the JSON file:

   gog auth credentials inbox/client_secret_....json

   Example output:

   path    /sandbox/.config/gogcli/credentials.json
   client  default

3. Start the authentication flow. Replace the email, services, and redirect host values with your own:

   gog auth add [email protected] --services gmail,calendar,drive,contacts,sheets,docs \
        --listen-addr 0.0.0.0:8080 \
        --redirect-host <your-control-ui-domain> \
        --force-consent

   TIP

   Do not include https:// in the --redirect-host value. Use only the domain, such as d38aad901.laresprime.olares.com.

   For example:

   gog auth add [email protected] --services calendar \
        --listen-addr 0.0.0.0:8080 \
        --redirect-host d38aad901.laresprime.olares.com \
        --force-consent

4. Click the URL that appears in the terminal and complete the Google authentication within 3 minutes.

   TIP

   The final callback URL should look like https://d38aad901.{username}.olares.com/oauth2/callback?state=.... If your browser appends /chat to the URL due to cache, complete the authentication in an incognito window.

5. When authentication succeeds, you see a confirmation message in the terminal.

   Example output:

   email [email protected]
   services calendar
   client default

Step 4: Use Google Workspace with your agent

You can use Google Workspace either from the NemoClaw CLI sandbox directly or through the OpenClaw agent in chat.

Learn more

• Run NemoClaw with a local LLM: Set up NemoClaw with a local model.
• Manage skills and plugins: Install and manage other OpenClaw skills.