// dokumentacja openclaw

Pierwsze kroki z OpenClaw — instalacja i konfiguracja

Wprowadzenie

OpenClaw to otwartoźródłowa platforma do uruchamiania autonomicznych agentów AI, którzy komunikują się przez popularne kanały — Telegram, Discord, Slack, WhatsApp i wiele innych. Ten przewodnik przeprowadzi Cię przez cały proces: od instalacji, przez konfigurację pierwszego providera AI, aż po uruchomienie Gateway i weryfikację, że wszystko działa poprawnie.

Wymagania systemowe

Zanim zaczniesz, upewnij się, że Twój system spełnia poniższe wymagania:

  • Node.js 24 lub nowszy — OpenClaw korzysta z najnowszych funkcji runtime'u. Sprawdź wersję poleceniem node --version.
  • Klucz API providera AI — np. OpenAI, Anthropic, Google Gemini lub dowolny z ponad 35 obsługiwanych dostawców. Klucz uzyskasz w panelu wybranego providera.
  • System operacyjny — macOS 13+, Ubuntu 22.04+ / Debian 12+, Windows 10+ (WSL2 lub natywnie), lub Docker na dowolnej platformie.
  • Minimum 2 GB RAM — zalecane 4 GB przy intensywnym użyciu wielu agentów jednocześnie.
  • Połączenie z internetem — wymagane do komunikacji z API providerów AI oraz kanałami komunikacji.

Instalacja

OpenClaw oferuje kilka metod instalacji. Wybierz tę, która najlepiej pasuje do Twojego środowiska.

macOS i Linux — instalacja przez curl

Najszybsza metoda to użycie jednolinijkowego skryptu instalacyjnego:

curl -fsSL https://get.openclaw.ai | bash

Skrypt automatycznie wykryje architekturę systemu, pobierze odpowiedni plik binarny i doda go do PATH. Po zakończeniu możesz od razu używać polecenia openclaw w terminalu.

Windows — instalacja przez PowerShell

Otwórz PowerShell jako administrator i uruchom:

irm https://get.openclaw.ai/win | iex

Skrypt zainstaluje OpenClaw i doda go do zmiennej środowiskowej PATH. Po instalacji zamknij i otwórz ponownie terminal, aby zmiany były widoczne.

Docker

Jeśli wolisz konteneryzację, skorzystaj z oficjalnego obrazu Docker:

docker pull ghcr.io/openclaw/openclaw:latest
docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  -p 18789:18789 \
  ghcr.io/openclaw/openclaw:latest

Katalog ~/.openclaw jest montowany jako wolumen, dzięki czemu konfiguracja i dane persystują między restartami kontenera.

npm (globalna paczka)

Jeśli masz już Node.js, możesz zainstalować OpenClaw jako globalny pakiet npm:

npm install -g @openclaw/openclaw

Ta metoda jest wygodna dla programistów, którzy chcą łatwo aktualizować OpenClaw przez npm update -g.

Kreator konfiguracji

Po instalacji uruchom interaktywny kreator, który przeprowadzi Cię przez pierwszą konfigurację:

openclaw onboard --install-daemon

Kreator wykona następujące kroki:

  1. Wybór providera AI — zostaniesz poproszony o podanie klucza API. Kreator przetestuje połączenie z wybranym dostawcą.
  2. Konfiguracja kanału — wybierz co najmniej jeden kanał komunikacji (np. Telegram, Discord). Kreator poprowadzi Cię przez tworzenie bota i konfigurację tokenów.
  3. Instalacja demona — flaga --install-daemon spowoduje, że Gateway będzie automatycznie uruchamiany wraz z systemem (jako usługa systemd na Linuksie, LaunchAgent na macOS lub Task Scheduler na Windows).
  4. Wygenerowanie konfiguracji — kreator zapisze plik ~/.openclaw/openclaw.json ze wszystkimi ustawieniami.

Weryfikacja instalacji

Po zakończeniu konfiguracji sprawdź, czy Gateway działa poprawnie:

openclaw gateway status

Poprawna odpowiedź powinna wyglądać mniej więcej tak:

OpenClaw Gateway v2.x.x
Status: running
Uptime: 5m 23s
Agents: 1 active
Channels: telegram (connected)

Jeśli widzisz status running oraz podłączone kanały — gratulacje, instalacja przebiegła pomyślnie!

Panel kontrolny (Dashboard)

OpenClaw udostępnia wbudowany panel webowy do zarządzania agentem. Uruchom go poleceniem:

openclaw dashboard

Domyślnie panel otworzy się pod adresem http://localhost:18789. Dashboard pozwala na:

  • Podgląd rozmów i sesji w czasie rzeczywistym
  • Edycję konfiguracji bez restartowania Gateway
  • Zarządzanie cronami i webhookami
  • Przeglądanie logów i diagnostykę

Zmienne środowiskowe

OpenClaw respektuje kilka zmiennych środowiskowych, które pozwalają na niestandardową lokalizację plików:

  • OPENCLAW_HOME — główny katalog OpenClaw. Domyślnie ~/.openclaw. Ustawienie tej zmiennej zmienia bazową ścieżkę dla konfiguracji i danych.
  • OPENCLAW_STATE_DIR — katalog przechowujący stan runtime: sesje, pamięć agentów, dane tymczasowe. Domyślnie $OPENCLAW_HOME/state.
  • OPENCLAW_CONFIG_PATH — pełna ścieżka do pliku konfiguracyjnego. Domyślnie $OPENCLAW_HOME/openclaw.json. Przydatne, gdy chcesz trzymać konfigurację w innym miejscu, np. w repozytorium dotfiles.

Przykład ustawienia zmiennych w pliku .bashrc lub .zshrc:

export OPENCLAW_HOME="/opt/openclaw"
export OPENCLAW_STATE_DIR="/var/lib/openclaw/state"
export OPENCLAW_CONFIG_PATH="/etc/openclaw/openclaw.json"

Następne kroki

Po pomyślnej instalacji i weryfikacji warto zapoznać się z kolejnymi stronami dokumentacji:

Wróc do dokumentacji