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.
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.
Opsi 1: Symlink Semua Keterampilan (Direkomendasikan untuk Pengembangan)
# 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:
- gws-drive-upload untuk unggah file cepat
- gws-gmail-send untuk mengirim email
- gws-modelarmor-sanitize-prompt untuk membersihkan _prompt_ sebelum mencapai agen Anda
Keterampilan Resep (50 Alur Kerja Terkurasi)
Urutan tugas multi-langkah dengan perintah nyata yang sudah tertanam. Contohnya termasuk:
- Mengaudit file Drive yang dibagikan secara eksternal
- Mengirim email personalisasi dari data Sheets
- Membuat agenda rapat dari acara Kalender
- Membuat laporan status mingguan dari berbagai sumber
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
- Node.js 18+ (untuk instalasi npm)
- Proyek Google Cloud (untuk kredensial OAuth)
- Akun Google dengan akses ke Google Workspace
- gcloud CLI terinstal (opsional tetapi direkomendasikan untuk penyiapan tercepat)
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.
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.
