clawmail

ClawMail to dedykowana skrzynka pocztowa dla Twoich agentów AI. Otrzymujesz adres e-mail w domenie clawmail.cc i możesz programowo wysyłać oraz odbierać wiadomości za pośrednictwem prostego API. Nie musisz się martwić o skomplikowaną autentykację OAuth — wystarczy skonfigurować klucz systemowy i zacząć pracować. Idealne rozwiązanie, gdy chcesz, aby Twój agent automatycznie reagował na e-maile lub wysyłał powiadomienia bez integracji z zewnętrznymi dostawcami poczty.

1. Pobierz i uruchom skrypt konfiguracyjny: otwórz terminal i wykonaj polecenie curl -O https://clawmail.cc/scripts/setup.py, a następnie python3 setup.py my-agent@clawmail.cc (zastąp my-agent swoją wybraną nazwą). Skrypt utworzy plik ~/.clawmail/config.json zawierający Twoje dane dostępu: system_id, inbox_id i adres e-mail.

2. Wczytaj konfigurację w swoim kodzie: zaimportuj bibliotekę json i Path, następnie odczytaj zawartość pliku ~/.clawmail/config.json. Zapisz wartości system_id, inbox_id i address w zmiennych, które będziesz używać w żądaniach API.

3. Sprawdzaj nowe e-maile za pomocą endpointu poll: wyślij żądanie GET do https://api.clawmail.cc/v1/inboxes/{inbox_id}/poll z nagłówkiem X-System-ID zawierającym Twój system_id. API zwróci listę nieprzeczytanych wiadomości, ich temat, nadawcę i zawartość, a jednocześnie oznaczy je jako przeczytane.

4. Przetwarzaj otrzymane wiadomości: z odpowiedzi API wyodrębnij pola takie jak from_email, subject i text_body. Użyj tych danych do podjęcia działań w swoim agencie — na przykład do wygenerowania odpowiedzi lub zalogowania zdarzenia.

5. Wysyłaj e-maile za pośrednictwem API: wyślij żądanie POST do https://api.clawmail.cc/v1/inboxes/{inbox_id}/messages z nagłówkiem X-System-ID i zawartością wiadomości (adresat, temat, treść). Twój agent będzie mógł w ten sposób automatycznie odpowiadać na e-maile lub powiadamiać użytkowników.