Instalacja OpenClaw i konfiguracja OmniProxy

OpenClaw to asystent AI instalowany na własnym komputerze. Możesz rozmawiać z nim bezpośrednio przez Telegram, Discord, WhatsApp lub Feishu, bez konieczności ciągłego trzymania otwartego osobnego okna czatu. Rozmowy i historia pozostają na tym komputerze, a asystent może lokalnie wykonywać kolejne kroki.

Przygotowanie przed instalacją

OpenClaw wymaga Node 24.16 lub nowszego. Można również użyć Node 26.1 lub nowszego; zalecany jest Node 26. Node to podstawowe środowisko wymagane do działania OpenClaw.

Instalacja jest możliwa w systemach macOS, Linux i Windows. Jeśli na komputerze nie ma odpowiedniej wersji Node, skrypt instalacyjny przygotuje ją automatycznie: Node 26 w systemie macOS oraz Node 24 LTS w systemie Linux. pnpm jest potrzebny tylko podczas budowania OpenClaw z kodu źródłowego.

Jeżeli na komputerze jest już zainstalowana starsza wersja Node, nie trzeba jej od razu odinstalowywać. Podczas testu 2026-10-09 systemową wersją Node na tym komputerze była 24.2.0, czyli niższa od wymaganej 24.16. Nieinteraktywny skrypt instalacyjny samodzielnie przygotował Node 24.21.0.

Chcesz okno

Aplikacja desktopowa

• Pakiet Hub dla Windows
• DMG z GitHub dla macOS
• Przy pierwszym uruchomieniu możesz zainstalować lokalny Gateway

Oficjalnie zalecane

Skrypt instalacyjny

• macOS Linux WSL2
• W Windows użyj PowerShell
• Możesz dodać --no-onboard

Masz już Node

Menedżer pakietów

• npm pnpm lub bun
• Następnie uruchom onboard
• Wersję Node znajdziesz na stronie instalacji

Instalacja i pierwsze uruchomienie

Możesz zainstalować aplikację desktopową z interfejsem okienkowym albo przeprowadzić instalację bezpośrednio w terminalu. Gateway to lokalna usługa, która odbiera wiadomości, wywołuje model i odsyła wyniki. Można ją przygotować podczas pierwszego uruchomienia aplikacji desktopowej.

Jeśli chcesz korzystać z okna

• Windows: pobierz i uruchom OpenClawCompanion-Setup-x64.exe albo OpenClawCompanion-Setup-arm64.exe. Pakiet instalacyjny jest podpisany i zawiera ustawienia, stan w zasobniku systemowym, czat oraz tryb node.
• macOS: pobierz plik .dmg aplikacji OpenClaw z GitHub releases projektu OpenClaw. W pierwszej kolejności użyj dmg, ale można też użyć pliku .zip. Po instalacji otwórz OpenClaw.app. Jeśli ta wersja nie zawiera plików dla macOS, postępuj zgodnie ze stroną aplikacji dla macOS.

Przy pierwszym uruchomieniu możesz pozwolić OpenClaw przygotować Gateway na tym komputerze albo połączyć się z istniejącym zdalnym Gateway.

Instalacja w terminalu

W systemach macOS, Linux i WSL2 użyj:

curl -fsSL https://openclaw.ai/install.sh | bash

W Windows PowerShell użyj:

iwr -useb https://openclaw.ai/install.ps1 | iex

Skrypt rozpozna bieżący system, w razie potrzeby zainstaluje Node, następnie zainstaluje OpenClaw i uruchomi konfigurację początkową. Kreator przeprowadzi Cię przez pierwszą konfigurację.

Jeśli nie chcesz jeszcze uruchamiać konfiguracji początkowej, w systemach macOS, Linux i WSL2 użyj zamiast tego:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

W systemie Windows użyj oficjalnej opcji -NoOnboard:

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Jeśli samodzielnie zarządzasz Node, możesz również użyć npm, pnpm albo bun. W przypadku npm 12 oraz npm 11.16 lub nowszego uruchom:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

W npm 11.15 i starszych wersjach trzeba pominąć --allow-scripts=openclaw. W przypadku pnpm należy dodać --allow-build=openclaw. Szczegółowe różnice opisano na stronie instalacji.

Po zakończeniu instalacji uruchom kolejno poniższe trzy polecenia:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version wyświetla wersję, openclaw doctor sprawdza typowe problemy ze środowiskiem, a openclaw gateway status pokazuje, czy Gateway jest uruchomiony. Podstawową instalację można uznać za zakończoną dopiero wtedy, gdy wszystkie trzy polecenia zwracają prawidłowe dane.

Jeśli terminal informuje, że nie może znaleźć polecenia openclaw, zwykle oznacza to, że globalny katalog bin npm nie został dodany do PATH. PATH to lista lokalizacji, w których terminal szuka programów. Możesz porównać wyniki poleceń node -v, npm prefix -g i echo "$PATH", dodać odpowiedni katalog bin do PATH, a następnie ponownie otworzyć terminal.

Jeśli w ~/.openclaw znajduje się już używana konfiguracja, domyślny skrypt instalacyjny wykorzysta ten katalog. Aby zainstalować osobną kopię bez zmieniania dotychczasowej konfiguracji, uruchom skrypt nieinteraktywny i wskaż nowy katalog:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix "$HOME/openclaw-omniproxy" --no-onboard

--no-onboard jest domyślnym zachowaniem tego skryptu. Dnia 2026-10-09 to polecenie zainstalowało OpenClaw 2026.9.9. Po zakończeniu instalacji należy uruchamiać program openclaw znajdujący się w katalogu bin tej instalacji.

Pobieranie parametrów połączenia z OmniProxy

Najpierw upewnij się, że OmniProxy działa, a następnie otwórz jego listę modeli i przygotuj następujące trzy wartości:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: skopiuj w całości z bieżącej listy modeli OmniProxy

baseUrl to adres, pod który OpenClaw wysyła żądania do modelu. Musi kończyć się na /v1. Podczas integracji z OmniProxy dla pola api użyj openai-completions. Zmień je na openai-responses tylko wtedy, gdy dany model rzeczywiście działa przez /v1/responses.

Model ID to pełny identyfikator modelu widoczny na liście. Skopiuj go dokładnie w podanej postaci, zachowując również wszystkie ukośniki. Poniższe dwie nazwy służą jedynie jako odniesienie do dokumentacji dostawców z 2026-10-09. Nie używaj ich, jeśli nie ma ich na liście: claude-sonnet-5-5, gpt-6-luna.

Nawet jeśli Gateway nie sprawdza klucza, pole apiKey nadal musi zawierać jakąś wartość. Możesz użyć ciągu znaków zastępczych przeznaczonego wyłącznie dla tego komputera. Nie umieszczaj prawdziwego klucza w repozytorium.

Wprowadzanie konfiguracji narzędzia

Provider można rozumieć jako zestaw ustawień połączenia, których OpenClaw używa do odnalezienia usługi modelu. W tym przykładzie Provider otrzymuje nazwę omniproxy.

Uruchom poniższe polecenie w terminalu, zastępując adres, klucz oraz dwa identyfikatory modeli własnymi wartościami:

openclaw config set models.providers.omniproxy '{"baseUrl":"https://your-omniproxy-origin.example/v1","apiKey":"<YOUR_OMNIPROXY_API_KEY>","api":"openai-completions","models":[{"id":"claude-sonnet-5-5","name":"Claude Sonnet 5.5"},{"id":"gpt-6-luna","name":"GPT-6 Luna"}]}' --strict-json --merge

To polecenie zapisuje Provider i listę modeli w konfiguracji. Po jego pomyślnym wykonaniu nie trzeba ponownie uruchamiać Gateway.

Następnie ustaw model domyślny. Odwołanie do modelu składa się z omniproxy/ oraz Model ID. Zachowaj wszystkie ukośniki występujące w identyfikatorze. Jeśli ID na liście modeli jest dłuższe od skróconej nazwy użytej poniżej, użyj pełnej wartości z listy:

openclaw config set agents.defaults.model.primary '"omniproxy/claude-sonnet-5-5"' --strict-json

Pola reasoning, input, cost, contextWindow i maxTokens można pominąć. Jeśli nie zostaną podane, modele tekstowe będą obsługiwane w sposób domyślny.

Te same ustawienia można również wpisać bezpośrednio do pliku konfiguracyjnego. W konfiguracji głównej Provider znajduje się w models.providers. Każdy agent może także mieć własny plik models.json; agent to instancja asystenta, która faktycznie odbiera zadania i wywołuje model. Plik znajduje się w agent/models.json we właściwym katalogu agenta pod ~/.openclaw/agents/.

Jeśli ten plik models.json zawiera niepustą wartość baseUrl, zastąpi ona adres z konfiguracji głównej.

Sprawdzenie instalacji

Trzy polecenia

• openclaw --version
• openclaw doctor
• gateway status

Konfiguracja

models.providers

• baseUrl kończy się na /v1
• api używa completions
• Model musi zawierać co najmniej id

Wybór

provider/model

• primary używa tego odwołania
• Klucz najlepiej podać przez zmienną środowiskową
• Kieruj się listą bramy

Weryfikacja rzeczywistego zadania

Przejdź do zwykłego katalogu projektu i wyślij bardzo krótką wiadomość. Zastąp odwołanie do modelu w poleceniu pełnym Model ID:

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "Odpowiedz jednym słowem."

--local oznacza lokalne uruchomienie tego zadania agenta, --model wskazuje model używany w tym wywołaniu, a --timeout 300 ustawia maksymalny czas oczekiwania na 300 sekund.

W terminalu musi rzeczywiście pojawić się odpowiedź modelu. Dnia 2026-10-09 OpenClaw 2026.9.9 otrzymał odpowiedź po użyciu tego polecenia. Pierwsze wywołanie może potrwać minutę lub dwie.

Jeśli pojawi się oryginalny błąd Request timed out before a response was generated, najpierw zwiększ wartość --timeout, a następnie wyślij wiadomość ponownie. Zwykle oznacza to, że czas oczekiwania był zbyt krótki, a nie że adres na pewno jest błędny.

Po uzyskaniu krótkiej odpowiedzi poproś asystenta o odczytanie wskazanego przez Ciebie pliku lokalnego. Następnie otwórz historię wywołań OmniProxy i sprawdź zapisane źródło oraz Model ID. Samo wyświetlenie numeru wersji lub wyniku działania doctor nie potwierdza jeszcze, że połączenie z modelem zostało prawidłowo skonfigurowane.

Instalacja

Polecenie odpowiada

• Można wyświetlić numer wersji
• doctor nie blokuje działania
• Stan Gateway jest dostępny

Zadanie

Zrobił małą rzecz

• Na przykład odczytał lokalny plik
• Odpowiedź nie jest błędem
• Odwołanie do modelu jest poprawne

Rejestr

Brama go widzi

• Źródło to OpenClaw
• Identyfikator modelu jest zgodny
• Klucz nie trafił do repozytorium

Typowe błędy

• Nie można znaleźć openclaw: dodaj globalny katalog bin npm do PATH, a następnie ponownie otwórz terminal. Jeśli instalacja została wykonana we wskazanym katalogu, uruchamiaj program z jego katalogu bin.
• node -v pokazuje wersję niższą niż 24.16: nie trzeba najpierw odinstalowywać starszej wersji. Sprawdź Node przygotowany przez skrypt instalacyjny albo zgodnie ze stroną instalacji użyj wersji 24.16+ lub 26.1+. Zalecany jest Node 26.
• Model się nie pojawia: model musi być zapisany w tablicy models w models.providers i zawierać co najmniej zgodne pole id. Samo wpisanie go do agents.defaults.models nie rejestruje nowego modelu.
• Zwracany jest błąd 400 ze wzmianką o roli developer: jeśli host adresu nie jest api.openai.com, zachowaj ustawienie domyślne i nie ustawiaj supportsDeveloperRole na true. Nawet po ustawieniu true ta wartość zostanie zastąpiona.
• Przekroczenie czasu następuje bardzo szybko: zwiększ --timeout do co najmniej 300 sekund i na razie nie zmieniaj adresu.
• Wybrano gpt-6-luna, ale wywoływanie narzędzi nie działa: ten model obsługuje Chat Completions; wywoływanie funkcji w Chat Completions jest obsługiwane tylko wtedy, gdy reasoning_effort ma wartość none. Jeśli ID na liście jest inne, użyj wartości z listy.
• Nie można połączyć się z adresem: upewnij się, że OmniProxy działa, baseUrl kończy się na /v1, a adres zapisany w konfiguracji jest dostępny. Inne adresy sieci prywatnej trzeba osobno dopuścić.
• Mimo konfiguracji żądania nadal trafiają pod inny adres: sprawdź, czy plik models.json danego agenta zawiera inną wartość baseUrl.

Oficjalne materiały

Instrukcje instalacji znajdziesz na stronie OpenClaw install. Sposób konfiguracji niestandardowego Provider opisują strony Custom providers oraz pola konfiguracji. Identyfikatory modeli użyte w przykładzie można porównać z materiałami przegląd modeli Claude i GPT-6 Luna.

Zastąp każdy placeholder wartościami z własnej konfiguracji OmniProxy. Nigdy nie publikuj prawdziwego klucza.

Zapisany wynik lub HTTP 200 samo w sobie nie dowodzi pełnej kompatybilności Agenta. Sprawdź źródło i model w rejestrze połączeń OmniProxy.

Źródła oficjalne · OpenClaw ↗