Google Workspace CLI OpenClaw 連携方法

TL;DR

Google Workspace CLI (gws) は、AIエージェントがGmail、Drive、Calendar、Sheets、Docs、およびあらゆるGoogle Workspace APIに構造化されたJSON出力を介して直接アクセスできるようにするコマンドラインツールです。ネイティブのOpenClawサポートと100以上の組み込みエージェントスキルにより、WhatsAppやDiscordのようなメッセージングアプリを通じてWorkspaceワークフロー全体を自動化できます。セットアップは、npm install -g @googleworkspace/cliに続いてgws auth setupを実行するだけで5分で完了します。

はじめに

AIエージェントが、あなたが指一本動かすことなくGmailを読み、カレンダーを更新し、Google Driveを整理できるとしたらどうでしょうか？

ほとんどのGoogle Workspace自動化ツールでは、複雑なAPIセットアップ、カスタムコード、または高価なサードパーティサービスが必要です。開発者は、OAuthフロー、レート制限、古くなったドキュメントとの格闘に何時間も費やしています。その間、AIエージェントは、私たちが毎日使うツールへの直接アクセスがないため、活用されずにいます。

Googleのエンジニアが、すべてを変えるものをリリースしました。Google Workspace CLI (gws) はすでに12,400以上のGitHubスターを獲得しており、100以上の組み込みエージェントスキルが付属しています。Rustで構築され、実行時にGoogleのDiscovery Serviceを読み込み、AIエージェントが解析できる構造化されたJSONを出力します。

Google Workspace CLIとは？

Google Workspace CLI (gws)は、すべてのGoogle Workspace APIをクリーンで構成可能なコマンドにまとめる単一のコマンドラインツールです。Gmail、Google Drive、Calendar、Sheets、Docs、Slides、Chat、Tasks、Meet、Forms、Keep、Classroom、Admin、そして基本的に存在するすべてのGoogle Workspace APIをカバーしています。

これまでに使用してきた他のCLIツールとの違いは次のとおりです。

ほとんどの開発者ツールは、固定されたコマンドリストと共に出荷されます。Googleが新しいAPIエンドポイントを追加すると、誰かが手動でツールを更新し、新しいリリースを出し、全員がアップグレードすることを期待しなければなりません。それは終わりのないメンテナンスのルーチンです。これまで見てきたほとんどのGoogle Workspaceラッパーは、インストールする頃にはすでに古くなっています。

gwsはこれを根本的に異なる方法で解決します。コマンドをハードコーディングするのではなく、GoogleのDiscovery Serviceに直接話しかけます。これは、Google自身のWorkspaceアプリ全体で利用可能なすべてのアクションのライブカタログだと考えてください。すべてのAPI、すべてのメソッド、すべてのパラメータが含まれています。Googleは常にこのカタログを最新の状態に保っています。

gwsを実行すると、まずこのライブカタログを取得し、Googleが現在利用可能だと示すものから、その場でコマンド構造全体を構築します。もしGoogleが今日の午後2時に新しいSheets機能をリリースしたら、あなたのCLIは午後2時1分にはそれをすでにサポートしています。更新も、新しいバージョンも、メンテナーが追いつくのを待つ必要もありません。

このツールは、常に真実の源から読み込むため、文字通り遅れることがありません。

簡単な例

# 最新のファイル10件をリスト表示する
gws drive files list --params '{"pageSize": 10}'

# スプレッドシートを作成する
gws sheets spreadsheets create --json '{"properties": {"title": "Q1 Budget"}}'

# Chatメッセージを送信する
gws chat spaces messages create \
  --params '{"parent": "spaces/xyz"}' \
  --json '{"text": "Deploy complete."}'

すべての応答は構造化されたJSONとして返されます。HTMLでも、フォーマットされたテキストでもありません。AIエージェントがすぐに推論し、行動できる、クリーンで予測可能で機械可読なデータです。

AIエージェントにとってgwsが重要な理由

AIエージェントコミュニティは、特定の技術的な理由からgwsに注目しています。

構造化されたJSON出力: すべての応答が構造化されたJSONとして返されます。エージェントはHTMLを解析したり、フォーマットを推測したりする必要はありません。すぐに処理できるクリーンなデータが得られます。

カスタムツール不要: ほとんどのAIエージェントのセットアップでは、アクセスしたいAPIごとにカスタムツールを構築する必要があります。gwsでは、ツールがすでに構築されています。エージェントはシェルコマンドを実行する方法を知っているだけで済みます。

100以上の組み込み済みエージェントスキル: リポジトリには100以上のSKILL.mdファイルが付属しています。サポートされているすべてのAPI用のファイルに加えて、一般的なワークフロー用のより高レベルのヘルパー、およびGmail、Drive、Docs、Calendar、Sheets用に厳選された50のレシピが含まれています。

ネイティブOpenClawサポート: GoogleはREADMEにOpenClawのセットアップ手順を直接含めました。これはコミュニティによるハックや回避策ではありません。組み込みの、ファーストクラスのサポートです。

MCPサーバー内蔵: gwsには、Google Workspace APIを構造化されたツールとして公開するModel Context Protocolサーバーが含まれています。MCP互換クライアント（Claude Desktop、Gemini CLI、VS Code）は、これらのツールを直接呼び出すことができます。

エージェントエコノミーのインフラ

多くの人が気づいているよりも速く、エージェントインフラの出現が起こっています。gwsのようなツールは、自律的なワークフローを強化する基盤を表しています。各SaaSプラットフォームにカスタム統合を構築する代わりに、エージェントは一貫した出力形式を持つ標準化されたCLIに頼ることができます。

これは、参入障壁を下げるため重要です。WorkspaceのAI自動化を構築するために、エンジニアのチームは必要ありません。npmと5分あれば十分です。

gwsの仕組み：アーキテクチャ

gwsは、理解しておく価値のある2段階の解析戦略を使用しています。

フェーズ1：サービス識別

gws drive files listを実行すると、CLIは最初の引数（drive）を読み取ってサービスを識別します。

フェーズ2：動的なコマンド構築

CLIは、GoogleからサービスのDiscovery Document（24時間キャッシュされる）を取得します。ドキュメントのリソースとメソッドからclap::Commandツリーを構築します。ここで魔法が起こります。コマンドインターフェース全体がGoogle独自のAPI仕様から生成されます。

フェーズ3：リクエスト実行

CLIは残りの引数を再解析し、設定された認証情報を使用して認証し、HTTPリクエストを構築して実行します。

すべての出力（成功応答、エラー、ダウンロードメタデータ）は構造化されたJSONです。

┌─────────────────────────────────────────────────────────┐
│  argv[1] = "drive"                                      │
│       ↓                                                 │
│  Discovery Documentを取得 (24時間キャッシュ)            │
│       ↓                                                 │
│  リソースとメソッドからclap::Commandツリーを構築        │
│       ↓                                                 │
│  残りの引数を再解析                                     │
│       ↓                                                 │
│  認証 → HTTPリクエスト構築 → 実行                       │
│       ↓                                                 │
│  出力: 構造化JSON                                       │
└─────────────────────────────────────────────────────────┘

このアーキテクチャにより、gwsは単一のコマンドをハードコーディングすることなく、すべてのGoogle Workspace APIをサポートできます。Discovery Documentは真実の源であり、gwsは毎回それをライブで読み取ります。

OpenClaw連携：ステップバイステップ

OpenClawは、WhatsApp、Telegram、Discordなどのメッセージングアプリに接続する自己ホスト型AIエージェントフレームワークです。gwsをOpenClawと統合すると、テキストメッセージを通じてGoogle Workspace全体を管理できるAIアシスタントが得られます。

Googleは、READMEにOpenClawのセットアップ手順を文字通り含めました。開始方法は次のとおりです。

オプション1：すべてのスキルをシンボリックリンクする（開発向け推奨）

# リポジトリをクローンする
git clone https://github.com/googleworkspace/cli.git
cd cli

# すべてのスキルをOpenClawスキルディレクトリにシンボリックリンクする
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/

これにより、すべてがリポジトリと同期されます。Googleがスキルを更新すると、自動的に更新が取得されます。

オプション2：特定のスキルをコピーする

# 必要なものだけ取得する
cp -r skills/gws-drive skills/gws-gmail ~/.openclaw/skills/

オプション3：Skills CLIを使用する

# すべてのスキルを一度にインストールする
npx skills add https://github.com/googleworkspace/cli

# または個別のスキルを選択する
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-drive
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail

gws-sharedスキル

gws-sharedスキルは特にスマートです。gwsがまだPATHにない場合、npmを介してCLIを自動インストールするインストールブロックが含まれています。OpenClawエージェントは自己ブートストラップできます。ツールをチェックし、必要に応じてインストールし、作業を開始します。手動設定は不要です。

WhatsAppを介したgwsの使用

統合後、次のようなメッセージを送信できます。

"今日の会議をカレンダーで確認して"
"上司からの未読メールを見つけて"
"Q2予算という名前で新しいスプレッドシートを作成して"
"このPDFをプロジェクトフォルダにアップロードして"

OpenClawはメッセージを受け取り、実行すべきgwsコマンドを決定し、それを実行し、結果を返します。すべてWhatsAppを通じて行われます。

100以上のエージェントスキルの内訳

リポジトリには、4つのカテゴリに分類された100以上のSKILL.mdファイルが付属しています。SKILL.md形式に精通していない場合、これはAIエージェントに構造化された構成可能な機能を与えるための新しい標準です。スキルはアプリのようなものですが、エージェントの知識とツールアクセス用だと考えてください。

サービススキル (25以上)

Google Workspace APIごとに1つのスキル。これらはビルディングブロックです。

追加のスキルには、Cloud Identity、Alert Center、Group Settings、Licensing、Reseller、および安全フィルタリング用のModel Armorが含まれます。

ペルソナスキル (10種類の組み込み済みエージェントロール)

Googleは、完全なエージェントロールを定義する10のすぐに使えるペルソナバンドルを作成しました。

各ペルソナは、その特定の役割に適切なサービススキル、ヘルパーコマンド、およびワークフローパターンをバンドルしています。エージェントに必要なGmail + Calendar + Drive + Sheetsスキルの組み合わせを自分で考える必要はありません。ペルソナを与えるだけで、エージェントは何をすべきかを知っています。

ヘルパースキル

これらは、最も一般的な操作のためのショートカットコマンドです。

• 簡単なファイルアップロード用の gws-drive-upload
• メール送信用の gws-gmail-send
• エージェントがプロンプトを処理する前にプロンプトをクリーンアップするための gws-modelarmor-sanitize-prompt

レシピスキル (50種類の厳選されたワークフロー)

実際のコマンドが組み込まれた多段階のタスクシーケンスです。例としては以下が含まれます。

• 外部共有されているDriveファイルの監査
• Sheetsデータからのパーソナライズされたメール送信
• カレンダーイベントからの会議議題の作成
• 複数の情報源からの週次ステータスレポートの生成

これらは、何時間ものプロンプトエンジニアリングを節約する「コピー＆ペーストで実行」できるワークフローです。

現実世界での自動化ワークフロー

gwsとOpenClawで自動化できる具体的な例を以下に示します。

Gmailの自動化

# 特定の送信者からの未読メールを受信トレイで検索する
gws gmail users.messages list \
  --params '{"userId": "me", "q": "from:boss@company.com is:unread"}'

# 特定のメールを読む
gws gmail users.messages get --params '{"userId": "me", "id": "MSG_ID"}'

# メールを送信する（ヘルパーがすべてのエンコードを処理します）
gws gmail +send --to alice@company.com --subject 'Q2 Report Ready' \
  --body 'Hey Alice, the Q2 report is ready for review.'

# 未読受信トレイを選別する（エージェントに優しい要約）
gws gmail +triage --max 5 --query 'from:boss'

カレンダー管理

# 今日のカレンダーを確認する
gws calendar +agenda

# 出席者との会議を作成する
gws calendar +insert --summary 'Weekly Standup' \
  --start '2026-03-10T09:00:00-07:00' \
  --end '2026-03-10T09:30:00-07:00'

# 詳細を含む定期的なイベントを作成する
gws calendar events insert \
  --params '{"calendarId": "primary"}' \
  --json '{
    "summary": "Weekly Standup",
    "start": {"dateTime": "2026-03-10T09:00:00", "timeZone": "America/Vancouver"},
    "end": {"dateTime": "2026-03-10T09:30:00", "timeZone": "America/Vancouver"},
    "recurrence": ["RRULE:FREQ=WEEKLY;BYDAY=MO"],
    "attendees": [{"email": "team@company.com"}]
  }'

# イベントを再スケジュールし、出席者に通知する
gws calendar events patch \
  --params '{"calendarId": "primary", "eventId": "EVENT_ID", "sendUpdates": "all"}' \
  --json '{
    "start": {"dateTime": "2026-03-10T14:00:00", "timeZone": "America/Vancouver"},
    "end": {"dateTime": "2026-03-10T15:00:00", "timeZone": "America/Vancouver"}
  }'

Driveファイル管理

# 最新のファイル10件をリスト表示する
gws drive files list --params '{"pageSize": 10}'

# 特定のフォルダにファイルをアップロードする
gws drive +upload --file ./report.pdf --parent FOLDER_ID

# 新しいプロジェクトフォルダを作成する
gws drive files create \
  --json '{"name": "Q2 Project", "mimeType": "application/vnd.google-apps.folder"}'

# ファイルをダウンロードする
gws drive files get \
  --params '{"fileId": "FILE_ID", "alt": "media"}' -o report.pdf

# GoogleドキュメントをPDFとしてエクスポートする
gws drive files export \
  --params '{"fileId": "FILE_ID", "mimeType": "application/pdf"}' -o document.pdf

# フォルダを同僚と共有する
gws drive permissions create \
  --params '{"fileId": "FOLDER_ID"}' \
  --json '{"role": "writer", "type": "user", "emailAddress": "colleague@company.com"}'

シート操作

# 特定の範囲からデータを読み取る
gws sheets +read --spreadsheet-id SHEET_ID --range 'Contacts!A2:C'

# 新しい行データを追加する
gws sheets +append --spreadsheet-id SHEET_ID --range 'Sheet1' \
  --values '["2026-03-05", "Marketing", "Ad spend", "1500"]'

# まったく新しいスプレッドシートを作成する
gws drive files create \
  --json '{"name": "Expense Tracker 2026", "mimeType": "application/vnd.google-apps.spreadsheet"}'

ドキュメントとコンテンツ作成

# 新しいドキュメントを作成する
gws docs documents create --json '{"title": "Meeting Notes - March 2026"}'

# 既存のドキュメントにコンテンツを書き込む
gws docs +write --document-id DOC_ID \
  --text '## Project: Q2 Launch\n\n### Objective\nLaunch the new feature by end of Q2.'

Chat、Meet、フォームなど

# Google Chatでチーム通知を送信する
gws chat +send --space spaces/TEAM_SPACE \
  --text '重要: 更新されたポリシーについてはメールを確認してください。'

# Google Meetルームを作成する
gws meet spaces create --json '{"config": {"accessType": "OPEN"}}'

# フィードバックフォームを作成する
gws forms forms create \
  --json '{"info": {"title": "イベントフィードバック", "documentTitle": "イベントフィードバックフォーム"}}'

# プレゼンテーションを作成する
gws slides presentations create --json '{"title": "四半期レビュー Q2"}'

パターンに注目してください。すべてのアクションは1行です。+ヘルパーコマンド（+send、+upload、+agenda、+triage、+read、+append、+writeなど）は、通常10行の定型コードが必要な面倒なエンコードとフォーマットをすべて処理します。エージェントはRFC 2822メールフォーマットやBase64エンコーディングについて知る必要はありません。何をしたいかを伝えるだけで、gwsが残りを処理します。

セキュリティとモデルアーマー

十分に注目されていないことが1つあります。リポジトリには、レスポンスのサニタイズのためのGoogle Cloud Model Armorとの連携が含まれています。

モデルアーマーとは？

エージェントがGmailやDriveからデータを読み取るとき、そのデータにはプロンプトインジェクション攻撃が含まれている可能性があります。誰かがエージェントの挙動を操作するように特別に設計されたメールを作成する可能性があります。Model Armorは、APIレスポンスがエージェントに到達する前にスキャンし、潜在的に悪意のあるコンテンツを除外します。

gws gmail users messages get --params '...' \
  --sanitize "projects/P/locations/L/templates/T"

サニタイズモード

なぜこれが重要なのか

CiscoのAIセキュリティチームは、ClawHub上の31,000以上のスキルの26%に脆弱性が含まれていることを発見しました。SecurityScorecardは、露出したOpenClawインスタンスの63%が誤設定されていると報告しています。エージェントのセキュリティは理論的な問題ではありません。それは今まさに起こっています。

データパイプラインに安全フィルタリングが組み込まれていることは、Googleにとって賢明な動きです。

セキュリティのための環境変数

# デフォルトのモデルアーマーテンプレート
export GOOGLE_WORKSPACE_CLI_SANITIZE_TEMPLATE="projects/P/locations/L/templates/T"

# サニタイズモード (warnまたはblock)
export GOOGLE_WORKSPACE_CLI_SANITIZE_MODE="block"

gwsと代替案の比較

gwsと、検討する可能性のある他のアプローチを比較してみましょう。

gws対gcloud CLI

インフラ管理にはgcloudを使用してください。Workspaceの自動化にはgwsを使用してください。

gws対Google Apps Script

Apps Scriptは、Google Workspace内でのワークフロー自動化に優れています。gwsは、外部ツールやAIエージェントにWorkspaceへのアクセスを提供することに優れています。

gws対サードパーティツール（Zapier、Make）

サードパーティツールは、非技術系ユーザーに適しています。gwsは、開発者やAIエージェントのセットアップに適しています。

クイックスタートガイド

試してみる準備はできましたか？作業環境をセットアップするための最速の方法を以下に示します。

前提条件

• Node.js 18以上 (npmインストール用)
• Google Cloudプロジェクト (OAuth認証情報用)
• Google WorkspaceにアクセスできるGoogleアカウント
• gcloud CLIがインストールされていること (任意ですが、最速のセットアップには推奨)

ステップ1：gwsをインストールする

npm install -g @googleworkspace/cli

npmパッケージには、お使いのOSとアーキテクチャ用にプリビルドされたネイティブバイナリがバンドルされています。Rustツールチェインは不要です。

ステップ2：認証を設定する

gws auth setup

これにより、Google Cloudプロジェクトの設定が行われます。Cloudプロジェクトを作成し、APIを有効にして、ログインします。

gcloudがインストールされていない場合は、Google Cloud Consoleから手動でOAuthを設定できます。

ステップ3：ログイン

gws auth login

これにより、OAuthスコープの選択とログインのためにブラウザが開きます。

ステップ4：セットアップをテストする

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

最近のファイルを含むJSONレスポンスが表示されるはずです。

ステップ5：OpenClawと連携する

# リポジトリをクローンする
git clone https://github.com/googleworkspace/cli.git
cd cli

# すべてのスキルをシンボリックリンクする
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/

ステップ6：メッセージングを介して使用を開始する

設定済みのOpenClawメッセージングプラットフォームを通じてメッセージを送信します。

"最近のDriveファイル5件をリスト表示して"

OpenClawは適切なgwsコマンドを実行し、結果を返します。

一般的な問題のトラブルシューティング

ログイン中に「アクセスがブロックされました」または403エラーが発生する

OAuthアプリがテストモードであり、あなたのアカウントがテストユーザーとしてリストされていません。

修正：GCPプロジェクトのOAuth同意画面を開き、「テストユーザー」に移動してGoogleアカウントのメールアドレスを追加し、再度gws auth loginを試してください。

「Googleがこのアプリを検証していません」

アプリがテストモードの場合、これは予期される動作です。「詳細」をクリックし、「(安全でないページに) 移動」をクリックして続行してください。これは個人使用では安全です。

スコープが多すぎるエラー

未検証（テストモード）のアプリは、約25のOAuthスコープに制限されています。推奨されるスコーププリセットには多くのスコープが含まれており、この制限を超える可能性があります。

修正：必要なスコープのみを選択してください。

gws auth login --scopes drive,gmail,calendar

APIが有効になっていません

必要なGoogle APIがGCPプロジェクトで有効になっていない場合、理由がaccessNotConfiguredである403エラーが表示されます。

gwsは、APIを有効にするためのリンクを含む実用的なヒントを表示します。リンクをクリックし、有効にして、約10秒待ってから再試行してください。

結論

Google Workspace CLIは、AIエージェントエコシステムにとって重要なものを表しています。単なるCLIラッパーではありません。npmがインストールされていれば誰でもAI自動化にアクセスできるようにするインフラです。

アーキテクチャは堅牢です。スキルの網羅範囲は素晴らしいです。Googleが初日からOpenClaw互換性を構築したという事実は、彼らがエージェントエコシステムがどこへ向かっていると考えているかを示しています。

OpenClaw、Claude Code、またはその他のエージェントプラットフォームを構築している開発者にとって、gwsはツールキットに入れておきたいツールの1つです。Google Workspace APIの複雑さを処理するため、エージェントは最も重要なこと、つまり仕事を成し遂げることに集中できます。

エージェントエコノミーはインフラを整えつつあります。そしてそれは、多くの人が気づいているよりも速く進行しています。

よくある質問

Q: gwsは無料で利用できますか？

A: はい、gwsはApache-2.0ライセンスの下でオープンソースです。無料枠を超過しない限り、Google APIの使用料はかかりません。

Q: Google Workspaceアカウントが必要ですか？

A: 標準のGoogleアカウントでほとんどの機能を利用できます。一部の管理APIにはWorkspaceサブスクリプションが必要です。

Q: OpenClawなしでgwsを使用できますか？

A: はい、もちろんです。gwsはスタンドアロンのCLIツールとして機能します。OpenClaw連携は、メッセージングベースのアクセスにはオプションです。

Q: gwsを更新するにはどうすればよいですか？

A: npm update -g @googleworkspace/cliを実行して最新バージョンを取得します。CLIは実行時にGoogleのDiscovery Serviceを読み取るため、常に最新のAPIにアクセスできます。

Q: gwsでのデータは安全ですか？

A: gwsは、OSのキーリング内のキーを使用してAES-256-GCMで暗号化された認証情報を保存します。Model Armor連携は、エージェントワークフローのセキュリティをさらに強化します。

Q: CI/CDパイプラインでgwsを使用できますか？

A: はい。gws auth export --unmasked > credentials.jsonで認証情報をエクスポートし、CI環境でGOOGLE_WORKSPACE_CLI_CREDENTIALS_FILEを設定してください。

Q: gwsとGoogle APIs Explorerの違いは何ですか？

A: gwsは、自動化およびAIエージェント連携用に設計されたCLIツールです。APIs Explorerはウェブベースのテストツールです。gwsは構造化されたJSONを出力し、スクリプト作成をサポートします。

Q: gwsはサービスアカウントで動作しますか？

A: はい。GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILEをサービスアカウントのJSONキーファイルに設定してください。インタラクティブなログインは不要です。

Q: gwsに貢献できますか？

A: はい、プロジェクトはGitHubでオープンソースです。ただし、リポジトリメンテナーの方針により、非協力者からのプルリクエストは一時的に無効になっています。

Q: gwsはどのプラットフォームをサポートしていますか？

A: gwsはmacOS、Linux、Windows用のプリビルドバイナリを同梱しています。npmパッケージはネイティブバイナリのインストールを自動的に処理します。