Instalacja OWLI
Od komendy ze strony do pierwszej rozmowy z OWLI - jedna komenda instaluje wszystko.
Zacznij tutaj
OWLI to dodatek do Claude Code - piszesz po polsku, a OWLI robi robotę na Twoim koncie Meta Ads. Instalacja to jedna komenda wklejona do terminala (czyli okna, w które wpisuje się polecenia). Node.js i git (narzędzia, na których chodzi OWLI) instalator dokłada sam.
Zanim zaczniesz
Przygotuj cztery rzeczy:
- Konto GitHub - potrzebne, żeby pobrać program. Przyjmij zaproszenie do repozytorium OWLI (mail albo github.com/notifications).
- Claude Code w planie płatnym Claude - to tu piszesz do OWLI.
- Klucz licencji (
owli_live_...) - dostajesz go w kreatorze na ai.owli.co/init (link z maila po zakupie). - Token Meta (
EAA...) - łączy OWLI z kontami reklamowymi. Można pominąć i dodać później. Jak go zdobyć: Aplikacja Meta.
Przyjmij zaproszenie do GitHub
Bez zaakceptowanego zaproszenia do repozytorium OWLI pobranie w terminalu się nie powiedzie. To najczęstsza przyczyna błędu na starcie.
1. Weź komendę ze strony
Na ai.owli.co/init przejdź kreator konfiguracji. Na ostatnim kroku dostajesz gotową komendę z Twoim kluczem licencji i przycisk „Skopiuj polecenie". Skopiuj ją.
2. Otwórz terminal
- macOS / Linux - Terminal (Cmd+spacja, wpisz „Terminal", Enter).
- Windows - PowerShell jako administrator (klawisz Win, wpisz „PowerShell", prawym przyciskiem → Uruchom jako administrator).
3. Wklej komendę i uruchom
Jedna komenda instaluje wszystko. Wklej skopiowaną ze strony (ma już Twój klucz w środku) i naciśnij Enter.
macOS / Linux:
~ % curl -fsSL https://ai.owli.co/install.sh \ | bash -s -- --key owli_live_…
Windows · PowerShell (Administrator):
PS> $env:OWLI_KEY='owli_live_…'PS> irm https://ai.owli.co/install.ps1 | iex
Coś przerwało instalację?
Wklej tę samą komendę jeszcze raz - instalator dokończy: to, co pobrane, zostaje, brakujące dołoży, a Twojej konfiguracji nie nadpisze. Jeśli napisze, że katalog owli już istnieje i nie jest instalacją OWLI - zmień mu nazwę i powtórz.
4. Zaloguj się do GitHub
Sama otworzy się przeglądarka. Zaloguj się (jeśli trzeba) i kliknij Autoryzuj. Na Windowsie pojawi się jednorazowy kod - skopiuj go i wklej na otwartej stronie GitHub. Robisz to raz.
5. Pobranie i przygotowanie
Skrypt sprawdza wymagania, pobiera program i instaluje wszystko, co potrzebne. Na Windowsie może pojawić się pytanie o uprawnienia - zatwierdź. To trwa 1-3 minuty, nie zamykaj okna.
╔═══════════════════════════════╗ ║ OWLI MCP - Instalacja ║ ╚═══════════════════════════════╝ ✅ Node.js v22.11.0 ✅ jq jq-1.7.1 📦 Instaluję zależności - to zajmie 1-3 minuty, nie zamykaj okna. ✅ Zależności zainstalowane. ▶ Przechodzę do konfiguracji...
6. Kreator konfiguracji - 4 kroki
Na końcu instalator uruchamia kreator. Przechodzi go w większości sam.
Krok 1/4 · Środowisko - sprawdza, czy Claude Code jest zainstalowany (bez niego OWLI się nie uruchomi). Jeśli brakuje, zaproponuje instalację.
▸ Krok 1/4 · Środowisko Wymaga konta Claude w planie płatnym. ✓ Claude Code wykryty w systemie. ✓ jq wykryty.
Krok 2/4 · Licencja - klucz owli_live_... przy instalacji jedną komendą przechodzi automatycznie, nie musisz go wpisywać.
▸ Krok 2/4 · Licencja Klucz aktywuje silnik OWLI - zaawansowaną diagnostykę kont. ✓ Klucz zapisany (format poprawny). ✓ Stanowisko tej maszyny aktywowane (1/3).
Krok 3/4 · Meta API - wklej token (EAA...). Kreator sprawdza go na żywo. Nie masz tokena? Naciśnij Enter, dodasz później - patrz Aplikacja Meta.
▸ Krok 3/4 · Meta API Token łączy OWLI z Twoimi kontami reklamowymi Meta. Token Meta (EAA… - Enter pomija, uzupełnisz później): ✓ Token zapisany i zweryfikowany na żywo (system user: OWLI Ads).
Krok 4/4 · Sprawdzenie - kreator uruchamia OWLI i pokazuje status każdego elementu.
▸ Krok 4/4 · Sprawdzenie ✓ OWLI działa - narzędzi: 86. INSTALACJA ZAKOŃCZONA ✓ Claude Code wykryty ✓ Licencja aktywna (1/3 stanowisk) ✓ Token Meta zweryfikowany ✓ Serwer działa (86 narzędzi) Otwórz nowe okno terminala i wpisz: cd owli claude
Gotowe
OWLI jest zainstalowany i podpięty pod Claude Code. Zostało tylko go włączyć.
7. Pierwsze uruchomienie
Otwórz nowe okno terminala, wejdź do folderu OWLI i uruchom Claude Code:
~ % cd owli~/owli % claude Uruchamiam Claude Code z OWLI...› Jak wygląda konto za 28 dni?
Folder owli powstał tam, gdzie uruchomiłeś instalację - zwykle katalog domowy (cd ~/owli na macOS/Linux, cd $HOME\owli na Windowsie). Kreator na końcu pokazał dokładną ścieżkę - jeśli cd owli nie działa, użyj jej.
Dalej piszesz do OWLI zwykłym językiem. Na start:
- „Jak wygląda konto za ostatnie 28 dni?" - pierwsza diagnoza.
- „Pomóż mi podłączyć pierwszego klienta" - jeśli robisz to po raz pierwszy.
Coś nie działa?
Nie udało się pobrać OWLI
Najczęściej niezaakceptowane zaproszenie do repozytorium. Sprawdź mail albo github.com/notifications i kliknij Akceptuj, potem powtórz komendę.
Wsparcie
Nie pomogło? Zapytaj na Discordzie OWLI - pomożemy.
Co dalej
Instalacja skończona - czas zacząć pracę. Zobacz Podstawowe polecenia, żeby wiedzieć, co i jak powiedzieć OWLI.