Lekcja 20 · krok 2około 60 min pracy

Postaw Gateway i doprowadź do pierwszej odpowiedzi

Ćwiczenie do lekcji Instalacja OpenClaw krok po kroku: VPS, Windows, Docker. Teorię masz za sobą — teraz wykonaj to na własnym agencie albo w dowolnym czacie z modelem. Bez tego kroku kurs zostaje wiedzą, która nie zmienia niczego w Twojej pracy.

Co powinieneś już wiedzieć z teorii

  • Node musi być w wersji 22.22.3+, 24.15+ albo 25.9+ — dziś polecany jest Node 26. Bun nie uruchomi CLI ani Gateway, bo brakuje mu node:sqlite.
  • Minimum sprzętowe to 1 vCPU, 1 GB RAM, 500 MB dysku i system 64-bitowy, ale sam build obrazu Dockera potrzebuje co najmniej 2 GB RAM, inaczej pnpm install ginie z kodem 137.
  • Na serwerze bez ekranu: npm i -g openclaw@latest, openclaw onboard --install-daemon, a do panelu tunel ssh -N -L 18789:127.0.0.1:18789.
  • W Dockerze domyślny loopback oznacza 127.0.0.1 wewnątrz kontenera, więc przy zwykłym -p 18789:18789 Gateway jest nieosiągalny; gateway.bind ustawia się nazwą trybu, nie adresem.

Co masz zrobić

Zadanie na własnej maszynie: doprowadź instalację do momentu, w którym agent odpowiada w panelu. Wybierz jedną z trzech dróg — VPS przez npm, Windows przez instalator PowerShell albo Docker przez skrypt setup.sh — i nie mieszaj ich w trakcie. Do testu pierwszej wiadomości wystarczy lokalny model z Ollamy albo LM Studio — klucz płatnego providera nie jest do tego ćwiczenia potrzebny. Zanotuj godzinę startu i zakończenia; ta liczba przyda się przy decyzji, czy self-host ma u Ciebie sens. Jeśli utkniesz na dłużej niż dwie godziny, zapisz, na czym, i wróć do tego następnego dnia.

Prowadzę instalację silnika OpenClaw na własnej maszynie. Podam system operacyjny, wersję Node'a z komendy node --version, wybraną drogę instalacji oraz treść błędu, na którym utknąłem. Powiedz, co sprawdzić w następnej kolejności i jakimi komendami, układając je od najtańszej diagnostycznie do najbardziej inwazyjnej. Nie proponuj reinstalacji ani kasowania katalogu stanu, dopóki nie wyczerpiemy diagnostyki. Przy każdej komendzie napisz jednym zdaniem, czego się z niej dowiem.

Gotowe, gdy:

Gdzie to się najczęściej sypie

Zanim uznasz ćwiczenie za zrobione, sprawdź, czy nie wpadłeś w któreś z tych miejsc. Każde widzieliśmy więcej niż raz.

  • Instalacja na Node w wersji spoza wspieranego zakresu albo próba uruchomienia CLI Bunem. Objaw wygląda na błąd kodu, a jest brakiem node:sqlite lub za starym runtime'em.
  • Wystawienie panelu na 0.0.0.0, żeby dostać się do niego z laptopa. Dokumentacja zabrania tego wprost bez uwierzytelniania; właściwa droga to tunel SSH albo Tailscale Serve.
  • Uruchomienie kontenera z -p 18789:18789 bez zmiany gateway.bind. Port jest zmapowany, kontener działa, a panel milczy, bo Gateway słucha na loopbacku wewnątrz kontenera.
  • Pominięcie testu pierwszej wiadomości i przejście od razu do podłączania kanałów. Potem nie wiadomo, czy milczy kanał, czy provider modelu, i diagnostyka robi się dwa razy dłuższa.

Nie masz jeszcze na czym ćwiczyć?

Agent w chmurze EU startuje w około minutę. Pierwsza subskrypcja pakietu Premium ma 5 dni za darmo, a kurs czytasz dalej niezależnie od tego.

Zobacz plany