Agent Skills › swarmclawai/swarmclaw › google-workspace

google-workspace

GitHub

提供 Google Workspace CLI (gws) 的使用规范，涵盖 Drive、Docs、Gmail 等资源的自动化操作。指导 Agent 优先使用结构化 API 调用而非 HTTP 请求，强调先读后写、ID 确认及错误处理机制。

skills/google-workspace/SKILL.md swarmclawai/swarmclaw

Trigger Scenarios

需要自动化管理 Google Drive 文件操作 Google Docs 或 Sheets 文档查询或发送 Gmail 邮件管理 Google Calendar 日程在 Google Chat 中交互

Install

npx skills add swarmclawai/swarmclaw --skill google-workspace -g -y

More Options

Use without installing

npx skills use swarmclawai/swarmclaw@google-workspace

指定 Agent (Claude Code)

npx skills add swarmclawai/swarmclaw --skill google-workspace -a claude-code -g -y

安装 repo 全部 skill

npx skills add swarmclawai/swarmclaw --all -g -y

预览 repo 内 skill

npx skills add swarmclawai/swarmclaw --list

SKILL.md

Frontmatter

{
    "name": "google-workspace",
    "homepage": "https:\/\/github.com\/googleworkspace\/cli",
    "metadata": {
        "openclaw": {
            "requires": {
                "bins": [
                    "gws"
                ]
            },
            "toolNames": [
                "google_workspace",
                "gws"
            ],
            "capabilities": [
                "google-workspace",
                "google-docs",
                "google-drive",
                "google-sheets",
                "gmail",
                "google-calendar",
                "google-chat"
            ]
        }
    },
    "description": "Use Google Workspace CLI (`gws`) for Drive, Docs, Sheets, Gmail, Calendar, Chat, and related Workspace API tasks."
}

Google Workspace CLI

Use gws when the task is about Google Workspace resources or Google Workspace API automation.

Prefer gws over generic HTTP calls when possible because it already knows the Workspace API surface and returns structured JSON by default.

Rules

Start with read/list/get commands before mutating Workspace state.
Confirm IDs first: document IDs, spreadsheet IDs, file IDs, message IDs, calendar IDs, space IDs.
Do not run interactive auth flows from an agent tool call. If auth is missing, report that gws needs to be configured in plugin settings or via a manual terminal login.
Keep commands machine-readable. Prefer JSON output and parse it instead of scraping human text.
For large list operations, limit the scope first, then page or filter.

Common Commands

Check installation and health:

gws doctor

Inspect help for a resource or method:

gws help
gws drive help
gws drive files help

Google Docs:

gws docs get --document-id <DOC_ID>

Google Drive:

gws drive files list --params '{"pageSize":10}'
gws drive files get --file-id <FILE_ID>

Google Sheets:

gws sheets spreadsheets get --spreadsheet-id <SPREADSHEET_ID>

Gmail:

gws gmail users messages list --user-id me --params '{"maxResults":10}'
gws gmail users messages get --user-id me --message-id <MESSAGE_ID>

Google Calendar:

gws calendar events list --calendar-id primary --params '{"maxResults":10,"singleEvents":true}'

Google Chat:

gws chat spaces messages list --parent spaces/<SPACE_ID>

Tool Usage In SwarmClaw

When using the google_workspace tool:

Put the gws command after the binary into args, for example: {"args":["drive","files","list"],"params":{"pageSize":5}}
Use params for --params
Use jsonInput for --json
Use pageAll: true when you intentionally want all pages
Use dryRun: true before risky mutations if you are unsure

Error Handling

If gws is missing: tell the user to install Google Workspace CLI.
If auth is missing or expired: tell the user to configure the plugin settings or authenticate gws manually.
If a command fails because an ID is missing: switch to a list/search command first and find the right ID.

Version History

ed38ba5 Current 2026-07-24 16:55

Metadata

Files: 0
Version: ed38ba5
Hash: 0085e6a9
Indexed: 2026-07-24 16:55

google-workspace