← Back to Skills Marketplace
Google Workspace
by
PanthroCorp
· GitHub ↗
· v0.5.2
· MIT-0
326
Downloads
0
Stars
0
Active Installs
6
Versions
Install in OpenClaw
/install panthrocorp-google-workspace
Description
Gmail, Contacts, Calendar, Drive (with comments), Docs, and Sheets for OpenClaw agents
Usage Guidance
This skill appears to implement exactly what it advertises: a Google Workspace CLI that uses OAuth and encrypts the refresh token with a provided key. Before installing: 1) Confirm you created the OAuth Desktop client in your Google Cloud project and only provide the CLIENT_ID/SECRET to this instance; 2) Provide GOOGLE_WORKSPACE_TOKEN_KEY from a secure secret store so the token at rest is encrypted; 3) If you want maximum assurance, either verify the release checksums in dist/checksums.txt or build the binary from source yourself (go build); 4) Keep Docs/Sheets/Drive in 'off' or 'readonly' unless you deliberately enable readwrite — the binary warns that readwrite requires broad Drive scopes; 5) Note the repo/publish metadata mismatch (no formal install spec in registry) — if you rely on automatic installers, verify how clawhub will obtain and install the binary. If any of these points are unacceptable or unclear, do not install until resolved.
Capability Analysis
Type: OpenClaw Skill
Name: panthrocorp-google-workspace
Version: 0.5.2
The Google Workspace skill is a well-architected and security-focused integration for Gmail, Calendar, Contacts, Drive, Docs, and Sheets. It implements multiple layers of defense, including hardcoded read-only access for sensitive services (Gmail/Contacts), configuration-gated write operations for others, and AES-256-GCM encryption for stored OAuth tokens using a user-provided key (GOOGLE_WORKSPACE_TOKEN_KEY). The code (cmd/ and internal/google/) strictly follows the stated security boundaries, and no evidence of data exfiltration or malicious intent was found.
Capability Tags
Capability Assessment
Purpose & Capability
Name and description match the implementation: CLI commands for Gmail, Calendar, Contacts, Drive, Docs, and Sheets are present. The three required environment variables (OAuth client ID/secret and an encryption key for tokens) are appropriate and necessary for the described OAuth flows and encrypted token storage. Requiring the google-workspace binary is consistent with the provided Go source and dist artifacts.
Instruction Scope
SKILL.md and the code instruct the agent/operator to install the binary, run an interactive OAuth Desktop flow, and operate only on the configured services. The instructions and commands reference only service-specific config and token files and do not ask the agent to read unrelated system files or additional secrets. The README and code explicitly warn about scope escalation (e.g., full Drive scope) and Advanced Protection errors.
Install Mechanism
Installation instructions download a prebuilt tarball from the project's GitHub Releases (well-known host) and extract a binary to ~/.openclaw/bin — this is a common pattern and acceptable but carries the normal risk of installing a binary. Registry metadata lists no formal install spec even though source and dist artifacts exist; this packaging/metadata mismatch should be noted. The repo includes dist/checksums.txt and artifacts.json — verify checksums/signatures before running the binary if you require higher assurance, or build from source (Go) as README suggests.
Credentials
The three required environment variables (GOOGLE_WORKSPACE_TOKEN_KEY, GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET) are directly tied to the OAuth + encrypted token storage functionality. No unrelated credentials or broad system secrets are requested. The SKILL.md also mentions an optional GOOGLE_WORKSPACE_CONFIG_DIR (not listed in requires.env) which is a harmless override for config location.
Persistence & Privilege
The skill does persist an encrypted OAuth token to disk (default ~/.openclaw/credentials/google-workspace/token.enc) and expects the encryption key from an env var — this is explicit in the docs and code. The skill does not request elevated platform privileges, does not set always:true, and does not modify other skills. Autonomous invocation is allowed by default but not combined with elevated privileges or unrelated credential access.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install panthrocorp-google-workspace - After installation, invoke the skill by name or use
/panthrocorp-google-workspace - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.5.2
- Release v0.5.2
- Updated version number in documentation and metadata
- No user-facing feature changes or new capabilities
- All usage instructions, limitations, and commands remain unchanged
v0.5.1
- Internal files updated: artifacts.json, checksums.txt, metadata.json, and main.go.
- No user-facing changes to documentation or features.
v0.5.0
Version 0.5.0 — Adds Google Docs and Sheets support, enhances Drive, and updates configuration options.
- New: Google Docs and Google Sheets commands with configurable access (read-only or read-write).
- New: Drive now supports comments (list, add, reply); write access can be enabled for comments only.
- Breaking: Mode/configuration controls extended to Docs, Sheets, and Drive (beyond Calendar).
- Docs and Sheets support is disabled by default; enable via `config set`.
- Security note: Setting Drive to readwrite mode grants broad access via the OAuth token; only enable if acceptable.
- Documentation updated to reflect all new capabilities, usage, and configuration options.
v0.4.3
- Added support for Google Drive (read-only): list, search, get metadata, and download files.
- Updated documentation to include Drive usage and installation instructions.
- Improved project metadata and clarified supported features.
- Minor corrections and enhancements across Calendar, Gmail, and Contacts command documentation.
v0.2.0
- Added troubleshooting guidance for Google accounts with Advanced Protection: how to address "Error 400: policy_enforced" during authentication.
- Documentation updates in SKILL.md and related files.
- New CLAUDE.md file added.
v0.1.0
- Initial release of Google Workspace skill for OpenClaw agents.
- Provides read-only access to Gmail and Contacts.
- Offers configurable (readonly or readwrite) access to Google Calendar.
- Includes commands for searching, reading, and listing Gmail messages and contacts.
- Supports calendar event creation, updating, and deletion when in readwrite mode.
- All commands default to JSON output; plain text available with `--output text` option.
- Authentication managed via environment variables, with status checks and re-authentication guidance.
Metadata
Frequently Asked Questions
What is Google Workspace?
Gmail, Contacts, Calendar, Drive (with comments), Docs, and Sheets for OpenClaw agents. It is an AI Agent Skill for Claude Code / OpenClaw, with 326 downloads so far.
How do I install Google Workspace?
Run "/install panthrocorp-google-workspace" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Google Workspace free?
Yes, Google Workspace is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Google Workspace support?
Google Workspace is cross-platform and runs anywhere OpenClaw / Claude Code is available (linux).
Who created Google Workspace?
It is built and maintained by PanthroCorp (@panthrocorp); the current version is v0.5.2.
More Skills