Cara Menghubungkan Google Workspace CLI ke OpenClaw

Ashley Innocent

Ashley Innocent

6 March 2026

Cara Menghubungkan Google Workspace CLI ke OpenClaw

TL;DR

Google Workspace CLI (gws) adalah alat baris perintah yang memberikan agen AI akses langsung ke Gmail, Drive, Kalender, Sheets, Docs, dan setiap API Google Workspace melalui keluaran JSON terstruktur. Dengan dukungan OpenClaw asli dan 100+ keterampilan agen yang sudah ada, Anda dapat mengotomatiskan seluruh alur kerja Workspace Anda melalui aplikasi pesan seperti WhatsApp atau Discord. Penyiapan hanya membutuhkan waktu 5 menit dengan npm install -g @googleworkspace/cli diikuti oleh gws auth setup.

Pendahuluan

Bagaimana jika agen AI Anda dapat membaca Gmail Anda, memperbarui Kalender Anda, dan mengatur Google Drive Anda tanpa Anda perlu repot?

Sebagian besar alat otomatisasi Google Workspace memerlukan penyiapan API yang kompleks, kode khusus, atau layanan pihak ketiga yang mahal. Pengembang menghabiskan berjam-jam bergulat dengan alur OAuth, batas tarif, dan dokumentasi yang ketinggalan zaman. Sementara itu, agen AI tetap menganggur karena mereka tidak memiliki akses langsung ke alat yang kita gunakan setiap hari.

Insinyur Google baru saja merilis sesuatu yang mengubah segalanya. Google Workspace CLI (gws) telah mengumpulkan lebih dari 12.400 bintang GitHub dan dilengkapi dengan 100+ keterampilan agen yang sudah ada. Alat ini dibangun dengan Rust, membaca Discovery Service Google saat runtime, dan mengeluarkan JSON terstruktur yang dapat diurai oleh agen AI mana pun.

💡
Bagi pengembang yang membuat dan menguji API, integrasi ini membuka kemungkinan baru. Anda dapat menggunakan Apidog untuk merancang dan menguji API Anda sementara gws menangani semua otomatisasi Google Workspace - mulai dari mengirim notifikasi penerapan hingga menjadwalkan rapat tinjauan berdasarkan hasil pengujian.
button

Apa itu Google Workspace CLI?

Google Workspace CLI (gws) adalah alat baris perintah tunggal yang membungkus setiap API Google Workspace menjadi perintah yang bersih dan dapat disusun. Ini mencakup Gmail, Google Drive, Kalender, Sheets, Docs, Slides, Chat, Tasks, Meet, Forms, Keep, Classroom, Admin, dan pada dasarnya setiap API Google Workspace yang ada.

Inilah yang membuatnya berbeda dari alat CLI lain yang pernah Anda gunakan.

Sebagian besar alat pengembang dilengkapi dengan daftar perintah yang tetap. Ketika Google menambahkan endpoint API baru, seseorang harus memperbarui alat secara manual, mengeluarkan rilis baru, dan berharap semua orang melakukan pembaruan. Ini adalah siklus pemeliharaan yang tidak pernah berakhir. Sebagian besar pembungkus Google Workspace yang pernah Anda lihat sudah ketinggalan zaman saat Anda menginstalnya.

gws menyelesaikan masalah ini dengan cara yang sangat berbeda. Alih-alih mengodekan perintah secara _hardcode_, ia berbicara langsung dengan Google Discovery Service. Bayangkan ini sebagai katalog langsung Google sendiri dari setiap tindakan yang tersedia di semua aplikasi Workspace mereka. Setiap API, setiap metode, setiap parameter. Google memelihara katalog ini sendiri, dan selalu terbaru.

Saat Anda menjalankan gws, hal pertama yang dilakukannya adalah menarik katalog langsung ini dan membangun seluruh struktur perintahnya secara _on the fly_ dari apa pun yang Google katakan tersedia saat ini. Jika Google meluncurkan fitur Sheets baru pada pukul 2 siang hari ini, CLI Anda sudah mendukungnya pada pukul 2:01 siang. Tanpa pembaruan. Tanpa versi baru. Tanpa menunggu _maintainer_ untuk menyusul.

Alat ini secara harfiah tidak dapat ketinggalan karena selalu membaca dari sumber kebenaran setiap saat.

Contoh Singkat

# Daftar 10 file terbaru
gws drive files list --params '{"pageSize": 10}'

# Buat spreadsheet
gws sheets spreadsheets create --json '{"properties": {"title": "Anggaran Q1"}}'

# Kirim pesan Chat
gws chat spaces messages create \
  --params '{"parent": "spaces/xyz"}' \
  --json '{"text": "Penerapan selesai."}'

Setiap respons kembali dalam bentuk JSON terstruktur. Bukan HTML. Bukan teks terformat. Data yang bersih, dapat diprediksi, dan dapat dibaca mesin yang dapat segera dianalisis dan ditindaklanjuti oleh agen AI.

Mengapa gws Penting untuk Agen AI

Komunitas agen AI antusias dengan gws karena alasan teknis tertentu.

Keluaran JSON Terstruktur: Setiap respons kembali dalam bentuk JSON terstruktur. Agen Anda tidak perlu mengurai HTML atau menebak formatnya. Ia mendapatkan data bersih yang dapat segera digunakan.

Tidak Perlu Peralatan Kustom: Sebagian besar penyiapan agen AI mengharuskan Anda membangun alat kustom untuk setiap API yang ingin Anda akses. Dengan gws, peralatannya sudah dibuat. Agen Anda hanya perlu tahu cara menjalankan perintah _shell_.

100+ Keterampilan Agen yang Sudah Ada: Repo ini dilengkapi dengan lebih dari 100 file SKILL.md – satu untuk setiap API yang didukung, ditambah pembantu tingkat tinggi untuk alur kerja umum dan 50 resep pilihan untuk Gmail, Drive, Docs, Calendar, dan Sheets.

Dukungan OpenClaw Asli: Google menyertakan instruksi penyiapan OpenClaw langsung di README. Ini bukan _hack_ komunitas atau _workaround_. Ini adalah dukungan bawaan, kelas satu.

Server MCP Terpasang: gws menyertakan server Model Context Protocol yang mengekspos API Google Workspace sebagai alat terstruktur. Klien yang kompatibel dengan MCP (Claude Desktop, Gemini CLI, VS Code) dapat memanggil alat ini secara langsung.

Infrastruktur Ekonomi Agen

Kita melihat kemunculan infrastruktur agen lebih cepat dari yang disadari banyak orang. Alat seperti gws mewakili perpipaan yang akan menggerakkan alur kerja otonom. Alih-alih membangun integrasi kustom untuk setiap platform SaaS, agen dapat mengandalkan CLI standar dengan format keluaran yang konsisten.

Ini penting karena menurunkan hambatan masuk. Anda tidak memerlukan tim insinyur untuk membangun otomatisasi AI untuk Workspace Anda. Anda hanya perlu npm dan 5 menit.

Cara Kerja gws: Arsitektur

gws menggunakan strategi _parsing_ dua fase yang patut dipahami.

Fase 1: Identifikasi Layanan

Saat Anda menjalankan gws drive files list, CLI membaca argumen pertama (drive) untuk mengidentifikasi layanan.

Fase 2: Pembangunan Perintah Dinamis

CLI mengambil Dokumen Penemuan layanan dari Google (di-cache selama 24 jam). Ini membangun pohon clap::Command dari sumber daya dan metode dokumen tersebut. Di sinilah keajaiban terjadi – seluruh permukaan perintah dihasilkan dari spesifikasi API Google sendiri.

Fase 3: Eksekusi Permintaan

CLI mengurai ulang argumen yang tersisa, mengautentikasi menggunakan kredensial yang Anda konfigurasi, membangun permintaan HTTP, dan mengeksekusinya.

Semua keluaran – respons sukses, kesalahan, metadata unduhan – adalah JSON terstruktur.

┌─────────────────────────────────────────────────────────┐
│  argv[1] = "drive"                                      │
│       ↓                                                 │
│  Ambil Dokumen Penemuan (cache 24 jam)                 │
│       ↓                                                 │
│  Bangun pohon clap::Command dari sumber daya & metode     │
│       ↓                                                 │
│  Urai ulang argumen yang tersisa                          │
│       ↓                                                 │
│  Autentikasi → Bangun Permintaan HTTP → Eksekusi           │
│       ↓                                                 │
│  Keluaran: JSON Terstruktur                               │
└─────────────────────────────────────────────────────────┘

Arsitektur ini berarti gws dapat mendukung setiap API Google Workspace tanpa mengodekan satu perintah pun secara _hardcode_. Dokumen Penemuan adalah sumber kebenaran, dan gws membacanya secara langsung setiap saat.

Integrasi OpenClaw: Langkah demi Langkah

OpenClaw adalah kerangka kerja agen AI yang di-host sendiri yang terhubung ke aplikasi perpesanan seperti WhatsApp, Telegram, dan Discord. Ketika Anda mengintegrasikan gws dengan OpenClaw, Anda mendapatkan asisten AI yang dapat mengelola seluruh Google Workspace Anda melalui pesan teks.

Google secara harfiah menyertakan instruksi penyiapan OpenClaw di README. Berikut cara memulainya.

# Kloning repo
git clone https://github.com/googleworkspace/cli.git
cd cli

# Symlink semua keterampilan ke direktori keterampilan OpenClaw Anda
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/

Ini menjaga semuanya tetap sinkron dengan repo. Ketika Google memperbarui keterampilan, Anda mendapatkan pembaruan secara otomatis.

Opsi 2: Salin Keterampilan Tertentu

# Ambil hanya yang Anda butuhkan
cp -r skills/gws-drive skills/gws-gmail ~/.openclaw/skills/

Opsi 3: Gunakan CLI Keterampilan

# Instal semua keterampilan sekaligus
npx skills add https://github.com/googleworkspace/cli

# Atau pilih keterampilan individu
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

Keterampilan gws-shared

Keterampilan gws-shared sangat cerdas. Ini mencakup blok instalasi yang secara otomatis menginstal CLI melalui npm jika gws belum ada di PATH Anda. Agen OpenClaw Anda dapat melakukan _bootstrapping_ sendiri - ia memeriksa alat, menginstalnya jika diperlukan, dan mulai bekerja. Tidak ada penyiapan manual yang diperlukan.

Menggunakan gws Melalui WhatsApp

Setelah terintegrasi, Anda dapat mengirim pesan seperti:

"Periksa kalender saya untuk rapat hari ini"
"Temukan email yang belum dibaca dari bos saya"
"Buat spreadsheet baru bernama Anggaran Q2"
"Unggah PDF ini ke folder Proyek"

OpenClaw menerima pesan Anda, menentukan perintah gws mana yang akan dijalankan, mengeksekusinya, dan mengirimkan kembali hasilnya – semuanya melalui WhatsApp.

Rincian 100+ Keterampilan Agen

Repo ini dilengkapi dengan lebih dari 100 file SKILL.md yang diatur ke dalam empat kategori. Jika Anda tidak familiar dengan format SKILL.md, ini adalah standar yang berkembang untuk memberikan agen AI kemampuan yang terstruktur dan dapat disusun. Anggaplah keterampilan seperti aplikasi tetapi untuk pengetahuan agen dan akses alat.

Keterampilan Layanan (25+)

Satu keterampilan per API Google Workspace. Ini adalah blok bangunan Anda:

Keterampilan Tujuan
gws-drive Mengelola file, folder, dan drive bersama
gws-gmail Mengirim, membaca, dan mengelola email
gws-calendar Mengelola kalender dan acara
gws-sheets Membaca dan menulis spreadsheet
gws-docs Membaca dan menulis Google Docs
gws-slides Presentasi
gws-tasks Daftar tugas
gws-chat Ruang dan pesan Google Chat
gws-people Kontak dan profil
gws-admin Mengelola pengguna, grup, dan perangkat
gws-classroom Kelas, daftar nama, dan materi pelajaran
gws-forms Google Forms
gws-keep Catatan Google Keep
gws-meet Manajemen konferensi
gws-vault eDiscovery
gws-apps-script Mengelola proyek Apps Script

Keterampilan tambahan mencakup Cloud Identity, Pusat Peringatan, Pengaturan Grup, Lisensi, Reseller, dan Model Armor untuk penyaringan keamanan.

Keterampilan Persona (10 Peran Agen yang Sudah Dibangun)

Google menciptakan 10 paket persona siap pakai yang mendefinisikan peran agen lengkap:

Persona Tanggung Jawab
Asisten Eksekutif Mengelola jadwal, kotak masuk, dan komunikasi
Manajer Proyek Mengoordinasikan proyek, melacak tugas, menjadwalkan rapat
Koordinator HR Menangani orientasi, pengumuman, komunikasi karyawan
Operasional Penjualan Mengelola alur kerja penjualan, melacak kesepakatan, menjadwalkan panggilan
Admin IT Mengelola pengguna, memantau keamanan, mengonfigurasi Workspace
Pembuat Konten Membuat, mengatur, dan mendistribusikan konten
Dukungan Pelanggan Mengelola tiket, menanggapi masalah, menangani eskalasi
Koordinator Acara Merencanakan acara, mengelola undangan, menangani logistik
Pemimpin Tim Menjalankan _standup_, mengoordinasikan tugas, mengelola komunikasi tim
Peneliti Mengatur penelitian, mengelola referensi, menangani kolaborasi

Setiap persona menggabungkan keterampilan layanan yang tepat, perintah pembantu, dan pola alur kerja untuk peran tertentu tersebut. Anda tidak perlu mencari tahu kombinasi keterampilan Gmail + Kalender + Drive + Sheets mana yang dibutuhkan agen Anda. Cukup berikan persona tersebut dan ia tahu apa yang harus dilakukan.

Keterampilan Pembantu

Ini adalah perintah pintasan untuk operasi yang paling umum:

Keterampilan Resep (50 Alur Kerja Terkurasi)

Urutan tugas multi-langkah dengan perintah nyata yang sudah tertanam. Contohnya termasuk:

Ini adalah alur kerja “salin-tempel dan jalan” yang menghemat waktu berjam-jam _prompt engineering_.

Alur Kerja Otomatisasi Dunia Nyata

Berikut adalah contoh nyata dari apa yang dapat Anda otomatisasi dengan gws dan OpenClaw.

Otomatisasi Gmail

# Cari kotak masuk Anda untuk email yang belum dibaca dari pengirim tertentu
gws gmail users.messages list \
  --params '{"userId": "me", "q": "from:boss@company.com is:unread"}'

# Baca email tertentu
gws gmail users.messages get --params '{"userId": "me", "id": "MSG_ID"}'

# Kirim email (pembantu menangani semua pengodean)
gws gmail +send --to alice@company.com --subject 'Laporan Q2 Siap' \
  --body 'Hai Alice, laporan Q2 sudah siap untuk ditinjau.'

# Pilah kotak masuk Anda yang belum dibaca (ringkasan ramah agen)
gws gmail +triage --max 5 --query 'from:boss'

Manajemen Kalender

# Lihat apa yang ada di kalender Anda hari ini
gws calendar +agenda

# Buat rapat dengan peserta
gws calendar +insert --summary 'Rapat Mingguan' \
  --start '2026-03-10T09:00:00-07:00' \
  --end '2026-03-10T09:30:00-07:00'

# Buat acara berulang dengan semua detail
gws calendar events insert \
  --params '{"calendarId": "primary"}' \
  --json '{
    "summary": "Rapat Mingguan",
    "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"}]
  }'

# Jadwalkan ulang acara dan beritahu peserta
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"}
  }'

Manajemen File Drive

# Daftar 10 file terbaru Anda
gws drive files list --params '{"pageSize": 10}'

# Unggah file ke folder tertentu
gws drive +upload --file ./report.pdf --parent FOLDER_ID

# Buat folder proyek baru
gws drive files create \
  --json '{"name": "Proyek Q2", "mimeType": "application/vnd.google-apps.folder"}'

# Unduh file
gws drive files get \
  --params '{"fileId": "FILE_ID", "alt": "media"}' -o report.pdf

# Ekspor Google Doc sebagai PDF
gws drive files export \
  --params '{"fileId": "FILE_ID", "mimeType": "application/pdf"}' -o document.pdf

# Bagikan folder dengan kolega
gws drive permissions create \
  --params '{"fileId": "FOLDER_ID"}' \
  --json '{"role": "writer", "type": "user", "emailAddress": "colleague@company.com"}'

Operasi Sheets

# Baca data dari rentang tertentu
gws sheets +read --spreadsheet-id SHEET_ID --range 'Kontak!A2:C'

# Tambahkan baris data baru
gws sheets +append --spreadsheet-id SHEET_ID --range 'Sheet1' \
  --values '["2026-03-05", "Pemasaran", "Belanja iklan", "1500"]'

# Buat spreadsheet baru
gws drive files create \
  --json '{"name": "Pelacak Pengeluaran 2026", "mimeType": "application/vnd.google-apps.spreadsheet"}'

Pembuatan Dokumen dan Konten

# Buat dokumen baru
gws docs documents create --json '{"title": "Catatan Rapat - Maret 2026"}'

# Tulis konten ke dokumen yang sudah ada
gws docs +write --document-id DOC_ID \
  --text '## Proyek: Peluncuran Q2\n\n### Tujuan\nMeluncurkan fitur baru pada akhir Q2.'

Chat, Meet, Formulir, dan Lainnya

# Kirim notifikasi tim di Google Chat
gws chat +send --space spaces/TEAM_SPACE \
  --text 'Penting: Harap periksa email Anda untuk kebijakan yang diperbarui.'

# Buat ruang Google Meet
gws meet spaces create --json '{"config": {"accessType": "OPEN"}}'

# Buat formulir umpan balik
gws forms forms create \
  --json '{"info": {"title": "Umpan Balik Acara", "documentTitle": "Formulir Umpan Balik Acara"}}'

# Buat presentasi
gws slides presentations create --json '{"title": "Tinjauan Triwulanan Q2"}'

Perhatikan polanya. Setiap tindakan adalah satu baris. Perintah pembantu + (seperti +send, +upload, +agenda, +triage, +read, +append, +write) menangani semua pengodean dan pemformatan yang rumit yang biasanya membutuhkan 10 baris _boilerplate_. Agen Anda tidak perlu tahu tentang format email RFC 2822 atau pengodean base64. Ia hanya mengatakan apa yang ingin dilakukannya dan gws menangani sisanya.

Keamanan dan Model Armor

Ini adalah sesuatu yang tidak mendapatkan cukup perhatian. Repo ini mencakup integrasi dengan Google Cloud Model Armor untuk sanitasi respons.

Apa itu Model Armor?

Ketika agen Anda membaca data dari Gmail atau Drive, data tersebut dapat mengandung serangan _prompt injection_. Seseorang dapat membuat email yang dirancang khusus untuk memanipulasi perilaku agen Anda. Model Armor memindai respons API sebelum mencapai agen Anda dan menyaring konten yang berpotensi berbahaya.

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

Mode Sanitasi

Mode Perilaku
warn Menandai konten mencurigakan tetapi tetap mengembalikannya
block Menghilangkan konten yang berpotensi berbahaya secara keseluruhan

Mengapa Ini Penting

Tim keamanan AI Cisco menemukan bahwa 26% dari lebih dari 31.000 keterampilan di ClawHub mengandung kerentanan. SecurityScorecard melaporkan bahwa 63% instans OpenClaw yang terekspos salah dikonfigurasi. Keamanan agen bukan masalah teoretis. Ini sedang terjadi sekarang.

Memiliki penyaringan keamanan yang terintegrasi ke dalam _pipeline_ data adalah langkah cerdas dari Google.

Variabel Lingkungan untuk Keamanan

# Templat Model Armor default
export GOOGLE_WORKSPACE_CLI_SANITIZE_TEMPLATE="projects/P/locations/L/templates/T"

# Mode sanitasi (peringatan atau blokir)
export GOOGLE_WORKSPACE_CLI_SANITIZE_MODE="block"

gws vs Alternatif

Mari kita bandingkan gws dengan pendekatan lain yang mungkin Anda pertimbangkan.

gws vs gcloud CLI

Fitur gws gcloud CLI
Cakupan API Google Workspace Semua layanan Google Cloud
Keterampilan Agen 100+ yang sudah dibangun Tidak ada
Dukungan OpenClaw Asli Penyiapan manual
Format Keluaran JSON terstruktur Bervariasi
Khusus Workspace Ya Sebagian

Gunakan gcloud untuk manajemen infrastruktur. Gunakan gws untuk otomatisasi Workspace.

gws vs Google Apps Script

Fitur gws Apps Script
Eksekusi CLI lokal / agen AI Berbasis _cloud_
Bahasa Perintah _shell_ JavaScript
Integrasi AI Bawaan Manual
Otentikasi OAuth / Akun Layanan OAuth
Kasus Penggunaan Otomatisasi / Agen Otomatisasi dalam Workspace

Apps Script sangat baik dalam mengotomatisasi alur kerja di dalam Google Workspace. gws sangat baik dalam memberikan alat eksternal dan agen AI akses ke Workspace.

gws vs Alat Pihak Ketiga (Zapier, Make)

Fitur gws Zapier/Make
Biaya Gratis $20-500/bulan
Kustomisasi Kontrol penuh Terbatas pada platform
Batas Tarif Hanya batas API Google Batas platform
Privasi Data Eksekusi lokal Server pihak ketiga
Kurva Belajar Teknis _Low-code_

Alat pihak ketiga masuk akal untuk pengguna non-teknis. gws masuk akal untuk pengembang dan penyiapan agen AI.


Panduan Memulai

Siap mencoba ini? Berikut adalah jalur tercepat untuk penyiapan yang berfungsi.

Prasyarat

Langkah 1: Instal gws

npm install -g @googleworkspace/cli

Paket npm menggabungkan biner asli yang sudah dibangun untuk OS dan arsitektur Anda. Tidak perlu _toolchain_ Rust.

Langkah 2: Siapkan Autentikasi

gws auth setup

Ini memandu Anda melalui konfigurasi proyek Google Cloud. Ini membuat proyek Cloud, mengaktifkan API, dan membuat Anda masuk.

Jika Anda tidak menginstal gcloud, Anda dapat menyiapkan OAuth secara manual melalui Google Cloud Console.

Langkah 3: Masuk

gws auth login

Ini membuka browser untuk pemilihan cakupan OAuth dan login.

Langkah 4: Uji Penyiapan Anda

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

Anda akan melihat respons JSON dengan file terbaru Anda.

Langkah 5: Integrasikan dengan OpenClaw

# Kloning repo
git clone https://github.com/googleworkspace/cli.git
cd cli

# Symlink semua keterampilan
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/

Langkah 6: Mulai Gunakan Melalui Pesan

Kirim pesan melalui platform perpesanan OpenClaw yang Anda konfigurasi:

"Daftar 5 file Drive terbaru saya"

OpenClaw akan mengeksekusi perintah gws yang sesuai dan mengirimkan kembali hasilnya.

Pemecahan Masalah Umum

"Akses diblokir" atau 403 saat masuk

Aplikasi OAuth Anda dalam mode pengujian dan akun Anda tidak terdaftar sebagai pengguna uji.

Solusi: Buka layar persetujuan OAuth di proyek GCP Anda, buka Pengguna uji, tambahkan email akun Google Anda, lalu coba lagi gws auth login.

"Google belum memverifikasi aplikasi ini"

Diharapkan saat aplikasi Anda dalam mode pengujian. Klik Lanjutan, lalu "Lanjutkan ke (tidak aman)" untuk melanjutkan. Ini aman untuk penggunaan pribadi.

Kesalahan cakupan terlalu banyak

Aplikasi yang tidak terverifikasi (mode pengujian) dibatasi hingga sekitar 25 cakupan OAuth. Preset cakupan yang direkomendasikan mencakup banyak cakupan dan akan melebihi batas ini.

Solusi: Pilih hanya cakupan yang Anda butuhkan:

gws auth login --scopes drive,gmail,calendar

API tidak diaktifkan

Jika API Google yang diperlukan tidak diaktifkan untuk proyek GCP Anda, Anda akan melihat kesalahan 403 dengan alasan `accessNotConfigured`.

gws mencetak petunjuk yang dapat ditindaklanjuti dengan tautan untuk mengaktifkan API. Klik tautan, aktifkan, tunggu sekitar 10 detik, lalu coba lagi.

Kesimpulan

Google Workspace CLI merepresentasikan sesuatu yang signifikan bagi ekosistem agen AI. Ini bukan hanya pembungkus CLI lain. Ini adalah infrastruktur yang membuat otomatisasi AI dapat diakses oleh siapa saja yang menginstal npm.

Arsitekturnya kokoh. Cakupan keterampilannya mengesankan. Fakta bahwa Google membangun kompatibilitas OpenClaw sejak hari pertama memberitahu Anda ke mana mereka pikir ekosistem agen akan menuju.

Bagi pengembang yang membangun di OpenClaw, Claude Code, atau platform agen apa pun, gws adalah salah satu alat yang ingin Anda miliki dalam perangkat Anda. Ini menangani kompleksitas API Google Workspace sehingga agen Anda dapat fokus pada hal yang penting – menyelesaikan pekerjaan.

Ekonomi agen mendapatkan infrastrukturnya. Dan itu terjadi lebih cepat dari yang disadari kebanyakan orang.

button

FAQ

T: Apakah gws gratis untuk digunakan?

J: Ya, gws adalah sumber terbuka di bawah lisensi Apache-2.0. Anda hanya membayar untuk penggunaan Google API jika Anda melebihi kuota gratis.

T: Apakah saya memerlukan akun Google Workspace?

J: Akun Google standar berfungsi untuk sebagian besar fitur. Beberapa API Admin memerlukan langganan Workspace.

T: Bisakah saya menggunakan gws tanpa OpenClaw?

J: Tentu saja. gws berfungsi sebagai alat CLI mandiri. Integrasi OpenClaw bersifat opsional untuk akses berbasis pesan.

T: Bagaimana cara memperbarui gws?

J: Jalankan npm update -g @googleworkspace/cli untuk mendapatkan versi terbaru. CLI membaca Google Discovery Service saat runtime, sehingga selalu memiliki akses ke API terbaru.

T: Apakah data saya aman dengan gws?

J: gws menyimpan kredensial yang dienkripsi saat tidak aktif menggunakan AES-256-GCM dengan kunci di _keyring_ OS Anda. Integrasi Model Armor menyediakan keamanan tambahan untuk alur kerja agen.

T: Bisakah saya menggunakan gws di _pipeline_ CI/CD?

J: Ya. Ekspor kredensial Anda dengan gws auth export --unmasked > credentials.json dan atur GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE di lingkungan CI Anda.

T: Apa perbedaan antara gws dan Google APIs Explorer?

J: gws adalah alat CLI yang dirancang untuk otomatisasi dan integrasi agen AI. APIs Explorer adalah alat pengujian berbasis web. gws mengeluarkan JSON terstruktur dan mendukung _scripting_.

T: Apakah gws bekerja dengan akun layanan?

J: Ya. Atur GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE ke file kunci JSON akun layanan Anda. Tidak perlu login interaktif.

T: Bisakah saya berkontribusi pada gws?

J: Ya, proyek ini adalah sumber terbuka di GitHub. Perhatikan bahwa _pull request_ dari non-kolaborator dinonaktifkan sementara sesuai dengan pengelola repositori.

T: Platform apa saja yang didukung gws?

J: gws dilengkapi dengan biner _pre-built_ untuk macOS, Linux, dan Windows. Paket npm menangani instalasi biner asli secara otomatis.

Mengembangkan API dengan Apidog

Apidog adalah alat pengembangan API yang membantu Anda mengembangkan API dengan lebih mudah dan efisien.

Cara Menghubungkan Google Workspace CLI ke OpenClaw