Agent AI obsługuje Twój Gmail – praktyczny przewodnik

Sto wiadomości dziennie. Dwieście pięćdziesiąt dni roboczych. Dwadzieścia pięć tysięcy wiadomości rocznie. Jeśli spędzasz średnio dwie minuty na każdej – to ponad osiemset godzin. Sto dni roboczych. Ćwierć roku tylko na pocztę.

A gdyby agent AI przejął osiemdziesiąt procent tej pracy?

1. Problem: zalew wiadomości
2. Co potrafi gws-gmail?
3. Praktyczne scenariusze automatyzacji
4. Gotowe przepisy do użycia
5. Bezpieczeństwo: co agent widzi i robi
6. Krok po kroku: Gmail + OpenClaw

Problem: zalew wiadomości

Badania McKinsey pokazują, że przeciętny pracownik wiedzy spędza 28% czasu pracy na obsłudze poczty. Dla menedżerów ta liczba sięga nawet 40%. To nie jest produktywność – to przetrwanie.

Problem nie leży w samej liczbie wiadomości. Problem w tym, że większość z nich nie wymaga Twojej pełnej uwagi:

• Newslettery, które „może kiedyś przeczytam"
• Powiadomienia z systemów, które wymagają tylko przejrzenia
• Wiadomości w kopii, gdzie jesteś tylko „do wiadomości"
• Automatyczne potwierdzenia, faktury, rachunki

Agent AI z dostępem do Gmaila może przejąć tę pracę. Nie zastąpi Cię w pisaniu strategicznych odpowiedzi do kluczowych klientów. Ale może zrobić segregację, kategoryzację i przygotowanie – tak, żebyś Ty skupił się tylko na tym, co naprawdę wymaga Twojej uwagi.

Co potrafi gws-gmail?

Google Workspace CLI oferuje zestaw narzędzi do pracy z Gmailem. Nie musisz pisać integracji od zera – wystarczy skonfigurować umiejętność i wydać polecenie agentowi.

gws gmail-triage – Twój codzienny przegląd

Zamiast przewijać dziesiątki nieprzeczytanych wiadomości, poproś agenta o podsumowanie:

gws gmail-triage

Agent przeanalizuje Twoją skrzynkę i zwróci uporządkowany raport: ile wiadomości czeka, od kogo najważniejsze, jakie tematy się powtarzają. W formacie JSON, który można dalej przetwarzać lub wyświetlić jako czytelne podsumowanie.

gws gmail-send – wysyłka z kontrolą

Agent może wysyłać wiadomości w Twoim imieniu. Brzmi ryzykownie? Zależy od konfiguracji.

gws gmail-send \
  --to "klient@firma.pl" \
  --subject "Potwierdzenie spotkania" \
  --body "Dziękuję za potwierdzenie. Do zobaczenia jutro o 10:00."

Możesz skonfigurować agenta tak, by tylko przygotowywał szkice do Twojej akceptacji, albo by wysyłał automatycznie tylko określone typy wiadomości (np. potwierdzenia, przypomnienia).

gws gmail-watch – monitoring w czasie rzeczywistym

Dla bardziej zaawansowanych scenariuszy – strumień nowych wiadomości jako NDJSON:

gws gmail-watch

Agent może reagować na nowe wiadomości w czasie rzeczywistym: kategoryzować, eskalować pilne, odpowiadać na rutynowe.

Praktyczne scenariusze automatyzacji

Teoria jest piękna, ale co konkretnie możesz zautomatyzować? Oto scenariusze, które wdrażamy u klientów.

Codzienny przegląd

Każdego ranka agent analizuje Twoją skrzynkę i przygotowuje raport:

„Masz 47 nieprzeczytanych wiadomości. 3 od klientów (priorytet wysoki), 12 wewnętrznych (5 wymaga odpowiedzi), 8 newsletterów, 24 powiadomienia systemowe. Najważniejsze: wiadomość od Jana Kowalskiego z prośbą o ofertę, termin odpowiedzi do końca dnia."

Zamiast przeglądać wszystko, zaczynasz od tego, co naprawdę ważne.

Automatyczna kategoryzacja

Agent sortuje wiadomości do odpowiednich folderów i etykiet na podstawie treści, nadawcy i historii:

• Klienci → priorytet, odpowiedź w ciągu 24h
• Zespół → przegląd, odpowiedź gdy potrzebna
• Newslettery → archiwum, do przeczytania w wolnym czasie
• Powiadomienia → automatyczna archiwizacja, raport zbiorczy

Inteligentne szkice

Agent przygotowuje propozycje odpowiedzi na rutynowe wiadomości:

Otrzymano: „Czy możemy przesunąć spotkanie na czwartek?"

Szkic agenta: „Dziękuję za wiadomość. Czwartek o tej samej godzinie będzie odpowiadał. Potwierdzam zmianę terminu. Pozdrawiam, [Twoje imię]"

Ty tylko akceptujesz lub edytujesz przed wysłaniem.

Gotowe przepisy do użycia

Repozytorium gws zawiera gotowe „przepisy" – wielokrokowe scenariusze, które możesz uruchomić jednym poleceniem.

Spersonalizowana wysyłka z arkusza Google

Masz listę 200 klientów w Sheets i chcesz wysłać każdemu spersonalizowaną wiadomość? Przepis recipe-send-personalized-emails robi to za Ciebie:

1. Pobiera dane z arkusza
2. Generuje treść wiadomości dla każdego wiersza
3. Wysyła (lub tworzy szkice do akceptacji)
4. Rejestruje status każdej wysyłki

Bez ręcznego kopiowania, bez pomyłek w imionach.

Bezpieczeństwo: co agent widzi i robi

Danie agentowi AI dostępu do skrzynki to poważna decyzja. Jak kontrolować, co agent może zrobić?

Minimalne zakresy uprawnień

Nie musisz dawać agentowi pełnego dostępu do Gmail. Możesz wybrać konkretne uprawnienia:

# Tylko odczyt – agent nie może wysyłać
gws auth login --scopes gmail.readonly

# Odczyt + wysyłka – ale bez modyfikacji ustawień
gws auth login --scopes gmail.readonly,gmail.send

# Pełny dostęp – tylko gdy naprawdę potrzebny
gws auth login --scopes gmail

Model Armor – skanowanie treści

Jeśli agent przetwarza treść wiadomości, istnieje ryzyko wstrzyknięcia promptu – ktoś może wysłać wiadomość z ukrytymi instrukcjami dla AI. Model Armor skanuje treść przed przekazaniem do modelu:

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

Rejestr działań

Każda akcja agenta jest rejestrowana. W Admin Console Google Workspace możesz sprawdzić:

• Kto (który Service Account) wykonał akcję
• Kiedy
• Na czym (która wiadomość, który użytkownik)
• Jaki był rezultat

Pełna przejrzystość, możliwość audytu, zgodność z regulacjami.

Krok po kroku: Gmail + OpenClaw

Gotowy do wdrożenia? Oto konkretne kroki.

Krok 1: Instalacja gws i umiejętności gws-gmail

npm install -g @googleworkspace/cli
ln -s /path/to/skills/gws-gmail ~/.openclaw/skills/

Krok 2: Uwierzytelnianie

gws auth setup
gws auth login --scopes gmail.readonly,gmail.send

Więcej o bezpiecznej konfiguracji uwierzytelniania znajdziesz w artykule Bezpieczne uwierzytelnianie w Google Workspace CLI.

Krok 3: Test połączenia

gws gmail-triage

Powinieneś zobaczyć podsumowanie swojej skrzynki w formacie JSON.

Krok 4: Konfiguracja OpenClaw

Dodaj umiejętność do konfiguracji agenta i przetestuj pierwszy prompt:

„Przejrzyj moją skrzynkę i pokaż najważniejsze wiadomości z ostatnich 24 godzin. Posortuj według priorytetu."

Krok 5: Stopniowe rozszerzanie

Zacznij od trybu tylko do odczytu, dodawaj uprawnienia w miarę budowania zaufania. Monitoruj aktywność przez pierwsze tygodnie.