TL;DR
Die Google Workspace CLI (gws) ist ein Befehlszeilentool, das KI-Agenten direkten Zugriff auf Gmail, Drive, Kalender, Tabellen, Docs und jede Google Workspace API über strukturierte JSON-Ausgaben ermöglicht. Mit nativer OpenClaw-Unterstützung und über 100 vorgefertigten Agentenfähigkeiten können Sie Ihren gesamten Workspace-Workflow über Messaging-Apps wie WhatsApp oder Discord automatisieren. Die Einrichtung dauert 5 Minuten mit npm install -g @googleworkspace/cli, gefolgt von gws auth setup.
Einführung
Was wäre, wenn Ihr KI-Agent Ihre Gmail-Nachrichten lesen, Ihren Kalender aktualisieren und Ihr Google Drive organisieren könnte, ohne dass Sie einen Finger rühren müssen?
Die meisten Google Workspace-Automatisierungstools erfordern komplexe API-Einrichtungen, benutzerdefinierten Code oder teure Drittanbieterdienste. Entwickler verbringen Stunden damit, sich mit OAuth-Flüssen, Ratenbegrenzungen und veralteter Dokumentation herumzuschlagen. Währenddessen bleiben KI-Agenten untätig, weil ihnen der direkte Zugang zu den Tools fehlt, die wir täglich nutzen.
Google-Ingenieure haben gerade etwas veröffentlicht, das alles verändert. Die Google Workspace CLI (gws) hat bereits über 12.400 GitHub-Sterne gesammelt und wird mit über 100 vorgefertigten Agentenfähigkeiten geliefert. Sie ist in Rust geschrieben, liest Googles Discovery Service zur Laufzeit und gibt strukturierte JSON-Daten aus, die jeder KI-Agent parsen kann.
Was ist Google Workspace CLI?
Google Workspace CLI (gws) ist ein einzelnes Befehlszeilentool, das jede Google Workspace API in saubere, zusammensetzbare Befehle verpackt. Es deckt Gmail, Google Drive, Kalender, Tabellen, Docs, Präsentationen, Chat, Aufgaben, Meet, Formulare, Notizen, Classroom, Admin und im Grunde jede existierende Google Workspace API ab.
Hier erfahren Sie, was es von anderen CLI-Tools unterscheidet, die Sie verwendet haben.
Die meisten Entwicklertools werden mit einer festen Liste von Befehlen ausgeliefert. Wenn Google einen neuen API-Endpunkt hinzufügt, muss jemand das Tool manuell aktualisieren, eine neue Version veröffentlichen und hoffen, dass jeder ein Upgrade durchführt. Es ist ein Wartungstretmühle, die niemals endet. Die meisten Google Workspace-Wrapper, die Sie gesehen haben, sind bereits veraltet, wenn Sie sie installieren.
gws löst dies auf eine grundlegend andere Weise. Anstatt Befehle fest zu kodieren, kommuniziert es direkt mit Googles Discovery Service. Stellen Sie sich dies als Googles eigenen Live-Katalog jeder einzelnen verfügbaren Aktion in all ihren Workspace-Anwendungen vor. Jede API, jede Methode, jeder Parameter. Google pflegt diesen Katalog selbst, und er ist immer aktuell.
Wenn Sie gws ausführen, ist das Erste, was es tut, diesen Live-Katalog abzurufen und seine gesamte Befehlsstruktur im Handumdrehen aus dem aufzubauen, was Google gerade als verfügbar angibt. Wenn Google heute um 14 Uhr eine neue Tabellenfunktion veröffentlicht, unterstützt Ihre CLI diese bereits um 14:01 Uhr. Kein Update. Keine neue Version. Kein Warten darauf, dass ein Maintainer aufholt.
Das Tool kann buchstäblich nicht zurückfallen, weil es jedes Mal aus der Quelle der Wahrheit liest.
Kurzes Beispiel
# Die 10 neuesten Dateien auflisten
gws drive files list --params '{"pageSize": 10}'
# Eine Tabelle erstellen
gws sheets spreadsheets create --json '{"properties": {"title": "Q1 Budget"}}'
# Eine Chat-Nachricht senden
gws chat spaces messages create \
--params '{"parent": "spaces/xyz"}' \
--json '{"text": "Deploy complete."}'
Jede Antwort kommt als strukturierte JSON-Datei zurück. Nicht HTML. Nicht formatierter Text. Saubere, vorhersagbare, maschinenlesbare Daten, die ein KI-Agent sofort analysieren und darauf reagieren kann.
Warum gws für KI-Agenten wichtig ist
Die KI-Agenten-Community ist aus spezifischen technischen Gründen von gws begeistert.
Strukturierte JSON-Ausgabe: Jede einzelne Antwort kommt als strukturierte JSON-Datei zurück. Ihr Agent muss weder HTML parsen noch die Formatierung erraten. Er erhält saubere Daten, mit denen er sofort arbeiten kann.
Keine benutzerdefinierte Tooling erforderlich: Die meisten KI-Agenten-Setups erfordern, dass Sie für jede API, auf die Sie zugreifen möchten, benutzerdefinierte Tools erstellen. Mit gws ist das Tooling bereits integriert. Ihr Agent muss lediglich wissen, wie Shell-Befehle ausgeführt werden.
Über 100 vorgefertigte Agentenfähigkeiten: Das Repository wird mit über 100 SKILL.md-Dateien geliefert – eine für jede unterstützte API, plus übergeordnete Helfer für gängige Workflows und 50 kuratierte Rezepte für Gmail, Drive, Docs, Kalender und Tabellen.
Native OpenClaw-Unterstützung: Google hat Anweisungen zur OpenClaw-Einrichtung direkt in die README-Datei aufgenommen. Dies ist kein Community-Hack oder Workaround. Es ist eine integrierte, erstklassige Unterstützung.
MCP-Server integriert: gws enthält einen Model Context Protocol-Server, der Google Workspace APIs als strukturierte Tools bereitstellt. Jeder MCP-kompatible Client (Claude Desktop, Gemini CLI, VS Code) kann diese Tools direkt aufrufen.
Die Infrastruktur der Agentenökonomie
Wir erleben die Entstehung der Agenten-Infrastruktur schneller, als die meisten Leute es sich vorstellen. Tools wie gws stellen die Grundlagen dar, die autonome Workflows ermöglichen werden. Anstatt für jede SaaS-Plattform benutzerdefinierte Integrationen zu erstellen, können Agenten auf standardisierte CLIs mit konsistenten Ausgabeformaten vertrauen.
Dies ist wichtig, weil es die Eintrittsbarriere senkt. Sie brauchen kein Team von Ingenieuren, um KI-Automatisierung für Ihren Workspace zu entwickeln. Sie benötigen npm und 5 Minuten.
Wie gws funktioniert: Die Architektur
gws verwendet eine zweistufige Parsing-Strategie, deren Verständnis sich lohnt.
Phase 1: Dienstidentifizierung
Wenn Sie gws drive files list ausführen, liest die CLI das erste Argument (drive), um den Dienst zu identifizieren.
Phase 2: Dynamische Befehlserstellung
Die CLI ruft das Discovery Document des Dienstes von Google ab (für 24 Stunden zwischengespeichert). Sie erstellt einen clap::Command-Baum aus den Ressourcen und Methoden des Dokuments. Hier geschieht die Magie – die gesamte Befehlsoberfläche wird aus Googles eigener API-Spezifikation generiert.
Phase 3: Anforderungsausführung
Die CLI parst die restlichen Argumente erneut, authentifiziert sich mit Ihren konfigurierten Anmeldeinformationen, erstellt die HTTP-Anfrage und führt sie aus.
Alle Ausgaben – Erfolgsantworten, Fehler, Download-Metadaten – sind strukturiertes JSON.
┌─────────────────────────────────────────────────────────┐
│ argv[1] = "drive" │
│ ↓ │
│ Discovery-Dokument abrufen (24h zwischengespeichert) │
│ ↓ │
│ clap::Command-Baum aus Ressourcen & Methoden erstellen │
│ ↓ │
│ Verbleibende Argumente erneut parsen │
│ ↓ │
│ Authentifizieren → HTTP-Anfrage erstellen → Ausführen │
│ ↓ │
│ Ausgabe: Strukturiertes JSON │
└─────────────────────────────────────────────────────────┘
Diese Architektur bedeutet, dass gws jede Google Workspace API unterstützen kann, ohne einen einzigen Befehl fest zu kodieren. Das Discovery Document ist die Quelle der Wahrheit, und gws liest es jedes Mal live.
OpenClaw-Integration: Schritt für Schritt
OpenClaw ist ein selbst gehostetes KI-Agenten-Framework, das sich mit Messaging-Apps wie WhatsApp, Telegram und Discord verbindet. Wenn Sie gws in OpenClaw integrieren, erhalten Sie einen KI-Assistenten, der Ihren gesamten Google Workspace über Textnachrichten verwalten kann.
Google hat die Anweisungen zur OpenClaw-Einrichtung buchstäblich in die README-Datei aufgenommen. So fangen Sie an.
Option 1: Alle Fähigkeiten verknüpfen (empfohlen für die Entwicklung)
# Das Repository klonen
git clone https://github.com/googleworkspace/cli.git
cd cli
# Alle Fähigkeiten in Ihr OpenClaw-Fähigkeitenverzeichnis verknüpfen
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/
Dadurch bleibt alles mit dem Repository synchron. Wenn Google die Fähigkeiten aktualisiert, erhalten Sie die Updates automatisch.
Option 2: Spezifische Fähigkeiten kopieren
# Nur das nehmen, was Sie brauchen
cp -r skills/gws-drive skills/gws-gmail ~/.openclaw/skills/
Option 3: Die Skills CLI verwenden
# Alle Fähigkeiten auf einmal installieren
npx skills add https://github.com/googleworkspace/cli
# Oder einzelne Fähigkeiten auswählen
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
Die gws-shared-Fähigkeit
Die gws-shared-Fähigkeit ist besonders intelligent. Sie enthält einen Installationsblock, der die CLI automatisch über npm installiert, falls gws nicht bereits in Ihrem PATH vorhanden ist. Ihr OpenClaw-Agent kann sich selbst starten – er prüft das Tool, installiert es bei Bedarf und beginnt mit der Arbeit. Keine manuelle Einrichtung erforderlich.
gws über WhatsApp nutzen
Nach der Integration können Sie Nachrichten senden wie:
"Prüfe meinen Kalender auf heutige Termine"
"Finde ungelesene E-Mails von meinem Chef"
"Erstelle eine neue Tabelle namens Q2 Budget"
"Lade diese PDF in den Ordner Projekte hoch"
OpenClaw empfängt Ihre Nachricht, bestimmt, welchen gws-Befehl es ausführen soll, führt ihn aus und sendet die Ergebnisse zurück – alles über WhatsApp.
Aufschlüsselung der über 100 Agentenfähigkeiten
Das Repository wird mit über 100 SKILL.md-Dateien geliefert, die in vier Kategorien organisiert sind. Wenn Sie mit dem SKILL.md-Format nicht vertraut sind, ist es der aufstrebende Standard, um KI-Agenten strukturierte, zusammensetzbare Fähigkeiten zu verleihen. Stellen Sie sich Fähigkeiten wie Apps vor, aber für das Wissen und den Toolzugriff von Agenten.
Dienstfähigkeiten (25+)
Eine Fähigkeit pro Google Workspace API. Das sind Ihre Bausteine:
| Fähigkeit | Zweck |
|---|---|
| gws-drive | Verwaltung von Dateien, Ordnern und freigegebenen Laufwerken |
| gws-gmail | Senden, Lesen und Verwalten von E-Mails |
| gws-calendar | Verwaltung von Kalendern und Ereignissen |
| gws-sheets | Lesen und Schreiben von Tabellen |
| gws-docs | Lesen und Schreiben von Google Docs |
| gws-slides | Präsentationen |
| gws-tasks | Aufgabenlisten |
| gws-chat | Google Chat-Räume und -Nachrichten |
| gws-people | Kontakte und Profile |
| gws-admin | Verwaltung von Benutzern, Gruppen und Geräten |
| gws-classroom | Kurse, Teilnehmerlisten und Kursarbeiten |
| gws-forms | Google Forms |
| gws-keep | Google Notizen |
| gws-meet | Konferenzverwaltung |
| gws-vault | eDiscovery |
| gws-apps-script | Verwaltung von Apps Script-Projekten |
Zusätzliche Fähigkeiten umfassen Cloud Identity, Alert Center, Gruppeneinstellungen, Lizenzierung, Reseller und Model Armor zur Sicherheitsfilterung.
Persona-Fähigkeiten (10 vorgefertigte Agentenrollen)
Google hat 10 gebrauchsfertige Persona-Bundles erstellt, die vollständige Agentenrollen definieren:
| Persona | Verantwortlichkeiten |
|---|---|
| Executive Assistant | Verwaltet Termine, Posteingang und Kommunikation |
| Project Manager | Koordiniert Projekte, verfolgt Aufgaben, plant Meetings |
| HR Coordinator | Bearbeitet Onboarding, Ankündigungen, Mitarbeiterkommunikation |
| Sales Ops | Verwaltet Vertriebsworkflows, verfolgt Deals, plant Anrufe |
| IT Admin | Verwaltet Benutzer, überwacht Sicherheit, konfiguriert Workspace |
| Content Creator | Erstellt, organisiert und verteilt Inhalte |
| Customer Support | Verwaltet Tickets, beantwortet Probleme, behandelt Eskalationen |
| Event Coordinator | Plant Veranstaltungen, verwaltet Einladungen, kümmert sich um Logistik |
| Team Lead | Leitet Standups, koordiniert Aufgaben, verwaltet Teamkommunikation |
| Researcher | Organisiert Forschung, verwaltet Referenzen, kümmert sich um Zusammenarbeit |
Jede Persona bündelt die richtigen Dienstfähigkeiten, Hilfsbefehle und Workflow-Muster für diese spezifische Rolle. Sie müssen nicht herausfinden, welche Kombination von Gmail + Kalender + Drive + Tabellenfähigkeiten Ihr Agent benötigt. Geben Sie ihm einfach die Persona, und er weiß, was zu tun ist.
Helfer-Fähigkeiten
Dies sind Shortcut-Befehle für die gängigsten Operationen:
- gws-drive-upload für schnelle Dateiuploads
- gws-gmail-send zum Senden von E-Mails
- gws-modelarmor-sanitize-prompt zum Bereinigen von Prompts, bevor sie Ihren Agenten erreichen
Rezeptfähigkeiten (50 kuratierte Workflows)
Mehrstufige Aufgabenabfolgen mit integrierten echten Befehlen. Beispiele sind:
- Audit von extern freigegebenen Drive-Dateien
- Senden personalisierter E-Mails aus Tabellendaten
- Erstellen von Besprechungsagenden aus Kalenderereignissen
- Generieren von wöchentlichen Statusberichten aus verschiedenen Quellen
Dies sind die "Kopieren-Einfügen-und-Los"-Workflows, die Stunden an Prompt Engineering sparen.
Automatisierungsworkflows in der Praxis
Hier sind konkrete Beispiele dafür, was Sie mit gws und OpenClaw automatisieren können.
Gmail-Automatisierung
# Ihren Posteingang nach ungelesenen E-Mails von einem bestimmten Absender durchsuchen
gws gmail users.messages list \
--params '{"userId": "me", "q": "from:boss@company.com is:unread"}'
# Eine bestimmte E-Mail lesen
gws gmail users.messages get --params '{"userId": "me", "id": "MSG_ID"}'
# Eine E-Mail senden (der Helfer übernimmt die gesamte Codierung)
gws gmail +send --to alice@company.com --subject 'Q2 Bericht fertig' \
--body 'Hallo Alice, der Q2 Bericht ist fertig zur Überprüfung.'
# Ungelesenen Posteingang triagieren (agentenfreundliche Zusammenfassung)
gws gmail +triage --max 5 --query 'from:boss'
Kalenderverwaltung
# Sehen Sie, was heute in Ihrem Kalender steht
gws calendar +agenda
# Eine Besprechung mit Teilnehmern erstellen
gws calendar +insert --summary 'Wöchentlicher Standup' \
--start '2026-03-10T09:00:00-07:00' \
--end '2026-03-10T09:30:00-07:00'
# Ein wiederkehrendes Ereignis mit allen Details erstellen
gws calendar events insert \
--params '{"calendarId": "primary"}' \
--json '{
"summary": "Wöchentlicher 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"}]
}'
# Ein Ereignis verschieben und Teilnehmer benachrichtigen
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-Dateiverwaltung
# Die 10 zuletzt verwendeten Dateien auflisten
gws drive files list --params '{"pageSize": 10}'
# Eine Datei in einen bestimmten Ordner hochladen
gws drive +upload --file ./report.pdf --parent FOLDER_ID
# Einen neuen Projektordner erstellen
gws drive files create \
--json '{"name": "Q2 Projekt", "mimeType": "application/vnd.google-apps.folder"}'
# Eine Datei herunterladen
gws drive files get \
--params '{"fileId": "DATEI_ID", "alt": "media"}' -o report.pdf
# Ein Google Doc als PDF exportieren
gws drive files export \
--params '{"fileId": "DATEI_ID", "mimeType": "application/pdf"}' -o document.pdf
# Einen Ordner mit einem Kollegen teilen
gws drive permissions create \
--params '{"fileId": "ORDNER_ID"}' \
--json '{"role": "writer", "type": "user", "emailAddress": "kollege@firma.com"}'
Tabellenoperationen
# Daten aus einem bestimmten Bereich lesen
gws sheets +read --spreadsheet-id SHEET_ID --range 'Kontakte!A2:C'
# Eine neue Datenzeile anhängen
gws sheets +append --spreadsheet-id SHEET_ID --range 'Tabelle1' \
--values '["2026-03-05", "Marketing", "Werbeausgaben", "1500"]'
# Eine brandneue Tabelle erstellen
gws drive files create \
--json '{"name": "Spesenabrechnung 2026", "mimeType": "application/vnd.google-apps.spreadsheet"}'
Docs und Inhaltserstellung
# Ein neues Dokument erstellen
gws docs documents create --json '{"title": "Besprechungsnotizen - März 2026"}'
# Inhalt in ein bestehendes Dokument schreiben
gws docs +write --document-id DOC_ID \
--text '## Projekt: Q2 Start\n\n### Ziel\nDie neue Funktion bis Ende Q2 einführen.'
Chat, Meet, Formulare und mehr
# Eine Team-Benachrichtigung in Google Chat senden
gws chat +send --space spaces/TEAM_SPACE \
--text 'Wichtig: Bitte prüfen Sie Ihre E-Mails bezüglich der aktualisierten Richtlinie.'
# Einen Google Meet-Raum erstellen
gws meet spaces create --json '{"config": {"accessType": "OPEN"}}'
# Ein Feedback-Formular erstellen
gws forms forms create \
--json '{"info": {"title": "Veranstaltungsfeedback", "documentTitle": "Veranstaltungsfeedback-Formular"}}'
# Eine Präsentation erstellen
gws slides presentations create --json '{"title": "Quartalsrückblick Q2"}'
Beachten Sie das Muster. Jede Aktion ist eine Zeile. Die + Hilfsbefehle (wie +send, +upload, +agenda, +triage, +read, +append, +write) übernehmen die gesamte aufwändige Kodierung und Formatierung, die normalerweise 10 Zeilen Boilerplate erfordern würde. Ihr Agent muss nichts über RFC 2822 E-Mail-Formatierung oder Base64-Kodierung wissen. Er sagt einfach, was er tun möchte, und gws erledigt den Rest.
Sicherheit und Model Armor
Hier ist etwas, das nicht genug Aufmerksamkeit bekommt. Das Repository enthält die Integration mit Google Cloud Model Armor zur Bereinigung von Antworten.
Was ist Model Armor?
Wenn Ihr Agent Daten aus Gmail oder Drive liest, könnten diese Daten Prompt-Injection-Angriffe enthalten. Jemand könnte eine E-Mail speziell so gestalten, dass sie das Verhalten Ihres Agenten manipuliert. Model Armor scannt API-Antworten, bevor sie Ihren Agenten erreichen, und filtert potenziell bösartige Inhalte heraus.
gws gmail users messages get --params '...' \
--sanitize "projects/P/locations/L/templates/T"
Bereinigungsmodi
| Modus | Verhalten |
|---|---|
| warn | Kennzeichnet verdächtige Inhalte, gibt sie aber trotzdem zurück |
| block | Entfernt potenziell bösartige Inhalte vollständig |
Warum das wichtig ist
Ciscos KI-Sicherheitsteam stellte fest, dass 26 % der über 31.000 Fähigkeiten auf ClawHub Schwachstellen enthalten. SecurityScorecard berichtete, dass 63 % der exponierten OpenClaw-Instanzen falsch konfiguriert sind. Agenten-Sicherheit ist kein theoretisches Problem. Es geschieht gerade jetzt.
Eine in die Datenpipeline integrierte Sicherheitsfilterung ist ein kluger Schachzug von Google.
Umgebungsvariablen für die Sicherheit
# Standard-Model Armor-Vorlage
export GOOGLE_WORKSPACE_CLI_SANITIZE_TEMPLATE="projects/P/locations/L/templates/T"
# Bereinigungsmodus (warn oder block)
export GOOGLE_WORKSPACE_CLI_SANITIZE_MODE="block"
gws vs. Alternativen
Vergleichen wir gws mit anderen Ansätzen, die Sie in Betracht ziehen könnten.
gws vs. gcloud CLI
| Funktion | gws | gcloud CLI |
|---|---|---|
| Umfang | Google Workspace APIs | Alle Google Cloud Dienste |
| Agentenfähigkeiten | Über 100 vorgefertigt | Keine |
| OpenClaw-Unterstützung | Nativ | Manuelle Einrichtung |
| Ausgabeformat | Strukturiertes JSON | Variabel |
| Workspace-spezifisch | Ja | Partiell |
Verwenden Sie gcloud für die Infrastrukturverwaltung. Verwenden Sie gws für die Workspace-Automatisierung.
gws vs. Google Apps Script
| Funktion | gws | Apps Script |
|---|---|---|
| Ausführung | Lokale CLI / KI-Agenten | Cloud-basiert |
| Sprache | Shell-Befehle | JavaScript |
| KI-Integration | Integriert | Manuell |
| Authentifizierung | OAuth / Dienstkonto | OAuth |
| Anwendungsfall | Automatisierung / Agenten | Automatisierung innerhalb des Workspace |
Apps Script ist hervorragend geeignet, um Workflows innerhalb von Google Workspace zu automatisieren. gws ist hervorragend geeignet, um externen Tools und KI-Agenten Zugriff auf Workspace zu ermöglichen.
gws vs. Drittanbieter-Tools (Zapier, Make)
| Funktion | gws | Zapier/Make |
|---|---|---|
| Kosten | Kostenlos | 20-500 $/Monat |
| Anpassung | Volle Kontrolle | Auf Plattform beschränkt |
| Ratenbegrenzungen | Nur Google API-Limits | Plattform-Limits |
| Datenschutz | Lokale Ausführung | Drittanbieter-Server |
| Lernkurve | Technisch | Low-Code |
Drittanbieter-Tools sind für nicht-technische Benutzer sinnvoll. gws ist für Entwickler und KI-Agenten-Setups sinnvoll.
Erste Schritte
Bereit, dies auszuprobieren? Hier ist der schnellste Weg zu einer funktionierenden Einrichtung.
Voraussetzungen
- Node.js 18+ (für npm install)
- Ein Google Cloud-Projekt (für OAuth-Anmeldeinformationen)
- Ein Google-Konto mit Zugriff auf Google Workspace
- gcloud CLI installiert (optional, aber für die schnellste Einrichtung empfohlen)
Schritt 1: gws installieren
npm install -g @googleworkspace/cli
Das npm-Paket bündelt vorgefertigte native Binärdateien für Ihr Betriebssystem und Ihre Architektur. Keine Rust-Toolchain erforderlich.
Schritt 2: Authentifizierung einrichten
gws auth setup
Dies führt Sie durch die Google Cloud-Projektkonfiguration. Es erstellt ein Cloud-Projekt, aktiviert APIs und meldet Sie an.
Wenn Sie gcloud nicht installiert haben, können Sie OAuth manuell über die Google Cloud Console einrichten.
Schritt 3: Anmelden
gws auth login
Dies öffnet einen Browser zur Auswahl der OAuth-Bereiche und zur Anmeldung.
Schritt 4: Ihre Einrichtung testen
gws drive files list --params '{"pageSize": 5}'
Sie sollten eine JSON-Antwort mit Ihren letzten Dateien sehen.
Schritt 5: Integration mit OpenClaw
# Das Repository klonen
git clone https://github.com/googleworkspace/cli.git
cd cli
# Alle Fähigkeiten verknüpfen
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/
Schritt 6: Nutzung über Nachrichten beginnen
Senden Sie eine Nachricht über Ihre konfigurierte OpenClaw-Messaging-Plattform:
"Liste meine 5 neuesten Drive-Dateien auf"
OpenClaw führt den entsprechenden gws-Befehl aus und sendet die Ergebnisse zurück.
Fehlerbehebung bei häufigen Problemen
"Zugriff blockiert" oder 403 während der Anmeldung
Ihre OAuth-App befindet sich im Testmodus, und Ihr Konto ist nicht als Testbenutzer aufgeführt.
Behebung: Öffnen Sie den OAuth-Zustimmungsbildschirm in Ihrem GCP-Projekt, gehen Sie zu "Testbenutzer", fügen Sie Ihre Google-Konto-E-Mail hinzu und versuchen Sie es dann erneut mit gws auth login.
„Google hat diese App nicht verifiziert“
Erwartet, wenn Ihre App im Testmodus ist. Klicken Sie auf "Erweitert" und dann auf "Weiter zu (unsicher)", um fortzufahren. Dies ist für den persönlichen Gebrauch sicher.
Fehler "Zu viele Bereiche"
Unverifizierte (Testmodus-)Apps sind auf etwa 25 OAuth-Bereiche beschränkt. Das empfohlene Bereichsvoreinstellung enthält viele Bereiche und wird dieses Limit überschreiten.
Behebung: Wählen Sie nur die benötigten Bereiche aus:
gws auth login --scopes drive,gmail,calendar
API nicht aktiviert
Wenn eine erforderliche Google API für Ihr GCP-Projekt nicht aktiviert ist, wird ein 403-Fehler mit dem Grund "accessNotConfigured" angezeigt.
gws gibt einen handlungsrelevanten Hinweis mit einem Link zum Aktivieren der API aus. Klicken Sie auf den Link, aktivieren Sie ihn, warten Sie etwa 10 Sekunden und versuchen Sie es dann erneut.
Fazit
Die Google Workspace CLI stellt etwas Bedeutendes für das KI-Agenten-Ökosystem dar. Sie ist nicht nur ein weiterer CLI-Wrapper. Sie ist eine Infrastruktur, die die KI-Automatisierung jedem zugänglich macht, der npm installiert hat.
Die Architektur ist solide. Die Abdeckung der Fähigkeiten ist beeindruckend. Die Tatsache, dass Google die OpenClaw-Kompatibilität vom ersten Tag an eingebaut hat, zeigt, wohin sich das Agenten-Ökosystem ihrer Meinung nach entwickelt.
Für Entwickler, die mit OpenClaw, Claude Code oder einer anderen Agentenplattform arbeiten, ist gws eines dieser Tools, das Sie in Ihrem Werkzeugkasten haben möchten. Es bewältigt die Komplexität der Google Workspace APIs, sodass sich Ihr Agent auf das Wesentliche konzentrieren kann – die Arbeit zu erledigen.
Die Agentenökonomie bekommt ihre Infrastruktur. Und es geschieht schneller, als die meisten Leute es sich vorstellen.
FAQ
F: Ist gws kostenlos nutzbar?
A: Ja, gws ist Open Source unter der Apache-2.0-Lizenz. Sie zahlen nur für die Nutzung der Google API, wenn Sie die kostenlosen Kontingente überschreiten.
F: Benötige ich ein Google Workspace-Konto?
A: Ein Standard-Google-Konto funktioniert für die meisten Funktionen. Einige Admin-APIs erfordern ein Workspace-Abonnement.
F: Kann ich gws ohne OpenClaw verwenden?
A: Absolut. gws funktioniert als eigenständiges CLI-Tool. Die OpenClaw-Integration ist optional für den nachrichtenbasierten Zugriff.
F: Wie aktualisiere ich gws?
A: Führen Sie npm update -g @googleworkspace/cli aus, um die neueste Version zu erhalten. Die CLI liest Googles Discovery Service zur Laufzeit, sodass sie immer Zugriff auf die neuesten APIs hat.
F: Sind meine Daten mit gws sicher?
A: gws speichert Anmeldeinformationen verschlüsselt im Ruhezustand mithilfe von AES-256-GCM mit Schlüsseln in Ihrem Betriebssystem-Schlüsselbund. Die Model Armor-Integration bietet zusätzliche Sicherheit für Agenten-Workflows.
F: Kann ich gws in CI/CD-Pipelines verwenden?
A: Ja. Exportieren Sie Ihre Anmeldeinformationen mit gws auth export --unmasked > credentials.json und setzen Sie GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE in Ihrer CI-Umgebung.
F: Was ist der Unterschied zwischen gws und dem Google APIs Explorer?
A: gws ist ein CLI-Tool, das für die Automatisierung und KI-Agenten-Integration entwickelt wurde. Der APIs Explorer ist ein webbasiertes Testtool. gws gibt strukturiertes JSON aus und unterstützt Skripting.
F: Funktioniert gws mit Dienstkonten?
A: Ja. Setzen Sie GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE auf Ihre Dienstkonto-JSON-Schlüsseldatei. Keine interaktive Anmeldung erforderlich.
F: Kann ich zu gws beitragen?
A: Ja, das Projekt ist Open Source auf GitHub. Beachten Sie, dass Pull Requests von Nicht-Kollaboratoren gemäß den Repository-Maintainern vorübergehend deaktiviert sind.
F: Welche Plattformen unterstützt gws?
A: gws liefert vorgefertigte Binärdateien für macOS, Linux und Windows. Das npm-Paket übernimmt die native Binärinstallation automatisch.
