FAQ: konfiguracja przy pierwszym uruchomieniu

Użyj lokalnego agenta AI, który może widzieć Twoją maszynę. To znacznie skuteczniejsze niż pytanie na Discord, ponieważ większość przypadków „utknąłem” to lokalne problemy z konfiguracją lub środowiskiem, których zdalne osoby pomagające nie mogą sprawdzić.

• Claude Code: https://www.anthropic.com/claude-code/
• OpenAI Codex: https://openai.com/codex/

Te narzędzia mogą czytać repozytorium, uruchamiać polecenia, sprawdzać logi i pomagać naprawiać konfigurację na poziomie maszyny (PATH, usługi, uprawnienia, pliki uwierzytelniania). Daj im pełne pobranie źródeł przez instalację hackowalną (git):

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

To instaluje OpenClaw z pobranego repozytorium git, dzięki czemu agent może czytać kod + dokumentację i rozumować o dokładnej wersji, którą uruchamiasz. Zawsze możesz później wrócić do wersji stabilnej, uruchamiając instalator ponownie bez --install-method git.

Wskazówka: poproś agenta, aby zaplanował i nadzorował poprawkę (krok po kroku), a następnie wykonał tylko niezbędne polecenia. Dzięki temu zmiany są małe i łatwiejsze do audytu.

Jeśli odkryjesz rzeczywisty błąd lub poprawkę, zgłoś issue na GitHub albo wyślij PR: https://github.com/openclaw/openclaw/issues https://github.com/openclaw/openclaw/pulls

Zacznij od tych poleceń (udostępnij wyniki, gdy prosisz o pomoc):

openclaw statusopenclaw models statusopenclaw doctor

Co robią:

• openclaw status: szybki podgląd kondycji gateway/agenta + podstawowej konfiguracji.
• openclaw models status: sprawdza uwierzytelnianie dostawcy + dostępność modeli.
• openclaw doctor: weryfikuje i naprawia typowe problemy z konfiguracją/stanem.

Inne przydatne kontrole CLI: openclaw status --all, openclaw logs --follow, openclaw gateway status, openclaw health --verbose.

Szybka pętla debugowania: Pierwsze 60 sekund, jeśli coś jest zepsute. Dokumentacja instalacji: Instalacja, Flagi instalatora, Aktualizowanie.

Typowe powody pominięcia heartbeat:

• quiet-hours: poza skonfigurowanym oknem godzin aktywności
• empty-heartbeat-file: HEARTBEAT.md istnieje, ale zawiera tylko puste wiersze, komentarze, nagłówki, ogrodzenie lub pusty szkielet checklisty
• no-tasks-due: tryb zadań HEARTBEAT.md jest aktywny, ale żaden z interwałów zadań jeszcze nie nadszedł
• alerts-disabled: cała widoczność heartbeat jest wyłączona (showOk, showAlerts i useIndicator są wyłączone)

W trybie zadań znaczniki czasu terminu są przesuwane dopiero po zakończeniu rzeczywistego uruchomienia heartbeat. Pominięte uruchomienia nie oznaczają zadań jako ukończonych.

Dokumentacja: Heartbeat, Automatyzacja.

Repozytorium zaleca uruchamianie ze źródeł i używanie onboardingu:

curl -fsSL https://openclaw.ai/install.sh | bashopenclaw onboard --install-daemon

Kreator może też automatycznie zbudować zasoby UI. Po onboardingu zwykle uruchamiasz Gateway na porcie 18789.

Ze źródeł (kontrybutorzy/dev):

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm buildpnpm ui:buildopenclaw onboard

Jeśli nie masz jeszcze instalacji globalnej, uruchom przez pnpm openclaw onboard.

Kreator otwiera przeglądarkę z czystym (bez tokenu w URL) adresem dashboardu zaraz po onboardingu, a także wypisuje link w podsumowaniu. Zostaw tę kartę otwartą; jeśli się nie uruchomiła, skopiuj/wklej wypisany URL na tej samej maszynie.

Localhost (ta sama maszyna):

• Otwórz http://127.0.0.1:18789/.
• Jeśli poprosi o uwierzytelnienie współdzielonym sekretem, wklej skonfigurowany token lub hasło w ustawieniach Control UI.
• Źródło tokenu: gateway.auth.token (lub OPENCLAW_GATEWAY_TOKEN).
• Źródło hasła: gateway.auth.password (lub OPENCLAW_GATEWAY_PASSWORD).
• Jeśli współdzielony sekret nie jest jeszcze skonfigurowany, wygeneruj token poleceniem openclaw doctor --generate-gateway-token.

Nie na localhost:

• Tailscale Serve (zalecane): pozostaw bindowanie do loopback, uruchom openclaw gateway --tailscale serve, otwórz https://<magicdns>/. Jeśli gateway.auth.allowTailscale ma wartość true, nagłówki tożsamości spełniają uwierzytelnianie Control UI/WebSocket (bez wklejanego współdzielonego sekretu, przy założeniu zaufanego hosta gateway); API HTTP nadal wymagają uwierzytelniania współdzielonym sekretem, chyba że celowo używasz prywatnego ingress none albo uwierzytelniania HTTP przez zaufane proxy. Nieudane równoczesne próby uwierzytelnienia Serve od tego samego klienta są serializowane, zanim limiter nieudanego uwierzytelniania je zapisze, więc druga zła ponowna próba może już pokazać retry later.
• Bindowanie tailnet: uruchom openclaw gateway --bind tailnet --token "<token>" (lub skonfiguruj uwierzytelnianie hasłem), otwórz http://<tailscale-ip>:18789/, a następnie wklej pasujący współdzielony sekret w ustawieniach dashboardu.
• Reverse proxy świadome tożsamości: trzymaj Gateway za zaufanym proxy, skonfiguruj gateway.auth.mode: "trusted-proxy", a następnie otwórz URL proxy. Proxy loopback na tym samym hoście wymagają jawnego gateway.auth.trustedProxy.allowLoopback = true.
• Tunel SSH: ssh -N -L 18789:127.0.0.1:18789 user@host, potem otwórz http://127.0.0.1:18789/. Uwierzytelnianie współdzielonym sekretem nadal obowiązuje przez tunel; wklej skonfigurowany token lub hasło, jeśli pojawi się monit.

Zobacz Dashboard i Powierzchnie webowe, aby poznać tryby bindowania i szczegóły uwierzytelniania.

Kontrolują różne warstwy:

• approvals.exec: przekazuje monity zatwierdzania do miejsc docelowych czatu
• channels.<channel>.execApprovals: sprawia, że ten kanał działa jako natywny klient zatwierdzania dla zatwierdzeń exec

Polityka exec hosta nadal jest właściwą bramką zatwierdzania. Konfiguracja czatu kontroluje tylko, gdzie pojawiają się monity zatwierdzania i jak ludzie mogą na nie odpowiadać.

W większości konfiguracji nie potrzebujesz obu:

• Jeśli czat już obsługuje polecenia i odpowiedzi, /approve na tym samym czacie działa przez wspólną ścieżkę.
• Jeśli obsługiwany kanał natywny może bezpiecznie wywnioskować osoby zatwierdzające, OpenClaw automatycznie włącza teraz natywne zatwierdzenia DM-first, gdy channels.<channel>.execApprovals.enabled jest nieustawione albo ma wartość "auto".
• Gdy natywne karty/przyciski zatwierdzania są dostępne, ten natywny UI jest główną ścieżką; agent powinien dołączyć ręczne polecenie /approve tylko wtedy, gdy wynik narzędzia mówi, że zatwierdzenia na czacie są niedostępne albo ręczne zatwierdzenie jest jedyną ścieżką.
• Użyj approvals.exec tylko wtedy, gdy monity muszą być także przekazywane do innych czatów lub jawnych pokoi operacyjnych.
• Użyj channels.<channel>.execApprovals.target: "channel" albo "both" tylko wtedy, gdy wyraźnie chcesz, aby monity zatwierdzania były publikowane z powrotem w pokoju/temacie źródłowym.
• Zatwierdzenia pluginów są znów oddzielne: domyślnie używają /approve na tym samym czacie, opcjonalnego przekazywania approvals.plugin, a tylko niektóre kanały natywne utrzymują dodatkową natywną obsługę zatwierdzania pluginów.

W skrócie: przekazywanie służy do routingu, a konfiguracja klienta natywnego do bogatszego UX specyficznego dla kanału. Zobacz Zatwierdzenia Exec.

Wymagany jest Node >= 22. Zalecany jest pnpm. Bun nie jest zalecany dla Gateway.

Tak. Gateway jest lekki - dokumentacja podaje 512MB-1GB RAM, 1 rdzeń i około 500MB dysku jako wystarczające do użytku osobistego oraz zauważa, że Raspberry Pi 4 może go uruchomić.

Jeśli chcesz mieć dodatkowy zapas (logi, media, inne usługi), zalecane są 2GB, ale nie jest to twarde minimum.

Wskazówka: mały Raspberry Pi/VPS może hostować Gateway, a Ty możesz sparować węzły na laptopie/telefonie do lokalnego ekranu/kamery/canvas albo wykonywania poleceń. Zobacz Węzły.

W skrócie: działa, ale spodziewaj się nierówności.

• Użyj systemu operacyjnego 64-bit i utrzymuj Node >= 22.
• Preferuj instalację hackowalną (git), aby widzieć logi i szybko aktualizować.
• Zacznij bez kanałów/skills, a potem dodawaj je pojedynczo.
• Jeśli trafisz na dziwne problemy binarne, zwykle jest to problem zgodności z ARM.

Dokumentacja: Linux, Instalacja.

Ten ekran zależy od tego, czy Gateway jest osiągalny i uwierzytelniony. TUI wysyła też „Wake up, my friend!” automatycznie przy pierwszym wykluciu. Jeśli widzisz tę linię bez odpowiedzi i tokeny zostają na 0, agent nigdy się nie uruchomił.

1. Zrestartuj Gateway:

openclaw gateway restart

2. Sprawdź status + uwierzytelnianie:

openclaw statusopenclaw models statusopenclaw logs --follow

3. Jeśli nadal wisi, uruchom:

openclaw doctor

Jeśli Gateway jest zdalny, upewnij się, że tunel/połączenie Tailscale działa oraz że UI wskazuje właściwy Gateway. Zobacz Dostęp zdalny.

Tak. Skopiuj katalog stanu i workspace, a następnie uruchom Doctor raz. To utrzymuje Twojego bota „dokładnie takiego samego” (pamięć, historię sesji, uwierzytelnianie i stan kanałów), o ile skopiujesz obie lokalizacje:

1. Zainstaluj OpenClaw na nowej maszynie.
2. Skopiuj $OPENCLAW_STATE_DIR (domyślnie: ~/.openclaw) ze starej maszyny.
3. Skopiuj workspace (domyślnie: ~/.openclaw/workspace).
4. Uruchom openclaw doctor i zrestartuj usługę Gateway.

To zachowuje konfigurację, profile uwierzytelniania, poświadczenia WhatsApp, sesje i pamięć. Jeśli jesteś w trybie zdalnym, pamiętaj, że host gateway jest właścicielem magazynu sesji i workspace.

Ważne: jeśli tylko commitujesz/pushujesz workspace na GitHub, tworzysz kopię zapasową pamięci + plików bootstrap, ale nie historii sesji ani uwierzytelniania. One znajdują się pod ~/.openclaw/ (na przykład ~/.openclaw/agents/<agentId>/sessions/).

Powiązane: Migracja, Gdzie rzeczy są przechowywane na dysku, Workspace agenta, Doctor, Tryb zdalny.

Sprawdź changelog na GitHub: https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

Najnowsze wpisy są u góry. Jeśli górna sekcja jest oznaczona jako Unreleased, następna datowana sekcja jest najnowszą wydaną wersją. Wpisy są grupowane według Highlights, Changes i Fixes (plus sekcje dokumentacji/inne, gdy są potrzebne).

Niektóre połączenia Comcast/Xfinity nieprawidłowo blokują docs.openclaw.ai przez Xfinity Advanced Security. Wyłącz to albo dodaj docs.openclaw.ai do listy dozwolonych, a następnie spróbuj ponownie. Pomóż nam to odblokować, zgłaszając tutaj: https://spa.xfinity.com/check_url_status.

Jeśli nadal nie możesz otworzyć strony, dokumentacja jest zduplikowana na GitHub: https://github.com/openclaw/openclaw/tree/main/docs

Stabilna i beta to npm dist-tags, a nie oddzielne linie kodu:

• latest = stabilna
• beta = wczesna kompilacja do testów

Zwykle stabilne wydanie trafia najpierw do beta, a potem jawny krok promocji przenosi tę samą wersję do latest. Maintainerzy mogą też publikować bezpośrednio do latest, gdy jest to potrzebne. Dlatego beta i stabilna mogą wskazywać na tę samą wersję po promocji.

Zobacz, co się zmieniło: https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

Jednolinijkowe polecenia instalacji i różnicę między beta a dev znajdziesz w akordeonie poniżej.

Beta to npm dist-tag beta (po promocji może odpowiadać latest). Dev to ruchomy punkt HEAD gałęzi main (git); po publikacji używa npm dist-tag dev.

Jednolinijkowe polecenia (macOS/Linux):

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Instalator Windows (PowerShell): https://openclaw.ai/install.ps1

Więcej szczegółów: Kanały rozwojowe i Flagi instalatora.

Dwie opcje:

1. Kanał dev (git checkout):

openclaw update --channel dev

To przełącza na gałąź main i aktualizuje ze źródeł.

2. Instalacja do modyfikacji (ze strony instalatora):

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

Otrzymasz lokalne repozytorium, które możesz edytować, a potem aktualizować przez git.

Jeśli wolisz ręcznie wykonać czyste klonowanie, użyj:

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm build

Dokumentacja: Aktualizacja, Kanały rozwojowe, Instalacja.

Orientacyjnie:

• Instalacja: 2-5 minut
• Onboarding QuickStart: zwykle kilka minut
• Pełny onboarding: dłużej, gdy logowanie do providera, parowanie kanału, instalacja daemona, pobieranie z sieci, Skills lub opcjonalne pluginy wymagają dodatkowej konfiguracji

Kreator CLI pokazuje ten harmonogram z góry. Możesz pominąć opcjonalne kroki i wrócić później za pomocą openclaw configure.

Jeśli proces się zawiesza, użyj Instalator się zaciął oraz szybkiej pętli debugowania w Utknąłem.

Uruchom instalator ponownie z szczegółowym wyjściem:

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

Instalacja beta ze szczegółowym wyjściem:

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

Dla instalacji do modyfikacji (git):

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose

Odpowiednik dla Windows (PowerShell):

# install.ps1 has no dedicated -Verbose flag yet.Set-PSDebug -Trace 1& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardSet-PSDebug -Trace 0

Więcej opcji: Flagi instalatora.

Dwa typowe problemy w Windows:

1) błąd npm spawn git / nie znaleziono git

• Zainstaluj Git for Windows i upewnij się, że git jest w PATH.
• Zamknij i ponownie otwórz PowerShell, a potem uruchom instalator ponownie.

2) openclaw nie jest rozpoznawany po instalacji

• Globalny folder bin npm nie znajduje się w PATH.

• Sprawdź ścieżkę:

  npm config get prefix

• Dodaj ten katalog do swojego użytkownika PATH (w Windows nie jest potrzebny sufiks \bin; w większości systemów jest to %AppData%\npm).

• Po zaktualizowaniu PATH zamknij i ponownie otwórz PowerShell.

Do konfiguracji desktopowej użyj natywnej aplikacji Windows Hub. Do konfiguracji tylko terminalowej obsługiwane są zarówno instalator PowerShell, jak i ścieżki WSL2 Gateway. Dokumentacja: Windows.

Zwykle jest to niezgodność strony kodowej konsoli w natywnych powłokach Windows.

Objawy:

• wyjście system.run/exec renderuje chiński jako mojibake
• to samo polecenie wygląda poprawnie w innym profilu terminala

Szybkie obejście w PowerShell:

chcp 65001[Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false)[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)$OutputEncoding = [System.Text.UTF8Encoding]::new($false)

Następnie zrestartuj Gateway i ponów polecenie:

openclaw gateway restart

Jeśli nadal możesz odtworzyć ten problem w najnowszym OpenClaw, śledź/zgłoś go tutaj:

• Issue #30640

Użyj instalacji do modyfikacji (git), aby mieć pełne źródła i dokumentację lokalnie, a potem zapytaj swojego bota (albo Claude/Codex) z tego folderu, żeby mógł czytać repozytorium i odpowiedzieć precyzyjnie.

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

Więcej szczegółów: Instalacja i Flagi instalatora.

Krótko: wykonaj przewodnik dla Linux, a potem uruchom onboarding.

• Szybka ścieżka Linux + instalacja usługi: Linux.
• Pełny przewodnik: Pierwsze kroki.
• Instalator + aktualizacje: Instalacja i aktualizacje.

Działa dowolny VPS z Linux. Zainstaluj na serwerze, a potem użyj SSH/Tailscale, aby połączyć się z Gateway.

Przewodniki: exe.dev, Hetzner, Fly.io. Dostęp zdalny: Zdalny Gateway.

Utrzymujemy centrum hostingu z typowymi providerami. Wybierz jeden i postępuj zgodnie z przewodnikiem:

• Hosting VPS (wszyscy providerzy w jednym miejscu)
• Fly.io
• Hetzner
• exe.dev

Jak to działa w chmurze: Gateway działa na serwerze, a Ty uzyskujesz do niego dostęp z laptopa/telefonu przez Control UI (albo Tailscale/SSH). Twój stan i workspace znajdują się na serwerze, więc traktuj host jako źródło prawdy i twórz jego kopie zapasowe.

Możesz sparować węzły (Mac/iOS/Android/headless) z tym Gateway w chmurze, aby uzyskać dostęp do lokalnego ekranu/kamery/canvas albo uruchamiać polecenia na laptopie, trzymając Gateway w chmurze.

Centrum: Platformy. Dostęp zdalny: Zdalny Gateway. Węzły: Nodes, CLI Nodes.

Krótko: możliwe, ale niezalecane. Przepływ aktualizacji może zrestartować Gateway (co zrywa aktywną sesję), może wymagać czystego checkoutu git i może poprosić o potwierdzenie. Bezpieczniej: uruchamiaj aktualizacje z powłoki jako operator.

Użyj CLI:

openclaw updateopenclaw update statusopenclaw update --channel stable|beta|devopenclaw update --tag <dist-tag|version>openclaw update --no-restart

Jeśli musisz automatyzować z agenta:

openclaw update --yes --no-restartopenclaw gateway restart

Dokumentacja: Aktualizacja, Aktualizowanie.

openclaw onboard to zalecana ścieżka konfiguracji. W trybie lokalnym prowadzi Cię przez:

• Konfigurację modelu/auth (OAuth providera, klucze API, Anthropic setup-token oraz opcje modeli lokalnych, takie jak LM Studio)
• Lokalizację workspace + pliki bootstrap
• Ustawienia Gateway (bind/port/auth/tailscale)
• Kanały (WhatsApp, Telegram, Discord, Mattermost, Signal, iMessage oraz dołączone pluginy kanałów, takie jak QQ Bot)
• Instalację daemona (LaunchAgent w macOS; jednostka użytkownika systemd w Linux/WSL2)
• Kontrole zdrowia i wybór Skills

Ustawia też oczekiwania dotyczące czasu trwania przed rozpoczęciem głównych promptów i ostrzega, jeśli skonfigurowany model jest nieznany albo brakuje auth.

Nie. Możesz uruchamiać OpenClaw z kluczami API (Anthropic/OpenAI/inne) albo z modelami tylko lokalnymi, żeby Twoje dane pozostawały na Twoim urządzeniu. Subskrypcje (Claude Pro/Max albo OpenAI Codex) to opcjonalne sposoby uwierzytelniania tych providerów.

Dla Anthropic w OpenClaw praktyczny podział wygląda tak:

• Klucz API Anthropic: normalne rozliczanie Anthropic API
• Claude CLI / auth subskrypcji Claude w OpenClaw: pracownicy Anthropic powiedzieli nam, że to użycie jest ponownie dozwolone, a OpenClaw traktuje użycie claude -p jako zatwierdzone dla tej integracji, chyba że Anthropic opublikuje nową politykę

Dla długotrwałych hostów Gateway klucze API Anthropic nadal są bardziej przewidywalną konfiguracją. OpenAI Codex OAuth jest jawnie obsługiwany dla zewnętrznych narzędzi takich jak OpenClaw.

OpenClaw obsługuje też inne hostowane opcje w stylu subskrypcji, w tym Qwen Cloud Coding Plan, MiniMax Coding Plan i Z.AI / GLM Coding Plan.

Dokumentacja: Anthropic, OpenAI, Qwen Cloud, MiniMax, Z.AI (GLM), Modele lokalne, Modele.

Tak.

Pracownicy Anthropic powiedzieli nam, że użycie Claude CLI w stylu OpenClaw jest ponownie dozwolone, więc OpenClaw traktuje auth subskrypcji Claude i użycie claude -p jako zatwierdzone dla tej integracji, chyba że Anthropic opublikuje nową politykę. Jeśli chcesz najbardziej przewidywalną konfigurację po stronie serwera, zamiast tego użyj klucza API Anthropic.

Tak.

Pracownicy Anthropic powiedzieli nam, że to użycie jest ponownie dozwolone, więc OpenClaw traktuje ponowne użycie Claude CLI i użycie claude -p jako zatwierdzone dla tej integracji chyba że Anthropic opublikuje nową politykę.

Anthropic setup-token jest nadal dostępny jako obsługiwana ścieżka tokena OpenClaw, ale OpenClaw teraz preferuje ponowne użycie Claude CLI i claude -p, gdy są dostępne. Dla obciążeń produkcyjnych albo wieloużytkownikowych auth kluczem API Anthropic nadal jest bezpieczniejszym i bardziej przewidywalnym wyborem. Jeśli chcesz innych hostowanych opcji w stylu subskrypcji w OpenClaw, zobacz OpenAI, Qwen / Model Cloud, MiniMax i Modele GLM.

Oznacza to, że Twój limit przydziału/częstotliwości Anthropic został wyczerpany dla bieżącego okna. Jeśli używasz Claude CLI, poczekaj na zresetowanie okna albo podnieś plan. Jeśli używasz klucza API Anthropic, sprawdź Anthropic Console pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity.

Jeśli komunikat brzmi dokładnie: Extra usage is required for long context requests, żądanie próbuje użyć okna kontekstu 1M Anthropic (modelu Claude 4.x z obsługą GA dla 1M albo starszej konfiguracji context1m: true). Działa to tylko wtedy, gdy Twoje dane uwierzytelniające kwalifikują się do rozliczania długiego kontekstu (rozliczanie kluczem API albo ścieżka logowania Claude w OpenClaw z włączonym Extra Usage).

Wskazówka: ustaw model awaryjny, aby OpenClaw mógł dalej odpowiadać, gdy dostawca ma ograniczoną częstotliwość. Zobacz Modele, OAuth oraz /gateway/troubleshooting#anthropic-429-extra-usage-required-for-long-context.

Tak. OpenClaw ma dołączonego dostawcę Amazon Bedrock (Converse). Gdy obecne są znaczniki środowiskowe AWS, OpenClaw może automatycznie wykryć katalog Bedrock dla strumieniowania/tekstu i scalić go jako niejawnego dostawcę amazon-bedrock; w przeciwnym razie możesz jawnie włączyć plugins.entries.amazon-bedrock.config.discovery.enabled albo dodać ręczny wpis dostawcy. Zobacz Amazon Bedrock i Dostawcy modeli. Jeśli wolisz zarządzany przepływ kluczy, proxy zgodne z OpenAI przed Bedrock nadal jest prawidłową opcją.

OpenClaw obsługuje OpenAI Code (Codex) przez OAuth (logowanie ChatGPT). Użyj openai/gpt-5.5 dla typowej konfiguracji: uwierzytelnianie subskrypcją ChatGPT/Codex oraz natywne wykonywanie przez serwer aplikacji Codex. Starsze odwołania Codex GPT są starszą konfiguracją naprawianą przez openclaw doctor --fix. Bezpośredni dostęp przez klucz API OpenAI pozostaje dostępny dla powierzchni API OpenAI innych niż agenci oraz dla modeli agentów przez uporządkowany profil klucza API openai. Zobacz Dostawcy modeli i Wdrażanie (CLI).

openai to identyfikator dostawcy i profilu uwierzytelniania zarówno dla kluczy API OpenAI, jak i OAuth ChatGPT/Codex. Nadal możesz widzieć starszy prefiks OpenAI Codex w starszej konfiguracji i ostrzeżeniach migracji. Starsze konfiguracje używały go także jako prefiksu modelu:

• openai/gpt-5.5 = uwierzytelnianie subskrypcją ChatGPT/Codex z natywnym środowiskiem wykonawczym Codex dla tur agenta
• starsze odwołanie Codex GPT-5.5 = starsza trasa modelu naprawiana przez openclaw doctor --fix
• openai/gpt-5.5 plus uporządkowany profil klucza API openai = uwierzytelnianie kluczem API dla modelu agenta OpenAI
• starsze identyfikatory profili uwierzytelniania Codex = starszy identyfikator profilu uwierzytelniania migrowany przez openclaw doctor --fix

Jeśli chcesz użyć bezpośredniej ścieżki rozliczeń/limitów OpenAI Platform, ustaw OPENAI_API_KEY. Jeśli chcesz użyć uwierzytelniania subskrypcją ChatGPT/Codex, zaloguj się przez openclaw models auth login --provider openai. Pozostaw odwołanie do modelu jako openai/gpt-5.5; starsze odwołania modeli Codex to starsza konfiguracja, którą openclaw doctor --fix przepisuje.

Codex OAuth używa zarządzanych przez OpenAI okien przydziału zależnych od planu. W praktyce te limity mogą różnić się od doświadczenia w witrynie/aplikacji ChatGPT, nawet gdy oba są powiązane z tym samym kontem.

OpenClaw może pokazać obecnie widoczne okna użycia/przydziału dostawcy w openclaw models status, ale nie tworzy ani nie normalizuje uprawnień z ChatGPT w przeglądarce do bezpośredniego dostępu API. Jeśli chcesz użyć bezpośredniej ścieżki rozliczeń/limitów OpenAI Platform, użyj openai/* z kluczem API.

Tak. OpenClaw w pełni obsługuje OAuth subskrypcji OpenAI Code (Codex). OpenAI jawnie zezwala na użycie OAuth subskrypcji w zewnętrznych narzędziach/przepływach pracy takich jak OpenClaw. Wdrażanie może uruchomić przepływ OAuth za Ciebie.

Zobacz OAuth, Dostawcy modeli i Wdrażanie (CLI).

Gemini CLI używa przepływu uwierzytelniania Plugin, a nie identyfikatora klienta ani sekretu w openclaw.json.

Kroki:

1. Zainstaluj Gemini CLI lokalnie, aby gemini był w PATH
   • Homebrew: brew install gemini-cli
   • npm: npm install -g @google/gemini-cli
2. Włącz Plugin: openclaw plugins enable google
3. Zaloguj się: openclaw models auth login --provider google-gemini-cli --set-default
4. Domyślny model po zalogowaniu: google-gemini-cli/gemini-3-flash-preview
5. Jeśli żądania się nie udają, ustaw GOOGLE_CLOUD_PROJECT albo GOOGLE_CLOUD_PROJECT_ID na hoście Gateway

To przechowuje tokeny OAuth w profilach uwierzytelniania na hoście Gateway. Szczegóły: Dostawcy modeli.

Zwykle nie. OpenClaw potrzebuje dużego kontekstu i silnego bezpieczeństwa; małe karty ucinają dane i powodują wycieki. Jeśli musisz, uruchom lokalnie największą kompilację modelu, jaką możesz (LM Studio), i zobacz /gateway/local-models. Mniejsze/skwantyzowane modele zwiększają ryzyko wstrzyknięcia promptu - zobacz Bezpieczeństwo.

Wybierz punkty końcowe przypięte do regionu. OpenRouter udostępnia opcje hostowane w USA dla MiniMax, Kimi i GLM; wybierz wariant hostowany w USA, aby utrzymać dane w regionie. Nadal możesz wymienić Anthropic/OpenAI obok nich, używając models.mode: "merge", aby modele awaryjne pozostały dostępne przy jednoczesnym respektowaniu wybranego dostawcy regionalnego.

Nie. OpenClaw działa na macOS albo Linux (Windows przez WSL2). Mac mini jest opcjonalny - niektórzy kupują go jako zawsze włączony host, ale mały VPS, serwer domowy albo urządzenie klasy Raspberry Pi też działa.

Maca potrzebujesz tylko do narzędzi wyłącznie dla macOS. W przypadku iMessage użyj iMessage z imsg na dowolnym Macu zalogowanym do Messages. Jeśli Gateway działa na Linux albo gdzie indziej, ustaw channels.imessage.cliPath na wrapper SSH uruchamiający imsg na tym Macu. Jeśli chcesz używać innych narzędzi wyłącznie dla macOS, uruchom Gateway na Macu albo sparuj węzeł macOS.

Dokumentacja: iMessage, Węzły, Tryb zdalny Mac.

Potrzebujesz jakiegoś urządzenia macOS zalogowanego do Messages. Nie musi to być Mac mini - działa dowolny Mac. Użyj iMessage z imsg; Gateway może działać na tym Macu albo może działać gdzie indziej z wrapperem SSH cliPath.

Typowe konfiguracje:

• Uruchom Gateway na Linux/VPS i ustaw channels.imessage.cliPath na wrapper SSH uruchamiający imsg na Macu zalogowanym do Messages.
• Uruchom wszystko na Macu, jeśli chcesz najprostszą konfigurację na jednej maszynie.

Dokumentacja: iMessage, Węzły, Tryb zdalny Mac.

Tak. Mac mini może uruchamiać Gateway, a Twój MacBook Pro może połączyć się jako węzeł (urządzenie towarzyszące). Węzły nie uruchamiają Gateway - zapewniają dodatkowe możliwości, takie jak ekran/kamera/płótno i system.run na tym urządzeniu.

Typowy wzorzec:

• Gateway na Mac mini (zawsze włączony).
• MacBook Pro uruchamia aplikację macOS albo host węzła i paruje się z Gateway.
• Użyj openclaw nodes status / openclaw nodes list, aby go zobaczyć.

Dokumentacja: Węzły, CLI węzłów.

Bun nie jest zalecany. Widzimy błędy środowiska wykonawczego, szczególnie z WhatsApp i Telegram. Używaj Node dla stabilnych Gateway.

Jeśli nadal chcesz eksperymentować z Bun, rób to na nieprodukcyjnym Gateway bez WhatsApp/Telegram.

channels.telegram.allowFrom to identyfikator użytkownika Telegram osoby wysyłającej (liczbowy). To nie jest nazwa użytkownika bota.

Konfiguracja prosi tylko o liczbowe identyfikatory użytkowników. Jeśli masz już starsze wpisy @username w konfiguracji, openclaw doctor --fix może spróbować je rozwiązać.

Bezpieczniej (bez bota zewnętrznego):

• Wyślij DM do swojego bota, następnie uruchom openclaw logs --follow i odczytaj from.id.

Oficjalne Bot API:

• Wyślij DM do swojego bota, następnie wywołaj https://api.telegram.org/bot<bot_token>/getUpdates i odczytaj message.from.id.

Zewnętrzne (mniej prywatne):

• Wyślij DM do @userinfobot albo @getidsbot.

Zobacz /channels/telegram.

Tak, przez routing wielu agentów. Powiąż DM WhatsApp każdego nadawcy (peer kind: "direct", nadawca E.164, np. +15551234567) z innym agentId, aby każda osoba miała własny obszar roboczy i magazyn sesji. Odpowiedzi nadal przychodzą z tego samego konta WhatsApp, a kontrola dostępu DM (channels.whatsapp.dmPolicy / channels.whatsapp.allowFrom) jest globalna dla konta WhatsApp. Zobacz Routing wielu agentów i WhatsApp.

Tak. Użyj routingu wielu agentów: nadaj każdemu agentowi własny model domyślny, a następnie powiąż trasy przychodzące (konto dostawcy albo konkretne peery) z każdym agentem. Przykładowa konfiguracja znajduje się w Routing wielu agentów. Zobacz także Modele i Konfiguracja.

Tak. Homebrew obsługuje Linux (Linuxbrew). Szybka konfiguracja:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profileeval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"brew install <formula>

Jeśli uruchamiasz OpenClaw przez systemd, upewnij się, że PATH usługi zawiera /home/linuxbrew/.linuxbrew/bin (albo Twój prefiks brew), aby narzędzia zainstalowane przez brew były rozwiązywane w powłokach nielogowania. Ostatnie kompilacje dodają także na początek typowe katalogi bin użytkownika w usługach systemd na Linux (na przykład ~/.local/bin, ~/.npm-global/bin, ~/.local/share/pnpm, ~/.bun/bin) i respektują PNPM_HOME, NPM_CONFIG_PREFIX, BUN_INSTALL, VOLTA_HOME, ASDF_DATA_DIR, NVM_DIR oraz FNM_DIR, gdy są ustawione.

• Hakowalna instalacja (git): pełne pobranie źródeł, edytowalne, najlepsze dla kontrybutorów. Uruchamiasz kompilacje lokalnie i możesz poprawiać kod/dokumentację.
• Instalacja npm: globalna instalacja CLI, bez repozytorium, najlepsza do „po prostu uruchom”. Aktualizacje pochodzą z tagów dystrybucyjnych npm.

Dokumentacja: Pierwsze kroki, Aktualizowanie.

Tak. Użyj openclaw update --channel ..., gdy OpenClaw jest już zainstalowany. To nie usuwa Twoich danych - zmienia tylko instalację kodu OpenClaw. Twój stan (~/.openclaw) i obszar roboczy (~/.openclaw/workspace) pozostają nietknięte.

Z npm na git:

openclaw update --channel dev

Z git na npm:

openclaw update --channel stable

Dodaj --dry-run, aby najpierw podejrzeć planowaną zmianę trybu. Aktualizator uruchamia czynności następcze Doctor, odświeża źródła Plugin dla kanału docelowego i restartuje Gateway, chyba że przekażesz --no-restart.

Instalator też może wymusić dowolny z trybów:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method gitcurl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm

Wskazówki dotyczące kopii zapasowych: zobacz Strategia kopii zapasowych.

Krótka odpowiedź: jeśli chcesz niezawodności 24/7, użyj VPS. Jeśli chcesz najmniejszej liczby przeszkód i akceptujesz uśpienie/restarty, uruchom go lokalnie.

Laptop (lokalny Gateway)

• Zalety: brak kosztu serwera, bezpośredni dostęp do plików lokalnych, aktywne okno przeglądarki.
• Wady: uśpienie/zaniki sieci = rozłączenia, aktualizacje/restarty systemu przerywają pracę, musi pozostawać wybudzony.

VPS / chmura

• Zalety: zawsze włączony, stabilna sieć, brak problemów z uśpieniem laptopa, łatwiej utrzymać działanie.
• Wady: często działa bez interfejsu graficznego (używaj zrzutów ekranu), tylko zdalny dostęp do plików, do aktualizacji musisz używać SSH.

Uwaga specyficzna dla OpenClaw: WhatsApp/Telegram/Slack/Mattermost/Discord działają poprawnie z VPS. Jedyny realny kompromis to przeglądarka bez interfejsu graficznego kontra widoczne okno. Zobacz Przeglądarka.

Zalecane domyślne ustawienie: VPS, jeśli wcześniej występowały rozłączenia Gateway. Lokalnie sprawdza się świetnie, gdy aktywnie używasz Maca i chcesz mieć dostęp do plików lokalnych albo automatyzację UI z widoczną przeglądarką.

Nie jest wymagane, ale zalecane ze względu na niezawodność i izolację.

• Dedykowany host (VPS/Mac mini/Raspberry Pi): zawsze włączony, mniej przerw przez uśpienie/restarty, czystsze uprawnienia, łatwiej utrzymać działanie.
• Współdzielony laptop/desktop: całkowicie wystarczający do testów i aktywnego używania, ale spodziewaj się przerw, gdy maszyna zasypia lub się aktualizuje.

Jeśli chcesz połączyć zalety obu podejść, trzymaj Gateway na dedykowanym hoście i sparuj laptopa jako Node dla lokalnych narzędzi ekranu/kamery/wykonywania poleceń. Zobacz Nodes. Wskazówki dotyczące bezpieczeństwa znajdziesz w Bezpieczeństwo.

OpenClaw jest lekki. Dla podstawowego Gateway + jednego kanału czatu:

• Absolutne minimum: 1 vCPU, 1GB RAM, ~500MB dysku.
• Zalecane: 1-2 vCPU, 2GB RAM lub więcej dla zapasu (logi, multimedia, wiele kanałów). Narzędzia Node i automatyzacja przeglądarki mogą zużywać dużo zasobów.

System operacyjny: użyj Ubuntu LTS (lub dowolnego nowoczesnego Debian/Ubuntu). Ścieżka instalacji dla Linuxa jest tam najlepiej przetestowana.

Dokumentacja: Linux, Hosting VPS.

Tak. Traktuj VM tak samo jak VPS: musi być zawsze włączona, osiągalna i mieć wystarczająco dużo RAM dla Gateway oraz wszystkich kanałów, które włączysz.

Podstawowe wskazówki:

• Absolutne minimum: 1 vCPU, 1GB RAM.
• Zalecane: 2GB RAM lub więcej, jeśli uruchamiasz wiele kanałów, automatyzację przeglądarki albo narzędzia multimedialne.
• System operacyjny: Ubuntu LTS lub inny nowoczesny Debian/Ubuntu.

Jeśli używasz Windows, użyj Windows Hub do konfiguracji desktopowej albo WSL2, gdy konkretnie chcesz VM Gateway w stylu Linuxa z szeroką zgodnością narzędzi. Zobacz Windows, Hosting VPS. Jeśli uruchamiasz macOS w VM, zobacz VM macOS.