KISA ÖZET
Google Workspace CLI (gws), yapay zeka aracılarına Gmail, Drive, Takvim, E-Tablolar, Dokümanlar ve her Google Workspace API'ye yapılandırılmış JSON çıktısı aracılığıyla doğrudan erişim sağlayan bir komut satırı aracıdır. Yerel OpenClaw desteği ve 100'den fazla önceden oluşturulmuş aracı becerisi sayesinde, tüm Workspace iş akışınızı WhatsApp veya Discord gibi mesajlaşma uygulamaları aracılığıyla otomatikleştirebilirsiniz. Kurulum, npm install -g @googleworkspace/cli ardından gws auth setup komutuyla 5 dakika sürer.
Giriş
Yapay zeka aracınızın, siz parmağınızı bile oynatmadan Gmail'inizi okuyabildiğini, Takviminizi güncelleyebildiğini ve Google Drive'ınızı düzenleyebildiğini hayal edin.
Çoğu Google Workspace otomasyon aracı, karmaşık API kurulumları, özel kodlar veya pahalı üçüncü taraf hizmetler gerektirir. Geliştiriciler, OAuth akışları, hız limitleri ve güncel olmayan belgelerle uğraşarak saatlerini harcıyorlar. Bu arada, yapay zeka aracıları, her gün kullandığımız araçlara doğrudan erişimleri olmadığı için boşta oturuyorlar.
Google mühendisleri her şeyi değiştiren bir şey yayınladılar. Google Workspace CLI (gws) şimdiden 12.400'den fazla GitHub yıldızı topladı ve 100'den fazla önceden oluşturulmuş aracı becerisiyle birlikte geliyor. Rust ile geliştirildi, çalışma zamanında Google'ın Keşif Hizmeti'ni (Discovery Service) okur ve herhangi bir yapay zeka aracının ayrıştırabileceği yapılandırılmış JSON çıktısı üretir.
Google Workspace CLI Nedir?
Google Workspace CLI (gws), her Google Workspace API'sini düzenli, birleştirilebilir komutlara dönüştüren tek bir komut satırı aracıdır. Gmail, Google Drive, Takvim, E-Tablolar, Dokümanlar, Slaytlar, Chat, Görevler, Meet, Formlar, Keep, Classroom, Yönetim ve temelde var olan her Google Workspace API'sini kapsar.
İşte onu kullandığınız diğer CLI araçlarından ayıran özellikler.
Çoğu geliştirici aracı sabit bir komut listesiyle birlikte gelir. Google yeni bir API uç noktası eklediğinde, birilerinin aracı manuel olarak güncellemesi, yeni bir sürüm çıkarması ve herkesin yükseltmesini umması gerekir. Bu, hiç bitmeyen bir bakım döngüsüdür. Gördüğünüz çoğu Google Workspace sarmalayıcısı, siz onları kurduğunuzda zaten güncelliğini yitirmiş durumdadır.
gws bunu temelden farklı bir şekilde çözer. Komutları sabit kodlamak yerine, doğrudan Google'ın Keşif Hizmeti (Discovery Service) ile konuşur. Bunu, Google'ın tüm Workspace uygulamalarında mevcut olan her bir eylemin kendi canlı kataloğu olarak düşünebilirsiniz. Her API, her yöntem, her parametre. Google bu kataloğu kendisi sürdürür ve her zaman günceldir.
gws'yi çalıştırdığınızda, yaptığı ilk şey bu canlı kataloğu çekmek ve şu anda Google'ın mevcut olduğunu söylediği her şeyden tüm komut yapısını anında oluşturmaktır. Google bugün saat 14:00'te yeni bir E-Tablolar özelliği yayınlarsa, CLI'nız saat 14:01'de bunu zaten destekler. Güncelleme yok. Yeni sürüm yok. Bir bakımcının yetişmesini bekleme yok.
Araç, her seferinde doğru kaynaktan okuduğu için kelimenin tam anlamıyla geride kalamaz.
Hızlı Örnek
# Son 10 dosyayı listele
gws drive files list --params '{"pageSize": 10}'
# Bir e-tablo oluştur
gws sheets spreadsheets create --json '{"properties": {"title": "Q1 Bütçesi"}}'
# Bir Sohbet mesajı gönder
gws chat spaces messages create \
--params '{"parent": "spaces/xyz"}' \
--json '{"text": "Dağıtım tamamlandı."}'
Her yanıt yapılandırılmış JSON olarak gelir. HTML değil. Biçimlendirilmiş metin değil. Temiz, öngörülebilir, makine tarafından okunabilir veriler, bir yapay zeka aracısının hemen analiz edip üzerinde işlem yapabileceği veriler.
gws Yapay Zeka Aracıları İçin Neden Önemli?
Yapay zeka aracıları topluluğu, belirli teknik nedenlerden dolayı gws hakkında heyecanlı.
Yapılandırılmış JSON Çıktısı: Her bir yanıt yapılandırılmış JSON olarak geri döner. Aracınızın HTML'yi ayrıştırmasına veya biçimlendirmeyi tahmin etmesine gerek yoktur. Hemen kullanabileceği temiz veriler elde eder.
Özel Araç Gerekmez: Çoğu yapay zeka aracı kurulumu, erişmek istediğiniz her API için özel araçlar oluşturmanızı gerektirir. gws ile araçlar zaten oluşturulmuştur. Aracınızın yalnızca kabuk komutlarını nasıl yürüteceğini bilmesi yeterlidir.
100'den Fazla Önceden Oluşturulmuş Aracı Becerisi: Depo, 100'den fazla SKILL.md dosyasıyla birlikte gelir - her desteklenen API için bir tane, ayrıca yaygın iş akışları için üst düzey yardımcılar ve Gmail, Drive, Dokümanlar, Takvim ve E-Tablolar için 50 derlenmiş tarif.
Yerel OpenClaw Desteği: Google, OpenClaw kurulum talimatlarını doğrudan README'ye dahil etti. Bu bir topluluk hack'i veya geçici çözüm değil. Bu, yerleşik, birinci sınıf bir destektir.
Dahili MCP Sunucusu: gws, Google Workspace API'lerini yapılandırılmış araçlar olarak ifşa eden bir Model Bağlam Protokolü (Model Context Protocol - MCP) sunucusu içerir. Herhangi bir MCP uyumlu istemci (Claude Desktop, Gemini CLI, VS Code) bu araçları doğrudan çağırabilir.
Aracı Ekonomisi Altyapısı
Çoğu insanın fark ettiğinden daha hızlı bir şekilde aracı altyapısının ortaya çıktığını görüyoruz. gws gibi araçlar, otonom iş akışlarına güç verecek tesisatları temsil ediyor. Her SaaS platformu için özel entegrasyonlar oluşturmak yerine, aracılar tutarlı çıktı formatlarına sahip standartlaştırılmış CLI'lara güvenebilirler.
Bu önemlidir çünkü giriş engelini düşürür. Workspace'iniz için yapay zeka otomasyonu oluşturmak için bir mühendis ekibine ihtiyacınız yok. npm'e ve 5 dakikaya ihtiyacınız var.
gws Nasıl Çalışır: Mimari
gws, anlaşılması gereken iki aşamalı bir ayrıştırma stratejisi kullanır.
Aşama 1: Hizmet Tanımlama
gws drive files list komutunu çalıştırdığınızda, CLI ilk argümanı (drive) okuyarak hizmeti tanımlar.
Aşama 2: Dinamik Komut Oluşturma
CLI, hizmetin Keşif Belgesini (Discovery Document) Google'dan getirir (24 saat önbelleğe alınır). Belgenin kaynaklarından ve yöntemlerinden bir clap::Command ağacı oluşturur. İşte sihrin gerçekleştiği yer burasıdır - tüm komut yüzeyi, Google'ın kendi API spesifikasyonundan dinamik olarak oluşturulur.
Aşama 3: İstek Yürütme
CLI kalan argümanları yeniden ayrıştırır, yapılandırılmış kimlik bilgilerinizle kimlik doğrulaması yapar, HTTP isteğini oluşturur ve yürütür.
Tüm çıktı - başarı yanıtları, hatalar, indirme meta verileri - yapılandırılmış JSON'dur.
┌─────────────────────────────────────────────────────────┐
│ argv[1] = "drive" │
│ ↓ │
│ Keşif Belgesini Getir (24s önbelleğe alınmış) │
│ ↓ │
│ Kaynaklar ve yöntemlerden clap::Command ağacı oluştur │
│ ↓ │
│ Kalan argümanları yeniden ayrıştır │
│ ↓ │
│ Kimlik Doğrula → HTTP İsteğini Oluştur → Yürüt │
│ ↓ │
│ Çıktı: Yapılandırılmış JSON │
└─────────────────────────────────────────────────────────┘
Bu mimari, gws'nin tek bir komutu sabit kodlamadan her Google Workspace API'sini destekleyebileceği anlamına gelir. Keşif Belgesi (Discovery Document) gerçek kaynaktır ve gws her seferinde onu canlı olarak okur.
OpenClaw Entegrasyonu: Adım Adım
OpenClaw, WhatsApp, Telegram ve Discord gibi mesajlaşma uygulamalarına bağlanan, kendi kendine barındırılan bir yapay zeka aracı çerçevesidir. gws'yi OpenClaw ile entegre ettiğinizde, tüm Google Workspace'inizi metin mesajları aracılığıyla yönetebilen bir yapay zeka asistanı edinirsiniz.
Google, OpenClaw kurulum talimatlarını doğrudan README'ye dahil etti. İşte nasıl başlayacağınız.
Seçenek 1: Tüm Becerileri Sembolik Bağla (Geliştirme için Önerilir)
# Depoyu klonla
git clone https://github.com/googleworkspace/cli.git
cd cli
# Tüm becerileri OpenClaw beceri dizininize sembolik bağla
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/
Bu, her şeyi depoyla senkronize tutar. Google becerileri güncellediğinde, güncellemeleri otomatik olarak alırsınız.
Seçenek 2: Belirli Becerileri Kopyala
# Sadece ihtiyacınız olanları alın
cp -r skills/gws-drive skills/gws-gmail ~/.openclaw/skills/
Seçenek 3: Beceriler CLI'sini Kullanın
# Tüm becerileri bir kerede yükle
npx skills add https://github.com/googleworkspace/cli
# Veya ayrı ayrı becerileri seçin
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 Becerisi
gws-shared becerisi özellikle akıllıdır. gws zaten PATH'nizde yoksa, CLI'yi npm aracılığıyla otomatik olarak yükleyen bir kurulum bloğu içerir. OpenClaw aracınız kendini başlatabilir - aracı kontrol eder, gerekirse yükler ve çalışmaya başlar. Manuel kurulum gerekmez.
WhatsApp Aracılığıyla gws Kullanımı
Entegre edildikten sonra, şöyle mesajlar gönderebilirsiniz:
"Takvimimi bugünkü toplantılar için kontrol et"
"Patronumdan gelen okunmamış e-postaları bul"
"Q2 Bütçesi adlı yeni bir e-tablo oluştur"
"Bu PDF'yi Projeler klasörüne yükle"
OpenClaw mesajınızı alır, hangi gws komutunu çalıştıracağına karar verir, onu yürütür ve sonuçları geri gönderir - hepsi WhatsApp aracılığıyla.
100'den Fazla Aracı Becerisi Detaylı İncelemesi
Depo, dört kategoriye ayrılmış 100'den fazla SKILL.md dosyasıyla birlikte gelir. SKILL.md formatına aşina değilseniz, bu, yapay zeka aracılarına yapılandırılmış, birleştirilebilir yetenekler sağlamak için yükselen bir standarttır. Becerileri, uygulamalar gibi, ancak aracı bilgisi ve araç erişimi için düşünün.
Hizmet Becerileri (25+)
Her Google Workspace API'si için bir beceri. Bunlar yapı taşlarınızdır:
| Beceri | Amaç |
|---|---|
| gws-drive | Dosyaları, klasörleri ve paylaşılan sürücüleri yönetme |
| gws-gmail | E-posta gönderme, okuma ve yönetme |
| gws-calendar | Takvimleri ve etkinlikleri yönetme |
| gws-sheets | E-tabloları okuma ve yazma |
| gws-docs | Google Dokümanları okuma ve yazma |
| gws-slides | Sunumlar |
| gws-tasks | Görev listeleri |
| gws-chat | Google Chat alanları ve mesajları |
| gws-people | Kişiler ve profiller |
| gws-admin | Kullanıcıları, grupları ve cihazları yönetme |
| gws-classroom | Sınıflar, listeler ve ders içeriği |
| gws-forms | Google Formlar |
| gws-keep | Google Keep notları |
| gws-meet | Konferans yönetimi |
| gws-vault | eKeşif |
| gws-apps-script | Apps Script projelerini yönetme |
Ek beceriler Cloud Identity, Uyarı Merkezi, Grup Ayarları, Lisanslama, Satıcı ve güvenlik filtrelemesi için Model Armor'u kapsar.
Persona Becerileri (10 Önceden Oluşturulmuş Aracı Rolü)
Google, eksiksiz aracı rollerini tanımlayan 10 kullanıma hazır persona paketi oluşturdu:
| Persona | Sorumluluklar |
|---|---|
| Yönetici Asistanı | Programları, gelen kutusunu ve iletişimi yönetir |
| Proje Yöneticisi | Projeleri koordine eder, görevleri takip eder, toplantıları planlar |
| İnsan Kaynakları Koordinatörü | İşe alım, duyurular, çalışan iletişimlerini yönetir |
| Satış Operasyonları | Satış iş akışlarını yönetir, anlaşmaları takip eder, aramaları planlar |
| BT Yöneticisi | Kullanıcıları yönetir, güvenliği izler, Workspace'i yapılandırır |
| İçerik Oluşturucu | İçerik oluşturur, düzenler ve dağıtır |
| Müşteri Desteği | Destek taleplerini yönetir, sorunlara yanıt verir, eskalasyonu ele alır |
| Etkinlik Koordinatörü | Etkinlikleri planlar, davetiyeleri yönetir, lojistiği halleder |
| Ekip Lideri | Günlük toplantıları yönetir, görevleri koordine eder, ekip iletişimini yönetir |
| Araştırmacı | Araştırmayı düzenler, referansları yönetir, işbirliğini yürütür |
Her persona, o belirli rol için doğru hizmet becerilerini, yardımcı komutları ve iş akışı modellerini bir araya getirir. Aracınızın hangi Gmail + Takvim + Drive + E-Tablolar beceri kombinasyonuna ihtiyacı olduğunu çözmenize gerek yok. Sadece persona'yı verin ve ne yapacağını bilir.
Yardımcı Beceriler
Bunlar, en yaygın işlemler için kısayol komutlarıdır:
- Hızlı dosya yüklemeleri için gws-drive-upload
- E-posta göndermek için gws-gmail-send
- İstemler aracınıza ulaşmadan önce onları temizlemek için gws-modelarmor-sanitize-prompt
Tarif Becerileri (50 Seçilmiş İş Akışı)
İçine gerçek komutların yerleştirildiği çok adımlı görev dizileri. Örnekler şunları içerir:
- Harici olarak paylaşılan Drive dosyalarını denetleme
- E-Tablolar verilerinden kişiselleştirilmiş e-postalar gönderme
- Takvim etkinliklerinden toplantı gündemleri oluşturma
- Birden fazla kaynaktan haftalık durum raporları oluşturma
Bunlar, saatlerce süren prompt mühendisliğini kurtaran "kopyala-yapıştır ve çalıştır" iş akışlarıdır.
Gerçek Dünya Otomasyon İş Akışları
İşte gws ve OpenClaw ile otomatikleştirebileceğiniz somut örnekler.
Gmail Otomasyonu
# Gelen kutunuzu belirli bir göndericiden gelen okunmamış e-postalar için ara
gws gmail users.messages list \
--params '{"userId": "me", "q": "from:boss@company.com is:unread"}'
# Belirli bir e-postayı oku
gws gmail users.messages get --params '{"userId": "me", "id": "MSG_ID"}'
# Bir e-posta gönder (yardımcı tüm kodlamayı halleder)
gws gmail +send --to alice@company.com --subject 'Q2 Raporu Hazır' \
--body 'Merhaba Alice, Q2 raporu incelemeye hazır.'
# Okunmamış gelen kutunuzu sınıflandırın (aracı dostu özet)
gws gmail +triage --max 5 --query 'from:boss'
Takvim Yönetimi
# Bugün takviminizde ne olduğuna bakın
gws calendar +agenda
# Katılımcılarla bir toplantı oluştur
gws calendar +insert --summary 'Haftalık Toplantı' \
--start '2026-03-10T09:00:00-07:00' \
--end '2026-03-10T09:30:00-07:00'
# Tüm detaylarıyla yinelenen bir etkinlik oluştur
gws calendar events insert \
--params '{"calendarId": "primary"}' \
--json '{
"summary": "Haftalık Toplantı",
"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"}]
}'
# Bir etkinliği yeniden planla ve katılımcıları bilgilendir
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 Dosya Yönetimi
# Son 10 dosyanızı listele
gws drive files list --params '{"pageSize": 10}'
# Belirli bir klasöre dosya yükle
gws drive +upload --file ./report.pdf --parent FOLDER_ID
# Yeni bir proje klasörü oluştur
gws drive files create \
--json '{"name": "Q2 Projesi", "mimeType": "application/vnd.google-apps.folder"}'
# Bir dosya indir
gws drive files get \
--params '{"fileId": "FILE_ID", "alt": "media"}' -o report.pdf
# Bir Google Dokümanını PDF olarak dışa aktar
gws drive files export \
--params '{"fileId": "FILE_ID", "mimeType": "application/pdf"}' -o document.pdf
# Bir klasörü bir meslektaşınızla paylaşın
gws drive permissions create \
--params '{"fileId": "FOLDER_ID"}' \
--json '{"role": "writer", "type": "user", "emailAddress": "colleague@company.com"}'
E-Tablo İşlemleri
# Belirli bir aralıktan veri oku
gws sheets +read --spreadsheet-id SHEET_ID --range 'Kişiler!A2:C'
# Yeni bir veri satırı ekle
gws sheets +append --spreadsheet-id SHEET_ID --range 'Sayfa1' \
--values '["2026-03-05", "Pazarlama", "Reklam harcaması", "1500"]'
# Yepyeni bir e-tablo oluştur
gws drive files create \
--json '{"name": "Gider Takipçisi 2026", "mimeType": "application/vnd.google-apps.spreadsheet"}'
Dokümanlar ve İçerik Oluşturma
# Yeni bir doküman oluştur
gws docs documents create --json '{"title": "Toplantı Notları - Mart 2026"}'
# Mevcut bir dokümana içerik yaz
gws docs +write --document-id DOC_ID \
--text '## Proje: Q2 Lansmanı\n\n### Hedef\nQ2 sonuna kadar yeni özelliği başlat.'
Chat, Meet, Formlar ve Daha Fazlası
# Google Chat'te bir ekip bildirimi gönder
gws chat +send --space spaces/TEAM_SPACE \
--text 'Önemli: Güncellenmiş politika için lütfen e-postanızı kontrol edin.'
# Bir Google Meet odası oluştur
gws meet spaces create --json '{"config": {"accessType": "OPEN"}}'
# Bir geri bildirim formu oluştur
gws forms forms create \
--json '{"info": {"title": "Etkinlik Geri Bildirimi", "documentTitle": "Etkinlik Geri Bildirim Formu"}}'
# Bir sunum oluştur
gws slides presentations create --json '{"title": "Üç Aylık İnceleme Q2"}'
Desenine dikkat edin. Her eylem tek bir satırdır. `+` yardımcı komutları (+send, +upload, +agenda, +triage, +read, +append, +write gibi) normalde 10 satır boilerplate kod gerektirecek tüm dağınık kodlama ve biçimlendirmeyi halleder. Aracınızın RFC 2822 e-posta biçimlendirmesi veya base64 kodlaması hakkında bilgi sahibi olmasına gerek yoktur. Sadece ne yapmak istediğini söyler ve gws gerisini halleder.
Güvenlik ve Model Armor
İşte yeterince dikkat çekmeyen bir şey. Depo, yanıt temizleme için Google Cloud Model Armor ile entegrasyon içerir.
Model Armor Nedir?
Aracınız Gmail veya Drive'dan veri okuduğunda, bu veriler istem enjeksiyonu saldırıları içerebilir. Birisi, aracınızın davranışını manipüle etmek için özel olarak tasarlanmış bir e-posta hazırlayabilir. Model Armor, API yanıtlarını aracınıza ulaşmadan önce tarar ve potansiyel olarak kötü amaçlı içeriği filtreler.
gws gmail users messages get --params '...' \
--sanitize "projects/P/locations/L/templates/T"
Temizleme Modları
| Mod | Davranış |
|---|---|
| warn | Şüpheli içeriği işaretler ancak yine de döndürür |
| block | Potansiyel olarak kötü amaçlı içeriği tamamen çıkarır |
Bu Neden Önemli?
Cisco'nun yapay zeka güvenlik ekibi, ClawHub'daki 31.000'den fazla becerinin %26'sının güvenlik açıkları içerdiğini buldu. SecurityScorecard, açıkta kalan OpenClaw örneklerinin %63'ünün yanlış yapılandırıldığını bildirdi. Aracı güvenliği teorik bir sorun değil. Şu anda yaşanıyor.
Veri boru hattına yerleşik güvenlik filtrelemesi olması Google'dan akıllı bir hareket.
Güvenlik İçin Ortam Değişkenleri
# Varsayılan Model Armor şablonu
export GOOGLE_WORKSPACE_CLI_SANITIZE_TEMPLATE="projects/P/locations/L/templates/T"
# Temizleme modu (uyar veya engelle)
export GOOGLE_WORKSPACE_CLI_SANITIZE_MODE="block"
gws ve Alternatifler
gws'yi düşünebileceğiniz diğer yaklaşımlarla karşılaştıralım.
gws ve gcloud CLI
| Özellik | gws | gcloud CLI |
|---|---|---|
| Kapsam | Google Workspace API'leri | Tüm Google Cloud hizmetleri |
| Aracı Becerileri | 100+ önceden oluşturulmuş | Yok |
| OpenClaw Desteği | Yerel | Manuel kurulum |
| Çıktı Formatı | Yapılandırılmış JSON | Değişken |
| Workspace'e Özgü | Evet | Kısmi |
Altyapı yönetimi için gcloud kullanın. Workspace otomasyonu için gws kullanın.
gws ve Google Apps Script
| Özellik | gws | Apps Script |
|---|---|---|
| Yürütme | Yerel CLI / Yapay Zeka aracıları | Bulut tabanlı |
| Dil | Kabuk komutları | JavaScript |
| Yapay Zeka Entegrasyonu | Dahili | Manuel |
| Kimlik Doğrulama | OAuth / Hizmet Hesabı | OAuth |
| Kullanım Durumu | Otomasyon / Aracıla | Workspace içi otomasyon |
Apps Script, Google Workspace içinde iş akışlarını otomatikleştirmede mükemmeldir. gws, harici araçlara ve yapay zeka aracılarına Workspace erişimi sağlamada mükemmeldir.
gws ve Üçüncü Taraf Araçlar (Zapier, Make)
| Özellik | gws | Zapier/Make |
|---|---|---|
| Maliyet | Ücretsiz | 20-500$/ay |
| Özelleştirme | Tam kontrol | Platformla sınırlı |
| Oran Limitleri | Yalnızca Google API limitleri | Platform limitleri |
| Veri Gizliliği | Yerel yürütme | Üçüncü taraf sunucular |
| Öğrenme Eğrisi | Teknik | Düşük kod |
Üçüncü taraf araçlar teknik olmayan kullanıcılar için mantıklıdır. gws, geliştiriciler ve yapay zeka aracı kurulumları için mantıklıdır.
Başlangıç Kılavuzu
Bunu denemeye hazır mısınız? İşte çalışan bir kurulum için en hızlı yol.
Ön Koşullar
- Node.js 18+ (npm kurulumu için)
- Bir Google Cloud projesi (OAuth kimlik bilgileri için)
- Google Workspace erişimi olan bir Google hesabı
- gcloud CLI kurulu (isteğe bağlı ancak en hızlı kurulum için önerilir)
Adım 1: gws'yi Yükle
npm install -g @googleworkspace/cli
npm paketi, işletim sisteminiz ve mimariniz için önceden oluşturulmuş yerel ikili dosyaları içerir. Rust araç zinciri gerekmez.
Adım 2: Kimlik Doğrulamayı Ayarla
gws auth setup
Bu, sizi Google Cloud proje yapılandırması boyunca yönlendirir. Bir Cloud projesi oluşturur, API'leri etkinleştirir ve sizi oturum açtırır.
gcloud kurulu değilse, OAuth'yi Google Cloud Console üzerinden manuel olarak ayarlayabilirsiniz.
Adım 3: Oturum Aç
gws auth login
Bu, OAuth kapsam seçimi ve oturum açma için bir tarayıcı açar.
Adım 4: Kurulumunuzu Test Edin
gws drive files list --params '{"pageSize": 5}'
Son dosyalarınızla ilgili bir JSON yanıtı görmelisiniz.
Adım 5: OpenClaw ile Entegre Et
# Depoyu klonla
git clone https://github.com/googleworkspace/cli.git
cd cli
# Tüm becerileri sembolik bağla
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/
Adım 6: Mesajlaşma Aracılığıyla Kullanmaya Başlayın
Yapılandırılmış OpenClaw mesajlaşma platformunuz aracılığıyla bir mesaj gönderin:
"Son 5 Drive dosyamı listele"
OpenClaw uygun gws komutunu yürütecek ve sonuçları geri gönderecektir.
Sık Karşılaşılan Sorunları Giderme
"Erişim engellendi" veya oturum açma sırasında 403 hatası
OAuth uygulamanız test modundadır ve hesabınız test kullanıcısı olarak listelenmemiştir.
Düzeltme: GCP projenizdeki OAuth onay ekranını açın, Test kullanıcılarına gidin, Google hesabınızın e-postasını ekleyin, ardından gws auth login komutunu tekrar deneyin.
"Google bu uygulamayı doğrulamadı"
Uygulamanız test modundayken beklenen bir durumdur. İlerle (Advanced) seçeneğine tıklayın, ardından "Go to (unsafe)" seçeneğine tıklayarak devam edin. Bu, kişisel kullanım için güvenlidir.
Çok fazla kapsam hatası
Doğrulanmamış (test modu) uygulamalar yaklaşık 25 OAuth kapsamıyla sınırlıdır. Önerilen kapsam ön ayarı birçok kapsam içerir ve bu limiti aşar.
Düzeltme: Yalnızca ihtiyacınız olan kapsamları seçin:
gws auth login --scopes drive,gmail,calendar
API etkinleştirilmedi
Gerekli bir Google API'si GCP projeniz için etkinleştirilmemişse, reason accessNotConfigured ile 403 hatası görürsünüz.
gws, API'yi etkinleştirmek için bir bağlantı içeren eyleme geçirilebilir bir ipucu yazdırır. Bağlantıya tıklayın, etkinleştirin, yaklaşık 10 saniye bekleyin, sonra tekrar deneyin.
Sonuç
Google Workspace CLI, yapay zeka aracı ekosistemi için önemli bir şeyi temsil ediyor. Bu sadece başka bir CLI sarmalayıcısı değil. Bu, yapay zeka otomasyonunu npm yüklü herkesin erişimine sunan bir altyapıdır.
Mimari sağlam. Beceri kapsamı etkileyici. Google'ın ilk günden itibaren OpenClaw uyumluluğunu inşa etmesi, aracı ekosisteminin nereye gittiğini düşündüklerini gösteriyor.
OpenClaw, Claude Code veya herhangi bir aracı platformunda geliştirme yapan geliştiriciler için gws, araç setinizde isteyeceğiniz araçlardan biridir. Google Workspace API'lerinin karmaşıklığını yönetir, böylece aracınız önemli olana odaklanabilir - işi yapmak.
Aracı ekonomisi altyapısını alıyor. Ve çoğu insanın fark ettiğinden daha hızlı oluyor.
Sıkça Sorulan Sorular
S: gws'yi kullanmak ücretsiz mi?
C: Evet, gws Apache-2.0 lisansı altında açık kaynaktır. Yalnızca ücretsiz kotaları aşarsanız Google API kullanımı için ödeme yaparsınız.
S: Bir Google Workspace hesabına ihtiyacım var mı?
C: Standart bir Google hesabı çoğu özellik için çalışır. Bazı Yönetici API'leri bir Workspace aboneliği gerektirir.
S: gws'yi OpenClaw olmadan kullanabilir miyim?
C: Kesinlikle. gws bağımsız bir CLI aracı olarak çalışır. OpenClaw entegrasyonu, mesajlaşma tabanlı erişim için isteğe bağlıdır.
S: gws'yi nasıl güncellerim?
C: En son sürümü almak için npm update -g @googleworkspace/cli komutunu çalıştırın. CLI, çalışma zamanında Google'ın Keşif Hizmeti'ni okur, bu nedenle her zaman en son API'lere erişimi vardır.
S: Verilerim gws ile güvende mi?
C: gws, kimlik bilgilerini AES-256-GCM kullanarak işletim sisteminizin anahtar zincirindeki anahtarlarla şifrelenmiş olarak depolar. Model Armor entegrasyonu, aracı iş akışları için ek güvenlik sağlar.
S: gws'yi CI/CD işlem hatlarında kullanabilir miyim?
C: Evet. Kimlik bilgilerinizi gws auth export --unmasked > credentials.json ile dışa aktarın ve CI ortamınızda GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE'ı ayarlayın.
S: gws ve Google APIs Explorer arasındaki fark nedir?
C: gws, otomasyon ve yapay zeka aracı entegrasyonu için tasarlanmış bir CLI aracıdır. APIs Explorer web tabanlı bir test aracıdır. gws yapılandırılmış JSON çıktısı verir ve betiklemeyi destekler.
S: gws hizmet hesaplarıyla çalışır mı?
C: Evet. GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE'ı hizmet hesabı JSON anahtar dosyanıza ayarlayın. Etkileşimli oturum açma gerekmez.
S: gws'ye katkıda bulunabilir miyim?
C: Evet, proje GitHub'da açık kaynaktır. Depo yöneticileri tarafından işbirliği yapmayanlardan gelen pull request'lerin geçici olarak devre dışı bırakıldığını unutmayın.
S: gws hangi platformları destekliyor?
C: gws, macOS, Linux ve Windows için önceden oluşturulmuş ikili dosyalarla birlikte gelir. npm paketi, yerel ikili kurulumunu otomatik olarak halleder.
