From e9c2157fc848718e69ef92a26c9ef41520c4537b Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Sun, 19 Apr 2026 09:42:54 +0000 Subject: [PATCH] chore(i18n): refresh pl translations --- docs/pl/help/faq.md | 1916 +++++++++++++++++----------------- docs/pl/install/index.md | 110 +- docs/pl/platforms/windows.md | 98 +- docs/pl/start/setup.md | 118 ++- 4 files changed, 1130 insertions(+), 1112 deletions(-) diff --git a/docs/pl/help/faq.md b/docs/pl/help/faq.md index 8039deffa..b4b2789f3 100644 --- a/docs/pl/help/faq.md +++ b/docs/pl/help/faq.md @@ -1,23 +1,23 @@ --- read_when: - - Odpowiedzi na typowe pytania dotyczące konfiguracji, instalacji, onboardingu lub obsługi środowiska uruchomieniowego - - Wstępna analiza problemów zgłaszanych przez użytkowników przed głębszym debugowaniem + - Odpowiadanie na typowe pytania dotyczące konfiguracji, instalacji, wdrożenia lub działania w czasie wykonywania + - Wstępna ocena problemów zgłaszanych przez użytkowników przed głębszym debugowaniem summary: Często zadawane pytania dotyczące konfiguracji, ustawień i korzystania z OpenClaw title: FAQ x-i18n: - generated_at: "2026-04-12T23:28:34Z" + generated_at: "2026-04-19T09:34:11Z" model: gpt-5.4 provider: openai - source_hash: d2a78d0fea9596625cc2753e6dc8cc42c2379a3a0c91729265eee0261fe53eaa + source_hash: f569fb0412797314a11c41a1bbfa14f5892d2d368544fa67800823a6457000e6 source_path: help/faq.md workflow: 15 --- # FAQ -Szybkie odpowiedzi oraz dokładniejsze wskazówki diagnostyczne dla rzeczywistych konfiguracji (lokalny development, VPS, multi-agent, OAuth/klucze API, failover modeli). Informacje o diagnostyce środowiska uruchomieniowego znajdziesz w [Troubleshooting](/pl/gateway/troubleshooting). Pełne informacje o konfiguracji znajdziesz w [Configuration](/pl/gateway/configuration). +Szybkie odpowiedzi oraz bardziej szczegółowe rozwiązywanie problemów dla rzeczywistych konfiguracji (lokalny development, VPS, środowisko wieloagentowe, klucze OAuth/API, przełączanie awaryjne modeli). Informacje o diagnostyce środowiska uruchomieniowego znajdziesz w [Rozwiązywanie problemów](/pl/gateway/troubleshooting). Pełne informacje referencyjne o konfiguracji znajdziesz w [Konfiguracja](/pl/gateway/configuration). -## Pierwsze 60 sekund, jeśli coś nie działa +## Pierwsze 60 sekund, gdy coś nie działa 1. **Szybki status (pierwsza kontrola)** @@ -33,7 +33,7 @@ Szybkie odpowiedzi oraz dokładniejsze wskazówki diagnostyczne dla rzeczywistyc openclaw status --all ``` - Diagnoza tylko do odczytu z końcówką logów (tokeny zredagowane). + Diagnoza tylko do odczytu z końcówką logu (tokeny zredagowane). 3. **Stan demona + portu** @@ -41,16 +41,16 @@ Szybkie odpowiedzi oraz dokładniejsze wskazówki diagnostyczne dla rzeczywistyc openclaw gateway status ``` - Pokazuje środowisko uruchomieniowe supervisora vs dostępność RPC, docelowy URL sondy oraz której konfiguracji usługa prawdopodobnie użyła. + Pokazuje stan supervisora w środowisku uruchomieniowym względem osiągalności RPC, docelowy adres URL sondy oraz której konfiguracji usługa prawdopodobnie użyła. -4. **Głębokie sondy** +4. **Dogłębne sondy** ```bash openclaw status --deep ``` - Uruchamia aktywną sondę zdrowia Gateway, w tym sondy kanałów, gdy są obsługiwane - (wymaga osiągalnego Gateway). Zobacz [Health](/pl/gateway/health). + Uruchamia aktywną sondę kondycji Gateway, w tym sondy kanałów, gdy są obsługiwane + (wymaga osiągalnego Gateway). Zobacz [Kondycja](/pl/gateway/health). 5. **Podgląd najnowszego logu** @@ -64,15 +64,15 @@ Szybkie odpowiedzi oraz dokładniejsze wskazówki diagnostyczne dla rzeczywistyc tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)" ``` - Logi plikowe są oddzielone od logów usługi; zobacz [Logging](/pl/logging) i [Troubleshooting](/pl/gateway/troubleshooting). + Logi plikowe są oddzielne od logów usługi; zobacz [Rejestrowanie](/pl/logging) i [Rozwiązywanie problemów](/pl/gateway/troubleshooting). -6. **Uruchom doctora (naprawy)** +6. **Uruchom Doctor (naprawy)** ```bash openclaw doctor ``` - Naprawia/migruje konfigurację i stan + uruchamia kontrole zdrowia. Zobacz [Doctor](/pl/gateway/doctor). + Naprawia/migruje konfigurację i stan + uruchamia kontrole kondycji. Zobacz [Doctor](/pl/gateway/doctor). 7. **Migawka Gateway** @@ -81,39 +81,39 @@ Szybkie odpowiedzi oraz dokładniejsze wskazówki diagnostyczne dla rzeczywistyc openclaw health --verbose # pokazuje docelowy URL + ścieżkę konfiguracji przy błędach ``` - Pobiera pełną migawkę z uruchomionego Gateway (tylko WS). Zobacz [Health](/pl/gateway/health). + Prosi uruchomiony Gateway o pełną migawkę (tylko WS). Zobacz [Kondycja](/pl/gateway/health). ## Szybki start i konfiguracja przy pierwszym uruchomieniu - - Użyj lokalnego agenta AI, który potrafi **widzieć twój komputer**. To jest znacznie skuteczniejsze niż pytanie - na Discord, ponieważ większość przypadków typu „utknąłem” to **lokalne problemy z konfiguracją lub środowiskiem**, - których zdalne osoby pomagające nie mogą sprawdzić. + + Użyj lokalnego agenta AI, który potrafi **widzieć Twój komputer**. To jest znacznie skuteczniejsze niż pytanie + na Discordzie, ponieważ większość przypadków „utknąłem/utknęłam” to **lokalne problemy z konfiguracją lub środowiskiem**, + których zdalni pomocnicy nie mogą sprawdzić. - **Claude Code**: [https://www.anthropic.com/claude-code/](https://www.anthropic.com/claude-code/) - **OpenAI Codex**: [https://openai.com/codex/](https://openai.com/codex/) - Te narzędzia potrafią czytać repozytorium, uruchamiać polecenia, sprawdzać logi i pomagać naprawić - konfigurację na poziomie komputera (PATH, usługi, uprawnienia, pliki uwierzytelniania). Daj im **pełne checkout repozytorium** - przez instalację hackowalną (git): + Te narzędzia mogą odczytać repozytorium, uruchamiać polecenia, sprawdzać logi i pomagać naprawić konfigurację + na poziomie komputera (PATH, usługi, uprawnienia, pliki uwierzytelniania). Udostępnij im **pełne checkout źródeł** + przez instalację hackable (git): ```bash curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git ``` - Instaluje to OpenClaw **z checkoutu git**, dzięki czemu agent może czytać kod i dokumentację oraz + To instaluje OpenClaw **z checkoutu git**, dzięki czemu agent może odczytać kod + dokumentację i analizować dokładnie tę wersję, której używasz. Zawsze możesz później wrócić do wersji stabilnej, ponownie uruchamiając instalator bez `--install-method git`. Wskazówka: poproś agenta, aby **zaplanował i nadzorował** naprawę (krok po kroku), a następnie wykonał tylko - niezbędne polecenia. Dzięki temu zmiany pozostają małe i łatwiejsze do sprawdzenia. + niezbędne polecenia. Dzięki temu zmiany są niewielkie i łatwiejsze do audytu. - Jeśli odkryjesz prawdziwy błąd lub poprawkę, zgłoś issue na GitHub albo wyślij PR: + Jeśli odkryjesz prawdziwy błąd lub poprawkę, zgłoś proszę issue na GitHubie albo wyślij PR: [https://github.com/openclaw/openclaw/issues](https://github.com/openclaw/openclaw/issues) [https://github.com/openclaw/openclaw/pulls](https://github.com/openclaw/openclaw/pulls) - Zacznij od tych poleceń (udostępnij ich wyniki, gdy prosisz o pomoc): + Zacznij od tych poleceń (udostępnij wyniki, gdy prosisz o pomoc): ```bash openclaw status @@ -123,51 +123,52 @@ Szybkie odpowiedzi oraz dokładniejsze wskazówki diagnostyczne dla rzeczywistyc Co robią: - - `openclaw status`: szybka migawka zdrowia Gateway/agenta + podstawowej konfiguracji. - - `openclaw models status`: sprawdza uwierzytelnienie dostawcy + dostępność modeli. - - `openclaw doctor`: sprawdza i naprawia typowe problemy z konfiguracją i stanem. + - `openclaw status`: szybka migawka kondycji gateway/agenta + podstawowej konfiguracji. + - `openclaw models status`: sprawdza uwierzytelnianie dostawców + dostępność modeli. + - `openclaw doctor`: weryfikuje i naprawia typowe problemy z konfiguracją/stanem. - Inne przydatne kontrole CLI: `openclaw status --all`, `openclaw logs --follow`, + Inne przydatne kontrole w CLI: `openclaw status --all`, `openclaw logs --follow`, `openclaw gateway status`, `openclaw health --verbose`. - Szybka pętla debugowania: [First 60 seconds if something is broken](#first-60-seconds-if-something-is-broken). - Dokumentacja instalacji: [Install](/pl/install), [Installer flags](/pl/install/installer), [Updating](/pl/install/updating). + Szybka pętla debugowania: [Pierwsze 60 sekund, gdy coś nie działa](#pierwsze-60-sekund-gdy-coś-nie-działa). + Dokumentacja instalacji: [Instalacja](/pl/install), [Flagi instalatora](/pl/install/installer), [Aktualizacja](/pl/install/updating). - - Typowe powody pominięcia Heartbeat: + + Najczęstsze powody pomijania Heartbeat: - - `quiet-hours`: poza skonfigurowanym oknem aktywnych godzin - - `empty-heartbeat-file`: `HEARTBEAT.md` istnieje, ale zawiera tylko pustą strukturę lub same nagłówki - - `no-tasks-due`: tryb zadań `HEARTBEAT.md` jest aktywny, ale żaden z interwałów zadań nie jest jeszcze należny - - `alerts-disabled`: cała widoczność Heartbeat jest wyłączona (`showOk`, `showAlerts` i `useIndicator` są wyłączone) + - `quiet-hours`: poza skonfigurowanym oknem active-hours + - `empty-heartbeat-file`: plik `HEARTBEAT.md` istnieje, ale zawiera tylko pusty/nagłówkowy szablon + - `no-tasks-due`: tryb zadań `HEARTBEAT.md` jest aktywny, ale żaden z interwałów zadań nie jest jeszcze wymagalny + - `alerts-disabled`: cała widoczność heartbeat jest wyłączona (`showOk`, `showAlerts` i `useIndicator` są wyłączone) - W trybie zadań znaczniki czasu należności są przesuwane dopiero po zakończeniu - rzeczywistego uruchomienia Heartbeat. Pominięte uruchomienia nie oznaczają zadań jako ukończonych. + W trybie zadań znaczniki czasu wymagalności są przesuwane dopiero po + zakończeniu rzeczywistego uruchomienia heartbeat. Pominięte uruchomienia + nie oznaczają zadań jako ukończonych. - Dokumentacja: [Heartbeat](/pl/gateway/heartbeat), [Automation & Tasks](/pl/automation). + Dokumentacja: [Heartbeat](/pl/gateway/heartbeat), [Automatyzacja i zadania](/pl/automation). - Repozytorium zaleca uruchamianie ze źródeł i korzystanie z onboardingu: + Repozytorium zaleca uruchamianie ze źródeł i użycie onboardingu: ```bash curl -fsSL https://openclaw.ai/install.sh | bash openclaw onboard --install-daemon ``` - Kreator może również automatycznie zbudować zasoby UI. Po onboardingu zwykle uruchamiasz Gateway na porcie **18789**. + Kreator może także automatycznie zbudować zasoby interfejsu użytkownika. Po onboardingu zwykle uruchamiasz Gateway na porcie **18789**. - Ze źródeł (współtwórcy/dev): + Ze źródeł (współtwórcy/development): ```bash git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install pnpm build - pnpm ui:build # automatycznie instaluje zależności UI przy pierwszym uruchomieniu + pnpm ui:build openclaw onboard ``` @@ -176,93 +177,93 @@ Szybkie odpowiedzi oraz dokładniejsze wskazówki diagnostyczne dla rzeczywistyc - Kreator otwiera przeglądarkę z czystym adresem URL dashboardu (bez tokena) zaraz po onboardingu i wypisuje też link w podsumowaniu. Zachowaj tę kartę otwartą; jeśli nie uruchomiła się automatycznie, skopiuj i wklej wypisany URL na tej samej maszynie. + Kreator otwiera przeglądarkę z czystym (bez tokena) adresem URL dashboardu zaraz po onboardingu i wypisuje też link w podsumowaniu. Zachowaj tę kartę otwartą; jeśli się nie uruchomiła, skopiuj/wklej wypisany adres URL na tym samym komputerze. - - **Localhost (ta sama maszyna):** + + **Localhost (ten sam komputer):** - Otwórz `http://127.0.0.1:18789/`. - - Jeśli pojawi się żądanie uwierzytelnienia wspólnym sekretem, wklej skonfigurowany token lub hasło w ustawieniach Control UI. + - Jeśli poprosi o uwierzytelnianie wspólnym sekretem, wklej skonfigurowany token lub hasło w ustawieniach Control UI. - Źródło tokena: `gateway.auth.token` (lub `OPENCLAW_GATEWAY_TOKEN`). - Źródło hasła: `gateway.auth.password` (lub `OPENCLAW_GATEWAY_PASSWORD`). - Jeśli wspólny sekret nie jest jeszcze skonfigurowany, wygeneruj token poleceniem `openclaw doctor --generate-gateway-token`. **Poza localhost:** - - **Tailscale Serve** (zalecane): pozostaw bind loopback, uruchom `openclaw gateway --tailscale serve`, otwórz `https:///`. Jeśli `gateway.auth.allowTailscale` ma wartość `true`, nagłówki tożsamości spełniają wymagania uwierzytelnienia Control UI/WebSocket (bez wklejania wspólnego sekretu, przy założeniu zaufanego hosta Gateway); interfejsy HTTP API nadal wymagają uwierzytelnienia wspólnym sekretem, chyba że celowo używasz prywatnego wejścia `none` lub uwierzytelnienia HTTP zaufanego proxy. - Błędne równoczesne próby uwierzytelnienia Serve od tego samego klienta są serializowane, zanim ogranicznik nieudanych uwierzytelnień zapisze zdarzenie, więc przy drugiej błędnej próbie może już pojawić się `retry later`. - - **Powiązanie z tailnet**: uruchom `openclaw gateway --bind tailnet --token ""` (lub skonfiguruj uwierzytelnianie hasłem), otwórz `http://:18789/`, a następnie wklej pasujący wspólny sekret w ustawieniach dashboardu. - - **Reverse proxy ze świadomością tożsamości**: pozostaw Gateway za zaufanym proxy niebędącym loopback, skonfiguruj `gateway.auth.mode: "trusted-proxy"`, a następnie otwórz URL proxy. - - **Tunel SSH**: `ssh -N -L 18789:127.0.0.1:18789 user@host`, a następnie otwórz `http://127.0.0.1:18789/`. Uwierzytelnienie wspólnym sekretem nadal obowiązuje przez tunel; jeśli pojawi się monit, wklej skonfigurowany token lub hasło. + - **Tailscale Serve** (zalecane): pozostaw bind loopback, uruchom `openclaw gateway --tailscale serve`, otwórz `https:///`. Jeśli `gateway.auth.allowTailscale` ma wartość `true`, nagłówki tożsamości spełniają wymagania uwierzytelniania Control UI/WebSocket (bez wklejanego wspólnego sekretu, przy założeniu zaufanego hosta gateway); interfejsy API HTTP nadal wymagają uwierzytelniania wspólnym sekretem, chyba że celowo używasz prywatnego ingress `none` lub uwierzytelniania HTTP trusted-proxy. + Nieprawidłowe równoczesne próby uwierzytelniania Serve z tego samego klienta są serializowane, zanim ogranicznik nieudanych uwierzytelnień je zarejestruje, więc druga nieudana próba może już pokazać `retry later`. + - **Bind tailnet**: uruchom `openclaw gateway --bind tailnet --token ""` (lub skonfiguruj uwierzytelnianie hasłem), otwórz `http://:18789/`, a następnie wklej pasujący wspólny sekret w ustawieniach dashboardu. + - **Reverse proxy ze świadomością tożsamości**: pozostaw Gateway za zaufanym proxy innym niż loopback, skonfiguruj `gateway.auth.mode: "trusted-proxy"`, a następnie otwórz URL proxy. + - **Tunel SSH**: `ssh -N -L 18789:127.0.0.1:18789 user@host`, a następnie otwórz `http://127.0.0.1:18789/`. Uwierzytelnianie wspólnym sekretem nadal obowiązuje przez tunel; po wyświetleniu monitu wklej skonfigurowany token lub hasło. - Zobacz [Dashboard](/web/dashboard) i [Web surfaces](/web), aby poznać tryby bind i szczegóły uwierzytelniania. + Szczegółowe informacje o trybach bind i uwierzytelnianiu znajdziesz w [Dashboard](/web/dashboard) i [Powierzchnie webowe](/web). Sterują różnymi warstwami: - - `approvals.exec`: przekazuje prompty zatwierdzania do miejsc docelowych na czacie - - `channels..execApprovals`: sprawia, że dany kanał działa jako natywny klient zatwierdzania dla zatwierdzeń exec + - `approvals.exec`: przekazuje monity o zatwierdzenie do miejsc docelowych czatu + - `channels..execApprovals`: sprawia, że dany kanał działa jako natywny klient zatwierdzeń exec - Polityka exec hosta nadal jest rzeczywistą bramką zatwierdzania. Konfiguracja czatu steruje tylko tym, - gdzie pojawiają się prompty zatwierdzania i jak ludzie mogą na nie odpowiadać. + Zasada exec po stronie hosta nadal jest właściwą bramką zatwierdzania. Konfiguracja czatu kontroluje tylko to, gdzie pojawiają się + monity o zatwierdzenie 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` w tym samym czacie działa przez wspólną ścieżkę. - - Jeśli obsługiwany kanał natywny potrafi bezpiecznie ustalić osoby zatwierdzające, OpenClaw teraz automatycznie włącza natywne zatwierdzenia DM-first, gdy `channels..execApprovals.enabled` jest nieustawione lub ma wartość `"auto"`. - - Gdy dostępne są natywne karty/przyciski zatwierdzania, ta natywna warstwa UI jest ścieżką podstawową; agent powinien dołączyć ręczne polecenie `/approve` tylko wtedy, gdy wynik narzędzia mówi, że zatwierdzanie na czacie jest niedostępne albo ręczne zatwierdzenie jest jedyną ścieżką. - - Używaj `approvals.exec` tylko wtedy, gdy prompty muszą być też przekazywane do innych czatów lub wyraźnie wskazanych pokoi operacyjnych. - - Używaj `channels..execApprovals.target: "channel"` lub `"both"` tylko wtedy, gdy wyraźnie chcesz publikować prompty zatwierdzania z powrotem w pokoju/temacie źródłowym. - - Zatwierdzenia Plugin również są osobne: domyślnie używają `/approve` w tym samym czacie, opcjonalnego przekazywania `approvals.plugin`, a tylko niektóre kanały natywne utrzymują dodatkową natywną obsługę zatwierdzeń Plugin. + - Jeśli czat już obsługuje polecenia i odpowiedzi, `/approve` w tym samym czacie działa przez współdzieloną ścieżkę. + - Jeśli obsługiwany kanał natywny potrafi bezpiecznie wywnioskować osoby zatwierdzające, OpenClaw teraz automatycznie włącza natywne zatwierdzenia DM-first, gdy `channels..execApprovals.enabled` jest nieustawione albo ma wartość `"auto"`. + - Gdy dostępne są natywne karty/przyciski zatwierdzania, ta natywna warstwa UI jest główną ścieżką; agent powinien dołączać 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żywaj `approvals.exec` tylko wtedy, gdy monity muszą być także przekazywane do innych czatów lub jawnych pokojów operacyjnych. + - Używaj `channels..execApprovals.target: "channel"` albo `"both"` tylko wtedy, gdy wyraźnie chcesz, aby monity o zatwierdzenie były publikowane z powrotem do pokoju/tematu, z którego pochodzą. + - Zatwierdzenia Plugin są jeszcze oddzielne: domyślnie używają `/approve` w tym samym czacie, opcjonalnego przekazywania `approvals.plugin`, a tylko niektóre kanały natywne dodatkowo utrzymują natywną obsługę zatwierdzania Plugin. - Krótko: przekazywanie służy do routingu, konfiguracja klienta natywnego do bogatszego UX specyficznego dla kanału. - Zobacz [Exec Approvals](/pl/tools/exec-approvals). + W skrócie: przekazywanie służy do routingu, a konfiguracja klienta natywnego — do bogatszego, specyficznego dla kanału UX. + Zobacz [Zatwierdzenia Exec](/pl/tools/exec-approvals). - Wymagany jest Node **>= 22**. Zalecane jest `pnpm`. Bun **nie jest zalecany** dla Gateway. + Wymagany jest Node **>= 22**. Zalecany jest `pnpm`. Bun **nie jest zalecany** dla Gateway. - - Tak. Gateway jest lekki — dokumentacja podaje **512 MB–1 GB RAM**, **1 rdzeń** i około **500 MB** - miejsca na dysku jako wystarczające do użytku osobistego oraz zaznacza, że **Raspberry Pi 4 może go uruchomić**. + + Tak. Gateway jest lekki — dokumentacja podaje, że do użytku osobistego wystarczy **512 MB–1 GB RAM**, **1 rdzeń** i około **500 MB** + miejsca na dysku, oraz zaznacza, że **Raspberry Pi 4 może go uruchomić**. - Jeśli chcesz większy zapas zasobów (logi, multimedia, inne usługi), **zalecane są 2 GB**, ale - nie jest to twarde minimum. + Jeśli chcesz mieć większy zapas (logi, multimedia, inne usługi), zalecane są **2 GB**, + ale nie jest to sztywne minimum. - Wskazówka: mały Pi/VPS może hostować Gateway, a ty możesz sparować **nodes** na laptopie/telefonie do - lokalnego ekranu/kamery/canvas lub wykonywania poleceń. Zobacz [Nodes](/pl/nodes). + Wskazówka: mały Pi/VPS może hostować Gateway, a Ty możesz sparować **nodes** na laptopie/telefonie do + lokalnego ekranu/kamery/canvas albo wykonywania poleceń. Zobacz [Nodes](/pl/nodes). - - Krótko: działa, ale spodziewaj się pewnych nierówności. + + W skrócie: działa, ale spodziewaj się pewnych niedoskonałości. - - Używaj systemu **64-bitowego** i trzymaj Node >= 22. - - Preferuj **instalację hackowalną (git)**, aby mieć wgląd w logi i szybko aktualizować. - - Zacznij bez kanałów/Skills, a potem dodawaj je jeden po drugim. - - Jeśli trafisz na dziwne problemy binarne, zwykle jest to problem **zgodności ARM**. + - Używaj systemu **64-bitowego** i zachowaj Node >= 22. + - Preferuj **instalację hackable (git)**, aby mieć wgląd w logi i szybko aktualizować. + - Zacznij bez kanałów/Skills, a potem dodawaj je po jednym. + - Jeśli trafisz na dziwne problemy z binariami, zwykle chodzi o **zgodność z ARM**. - Dokumentacja: [Linux](/pl/platforms/linux), [Install](/pl/install). + Dokumentacja: [Linux](/pl/platforms/linux), [Instalacja](/pl/install). - - 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 ten tekst i **brak odpowiedzi**, - a liczba tokenów pozostaje na 0, agent nigdy się nie uruchomił. + + Ten ekran zależy od tego, czy Gateway jest osiągalny i uwierzytelniony. TUI także automatycznie wysyła + „Wake up, my friend!” przy pierwszym wykluciu. Jeśli widzisz tę linię **bez odpowiedzi** + i liczba tokenów pozostaje na 0, agent nigdy się nie uruchomił. - 1. Zrestartuj Gateway: + 1. Uruchom ponownie Gateway: ```bash openclaw gateway restart ``` - 2. Sprawdź status + uwierzytelnienie: + 2. Sprawdź status + uwierzytelnianie: ```bash openclaw status @@ -276,77 +277,77 @@ Szybkie odpowiedzi oraz dokładniejsze wskazówki diagnostyczne dla rzeczywistyc 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 [Remote access](/pl/gateway/remote). + Jeśli Gateway jest zdalny, upewnij się, że tunel/połączenie Tailscale działa oraz że interfejs UI + jest skierowany na właściwy Gateway. Zobacz [Dostęp zdalny](/pl/gateway/remote). - - Tak. Skopiuj **katalog stanu** i **workspace**, a następnie raz uruchom Doctor. Dzięki temu - twój bot pozostanie „dokładnie taki sam” (pamięć, historia sesji, uwierzytelnienie i stan - kanałów), o ile skopiujesz **obie** lokalizacje: + + Tak. Skopiuj **katalog stanu** i **workspace**, a następnie uruchom Doctor jeden raz. To + zachowa 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. + 1. Zainstaluj OpenClaw na nowym komputerze. + 2. Skopiuj `$OPENCLAW_STATE_DIR` (domyślnie: `~/.openclaw`) ze starego komputera. 3. Skopiuj swój workspace (domyślnie: `~/.openclaw/workspace`). 4. Uruchom `openclaw doctor` i zrestartuj usługę Gateway. - To zachowuje konfigurację, profile uwierzytelniania, dane logowania WhatsApp, sesje i pamięć. Jeśli działasz - w trybie zdalnym, pamiętaj, że host Gateway jest właścicielem magazynu sesji i workspace. + 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/wypychasz swój workspace do GitHub, tworzysz kopię zapasową - **pamięci + plików bootstrap**, ale **nie** historii sesji ani uwierzytelnienia. Te znajdują się + **pamięci + plików bootstrap**, ale **nie** historii sesji ani uwierzytelniania. One znajdują się w `~/.openclaw/` (na przykład `~/.openclaw/agents//sessions/`). - Powiązane: [Migrating](/pl/install/migrating), [Where things live on disk](#where-things-live-on-disk), - [Agent workspace](/pl/concepts/agent-workspace), [Doctor](/pl/gateway/doctor), - [Remote mode](/pl/gateway/remote). + Powiązane: [Migracja](/pl/install/migrating), [Gdzie rzeczy znajdują się na dysku](#gdzie-rzeczy-znajdują-się-na-dysku), + [Workspace agenta](/pl/concepts/agent-workspace), [Doctor](/pl/gateway/doctor), + [Tryb zdalny](/pl/gateway/remote). - - Sprawdź changelog na GitHub: + + Sprawdź changelog na GitHubie: [https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md](https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md) - Najnowsze wpisy są na górze. Jeśli górna sekcja jest oznaczona jako **Unreleased**, następna sekcja - z datą to najnowsza wydana wersja. Wpisy są pogrupowane według **Highlights**, **Changes** i + Najnowsze wpisy są na górze. Jeśli najwyższa sekcja jest oznaczona jako **Unreleased**, następna sekcja + z datą to najnowsza opublikowana wersja. Wpisy są pogrupowane według **Highlights**, **Changes** i **Fixes** (plus sekcje dokumentacji/inne, gdy są potrzebne). - Niektóre połączenia Comcast/Xfinity błędnie blokują `docs.openclaw.ai` przez Xfinity - Advanced Security. Wyłącz tę funkcję albo dodaj `docs.openclaw.ai` do listy dozwolonych, a następnie spróbuj ponownie. + Niektóre połączenia Comcast/Xfinity nieprawidłowo blokują `docs.openclaw.ai` przez Xfinity + Advanced Security. Wyłącz tę funkcję lub dodaj `docs.openclaw.ai` do allowlisty, a następnie spróbuj ponownie. Pomóż nam to odblokować, zgłaszając problem tutaj: [https://spa.xfinity.com/check_url_status](https://spa.xfinity.com/check_url_status). - Jeśli nadal nie możesz uzyskać dostępu do strony, dokumentacja jest też dostępna na GitHub: + Jeśli nadal nie możesz połączyć się ze stroną, dokumentacja jest mirrorowana na GitHubie: [https://github.com/openclaw/openclaw/tree/main/docs](https://github.com/openclaw/openclaw/tree/main/docs) - **Stable** i **beta** to **tagi dystybucyjne npm**, a nie oddzielne linie kodu: + **Stable** i **beta** to **npm dist-tags**, a nie oddzielne linie kodu: - `latest` = stable - `beta` = wczesna kompilacja do testów - Zwykle wydanie stable trafia najpierw na **beta**, a potem jawny + Zwykle stabilne wydanie trafia najpierw na **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 stable mogą + w razie potrzeby publikować bezpośrednio do `latest`. Dlatego beta i stable mogą wskazywać na **tę samą wersję** po promocji. Zobacz, co się zmieniło: [https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md](https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md) - Informacje o jednolinijkowych poleceniach instalacji i różnicy między beta a dev znajdziesz w akordeonie poniżej. + Jednolinijkowe polecenia instalacji oraz różnicę między beta i dev znajdziesz w akordeonie poniżej. - **Beta** to tag dystrybucyjny npm `beta` (po promocji może odpowiadać `latest`). - **Dev** to ruchomy HEAD gałęzi `main` (git); po publikacji używa tagu dystrybucyjnego npm `dev`. + **Beta** to npm dist-tag `beta` (po promocji może odpowiadać `latest`). + **Dev** to ruchoma główka `main` (git); po publikacji używa npm dist-tag `dev`. - Jednolinijkowe polecenia (macOS/Linux): + Jednolinijkowce (macOS/Linux): ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta @@ -359,12 +360,12 @@ Szybkie odpowiedzi oraz dokładniejsze wskazówki diagnostyczne dla rzeczywistyc Instalator Windows (PowerShell): [https://openclaw.ai/install.ps1](https://openclaw.ai/install.ps1) - Więcej szczegółów: [Development channels](/pl/install/development-channels) i [Installer flags](/pl/install/installer). + Więcej szczegółów: [Kanały deweloperskie](/pl/install/development-channels) i [Flagi instalatora](/pl/install/installer). - - Masz dwie opcje: + + Dwie opcje: 1. **Kanał dev (checkout git):** @@ -374,15 +375,15 @@ Szybkie odpowiedzi oraz dokładniejsze wskazówki diagnostyczne dla rzeczywistyc To przełącza na gałąź `main` i aktualizuje ze źródeł. - 2. **Instalacja hackowalna (ze strony instalatora):** + 2. **Instalacja hackable (ze strony instalatora):** ```bash curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git ``` - Daje to lokalne repozytorium, które możesz edytować, a następnie aktualizować przez git. + To daje lokalne repozytorium, które możesz edytować, a następnie aktualizować przez git. - Jeśli wolisz ręcznie wykonać czysty klon, użyj: + Jeśli wolisz ręcznie wykonać czysty clone, użyj: ```bash git clone https://github.com/openclaw/openclaw.git @@ -391,36 +392,36 @@ Szybkie odpowiedzi oraz dokładniejsze wskazówki diagnostyczne dla rzeczywistyc pnpm build ``` - Dokumentacja: [Update](/cli/update), [Development channels](/pl/install/development-channels), - [Install](/pl/install). + Dokumentacja: [Aktualizacja](/cli/update), [Kanały deweloperskie](/pl/install/development-channels), + [Instalacja](/pl/install). - + Orientacyjnie: - **Instalacja:** 2–5 minut - **Onboarding:** 5–15 minut w zależności od liczby skonfigurowanych kanałów/modeli - Jeśli proces się zawiesza, skorzystaj z [Installer stuck](#quick-start-and-first-run-setup) - i szybkiej pętli debugowania w [I am stuck](#quick-start-and-first-run-setup). + Jeśli proces się zawiesza, użyj [Instalator utknął](#szybki-start-i-konfiguracja-przy-pierwszym-uruchomieniu) + oraz szybkiej pętli debugowania z [Utknąłem/utknęłam](#szybki-start-i-konfiguracja-przy-pierwszym-uruchomieniu). - - Uruchom instalator ponownie z **szczegółowym wyjściem**: + + Uruchom instalator ponownie z **pełnym wyjściem diagnostycznym**: ```bash curl -fsSL https://openclaw.ai/install.sh | bash -s -- --verbose ``` - Instalacja beta z trybem verbose: + Instalacja beta z pełnym wyjściem: ```bash curl -fsSL https://openclaw.ai/install.sh | bash -s -- --beta --verbose ``` - Dla instalacji hackowalnej (git): + Dla instalacji hackable (git): ```bash curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose @@ -435,42 +436,42 @@ Szybkie odpowiedzi oraz dokładniejsze wskazówki diagnostyczne dla rzeczywistyc Set-PSDebug -Trace 0 ``` - Więcej opcji: [Installer flags](/pl/install/installer). + Więcej opcji: [Flagi instalatora](/pl/install/installer). - + Dwa częste problemy w Windows: - **1) błąd npm spawn git / git not found** + **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 następnie uruchom instalator ponownie. + - Zainstaluj **Git for Windows** i upewnij się, że `git` znajduje się w PATH. + - Zamknij i ponownie otwórz PowerShell, a następnie ponownie uruchom instalator. - **2) openclaw is not recognized po instalacji** + **2) openclaw nie jest rozpoznawany po instalacji** - - Twój globalny folder bin npm nie znajduje się w PATH. + - Twój globalny katalog bin npm nie znajduje się w PATH. - Sprawdź ścieżkę: ```powershell npm config get prefix ``` - - Dodaj ten katalog do użytkownikowego PATH (w Windows nie trzeba dopisywać sufiksu `\bin`; na większości systemów jest to `%AppData%\npm`). - - Zamknij i ponownie otwórz PowerShell po zaktualizowaniu PATH. + - 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`). + - Zamknij i ponownie otwórz PowerShell po aktualizacji PATH. - Jeśli chcesz uzyskać możliwie najpłynniejszą konfigurację w Windows, używaj **WSL2** zamiast natywnego Windows. + Jeśli chcesz uzyskać możliwie najpłynniejszą konfigurację w Windows, użyj **WSL2** zamiast natywnego Windows. Dokumentacja: [Windows](/pl/platforms/windows). - - Zwykle jest to problem niedopasowania strony kodowej konsoli w natywnych powłokach Windows. + + Zwykle jest to niedopasowanie strony kodowej konsoli w natywnych powłokach Windows. Objawy: - - Wyjście `system.run`/`exec` renderuje chiński tekst jako mojibake - - To samo polecenie wygląda poprawnie w innym profilu terminala + - dane wyjściowe `system.run`/`exec` renderują chiński tekst jako mojibake + - to samo polecenie wygląda poprawnie w innym profilu terminala Szybkie obejście w PowerShell: @@ -481,7 +482,7 @@ Szybkie odpowiedzi oraz dokładniejsze wskazówki diagnostyczne dla rzeczywistyc $OutputEncoding = [System.Text.UTF8Encoding]::new($false) ``` - Następnie zrestartuj Gateway i spróbuj ponownie wykonać polecenie: + Następnie zrestartuj Gateway i ponów polecenie: ```powershell openclaw gateway restart @@ -494,59 +495,59 @@ Szybkie odpowiedzi oraz dokładniejsze wskazówki diagnostyczne dla rzeczywistyc - Użyj **instalacji hackowalnej (git)**, aby mieć lokalnie pełne źródła i dokumentację, a potem zapytaj - swojego bota (lub Claude/Codex) _z tego folderu_, aby mógł czytać repozytorium i odpowiedzieć precyzyjnie. + Użyj **instalacji hackable (git)**, aby mieć lokalnie pełne źródła i dokumentację, a następnie zapytaj + swojego bota (lub Claude/Codex) _z tego folderu_, aby mógł odczytać repozytorium i odpowiedzieć precyzyjnie. ```bash curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git ``` - Więcej szczegółów: [Install](/pl/install) i [Installer flags](/pl/install/installer). + Więcej szczegółów: [Instalacja](/pl/install) i [Flagi instalatora](/pl/install/installer). - - Krótka odpowiedź: postępuj zgodnie z przewodnikiem dla Linux, a następnie uruchom onboarding. + + Krótka odpowiedź: postępuj zgodnie z przewodnikiem dla Linuxa, a następnie uruchom onboarding. - - Szybka ścieżka dla Linux + instalacja usługi: [Linux](/pl/platforms/linux). - - Pełny przewodnik: [Getting Started](/pl/start/getting-started). - - Instalator + aktualizacje: [Install & updates](/pl/install/updating). + - Szybka ścieżka dla Linuxa + instalacja usługi: [Linux](/pl/platforms/linux). + - Pełny przewodnik: [Pierwsze kroki](/pl/start/getting-started). + - Instalator + aktualizacje: [Instalacja i aktualizacje](/pl/install/updating). - Dowolny VPS z Linux będzie odpowiedni. Zainstaluj na serwerze, a następnie użyj SSH/Tailscale, aby uzyskać dostęp do Gateway. + Każdy VPS z Linuxem działa. Zainstaluj na serwerze, a następnie użyj SSH/Tailscale, aby uzyskać dostęp do Gateway. Przewodniki: [exe.dev](/pl/install/exe-dev), [Hetzner](/pl/install/hetzner), [Fly.io](/pl/install/fly). - Dostęp zdalny: [Gateway remote](/pl/gateway/remote). + Dostęp zdalny: [Gateway zdalnie](/pl/gateway/remote). - - Mamy **hub hostingowy** z najczęstszymi dostawcami. Wybierz jednego i postępuj zgodnie z przewodnikiem: + + Utrzymujemy **centrum hostingu** z najpopularniejszymi dostawcami. Wybierz jednego i postępuj zgodnie z przewodnikiem: - - [VPS hosting](/pl/vps) (wszyscy dostawcy w jednym miejscu) + - [Hosting VPS](/pl/vps) (wszyscy dostawcy w jednym miejscu) - [Fly.io](/pl/install/fly) - [Hetzner](/pl/install/hetzner) - [exe.dev](/pl/install/exe-dev) - Jak to działa w chmurze: **Gateway działa na serwerze**, a ty uzyskujesz do niego dostęp + Jak to działa w chmurze: **Gateway działa na serwerze**, a Ty uzyskujesz do niego dostęp z laptopa/telefonu przez Control UI (lub Tailscale/SSH). Twój stan + workspace - znajdują się na serwerze, więc traktuj host jako źródło prawdy i twórz jego kopie zapasowe. + znajdują się na serwerze, więc traktuj hosta jako źródło prawdy i twórz jego kopie zapasowe. Możesz sparować **nodes** (Mac/iOS/Android/headless) z tym chmurowym Gateway, aby uzyskać dostęp - do lokalnego ekranu/kamery/canvas lub uruchamiać polecenia na laptopie, zachowując + do lokalnego ekranu/kamery/canvas lub uruchamiać polecenia na laptopie, jednocześnie trzymając Gateway w chmurze. - Hub: [Platforms](/pl/platforms). Dostęp zdalny: [Gateway remote](/pl/gateway/remote). - Nodes: [Nodes](/pl/nodes), [Nodes CLI](/cli/nodes). + Centrum: [Platformy](/pl/platforms). Dostęp zdalny: [Gateway zdalnie](/pl/gateway/remote). + Nodes: [Nodes](/pl/nodes), [CLI Nodes](/cli/nodes). - + Krótka odpowiedź: **to możliwe, ale niezalecane**. Proces aktualizacji może zrestartować - Gateway (co przerywa aktywną sesję), może wymagać czystego checkoutu git i - może poprosić o potwierdzenie. Bezpieczniej: uruchamiać aktualizacje z powłoki jako operator. + Gateway (co kończy aktywną sesję), może wymagać czystego checkoutu git i + może prosić o potwierdzenie. Bezpieczniej: uruchamiaj aktualizacje z powłoki jako operator. Użyj CLI: @@ -565,49 +566,49 @@ Szybkie odpowiedzi oraz dokładniejsze wskazówki diagnostyczne dla rzeczywistyc openclaw gateway restart ``` - Dokumentacja: [Update](/cli/update), [Updating](/pl/install/updating). + Dokumentacja: [Aktualizacja](/cli/update), [Aktualizowanie](/pl/install/updating). - `openclaw onboard` to zalecana ścieżka konfiguracji. W **trybie lokalnym** prowadzi cię przez: + `openclaw onboard` to zalecana ścieżka konfiguracji. W **trybie lokalnym** prowadzi Cię przez: - - **Konfigurację modeli/uwierzytelniania** (OAuth dostawcy, klucze API, setup-token Anthropic oraz opcje modeli lokalnych, takie jak LM Studio) + - **Konfigurację modeli/uwierzytelniania** (OAuth dostawców, klucze API, setup-token Anthropic 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) + - **Kanały** (WhatsApp, Telegram, Discord, Mattermost, Signal, iMessage oraz dołączone Plugin kanałów, takie jak QQ Bot) - **Instalację demona** (LaunchAgent w macOS; jednostka użytkownika systemd w Linux/WSL2) - - **Kontrole zdrowia** i wybór **Skills** + - **Kontrole kondycji** i wybór **Skills** - Ostrzega też, jeśli skonfigurowany model jest nieznany lub brakuje uwierzytelnienia. + Ostrzega także, jeśli skonfigurowany model jest nieznany lub brakuje dla niego uwierzytelniania. Nie. Możesz uruchamiać OpenClaw za pomocą **kluczy API** (Anthropic/OpenAI/inne) albo - **wyłącznie modeli lokalnych**, aby dane pozostawały na twoim urządzeniu. Subskrypcje (Claude - Pro/Max lub OpenAI Codex) to opcjonalne sposoby uwierzytelniania tych dostawców. + z użyciem **wyłącznie modeli lokalnych**, aby Twoje dane pozostawały na urządzeniu. Subskrypcje (Claude + Pro/Max lub OpenAI Codex) są opcjonalnymi sposobami uwierzytelniania tych dostawców. - W przypadku Anthropic w OpenClaw praktyczny podział wygląda tak: + W praktyce dla Anthropic w OpenClaw podział wygląda tak: - - **Klucz API Anthropic**: zwykłe rozliczanie API Anthropic - - **Claude CLI / uwierzytelnianie subskrypcją Claude w OpenClaw**: pracownicy Anthropic - powiedzieli nam, że to użycie jest znowu dozwolone, a OpenClaw traktuje użycie `claude -p` - jako autoryzowane dla tej integracji, chyba że Anthropic opublikuje nową + - **Klucz API Anthropic**: standardowe rozliczanie API Anthropic + - **Uwierzytelnianie Claude CLI / subskrypcją Claude w OpenClaw**: pracownicy Anthropic + poinformowali nas, że ten sposób użycia jest znowu dozwolony, a OpenClaw traktuje użycie `claude -p` + jako usankcjonowane dla tej integracji, chyba że Anthropic opublikuje nową politykę - Dla hostów Gateway działających długoterminowo klucze API Anthropic nadal są bardziej - przewidywalną konfiguracją. OpenAI Codex OAuth jest jawnie obsługiwane dla zewnętrznych + Dla długotrwale działających hostów Gateway klucze API Anthropic nadal są + bardziej przewidywalną konfiguracją. OAuth OpenAI Codex jest jawnie obsługiwany dla zewnętrznych narzędzi takich jak OpenClaw. - OpenClaw obsługuje też inne hostowane opcje w stylu subskrypcyjnym, w tym - **Qwen Cloud Coding Plan**, **MiniMax Coding Plan** oraz + OpenClaw obsługuje także inne hostowane opcje w stylu subskrypcyjnym, w tym + **Qwen Cloud Coding Plan**, **MiniMax Coding Plan** i **Z.AI / GLM Coding Plan**. Dokumentacja: [Anthropic](/pl/providers/anthropic), [OpenAI](/pl/providers/openai), [Qwen Cloud](/pl/providers/qwen), - [MiniMax](/pl/providers/minimax), [GLM Models](/pl/providers/glm), - [Local models](/pl/gateway/local-models), [Models](/pl/concepts/models). + [MiniMax](/pl/providers/minimax), [Modele GLM](/pl/providers/glm), + [Modele lokalne](/pl/gateway/local-models), [Modele](/pl/concepts/models). @@ -615,7 +616,7 @@ Szybkie odpowiedzi oraz dokładniejsze wskazówki diagnostyczne dla rzeczywistyc Tak. Pracownicy Anthropic powiedzieli nam, że użycie Claude CLI w stylu OpenClaw jest znowu dozwolone, więc - OpenClaw traktuje uwierzytelnianie subskrypcją Claude i użycie `claude -p` jako autoryzowane + OpenClaw traktuje uwierzytelnianie subskrypcją Claude oraz użycie `claude -p` jako usankcjonowane dla tej integracji, chyba że Anthropic opublikuje nową politykę. Jeśli chcesz najbardziej przewidywalnej konfiguracji po stronie serwera, użyj zamiast tego klucza API Anthropic. @@ -624,77 +625,77 @@ Szybkie odpowiedzi oraz dokładniejsze wskazówki diagnostyczne dla rzeczywistyc Tak. - Pracownicy Anthropic powiedzieli nam, że to użycie jest znowu dozwolone, więc OpenClaw traktuje - ponowne użycie Claude CLI i użycie `claude -p` jako autoryzowane dla tej integracji, + Pracownicy Anthropic powiedzieli nam, że ten sposób użycia jest znowu dozwolony, więc OpenClaw traktuje + ponowne użycie Claude CLI oraz użycie `claude -p` jako usankcjonowane dla tej integracji, chyba że Anthropic opublikuje nową politykę. - Setup-token Anthropic jest nadal dostępny jako obsługiwana ścieżka tokenu OpenClaw, ale OpenClaw teraz preferuje ponowne użycie Claude CLI i `claude -p`, gdy są dostępne. - Dla środowisk produkcyjnych lub obciążeń wieloużytkownikowych uwierzytelnianie kluczem API Anthropic jest nadal + Setup-token Anthropic nadal jest 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 środowisk produkcyjnych lub wieloużytkownikowych uwierzytelnianie kluczem API Anthropic pozostaje bezpieczniejszym i bardziej przewidywalnym wyborem. Jeśli chcesz innych hostowanych opcji w stylu subskrypcyjnym w OpenClaw, zobacz [OpenAI](/pl/providers/openai), [Qwen / Model - Cloud](/pl/providers/qwen), [MiniMax](/pl/providers/minimax) oraz [GLM - Models](/pl/providers/glm). + Cloud](/pl/providers/qwen), [MiniMax](/pl/providers/minimax) oraz [Modele + GLM](/pl/providers/glm). -To oznacza, że twój **limit/rate limit Anthropic** został wyczerpany w bieżącym oknie. Jeśli -używasz **Claude CLI**, poczekaj na reset okna albo przejdź na wyższy plan. Jeśli -używasz **klucza API Anthropic**, sprawdź Anthropic Console -pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. +To oznacza, że Twój **limit/rate limit Anthropic** został wyczerpany w bieżącym oknie. Jeśli +używasz **Claude CLI**, poczekaj na reset okna albo podnieś plan. Jeśli +używasz **klucza API Anthropic**, sprawdź konsolę Anthropic +pod kątem użycia/rozliczeń i zwiększ limity w razie potrzeby. - Jeśli komunikat brzmi dokładnie: + Jeśli komunikat brzmi konkretnie: `Extra usage is required for long context requests`, żądanie próbuje użyć - bety kontekstu 1M Anthropic (`context1m: true`). To działa tylko wtedy, gdy twoje - poświadczenie kwalifikuje się do rozliczania długiego kontekstu (rozliczanie kluczem API lub + bety kontekstu 1M Anthropic (`context1m: true`). Działa to tylko wtedy, gdy Twoje + poświadczenie kwalifikuje 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 zapasowy**, aby OpenClaw mógł nadal odpowiadać, gdy dostawca jest ograniczany przez rate limit. - Zobacz [Models](/cli/models), [OAuth](/pl/concepts/oauth) oraz + Wskazówka: ustaw **model zapasowy**, aby OpenClaw mógł nadal odpowiadać, gdy dostawca ma rate limit. + Zobacz [Modele](/cli/models), [OAuth](/pl/concepts/oauth) oraz [/gateway/troubleshooting#anthropic-429-extra-usage-required-for-long-context](/pl/gateway/troubleshooting#anthropic-429-extra-usage-required-for-long-context). - Tak. OpenClaw ma dołączonego dostawcę **Amazon Bedrock (Converse)**. Gdy obecne są znaczniki środowiska AWS, OpenClaw może automatycznie wykryć katalog Bedrock dla streamingu/tekstu i scalić go jako niejawnego dostawcę `amazon-bedrock`; w przeciwnym razie możesz jawnie włączyć `plugins.entries.amazon-bedrock.config.discovery.enabled` lub dodać ręczny wpis dostawcy. Zobacz [Amazon Bedrock](/pl/providers/bedrock) i [Model providers](/pl/providers/models). Jeśli wolisz zarządzany przepływ kluczy, proxy zgodne z OpenAI przed Bedrock nadal jest prawidłową opcją. + Tak. OpenClaw ma dołączonego dostawcę **Amazon Bedrock (Converse)**. Przy obecnych znacznikach środowiskowych AWS OpenClaw może automatycznie wykrywać katalog Bedrock dla streamingu/tekstu i scalać 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](/pl/providers/bedrock) i [Dostawcy modeli](/pl/providers/models). 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). Onboarding może uruchomić przepływ OAuth i w odpowiednich przypadkach ustawi domyślny model na `openai-codex/gpt-5.4`. Zobacz [Model providers](/pl/concepts/model-providers) i [Onboarding (CLI)](/pl/start/wizard). + OpenClaw obsługuje **OpenAI Code (Codex)** przez OAuth (logowanie ChatGPT). Onboarding może uruchomić przepływ OAuth i ustawi domyślny model na `openai-codex/gpt-5.4`, gdy będzie to odpowiednie. Zobacz [Dostawcy modeli](/pl/concepts/model-providers) i [Onboarding (CLI)](/pl/start/wizard). - OpenClaw traktuje te dwie ścieżki oddzielnie: + OpenClaw traktuje te dwie ścieżki osobno: - `openai-codex/gpt-5.4` = OAuth ChatGPT/Codex - - `openai/gpt-5.4` = bezpośrednie API OpenAI Platform + - `openai/gpt-5.4` = bezpośrednie API platformy OpenAI W OpenClaw logowanie ChatGPT/Codex jest podłączone do ścieżki `openai-codex/*`, - a nie do bezpośredniej ścieżki `openai/*`. Jeśli chcesz używać bezpośredniej ścieżki API w + a nie do bezpośredniej ścieżki `openai/*`. Jeśli chcesz bezpośredniej ścieżki API w OpenClaw, ustaw `OPENAI_API_KEY` (lub równoważną konfigurację dostawcy OpenAI). - Jeśli chcesz używać logowania ChatGPT/Codex w OpenClaw, użyj `openai-codex/*`. + Jeśli chcesz logowania ChatGPT/Codex w OpenClaw, użyj `openai-codex/*`. - - `openai-codex/*` używa ścieżki OAuth Codex, a jego dostępne okna limitów są - zarządzane przez OpenAI i zależą od planu. W praktyce limity te mogą różnić się od - doświadczenia na stronie/aplikacji ChatGPT, nawet gdy oba są powiązane z tym samym kontem. + + `openai-codex/*` używa ścieżki OAuth Codex, a jej użyteczne okna limitów są + zarządzane przez OpenAI i zależne od planu. W praktyce te limity mogą różnić się od + doświadczenia w witrynie/aplikacji ChatGPT, nawet jeśli oba są powiązane z tym samym kontem. - OpenClaw może pokazać obecnie widoczne okna użycia/limitów dostawcy w + OpenClaw może pokazać aktualnie widoczne okna użycia/limitu dostawcy w `openclaw models status`, ale nie tworzy ani nie normalizuje uprawnień ChatGPT-web - do bezpośredniego dostępu API. Jeśli chcesz używać bezpośredniej ścieżki rozliczeń/limitów OpenAI Platform, + do bezpośredniego dostępu API. Jeśli chcesz bezpośredniej ścieżki rozliczeń/limitów OpenAI Platform, użyj `openai/*` z kluczem API. Tak. OpenClaw w pełni obsługuje **subskrypcyjny OAuth OpenAI Code (Codex)**. - OpenAI jednoznacznie zezwala na użycie subskrypcyjnego OAuth w zewnętrznych narzędziach/przepływach - takich jak OpenClaw. Onboarding może uruchomić ten przepływ OAuth za ciebie. + OpenAI jawnie zezwala na użycie subskrypcyjnego OAuth w zewnętrznych narzędziach/przepływach pracy + takich jak OpenClaw. Onboarding może uruchomić dla Ciebie przepływ OAuth. - Zobacz [OAuth](/pl/concepts/oauth), [Model providers](/pl/concepts/model-providers) i [Onboarding (CLI)](/pl/start/wizard). + Zobacz [OAuth](/pl/concepts/oauth), [Dostawcy modeli](/pl/concepts/model-providers) i [Onboarding (CLI)](/pl/start/wizard). @@ -709,72 +710,72 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. 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 kończą się błędem, ustaw `GOOGLE_CLOUD_PROJECT` lub `GOOGLE_CLOUD_PROJECT_ID` na hoście Gateway + 5. Jeśli żądania się nie powiodą, ustaw `GOOGLE_CLOUD_PROJECT` lub `GOOGLE_CLOUD_PROJECT_ID` na hoście gateway - To zapisuje tokeny OAuth w profilach uwierzytelniania na hoście Gateway. Szczegóły: [Model providers](/pl/concepts/model-providers). + To zapisuje tokeny OAuth w profilach uwierzytelniania na hoście gateway. Szczegóły: [Dostawcy modeli](/pl/concepts/model-providers). - Zwykle nie. OpenClaw potrzebuje dużego kontekstu i silnych zabezpieczeń; małe karty obcinają kontekst i przeciekają. Jeśli musisz, uruchom lokalnie **największy** build modelu, jaki możesz (LM Studio), i zobacz [/gateway/local-models](/pl/gateway/local-models). Mniejsze/kwantyzowane modele zwiększają ryzyko prompt injection — zobacz [Security](/pl/gateway/security). + Zwykle nie. OpenClaw potrzebuje dużego kontekstu + silnych zabezpieczeń; małe karty obcinają i przeciekają. Jeśli musisz, uruchom lokalnie **największą** kompilację modelu, jaką możesz (LM Studio), i zobacz [/gateway/local-models](/pl/gateway/local-models). Mniejsze/kwantyzowane modele zwiększają ryzyko prompt injection — zobacz [Bezpieczeństwo](/pl/gateway/security). - - Wybierz endpointy przypisane 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 wymieniać obok nich Anthropic/OpenAI, używając `models.mode: "merge"`, aby modele zapasowe pozostały dostępne przy jednoczesnym zachowaniu wybranego dostawcy regionalnego. + + Wybierz endpointy 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 wymieniać obok nich Anthropic/OpenAI, używając `models.mode: "merge"`, aby modele zapasowe pozostawały dostępne przy jednoczesnym poszanowaniu wybranego dostawcy regionalnego. - Nie. OpenClaw działa na macOS lub Linux (Windows przez WSL2). Mac mini jest opcjonalny — niektórzy - kupują go jako host działający cały czas, ale mały VPS, serwer domowy lub urządzenie klasy Raspberry Pi też się nada. + Nie. OpenClaw działa na macOS lub Linuxie (Windows przez WSL2). Mac mini jest opcjonalny — niektórzy + kupują go jako host działający cały czas, ale mały VPS, domowy serwer lub urządzenie klasy Raspberry Pi też się sprawdzi. - Potrzebujesz Mac **tylko do narzędzi dostępnych wyłącznie w macOS**. Dla iMessage użyj [BlueBubbles](/pl/channels/bluebubbles) (zalecane) — serwer BlueBubbles działa na dowolnym Mac, a Gateway może działać na Linux lub gdzie indziej. Jeśli chcesz korzystać z innych narzędzi tylko dla macOS, uruchom Gateway na Mac albo sparuj Node macOS. + Mac jest potrzebny tylko dla **narzędzi wyłącznie macOS**. Dla iMessage używaj [BlueBubbles](/pl/channels/bluebubbles) (zalecane) — serwer BlueBubbles działa na dowolnym Macu, a Gateway może działać na Linuxie lub gdzie indziej. Jeśli chcesz innych narzędzi tylko dla macOS, uruchom Gateway na Macu albo sparuj node macOS. - Dokumentacja: [BlueBubbles](/pl/channels/bluebubbles), [Nodes](/pl/nodes), [Mac remote mode](/pl/platforms/mac/remote). + Dokumentacja: [BlueBubbles](/pl/channels/bluebubbles), [Nodes](/pl/nodes), [Tryb zdalny Mac](/pl/platforms/mac/remote). Potrzebujesz **jakiegoś urządzenia macOS** zalogowanego do Wiadomości. To **nie** musi być Mac mini — - wystarczy dowolny Mac. Dla iMessage **użyj [BlueBubbles](/pl/channels/bluebubbles)** (zalecane) — serwer BlueBubbles działa na macOS, a Gateway może działać na Linux lub gdzie indziej. + dowolny Mac wystarczy. Dla iMessage **używaj [BlueBubbles](/pl/channels/bluebubbles)** (zalecane) — serwer BlueBubbles działa na macOS, a Gateway może działać na Linuxie lub gdzie indziej. Typowe konfiguracje: - - Uruchom Gateway na Linux/VPS, a serwer BlueBubbles na dowolnym Mac zalogowanym do Wiadomości. - - Uruchom wszystko na Mac, jeśli chcesz najprostszą konfigurację na jednej maszynie. + - Uruchom Gateway na Linuxie/VPS i serwer BlueBubbles na dowolnym Macu zalogowanym do Wiadomości. + - Uruchom wszystko na Macu, jeśli chcesz najprostszą konfigurację na jednym komputerze. Dokumentacja: [BlueBubbles](/pl/channels/bluebubbles), [Nodes](/pl/nodes), - [Mac remote mode](/pl/platforms/mac/remote). + [Tryb zdalny Mac](/pl/platforms/mac/remote). - - Tak. **Mac mini może uruchamiać Gateway**, a twój MacBook Pro może połączyć się jako - **Node** (urządzenie towarzyszące). Nodes nie uruchamiają Gateway — zapewniają dodatkowe - możliwości, takie jak ekran/kamera/canvas oraz `system.run` na tym urządzeniu. + + Tak. **Mac mini może uruchamiać Gateway**, a Twój MacBook Pro może połączyć się jako + **node** (urządzenie towarzyszące). Nodes nie uruchamiają Gateway — zapewniają dodatkowe + możliwości, takie jak screen/camera/canvas i `system.run` na tym urządzeniu. Typowy wzorzec: - - Gateway na Mac mini (zawsze włączony). - - MacBook Pro uruchamia aplikację macOS albo hosta Node i paruje się z Gateway. + - Gateway na Macu mini (zawsze włączony). + - MacBook Pro uruchamia aplikację macOS albo hosta node i paruje się z Gateway. - Użyj `openclaw nodes status` / `openclaw nodes list`, aby to zobaczyć. - Dokumentacja: [Nodes](/pl/nodes), [Nodes CLI](/cli/nodes). + Dokumentacja: [Nodes](/pl/nodes), [CLI Nodes](/cli/nodes). - Bun **nie jest zalecany**. Widzimy błędy środowiska uruchomieniowego, szczególnie z WhatsApp i Telegram. - Używaj **Node** do stabilnych Gateway. + Bun **nie jest zalecany**. Widzimy błędy środowiska uruchomieniowego, zwłaszcza z WhatsApp i Telegram. + Do stabilnych gateway używaj **Node**. - Jeśli mimo to chcesz eksperymentować z Bun, rób to na nieprodukcyjnym Gateway + Jeśli mimo to chcesz eksperymentować z Bun, rób to na nieprodukcyjnym gateway bez WhatsApp/Telegram. - `channels.telegram.allowFrom` to **Telegram user ID człowieka-nadawcy** (liczbowy). To nie jest nazwa użytkownika bota. + `channels.telegram.allowFrom` to **Telegram user ID nadawcy będącego człowiekiem** (liczbowe). To nie jest nazwa użytkownika bota. - Onboarding akceptuje dane wejściowe `@username` i rozwiązuje je do liczbowego ID, ale autoryzacja OpenClaw używa wyłącznie liczbowych ID. + Onboarding akceptuje dane wejściowe `@username` i rozwiązuje je do numerycznego ID, ale autoryzacja OpenClaw używa wyłącznie numerycznych ID. Bezpieczniej (bez bota zewnętrznego): @@ -784,7 +785,7 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. - Wyślij DM do swojego bota, a następnie wywołaj `https://api.telegram.org/bot/getUpdates` i odczytaj `message.from.id`. - Zewnętrzne rozwiązanie (mniej prywatne): + Zewnętrzne narzędzia (mniej prywatne): - Wyślij DM do `@userinfobot` lub `@getidsbot`. @@ -793,15 +794,15 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. - Tak, przez **ruting multi-agent**. Przypisz DM WhatsApp każdego nadawcy **DM** (peer `kind: "direct"`, E.164 nadawcy, np. `+15551234567`) do innego `agentId`, aby każda osoba miała własny workspace i magazyn sesji. Odpowiedzi nadal będą pochodzić z **tego samego konta WhatsApp**, a kontrola dostępu do DM (`channels.whatsapp.dmPolicy` / `channels.whatsapp.allowFrom`) jest globalna dla całego konta WhatsApp. Zobacz [Multi-Agent Routing](/pl/concepts/multi-agent) i [WhatsApp](/pl/channels/whatsapp). + Tak, przez **routing wieloagentowy**. Przypisz DM WhatsApp każdego nadawcy (**peer** `kind: "direct"`, E.164 nadawcy, np. `+15551234567`) do innego `agentId`, aby każda osoba miała własny workspace i magazyn sesji. Odpowiedzi nadal będą pochodzić z **tego samego konta WhatsApp**, a kontrola dostępu DM (`channels.whatsapp.dmPolicy` / `channels.whatsapp.allowFrom`) jest globalna dla danego konta WhatsApp. Zobacz [Routing wieloagentowy](/pl/concepts/multi-agent) i [WhatsApp](/pl/channels/whatsapp). - - Tak. Użyj rutingu multi-agent: przypisz każdemu agentowi własny model domyślny, a następnie powiąż trasy przychodzące (konto dostawcy lub określonych peerów) z każdym agentem. Przykładowa konfiguracja znajduje się w [Multi-Agent Routing](/pl/concepts/multi-agent). Zobacz też [Models](/pl/concepts/models) i [Configuration](/pl/gateway/configuration). + + Tak. Użyj routingu wieloagentowego: nadaj każdemu agentowi własny model domyślny, a następnie przypisz trasy przychodzące (konto dostawcy lub konkretnych peerów) do każdego agenta. Przykładowa konfiguracja znajduje się w [Routing wieloagentowy](/pl/concepts/multi-agent). Zobacz też [Modele](/pl/concepts/models) i [Konfiguracja](/pl/gateway/configuration). - - Tak. Homebrew obsługuje Linux (Linuxbrew). Szybka konfiguracja: + + Tak. Homebrew obsługuje Linuxa (Linuxbrew). Szybka konfiguracja: ```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" @@ -810,24 +811,24 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. brew install ``` - Jeśli uruchamiasz OpenClaw przez systemd, upewnij się, że PATH usługi zawiera `/home/linuxbrew/.linuxbrew/bin` (lub twój prefiks brew), aby narzędzia zainstalowane przez `brew` były rozpoznawane w powłokach niebędących powłokami logowania. - Nowsze buildy dodają też na początku typowe katalogi bin użytkownika w usługach Linux systemd (na przykład `~/.local/bin`, `~/.npm-global/bin`, `~/.local/share/pnpm`, `~/.bun/bin`) i honorują `PNPM_HOME`, `NPM_CONFIG_PREFIX`, `BUN_INSTALL`, `VOLTA_HOME`, `ASDF_DATA_DIR`, `NVM_DIR` oraz `FNM_DIR`, gdy są ustawione. + Jeśli uruchamiasz OpenClaw przez systemd, upewnij się, że PATH usługi zawiera `/home/linuxbrew/.linuxbrew/bin` (lub Twój prefiks brew), aby narzędzia zainstalowane przez `brew` były rozpoznawane w nieinteraktywnych powłokach. + Najnowsze kompilacje dodają też na początku typowe katalogi bin użytkownika w usługach Linux systemd (na przykład `~/.local/bin`, `~/.npm-global/bin`, `~/.local/share/pnpm`, `~/.bun/bin`) i uwzględniają `PNPM_HOME`, `NPM_CONFIG_PREFIX`, `BUN_INSTALL`, `VOLTA_HOME`, `ASDF_DATA_DIR`, `NVM_DIR` i `FNM_DIR`, gdy są ustawione. - - - **Hackowalna instalacja (git):** pełny checkout źródeł, możliwość edycji, najlepsza dla współtwórców. - Budujesz lokalnie i możesz poprawiać kod/dokumentację. - - **npm install:** globalna instalacja CLI, bez repozytorium, najlepsza do „po prostu uruchom”. - Aktualizacje pochodzą z tagów dystrybucyjnych npm. + + - **Instalacja hackable (git):** pełny checkout źródeł, możliwość edycji, najlepsza dla współtwórców. + Uruchamiasz buildy lokalnie i możesz poprawiać kod/dokumentację. + - **npm install:** globalna instalacja CLI, bez repozytorium, najlepsza, gdy chcesz „po prostu to uruchomić”. + Aktualizacje pochodzą z npm dist-tags. - Dokumentacja: [Getting started](/pl/start/getting-started), [Updating](/pl/install/updating). + Dokumentacja: [Pierwsze kroki](/pl/start/getting-started), [Aktualizowanie](/pl/install/updating). - - Tak. Zainstaluj drugi wariant, a następnie uruchom Doctor, aby usługa Gateway wskazywała na nowy entrypoint. - To **nie usuwa twoich danych** — zmienia tylko instalację kodu OpenClaw. Twój stan + + Tak. Zainstaluj drugi wariant, a następnie uruchom Doctor, aby usługa gateway wskazywała nowy entrypoint. + To **nie usuwa Twoich danych** — zmienia tylko instalację kodu OpenClaw. Twój stan (`~/.openclaw`) i workspace (`~/.openclaw/workspace`) pozostają nienaruszone. Z npm na git: @@ -849,68 +850,68 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. openclaw gateway restart ``` - Doctor wykrywa niedopasowanie entrypointu usługi Gateway i proponuje przepisanie konfiguracji usługi tak, aby odpowiadała bieżącej instalacji (w automatyzacji użyj `--repair`). + Doctor wykrywa niedopasowanie entrypoint usługi gateway i proponuje przepisanie konfiguracji usługi tak, aby odpowiadała bieżącej instalacji (w automatyzacji użyj `--repair`). - Wskazówki dotyczące kopii zapasowych: zobacz [Backup strategy](#where-things-live-on-disk). + Wskazówki dotyczące kopii zapasowych: zobacz [Strategia kopii zapasowych](#gdzie-rzeczy-znajdują-się-na-dysku). Krótka odpowiedź: **jeśli chcesz niezawodności 24/7, użyj VPS**. Jeśli chcesz - najmniejszych utrudnień i nie przeszkadzają ci uśpienia/restarty, uruchamiaj lokalnie. + najmniej tarcia i akceptujesz usypianie/restarty, uruchamiaj lokalnie. **Laptop (lokalny Gateway)** - - **Zalety:** brak kosztów serwera, bezpośredni dostęp do plików lokalnych, widoczne okno przeglądarki. - - **Wady:** uśpienie/utrata sieci = rozłączenia, aktualizacje/restarty systemu operacyjnego przerywają pracę, komputer musi pozostać aktywny. + - **Zalety:** brak kosztów serwera, bezpośredni dostęp do lokalnych plików, widoczne okno przeglądarki na żywo. + - **Wady:** usypianie/zaniki sieci = rozłączenia, aktualizacje/restarty systemu przerywają pracę, komputer musi pozostać wybudzony. **VPS / chmura** - - **Zalety:** działa cały czas, stabilna sieć, brak problemów z uśpieniem laptopa, łatwiej utrzymać działanie. - - **Wady:** często działa bez interfejsu (używaj zrzutów ekranu), tylko zdalny dostęp do plików, do aktualizacji trzeba używać SSH. + - **Zalety:** zawsze włączony, stabilna sieć, brak problemów z usypianiem 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, aktualizacje wymagają SSH. - **Uwaga specyficzna dla OpenClaw:** WhatsApp/Telegram/Slack/Mattermost/Discord działają dobrze na VPS. Jedyny realny kompromis to **przeglądarka bez interfejsu** vs widoczne okno. Zobacz [Browser](/pl/tools/browser). + **Uwaga specyficzna dla OpenClaw:** WhatsApp/Telegram/Slack/Mattermost/Discord działają dobrze z VPS. Jedyny realny kompromis to **przeglądarka bez interfejsu graficznego** kontra widoczne okno. Zobacz [Przeglądarka](/pl/tools/browser). - **Zalecane ustawienie domyślne:** VPS, jeśli wcześniej zdarzały ci się rozłączenia Gateway. Tryb lokalny jest świetny, gdy aktywnie używasz Mac i chcesz mieć dostęp do plików lokalnych lub automatyzację UI z widoczną przeglądarką. + **Zalecana opcja domyślna:** VPS, jeśli wcześniej występowały rozłączenia gateway. Lokalnie jest świetnie, gdy aktywnie używasz Maca i chcesz lokalnego dostępu do plików lub automatyzacji UI z widoczną przeglądarką. - - Nie jest to wymagane, ale **zalecane dla niezawodności i izolacji**. + + Nie jest to wymagane, ale **zalecane ze względu na niezawodność i izolację**. - - **Dedykowany host (VPS/Mac mini/Pi):** działa cały czas, mniej przerw z powodu uśpienia/restartów, 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 przechodzi w stan uśpienia lub się aktualizuje. + - **Dedykowany host (VPS/Mac mini/Pi):** zawsze włączony, mniej przerw z powodu uśpienia/restartów, czystsze uprawnienia, łatwiej utrzymać działanie. + - **Współdzielony laptop/desktop:** całkowicie w porządku do testów i aktywnego użycia, ale spodziewaj się przerw, gdy komputer przechodzi w stan uśpienia lub się aktualizuje. - Jeśli chcesz połączyć zalety obu podejść, utrzymuj Gateway na dedykowanym hoście i sparuj laptop jako **Node** dla lokalnych narzędzi ekranu/kamery/exec. Zobacz [Nodes](/pl/nodes). - Wskazówki dotyczące bezpieczeństwa znajdziesz w [Security](/pl/gateway/security). + Jeśli chcesz mieć to, co najlepsze z obu światów, trzymaj Gateway na dedykowanym hoście i sparuj laptop jako **node** dla lokalnych narzędzi screen/camera/exec. Zobacz [Nodes](/pl/nodes). + Wskazówki dotyczące bezpieczeństwa znajdziesz w [Bezpieczeństwo](/pl/gateway/security). OpenClaw jest lekki. Dla podstawowego Gateway + jednego kanału czatu: - - **Absolutne minimum:** 1 vCPU, 1 GB RAM, około 500 MB dysku. - - **Zalecane:** 1–2 vCPU, 2 GB RAM lub więcej dla zapasu (logi, multimedia, wiele kanałów). Narzędzia Node i automatyzacja przeglądarki mogą wymagać sporo zasobów. + - **Absolutne minimum:** 1 vCPU, 1 GB RAM, ~500 MB miejsca na dysku. + - **Zalecane:** 1–2 vCPU, 2 GB RAM lub więcej dla zapasu (logi, multimedia, wiele kanałów). Narzędzia Node i automatyzacja przeglądarki mogą zużywać sporo zasobów. - System operacyjny: używaj **Ubuntu LTS** (lub dowolnego nowoczesnego Debian/Ubuntu). Ścieżka instalacji Linux jest tam najlepiej przetestowana. + System operacyjny: używaj **Ubuntu LTS** (lub dowolnego nowoczesnego Debian/Ubuntu). Ścieżka instalacji dla Linuxa jest tam najlepiej przetestowana. - Dokumentacja: [Linux](/pl/platforms/linux), [VPS hosting](/pl/vps). + Dokumentacja: [Linux](/pl/platforms/linux), [Hosting VPS](/pl/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 włączonych kanałów. - Podstawowe wytyczne: + Podstawowe wskazówki: - **Absolutne minimum:** 1 vCPU, 1 GB RAM. - **Zalecane:** 2 GB RAM lub więcej, jeśli uruchamiasz wiele kanałów, automatyzację przeglądarki lub narzędzia multimedialne. - **System operacyjny:** Ubuntu LTS lub inny nowoczesny Debian/Ubuntu. - Jeśli używasz Windows, **WSL2 to najłatwiejsza konfiguracja w stylu VM** i oferuje najlepszą - zgodność narzędzi. Zobacz [Windows](/pl/platforms/windows), [VPS hosting](/pl/vps). - Jeśli uruchamiasz macOS w VM, zobacz [macOS VM](/pl/install/macos-vm). + Jeśli używasz Windows, **WSL2 to najłatwiejsza konfiguracja w stylu VM** i ma najlepszą + zgodność narzędzi. Zobacz [Windows](/pl/platforms/windows), [Hosting VPS](/pl/vps). + Jeśli uruchamiasz macOS w VM, zobacz [VM macOS](/pl/install/macos-vm). @@ -919,80 +920,80 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. - OpenClaw to osobisty asystent AI, którego uruchamiasz na własnych urządzeniach. Odpowiada na używanych już przez ciebie powierzchniach komunikacyjnych (WhatsApp, Telegram, Slack, Mattermost, Discord, Google Chat, Signal, iMessage, WebChat oraz dołączone pluginy kanałów, takie jak QQ Bot), a na obsługiwanych platformach może też oferować głos + aktywny Canvas. **Gateway** jest stale działającą płaszczyzną sterowania; asystent jest produktem. + OpenClaw to osobisty asystent AI, którego uruchamiasz na własnych urządzeniach. Odpowiada na używanych już przez Ciebie powierzchniach komunikacyjnych (WhatsApp, Telegram, Slack, Mattermost, Discord, Google Chat, Signal, iMessage, WebChat oraz dołączone Plugin kanałów, takie jak QQ Bot), a na obsługiwanych platformach oferuje także głos + Canvas na żywo. **Gateway** to zawsze aktywna płaszczyzna sterowania; asystent jest produktem. - OpenClaw nie jest „tylko wrapperem do Claude”. To **lokalna w pierwszej kolejności płaszczyzna sterowania**, która pozwala uruchamiać - wydajnego asystenta na **własnym sprzęcie**, dostępnego z aplikacji czatu, których już używasz, - ze stanowymi sesjami, pamięcią i narzędziami — bez oddawania kontroli nad swoimi przepływami pracy hostowanemu + OpenClaw nie jest „po prostu wrapperem dla Claude”. To **lokalna płaszczyzna sterowania local-first**, która pozwala uruchamiać + wydajnego asystenta na **własnym sprzęcie**, dostępnego z aplikacji czatowych, których już używasz, z + trwałymi sesjami, pamięcią i narzędziami — bez oddawania kontroli nad przepływami pracy hostowanemu SaaS. - Najważniejsze elementy: + Najważniejsze zalety: - - **Twoje urządzenia, twoje dane:** uruchamiaj Gateway tam, gdzie chcesz (Mac, Linux, VPS), i przechowuj - workspace + historię sesji lokalnie. - - **Prawdziwe kanały, a nie web sandbox:** WhatsApp/Telegram/Slack/Discord/Signal/iMessage itp., - a do tego głos mobilny i Canvas na obsługiwanych platformach. - - **Niezależność od modelu:** używaj Anthropic, OpenAI, MiniMax, OpenRouter itd. z rutingiem - per agent i failover. - - **Opcja wyłącznie lokalna:** uruchamiaj modele lokalne, aby **wszystkie dane mogły pozostać na twoim urządzeniu**, jeśli chcesz. - - **Ruting multi-agent:** oddzielni agenci dla kanału, konta lub zadania, każdy z własnym + - **Twoje urządzenia, Twoje dane:** uruchamiaj Gateway tam, gdzie chcesz (Mac, Linux, VPS), i trzymaj + lokalnie workspace + historię sesji. + - **Prawdziwe kanały, nie webowy sandbox:** WhatsApp/Telegram/Slack/Discord/Signal/iMessage itd., + plus głos mobilny i Canvas na obsługiwanych platformach. + - **Niezależność od modelu:** używaj Anthropic, OpenAI, MiniMax, OpenRouter itd., z routingiem + i przełączaniem awaryjnym per agent. + - **Opcja wyłącznie lokalna:** uruchamiaj modele lokalne, aby **wszystkie dane mogły pozostać na Twoim urządzeniu**, jeśli chcesz. + - **Routing wieloagentowy:** oddzielni agenci per kanał, konto lub zadanie, każdy z własnym workspace i ustawieniami domyślnymi. - - **Open source i możliwość modyfikacji:** sprawdzaj, rozszerzaj i hostuj samodzielnie bez uzależnienia od dostawcy. + - **Open source i hackable:** sprawdzaj, rozszerzaj i hostuj samodzielnie bez vendor lock-in. - Dokumentacja: [Gateway](/pl/gateway), [Channels](/pl/channels), [Multi-agent](/pl/concepts/multi-agent), - [Memory](/pl/concepts/memory). + Dokumentacja: [Gateway](/pl/gateway), [Kanały](/pl/channels), [Wieloagentowość](/pl/concepts/multi-agent), + [Pamięć](/pl/concepts/memory). - + Dobre pierwsze projekty: - - Zbuduj stronę internetową (WordPress, Shopify albo prostą stronę statyczną). - - Stwórz prototyp aplikacji mobilnej (zarys, ekrany, plan API). - - Zorganizuj pliki i foldery (porządkowanie, nazewnictwo, tagowanie). - - Połącz Gmail i zautomatyzuj podsumowania lub działania następcze. + - Zbudować stronę internetową (WordPress, Shopify lub prostą statyczną stronę). + - Stworzyć prototyp aplikacji mobilnej (zarys, ekrany, plan API). + - Uporządkować pliki i foldery (czyszczenie, nazewnictwo, tagowanie). + - Połączyć Gmail i zautomatyzować podsumowania lub follow-upy. - Potrafi obsługiwać duże zadania, ale działa najlepiej, gdy podzielisz je na etapy i - użyjesz sub-agentów do pracy równoległej. + Potrafi obsługiwać duże zadania, ale najlepiej działa, gdy dzielisz je na etapy i + używasz subagentów do pracy równoległej. Codzienne korzyści zwykle wyglądają tak: - - **Osobiste briefingi:** podsumowania skrzynki odbiorczej, kalendarza i interesujących cię wiadomości. - - **Research i tworzenie szkiców:** szybki research, podsumowania i pierwsze wersje e-maili lub dokumentów. - - **Przypomnienia i działania następcze:** bodźce i checklisty sterowane przez Cron lub Heartbeat. - - **Automatyzacja przeglądarki:** wypełnianie formularzy, zbieranie danych i powtarzalne zadania webowe. - - **Koordynacja między urządzeniami:** wyślij zadanie z telefonu, pozwól Gateway uruchomić je na serwerze i otrzymaj wynik z powrotem na czacie. + - **Osobiste briefingi:** podsumowania skrzynki odbiorczej, kalendarza i interesujących Cię wiadomości. + - **Research i tworzenie szkiców:** szybki research, podsumowania i pierwsze szkice maili lub dokumentów. + - **Przypomnienia i follow-upy:** Cron lub Heartbeat napędzające przypomnienia i checklisty. + - **Automatyzacja przeglądarki:** wypełnianie formularzy, zbieranie danych i powtarzanie zadań webowych. + - **Koordynacja między urządzeniami:** wyślij zadanie z telefonu, pozwól Gateway uruchomić je na serwerze i odbierz wynik z powrotem na czacie. - Tak, w zakresie **researchu, kwalifikacji i tworzenia szkiców**. Może skanować strony, budować shortlisty, - podsumowywać potencjalnych klientów i pisać szkice wiadomości outreachowych lub tekstów reklam. + Tak, w zakresie **researchu, kwalifikacji i przygotowywania szkiców**. Może skanować strony, budować shortlisty, + podsumowywać potencjalnych klientów i pisać szkice wiadomości outreach lub tekstów reklamowych. - W przypadku **outreachu lub uruchamiania reklam** pozostaw człowieka w pętli. Unikaj spamu, przestrzegaj lokalnego prawa i - zasad platform oraz sprawdzaj wszystko przed wysłaniem. Najbezpieczniejszy wzorzec to taki, w którym - OpenClaw przygotowuje szkic, a ty go zatwierdzasz. + W przypadku **outreachu lub uruchamiania kampanii reklamowych** zachowaj człowieka w pętli. Unikaj spamu, przestrzegaj lokalnego prawa i + zasad platform oraz sprawdzaj wszystko przed wysłaniem. Najbezpieczniejszy wzorzec to + pozwolić OpenClaw przygotować szkic, a Ty go zatwierdzasz. - Dokumentacja: [Security](/pl/gateway/security). + Dokumentacja: [Bezpieczeństwo](/pl/gateway/security). OpenClaw to **osobisty asystent** i warstwa koordynacji, a nie zamiennik IDE. Używaj - Claude Code lub Codex dla najszybszej bezpośredniej pętli kodowania w repozytorium. Używaj OpenClaw, gdy + Claude Code lub Codex dla najszybszej bezpośredniej pętli programistycznej w repozytorium. Używaj OpenClaw, gdy chcesz trwałej pamięci, dostępu między urządzeniami i orkiestracji narzędzi. Zalety: - **Trwała pamięć + workspace** między sesjami - **Dostęp wieloplatformowy** (WhatsApp, Telegram, TUI, WebChat) - - **Orkiestracja narzędzi** (przeglądarka, pliki, harmonogramowanie, hooki) - - **Stale działający Gateway** (uruchom na VPS, korzystaj z dowolnego miejsca) + - **Orkiestracja narzędzi** (przeglądarka, pliki, harmonogramy, hooki) + - **Zawsze aktywny Gateway** (uruchamiany na VPS, interakcja z dowolnego miejsca) - **Nodes** dla lokalnej przeglądarki/ekranu/kamery/exec Prezentacja: [https://openclaw.ai/showcase](https://openclaw.ai/showcase) @@ -1004,97 +1005,97 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. - Używaj zarządzanych nadpisań zamiast edytować kopię w repozytorium. Umieść zmiany w `~/.openclaw/skills//SKILL.md` (lub dodaj folder przez `skills.load.extraDirs` w `~/.openclaw/openclaw.json`). Priorytet to `/skills` → `/.agents/skills` → `~/.agents/skills` → `~/.openclaw/skills` → dołączone → `skills.load.extraDirs`, więc zarządzane nadpisania nadal mają pierwszeństwo przed dołączonymi Skills bez dotykania gita. Jeśli Skill ma być zainstalowany globalnie, ale widoczny tylko dla niektórych agentów, trzymaj wspólną kopię w `~/.openclaw/skills` i kontroluj widoczność przez `agents.defaults.skills` oraz `agents.list[].skills`. Tylko zmiany warte upstreamu powinny trafiać do repozytorium i wychodzić jako PR. + Używaj zarządzanych nadpisań zamiast edytować kopię w repozytorium. Umieść zmiany w `~/.openclaw/skills//SKILL.md` (lub dodaj folder przez `skills.load.extraDirs` w `~/.openclaw/openclaw.json`). Priorytet to `/skills` → `/.agents/skills` → `~/.agents/skills` → `~/.openclaw/skills` → dołączone → `skills.load.extraDirs`, więc zarządzane nadpisania nadal mają wyższy priorytet niż dołączone Skills bez dotykania git. Jeśli potrzebujesz Skill zainstalowanego globalnie, ale widocznego tylko dla niektórych agentów, trzymaj współdzieloną kopię w `~/.openclaw/skills` i kontroluj widoczność przez `agents.defaults.skills` oraz `agents.list[].skills`. Tylko zmiany warte wniesienia upstream powinny trafiać do repozytorium i wychodzić jako PR. - - Tak. Dodaj dodatkowe katalogi przez `skills.load.extraDirs` w `~/.openclaw/openclaw.json` (najniższy priorytet). Domyślny priorytet to `/skills` → `/.agents/skills` → `~/.agents/skills` → `~/.openclaw/skills` → dołączone → `skills.load.extraDirs`. `clawhub` instaluje domyślnie do `./skills`, co OpenClaw traktuje jako `/skills` przy następnej sesji. Jeśli Skill ma być widoczny tylko dla określonych agentów, połącz to z `agents.defaults.skills` lub `agents.list[].skills`. + + Tak. Dodaj dodatkowe katalogi przez `skills.load.extraDirs` w `~/.openclaw/openclaw.json` (najniższy priorytet). Domyślny priorytet to `/skills` → `/.agents/skills` → `~/.agents/skills` → `~/.openclaw/skills` → dołączone → `skills.load.extraDirs`. `clawhub` domyślnie instaluje do `./skills`, co OpenClaw traktuje jako `/skills` przy następnej sesji. Jeśli Skill ma być widoczny tylko dla określonych agentów, połącz to z `agents.defaults.skills` lub `agents.list[].skills`. - Obecnie obsługiwane wzorce to: + Dziś obsługiwane wzorce to: - - **Zadania Cron**: odizolowane zadania mogą ustawiać nadpisanie `model` dla każdego zadania. - - **Sub-agenci**: kieruj zadania do oddzielnych agentów z różnymi modelami domyślnymi. + - **Zadania Cron**: izolowane zadania mogą ustawić nadpisanie `model` dla każdego zadania. + - **Subagenci**: kieruj zadania do oddzielnych agentów z różnymi modelami domyślnymi. - **Przełączanie na żądanie**: użyj `/model`, aby w dowolnym momencie przełączyć model bieżącej sesji. - Zobacz [Cron jobs](/pl/automation/cron-jobs), [Multi-Agent Routing](/pl/concepts/multi-agent) i [Slash commands](/pl/tools/slash-commands). + Zobacz [Zadania Cron](/pl/automation/cron-jobs), [Routing wieloagentowy](/pl/concepts/multi-agent) oraz [Polecenia slash](/pl/tools/slash-commands). - Używaj **sub-agentów** do długich lub równoległych zadań. Sub-agenci działają we własnej sesji, + Używaj **subagentów** do długich lub równoległych zadań. Subagenci działają we własnej sesji, zwracają podsumowanie i utrzymują responsywność głównego czatu. - Poproś bota, aby „uruchomił sub-agenta dla tego zadania”, albo użyj `/subagents`. - Użyj `/status` na czacie, aby zobaczyć, co Gateway robi w tej chwili (i czy jest zajęty). + Poproś bota, aby „uruchomił subagenta dla tego zadania” albo użyj `/subagents`. + Użyj `/status` na czacie, aby zobaczyć, co Gateway robi teraz (i czy jest zajęty). - Wskazówka dotycząca tokenów: długie zadania i sub-agenci oba zużywają tokeny. Jeśli koszt ma znaczenie, ustaw - tańszy model dla sub-agentów przez `agents.defaults.subagents.model`. + Wskazówka dotycząca tokenów: długie zadania i subagenci zużywają tokeny. Jeśli koszt ma znaczenie, ustaw + tańszy model dla subagentów przez `agents.defaults.subagents.model`. - Dokumentacja: [Sub-agents](/pl/tools/subagents), [Background Tasks](/pl/automation/tasks). + Dokumentacja: [Subagenci](/pl/tools/subagents), [Zadania w tle](/pl/automation/tasks). - - Używaj powiązań wątków. Możesz powiązać wątek Discord z sub-agentem lub celem sesji, aby kolejne wiadomości w tym wątku pozostawały w tej powiązanej sesji. + + Używaj powiązań wątków. Możesz powiązać wątek Discord z subagentem lub celem sesji, aby kolejne wiadomości w tym wątku pozostawały w tej powiązanej sesji. Podstawowy przepływ: - - Uruchom przez `sessions_spawn` z `thread: true` (i opcjonalnie `mode: "session"` dla trwałych wiadomości następczych). - - Albo ręcznie powiąż przez `/focus `. + - Uruchom przez `sessions_spawn` z `thread: true` (i opcjonalnie `mode: "session"` dla trwałej kontynuacji). + - Albo powiąż ręcznie przez `/focus `. - Użyj `/agents`, aby sprawdzić stan powiązania. - - Użyj `/session idle ` i `/session max-age `, aby sterować automatycznym odwiązaniem. + - Użyj `/session idle ` i `/session max-age `, aby sterować automatycznym odwiązywaniem. - Użyj `/unfocus`, aby odłączyć wątek. Wymagana konfiguracja: - - Globalne wartości domyślne: `session.threadBindings.enabled`, `session.threadBindings.idleHours`, `session.threadBindings.maxAgeHours`. + - Ustawienia domyślne globalne: `session.threadBindings.enabled`, `session.threadBindings.idleHours`, `session.threadBindings.maxAgeHours`. - Nadpisania Discord: `channels.discord.threadBindings.enabled`, `channels.discord.threadBindings.idleHours`, `channels.discord.threadBindings.maxAgeHours`. - - Automatyczne wiązanie przy uruchamianiu: ustaw `channels.discord.threadBindings.spawnSubagentSessions: true`. + - Automatyczne powiązanie przy uruchomieniu: ustaw `channels.discord.threadBindings.spawnSubagentSessions: true`. - Dokumentacja: [Sub-agents](/pl/tools/subagents), [Discord](/pl/channels/discord), [Configuration Reference](/pl/gateway/configuration-reference), [Slash commands](/pl/tools/slash-commands). + Dokumentacja: [Subagenci](/pl/tools/subagents), [Discord](/pl/channels/discord), [Konfiguracja referencyjna](/pl/gateway/configuration-reference), [Polecenia slash](/pl/tools/slash-commands). - - Najpierw sprawdź rozstrzygniętą trasę żądającego: + + Najpierw sprawdź rozwiązaną trasę requestera: - - Dostarczanie ukończenia w trybie completion preferuje każdy powiązany wątek lub trasę rozmowy, jeśli taka istnieje. - - Jeśli źródło ukończenia zawiera tylko kanał, OpenClaw wraca do zapisanej trasy sesji żądającego (`lastChannel` / `lastTo` / `lastAccountId`), dzięki czemu bezpośrednie dostarczenie nadal może się udać. - - Jeśli nie istnieje ani powiązana trasa, ani użyteczna zapisana trasa, bezpośrednie dostarczenie może się nie powieść, a wynik wraca wtedy do kolejkowanego dostarczenia sesji zamiast zostać natychmiast opublikowany na czacie. - - Nieprawidłowe lub nieaktualne cele nadal mogą wymusić powrót do kolejki albo końcową porażkę dostarczenia. - - Jeśli ostatnia widoczna odpowiedź asystenta dziecka to dokładnie cichy token `NO_REPLY` / `no_reply` albo dokładnie `ANNOUNCE_SKIP`, OpenClaw celowo tłumi ogłoszenie zamiast publikować wcześniejszy, nieaktualny postęp. - - Jeśli dziecko przekroczyło limit czasu po samych wywołaniach narzędzi, ogłoszenie może zwinąć to do krótkiego podsumowania częściowego postępu zamiast odtwarzać surowe wyjście narzędzi. + - Dostarczanie completion-mode przez subagenta preferuje każdy powiązany wątek lub trasę rozmowy, jeśli taka istnieje. + - Jeśli źródło ukończenia zawiera tylko kanał, OpenClaw wraca do zapisanej trasy sesji requestera (`lastChannel` / `lastTo` / `lastAccountId`), aby bezpośrednie dostarczenie nadal mogło się powieść. + - Jeśli nie istnieje ani powiązana trasa, ani użyteczna zapisana trasa, bezpośrednie dostarczenie może się nie udać, a wynik wraca wtedy do dostarczenia przez kolejkę sesji zamiast natychmiastowej publikacji na czacie. + - Nieprawidłowe lub nieaktualne cele nadal mogą wymusić powrót do kolejki albo ostateczne niepowodzenie dostarczenia. + - Jeśli ostatnia widoczna odpowiedź asystenta podrzędnego to dokładnie cichy token `NO_REPLY` / `no_reply` albo dokładnie `ANNOUNCE_SKIP`, OpenClaw celowo tłumi ogłoszenie zamiast publikować wcześniejsze, nieaktualne postępy. + - Jeśli podrzędny proces przekroczył limit czasu po samych wywołaniach narzędzi, ogłoszenie może zwinąć to do krótkiego podsumowania częściowych postępów zamiast odtwarzać surowe dane wyjściowe narzędzi. - Debugowanie: + Diagnostyka: ```bash openclaw tasks show ``` - Dokumentacja: [Sub-agents](/pl/tools/subagents), [Background Tasks](/pl/automation/tasks), [Session Tools](/pl/concepts/session-tool). + Dokumentacja: [Sub-agenci](/pl/tools/subagents), [Zadania w tle](/pl/automation/tasks), [Narzędzie sesji](/pl/concepts/session-tool). - Cron działa wewnątrz procesu Gateway. Jeśli Gateway nie działa stale, - zaplanowane zadania nie będą się uruchamiać. + Cron działa wewnątrz procesu Gateway. Jeśli Gateway nie działa nieprzerwanie, + zaplanowane zadania nie będą uruchamiane. Lista kontrolna: - - Potwierdź, że Cron jest włączony (`cron.enabled`) i że `OPENCLAW_SKIP_CRON` nie jest ustawione. - - Sprawdź, czy Gateway działa 24/7 (bez uśpień/restartów). - - Zweryfikuj ustawienia strefy czasowej dla zadania (`--tz` vs strefa czasowa hosta). + - Potwierdź, że Cron jest włączony (`cron.enabled`) i `OPENCLAW_SKIP_CRON` nie jest ustawione. + - Sprawdź, czy Gateway działa 24/7 (bez uśpienia/restartów). + - Zweryfikuj ustawienia strefy czasowej dla zadania (`--tz` względem strefy czasowej hosta). - Debugowanie: + Diagnostyka: ```bash openclaw cron run openclaw cron runs --id --limit 50 ``` - Dokumentacja: [Cron jobs](/pl/automation/cron-jobs), [Automation & Tasks](/pl/automation). + Dokumentacja: [Zadania Cron](/pl/automation/cron-jobs), [Automatyzacja i zadania](/pl/automation). @@ -1102,57 +1103,57 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. Najpierw sprawdź tryb dostarczania: - `--no-deliver` / `delivery.mode: "none"` oznacza, że nie należy oczekiwać żadnej wiadomości zewnętrznej. - - Brakujący lub nieprawidłowy cel ogłoszenia (`channel` / `to`) oznacza, że runner pominął dostarczenie wychodzące. + - Brakujący lub nieprawidłowy cel ogłoszenia (`channel` / `to`) oznacza, że runner pominął dostarczanie wychodzące. - Błędy uwierzytelniania kanału (`unauthorized`, `Forbidden`) oznaczają, że runner próbował dostarczyć wiadomość, ale poświadczenia to zablokowały. - - Cichy wynik izolowany (`NO_REPLY` / `no_reply` bez niczego więcej) jest traktowany jako celowo nienadający się do dostarczenia, więc runner tłumi też awaryjne dostarczenie przez kolejkę. + - Cichy wynik izolowany (`NO_REPLY` / `no_reply` i nic więcej) jest traktowany jako celowo nienadający się do dostarczenia, więc runner tłumi także awaryjne dostarczanie przez kolejkę. - W przypadku izolowanych zadań Cron runner odpowiada za końcowe dostarczenie. Agent powinien - zwrócić zwykłe tekstowe podsumowanie, które runner wyśle. `--no-deliver` zachowuje - ten wynik wewnętrznie; nie pozwala agentowi zamiast tego wysyłać bezpośrednio - przez narzędzie wiadomości. + Dla izolowanych zadań Cron runner odpowiada za końcowe dostarczenie. Od agenta + oczekuje się zwrócenia podsumowania w zwykłym tekście, które runner wyśle. `--no-deliver` zachowuje + ten wynik wewnętrznie; nie pozwala agentowi wysyłać bezpośrednio za pomocą + message tool. - Debugowanie: + Diagnostyka: ```bash openclaw cron runs --id --limit 50 openclaw tasks show ``` - Dokumentacja: [Cron jobs](/pl/automation/cron-jobs), [Background Tasks](/pl/automation/tasks). + Dokumentacja: [Zadania Cron](/pl/automation/cron-jobs), [Zadania w tle](/pl/automation/tasks). - - To zwykle ścieżka przełączania modelu na żywo, a nie zduplikowane harmonogramowanie. + + Zwykle jest to ścieżka aktywnego przełączania modeli, a nie zduplikowane planowanie. - Izolowany Cron może utrwalić przekazanie modelu w czasie działania i wykonać ponowną próbę, gdy aktywne - uruchomienie zgłosi `LiveSessionModelSwitchError`. Ponowna próba zachowuje przełączonego + Izolowany Cron może utrwalić przekazanie modelu w środowisku uruchomieniowym i ponowić próbę, gdy aktywne + uruchomienie rzuci `LiveSessionModelSwitchError`. Ponowienie zachowuje przełączonego dostawcę/model, a jeśli przełączenie zawierało nowe nadpisanie profilu uwierzytelniania, Cron - zapisuje je również przed ponowną próbą. + utrwala je również przed ponowieniem. Powiązane reguły wyboru: - - Najpierw wygrywa nadpisanie modelu hooka Gmail, jeśli ma zastosowanie. - - Następnie `model` dla danego zadania. - - Następnie dowolne zapisane nadpisanie modelu sesji Cron. - - Następnie zwykły wybór modelu agenta/dom yślnego modelu. + - Nadpisanie modelu hooka Gmail wygrywa jako pierwsze, gdy ma zastosowanie. + - Następnie `model` per zadanie. + - Następnie każde zapisane nadpisanie modelu sesji Cron. + - Następnie zwykły wybór modelu agenta/domyslnego. - Pętla ponownych prób jest ograniczona. Po początkowej próbie i 2 ponownych próbach przełączenia - Cron przerywa działanie zamiast zapętlać się bez końca. + Pętla ponowień jest ograniczona. Po próbie początkowej i 2 ponowieniach przełączenia + Cron przerywa zamiast zapętlać się w nieskończoność. - Debugowanie: + Diagnostyka: ```bash openclaw cron runs --id --limit 50 openclaw tasks show ``` - Dokumentacja: [Cron jobs](/pl/automation/cron-jobs), [cron CLI](/cli/cron). + Dokumentacja: [Zadania Cron](/pl/automation/cron-jobs), [CLI cron](/cli/cron). - - Użyj natywnych poleceń `openclaw skills` albo umieść Skills w swoim workspace. UI Skills dla macOS nie jest dostępne na Linux. + + Używaj natywnych poleceń `openclaw skills` albo umieszczaj Skills w swoim workspace. Interfejs Skills UI dla macOS nie jest dostępny na Linuxie. Przeglądaj Skills na [https://clawhub.ai](https://clawhub.ai). ```bash @@ -1167,40 +1168,40 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. ``` Natywne `openclaw skills install` zapisuje do aktywnego katalogu `skills/` - w workspace. Osobne CLI `clawhub` instaluj tylko wtedy, gdy chcesz publikować lub - synchronizować własne Skills. W przypadku instalacji współdzielonych między agentami umieść Skill w - `~/.openclaw/skills` i użyj `agents.defaults.skills` lub + workspace. Oddzielne CLI `clawhub` instaluj tylko wtedy, gdy chcesz publikować lub + synchronizować własne Skills. W przypadku współdzielonych instalacji między agentami umieść Skill w + `~/.openclaw/skills` i użyj `agents.defaults.skills` albo `agents.list[].skills`, jeśli chcesz zawęzić, którzy agenci mogą go widzieć. - - Tak. Użyj harmonogramu Gateway: + + Tak. Użyj schedulera Gateway: - - **Cron jobs** do zadań zaplanowanych lub cyklicznych (utrzymują się po restartach). + - **Zadania Cron** do zadań zaplanowanych lub cyklicznych (trwają po restartach). - **Heartbeat** do okresowych kontroli „głównej sesji”. - - **Zadania izolowane** dla autonomicznych agentów, które publikują podsumowania lub dostarczają je na czaty. + - **Zadania izolowane** dla autonomicznych agentów, które publikują podsumowania lub dostarczają je do czatów. - Dokumentacja: [Cron jobs](/pl/automation/cron-jobs), [Automation & Tasks](/pl/automation), + Dokumentacja: [Zadania Cron](/pl/automation/cron-jobs), [Automatyzacja i zadania](/pl/automation), [Heartbeat](/pl/gateway/heartbeat). - - Nie bezpośrednio. Skills macOS są ograniczane przez `metadata.openclaw.os` oraz wymagane binaria, a Skills pojawiają się w prompcie systemowym tylko wtedy, gdy kwalifikują się na **hoście Gateway**. W Linux Skills tylko dla `darwin` (takie jak `apple-notes`, `apple-reminders`, `things-mac`) nie zostaną załadowane, chyba że nadpiszesz te ograniczenia. + + Nie bezpośrednio. Skills macOS są ograniczane przez `metadata.openclaw.os` oraz wymagane binaria, a Skills pojawiają się w system prompt tylko wtedy, gdy kwalifikują się na **hoście Gateway**. Na Linuxie Skills tylko dla `darwin` (takie jak `apple-notes`, `apple-reminders`, `things-mac`) nie zostaną załadowane, chyba że nadpiszesz te ograniczenia. Masz trzy obsługiwane wzorce: - **Opcja A — uruchom Gateway na Mac (najprostsze).** - Uruchom Gateway tam, gdzie istnieją binaria macOS, a następnie połącz się z Linux w [trybie zdalnym](#gateway-ports-already-running-and-remote-mode) lub przez Tailscale. Skills załadują się normalnie, ponieważ host Gateway działa na macOS. + **Opcja A - uruchom Gateway na Macu (najprostsze).** + Uruchom Gateway tam, gdzie istnieją binaria macOS, a następnie łącz się z Linuxa w [trybie zdalnym](#gateway-ports-already-running-and-remote-mode) lub przez Tailscale. Skills ładują się normalnie, ponieważ host Gateway to macOS. - **Opcja B — użyj Node macOS (bez SSH).** - Uruchom Gateway na Linux, sparuj Node macOS (aplikacja w pasku menu) i ustaw **Node Run Commands** na „Always Ask” lub „Always Allow” na Mac. OpenClaw może traktować Skills tylko dla macOS jako kwalifikujące się, gdy wymagane binaria istnieją na Node. Agent uruchamia te Skills przez narzędzie `nodes`. Jeśli wybierzesz „Always Ask”, zatwierdzenie „Always Allow” w prompcie doda to polecenie do allowlist. + **Opcja B - użyj node macOS (bez SSH).** + Uruchom Gateway na Linuxie, sparuj node macOS (aplikacja paska menu) i ustaw **Node Run Commands** na „Always Ask” lub „Always Allow” na Macu. OpenClaw może traktować Skills tylko dla macOS jako kwalifikujące się, gdy wymagane binaria istnieją na node. Agent uruchamia te Skills przez narzędzie `nodes`. Jeśli wybierzesz „Always Ask”, zatwierdzenie „Always Allow” w monicie doda to polecenie do allowlisty. - **Opcja C — proxowanie binariów macOS przez SSH (zaawansowane).** - Pozostaw Gateway na Linux, ale spraw, by wymagane binaria CLI były rozwiązywane do wrapperów SSH uruchamianych na Mac. Następnie nadpisz Skill, aby zezwalał na Linux i pozostawał kwalifikowalny. + **Opcja C - pośrednicz binaria macOS przez SSH (zaawansowane).** + Trzymaj Gateway na Linuxie, ale spraw, aby wymagane binaria CLI były rozwiązywane do wrapperów SSH uruchamianych na Macu. Następnie nadpisz Skill tak, aby dopuszczał Linux, dzięki czemu pozostanie kwalifikujący się. - 1. Utwórz wrapper SSH dla binarium (przykład: `memo` dla Apple Notes): + 1. Utwórz wrapper SSH dla binarnego pliku (przykład: `memo` dla Apple Notes): ```bash #!/usr/bin/env bash @@ -1209,7 +1210,7 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. ``` 2. Umieść wrapper w `PATH` na hoście Linux (na przykład `~/bin/memo`). - 3. Nadpisz metadane Skill (workspace lub `~/.openclaw/skills`), aby zezwalały na Linux: + 3. Nadpisz metadane Skill (workspace lub `~/.openclaw/skills`), aby dopuścić Linux: ```markdown --- @@ -1219,38 +1220,38 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. --- ``` - 4. Rozpocznij nową sesję, aby odświeżyć migawkę Skills. + 4. Uruchom nową sesję, aby odświeżyć migawkę Skills. - Obecnie nie jest wbudowana. + Obecnie nie jako wbudowaną. Opcje: - - **Własny Skill / Plugin:** najlepszy dla niezawodnego dostępu do API (zarówno Notion, jak i HeyGen mają API). - - **Automatyzacja przeglądarki:** działa bez kodu, ale jest wolniejsza i bardziej krucha. + - **Niestandardowy Skill / Plugin:** najlepsze do niezawodnego dostępu do API (zarówno Notion, jak i HeyGen mają API). + - **Automatyzacja przeglądarki:** działa bez kodu, ale jest wolniejsza i bardziej podatna na błędy. - Jeśli chcesz utrzymywać kontekst dla każdego klienta (przepływy agencyjne), prosty wzorzec jest taki: + Jeśli chcesz utrzymywać kontekst per klient (przepływy pracy agencji), prosty wzorzec to: - Jedna strona Notion na klienta (kontekst + preferencje + aktywna praca). - Poproś agenta, aby pobierał tę stronę na początku sesji. - Jeśli chcesz natywną integrację, otwórz prośbę o funkcję albo zbuduj Skill - korzystający z tych API. + Jeśli chcesz natywnej integracji, otwórz prośbę o funkcję albo zbuduj Skill + dla tych API. - Instalacja Skills: + Instalowanie Skills: ```bash openclaw skills install openclaw skills update --all ``` - Instalacje natywne trafiają do aktywnego katalogu `skills/` w workspace. W przypadku współdzielonych Skills między agentami umieść je w `~/.openclaw/skills//SKILL.md`. Jeśli tylko niektórzy agenci mają widzieć wspólną instalację, skonfiguruj `agents.defaults.skills` lub `agents.list[].skills`. Niektóre Skills oczekują binariów instalowanych przez Homebrew; na Linux oznacza to Linuxbrew (zobacz wpis FAQ o Homebrew na Linux powyżej). Zobacz [Skills](/pl/tools/skills), [Skills config](/pl/tools/skills-config) i [ClawHub](/pl/tools/clawhub). + Natywne instalacje trafiają do aktywnego katalogu `skills/` w workspace. W przypadku współdzielonych Skills między agentami umieść je w `~/.openclaw/skills//SKILL.md`. Jeśli tylko niektórzy agenci mają widzieć współdzieloną instalację, skonfiguruj `agents.defaults.skills` albo `agents.list[].skills`. Niektóre Skills oczekują binariów instalowanych przez Homebrew; na Linuxie oznacza to Linuxbrew (zobacz wpis FAQ o Homebrew na Linuxie powyżej). Zobacz [Skills](/pl/tools/skills), [Konfiguracja Skills](/pl/tools/skills-config) i [ClawHub](/pl/tools/clawhub). - + Użyj wbudowanego profilu przeglądarki `user`, który łączy się przez Chrome DevTools MCP: ```bash @@ -1265,112 +1266,112 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. openclaw browser --browser-profile chrome-live tabs ``` - Ta ścieżka jest lokalna dla hosta. Jeśli Gateway działa gdzie indziej, uruchom hosta Node na maszynie przeglądarki albo użyj zdalnego CDP. + Ta ścieżka jest lokalna dla hosta. Jeśli Gateway działa gdzie indziej, uruchom hosta node na komputerze z przeglądarką albo użyj zdalnego CDP. Obecne ograniczenia `existing-session` / `user`: - - działania są oparte na `ref`, a nie na selektorach CSS - - przesyłanie plików wymaga `ref` / `inputRef` i obecnie obsługuje tylko jeden plik naraz + - działania są oparte na ref, a nie na selektorach CSS + - upload wymaga `ref` / `inputRef` i obecnie obsługuje jeden plik naraz - `responsebody`, eksport PDF, przechwytywanie pobrań i działania wsadowe nadal wymagają zarządzanej przeglądarki albo surowego profilu CDP -## Sandbox i pamięć +## Sandboxing i pamięć - Tak. Zobacz [Sandboxing](/pl/gateway/sandboxing). Informacje o konfiguracji specyficznej dla Docker (pełny Gateway w Docker lub obrazy sandbox) znajdziesz w [Docker](/pl/install/docker). + Tak. Zobacz [Sandboxing](/pl/gateway/sandboxing). Konfigurację specyficzną dla Docker (pełny gateway w Docker albo obrazy sandbox) znajdziesz w [Docker](/pl/install/docker). Domyślny obraz stawia bezpieczeństwo na pierwszym miejscu i działa jako użytkownik `node`, więc nie zawiera pakietów systemowych, Homebrew ani dołączonych przeglądarek. Aby uzyskać pełniejszą konfigurację: - - Utrwal `/home/node` za pomocą `OPENCLAW_HOME_VOLUME`, aby cache przetrwał. - - Wbuduj zależności systemowe do obrazu za pomocą `OPENCLAW_DOCKER_APT_PACKAGES`. + - Utrwal `/home/node` za pomocą `OPENCLAW_HOME_VOLUME`, aby cache przetrwały. + - Wbuduj zależności systemowe w obraz za pomocą `OPENCLAW_DOCKER_APT_PACKAGES`. - Zainstaluj przeglądarki Playwright przez dołączone CLI: `node /app/node_modules/playwright-core/cli.js install chromium` - Ustaw `PLAYWRIGHT_BROWSERS_PATH` i upewnij się, że ta ścieżka jest utrwalana. - Dokumentacja: [Docker](/pl/install/docker), [Browser](/pl/tools/browser). + Dokumentacja: [Docker](/pl/install/docker), [Przeglądarka](/pl/tools/browser). - - Tak — jeśli twój ruch prywatny to **DM**, a ruch publiczny to **grupy**. + + Tak — jeśli Twój ruch prywatny to **DM**, a publiczny to **grupy**. - Użyj `agents.defaults.sandbox.mode: "non-main"`, aby sesje grupowe/kanałowe (klucze inne niż główne) działały w Docker, podczas gdy główna sesja DM pozostaje na hoście. Następnie ogranicz, które narzędzia są dostępne w sesjach sandboxowanych, przez `tools.sandbox.tools`. + Użyj `agents.defaults.sandbox.mode: "non-main"`, aby sesje grupowe/kanałowe (klucze inne niż główne) działały w Docker, podczas gdy główna sesja DM pozostaje na hoście. Następnie ogranicz, jakie narzędzia są dostępne w sesjach sandboxowanych przez `tools.sandbox.tools`. - Przewodnik konfiguracji + przykładowa konfiguracja: [Groups: personal DMs + public groups](/pl/channels/groups#pattern-personal-dms-public-groups-single-agent) + Instrukcja konfiguracji + przykładowa konfiguracja: [Grupy: prywatne DM + publiczne grupy](/pl/channels/groups#pattern-personal-dms-public-groups-single-agent) - Odwołanie do kluczowej konfiguracji: [Gateway configuration](/pl/gateway/configuration-reference#agentsdefaultssandbox) + Referencja kluczowej konfiguracji: [Konfiguracja Gateway](/pl/gateway/configuration-reference#agentsdefaultssandbox) - Ustaw `agents.defaults.sandbox.docker.binds` na `["host:path:mode"]` (np. `"/home/user/src:/src:ro"`). Powiązania globalne i per agent są scalane; powiązania per agent są ignorowane, gdy `scope: "shared"`. Używaj `:ro` dla wszystkiego, co wrażliwe, i pamiętaj, że powiązania omijają granice systemu plików sandboxa. + Ustaw `agents.defaults.sandbox.docker.binds` na `["host:path:mode"]` (np. `"/home/user/src:/src:ro"`). Powiązania globalne + per agent są scalane; powiązania per agent są ignorowane, gdy `scope: "shared"`. Używaj `:ro` dla wszystkiego, co wrażliwe, i pamiętaj, że powiązania omijają granice systemu plików sandboxa. - OpenClaw sprawdza źródła bind zarówno względem ścieżki znormalizowanej, jak i ścieżki kanonicznej rozwiązanej przez najgłębszego istniejącego przodka. Oznacza to, że ucieczki przez symlink w katalogu nadrzędnym nadal kończą się bezpiecznym odrzuceniem nawet wtedy, gdy ostatni segment ścieżki jeszcze nie istnieje, a kontrole dozwolonego katalogu głównego nadal obowiązują po rozwiązaniu symlinków. + OpenClaw weryfikuje źródła bind względem zarówno znormalizowanej ścieżki, jak i ścieżki kanonicznej rozwiązanej przez najgłębszego istniejącego przodka. Oznacza to, że ucieczki przez rodzica będącego symlinkiem nadal kończą się bezpiecznym odrzuceniem nawet wtedy, gdy ostatni segment ścieżki jeszcze nie istnieje, a kontrole dozwolonego katalogu głównego nadal obowiązują po rozwiązaniu symlinków. - Zobacz [Sandboxing](/pl/gateway/sandboxing#custom-bind-mounts) i [Sandbox vs Tool Policy vs Elevated](/pl/gateway/sandbox-vs-tool-policy-vs-elevated#bind-mounts-security-quick-check), aby poznać przykłady i uwagi dotyczące bezpieczeństwa. + Przykłady i uwagi dotyczące bezpieczeństwa znajdziesz w [Sandboxing](/pl/gateway/sandboxing#custom-bind-mounts) oraz [Sandbox vs Tool Policy vs Elevated](/pl/gateway/sandbox-vs-tool-policy-vs-elevated#bind-mounts-security-quick-check). Pamięć OpenClaw to po prostu pliki Markdown w workspace agenta: - - Codzienne notatki w `memory/YYYY-MM-DD.md` + - Dzienne notatki w `memory/YYYY-MM-DD.md` - Kuratorowane notatki długoterminowe w `MEMORY.md` (tylko sesje główne/prywatne) - OpenClaw uruchamia też **ciche opróżnianie pamięci przed Compaction**, aby przypomnieć modelowi - o zapisaniu trwałych notatek przed automatycznym Compaction. Działa to tylko wtedy, gdy workspace - jest zapisywalny (sandboxy tylko do odczytu to pomijają). Zobacz [Memory](/pl/concepts/memory). + OpenClaw uruchamia też **ciche opróżnienie pamięci przed Compaction**, aby przypomnieć modelowi, + żeby zapisywał trwałe notatki przed automatycznym Compaction. Działa to tylko wtedy, gdy workspace + jest zapisywalny (sandboxy tylko do odczytu pomijają ten krok). Zobacz [Pamięć](/pl/concepts/memory). - - Poproś bota, aby **zapisał dany fakt w pamięci**. Notatki długoterminowe powinny trafić do `MEMORY.md`, - a kontekst krótkoterminowy do `memory/YYYY-MM-DD.md`. + + Poproś bota, aby **zapisał fakt do pamięci**. Notatki długoterminowe powinny trafiać do `MEMORY.md`, + a krótkoterminowy kontekst do `memory/YYYY-MM-DD.md`. To nadal obszar, który ulepszamy. Pomaga przypominanie modelowi, aby zapisywał wspomnienia; będzie wiedział, co zrobić. Jeśli nadal zapomina, sprawdź, czy Gateway używa tego samego workspace przy każdym uruchomieniu. - Dokumentacja: [Memory](/pl/concepts/memory), [Agent workspace](/pl/concepts/agent-workspace). + Dokumentacja: [Pamięć](/pl/concepts/memory), [Workspace agenta](/pl/concepts/agent-workspace). - - Pliki pamięci są przechowywane na dysku i pozostają tam, dopóki ich nie usuniesz. Ograniczeniem jest - miejsce na dysku, a nie model. **Kontekst sesji** nadal jest jednak ograniczony przez okno kontekstu modelu, - więc długie rozmowy mogą zostać skompaktowane lub obcięte. Dlatego istnieje - wyszukiwanie w pamięci — przywraca ono do kontekstu tylko odpowiednie fragmenty. + + Pliki pamięci znajdują się na dysku i pozostają tam, dopóki ich nie usuniesz. Ograniczeniem jest + miejsce na dysku, a nie model. **Kontekst sesji** nadal jest ograniczony przez okno kontekstu + modelu, więc długie rozmowy mogą zostać poddane compaction albo obcięte. Dlatego + istnieje wyszukiwanie pamięci — przywraca do kontekstu tylko istotne fragmenty. - Dokumentacja: [Memory](/pl/concepts/memory), [Context](/pl/concepts/context). + Dokumentacja: [Pamięć](/pl/concepts/memory), [Kontekst](/pl/concepts/context). - - Tylko jeśli używasz **embeddingów OpenAI**. OAuth Codex obejmuje chat/completions i - **nie** przyznaje dostępu do embeddingów, więc **logowanie przez Codex (OAuth lub + + Tylko jeśli używasz **embeddingów OpenAI**. OAuth Codex obejmuje czat/completions i + **nie** daje dostępu do embeddingów, więc **logowanie przez Codex (OAuth albo logowanie CLI Codex)** nie pomaga w semantycznym wyszukiwaniu pamięci. Embeddingi OpenAI - nadal wymagają prawdziwego klucza API (`OPENAI_API_KEY` lub `models.providers.openai.apiKey`). + nadal wymagają prawdziwego klucza API (`OPENAI_API_KEY` albo `models.providers.openai.apiKey`). Jeśli nie ustawisz jawnie dostawcy, OpenClaw automatycznie wybiera dostawcę, gdy - może rozwiązać klucz API (profile uwierzytelniania, `models.providers.*.apiKey` lub zmienne środowiskowe). - Preferuje OpenAI, jeśli rozwiąże klucz OpenAI, w przeciwnym razie Gemini, jeśli - rozwiąże klucz Gemini, potem Voyage, a następnie Mistral. Jeśli nie ma dostępnego zdalnego klucza, - wyszukiwanie pamięci pozostaje wyłączone, dopóki go nie skonfigurujesz. Jeśli masz skonfigurowaną i obecną - ścieżkę modelu lokalnego, OpenClaw - preferuje `local`. Ollama jest obsługiwane, gdy jawnie ustawisz + potrafi rozwiązać klucz API (profile uwierzytelniania, `models.providers.*.apiKey` albo zmienne środowiskowe). + Preferuje OpenAI, jeśli można rozwiązać klucz OpenAI, w przeciwnym razie Gemini, jeśli można rozwiązać klucz Gemini, + potem Voyage, potem Mistral. Jeśli żaden zdalny klucz nie jest dostępny, wyszukiwanie pamięci + pozostaje wyłączone do czasu jego skonfigurowania. Jeśli masz skonfigurowaną i obecną ścieżkę + lokalnego modelu, OpenClaw + preferuje `local`. Ollama jest obsługiwana, gdy jawnie ustawisz `memorySearch.provider = "ollama"`. Jeśli wolisz pozostać lokalnie, ustaw `memorySearch.provider = "local"` (i opcjonalnie `memorySearch.fallback = "none"`). Jeśli chcesz embeddingów Gemini, ustaw - `memorySearch.provider = "gemini"` i podaj `GEMINI_API_KEY` (lub - `memorySearch.remote.apiKey`). Obsługujemy modele embeddingów **OpenAI, Gemini, Voyage, Mistral, Ollama lub local** - — szczegóły konfiguracji znajdziesz w [Memory](/pl/concepts/memory). + `memorySearch.provider = "gemini"` i podaj `GEMINI_API_KEY` (albo + `memorySearch.remote.apiKey`). Obsługujemy modele embeddingów **OpenAI, Gemini, Voyage, Mistral, Ollama lub local** — + szczegóły konfiguracji znajdziesz w [Pamięć](/pl/concepts/memory). @@ -1379,17 +1380,17 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. - Nie — **stan OpenClaw jest lokalny**, ale **zewnętrzne usługi nadal widzą to, co im wysyłasz**. + Nie — **stan OpenClaw jest lokalny**, ale **usługi zewnętrzne nadal widzą to, co im wysyłasz**. - - **Domyślnie lokalne:** sesje, pliki pamięci, konfiguracja i workspace znajdują się na hoście Gateway - (`~/.openclaw` + katalog twojego workspace). - - **Zdalne z konieczności:** wiadomości wysyłane do dostawców modeli (Anthropic/OpenAI/itd.) trafiają do - ich API, a platformy czatu (WhatsApp/Telegram/Slack/itd.) przechowują dane wiadomości na swoich + - **Domyślnie lokalnie:** sesje, pliki pamięci, konfiguracja i workspace znajdują się na hoście Gateway + (`~/.openclaw` + katalog Twojego workspace). + - **Zdalnie z konieczności:** wiadomości wysyłane do dostawców modeli (Anthropic/OpenAI/itd.) trafiają do + ich API, a platformy czatowe (WhatsApp/Telegram/Slack/itd.) przechowują dane wiadomości na swoich serwerach. - - **Ty kontrolujesz zakres:** używanie modeli lokalnych utrzymuje prompty na twojej maszynie, ale ruch kanałów - nadal przechodzi przez serwery danego kanału. + - **Ty kontrolujesz zakres:** używanie modeli lokalnych utrzymuje prompty na Twoim komputerze, ale ruch + kanałów nadal przechodzi przez serwery danego kanału. - Powiązane: [Agent workspace](/pl/concepts/agent-workspace), [Memory](/pl/concepts/memory). + Powiązane: [Workspace agenta](/pl/concepts/agent-workspace), [Pamięć](/pl/concepts/memory). @@ -1399,16 +1400,16 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. | Path | Purpose | | --------------------------------------------------------------- | ------------------------------------------------------------------ | | `$OPENCLAW_STATE_DIR/openclaw.json` | Główna konfiguracja (JSON5) | - | `$OPENCLAW_STATE_DIR/credentials/oauth.json` | Starszy import OAuth (kopiowany do profili uwierzytelniania przy pierwszym użyciu) | + | `$OPENCLAW_STATE_DIR/credentials/oauth.json` | Import zgodności ze starszym OAuth (kopiowany do profili uwierzytelniania przy pierwszym użyciu) | | `$OPENCLAW_STATE_DIR/agents//agent/auth-profiles.json` | Profile uwierzytelniania (OAuth, klucze API oraz opcjonalne `keyRef`/`tokenRef`) | - | `$OPENCLAW_STATE_DIR/secrets.json` | Opcjonalny ładunek sekretów opartych na pliku dla dostawców SecretRef typu `file` | - | `$OPENCLAW_STATE_DIR/agents//agent/auth.json` | Starszy plik zgodności (statyczne wpisy `api_key` są czyszczone) | + | `$OPENCLAW_STATE_DIR/secrets.json` | Opcjonalny ładunek sekretów opartych na pliku dla dostawców `file` SecretRef | + | `$OPENCLAW_STATE_DIR/agents//agent/auth.json` | Plik zgodności ze starszym systemem (statyczne wpisy `api_key` są czyszczone) | | `$OPENCLAW_STATE_DIR/credentials/` | Stan dostawców (np. `whatsapp//creds.json`) | | `$OPENCLAW_STATE_DIR/agents/` | Stan per agent (agentDir + sesje) | | `$OPENCLAW_STATE_DIR/agents//sessions/` | Historia rozmów i stan (per agent) | | `$OPENCLAW_STATE_DIR/agents//sessions/sessions.json` | Metadane sesji (per agent) | - Starsza ścieżka dla pojedynczego agenta: `~/.openclaw/agent/*` (migrowana przez `openclaw doctor`). + Starsza ścieżka jednoagentowa: `~/.openclaw/agent/*` (migrowana przez `openclaw doctor`). Twój **workspace** (`AGENTS.md`, pliki pamięci, Skills itd.) jest oddzielny i konfigurowany przez `agents.defaults.workspace` (domyślnie: `~/.openclaw/workspace`). @@ -1417,8 +1418,8 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. Te pliki znajdują się w **workspace agenta**, a nie w `~/.openclaw`. - - **Workspace (per agent)**: `AGENTS.md`, `SOUL.md`, `IDENTITY.md`, `USER.md`, - `MEMORY.md` (lub starszy fallback `memory.md`, gdy `MEMORY.md` nie istnieje), + - **Workspace (per agent):** `AGENTS.md`, `SOUL.md`, `IDENTITY.md`, `USER.md`, + `MEMORY.md` (albo starszy fallback `memory.md`, gdy `MEMORY.md` nie istnieje), `memory/YYYY-MM-DD.md`, opcjonalnie `HEARTBEAT.md`. - **Katalog stanu (`~/.openclaw`)**: konfiguracja, stan kanałów/dostawców, profile uwierzytelniania, sesje, logi oraz współdzielone Skills (`~/.openclaw/skills`). @@ -1431,44 +1432,44 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. } ``` - Jeśli bot „zapomina” po restarcie, sprawdź, czy Gateway używa tego samego - workspace przy każdym uruchomieniu (i pamiętaj: tryb zdalny używa workspace **hosta Gateway**, - a nie twojego lokalnego laptopa). + Jeśli bot „zapomina” po restarcie, upewnij się, że Gateway używa tego samego + workspace przy każdym uruchomieniu (i pamiętaj: tryb zdalny używa **workspace hosta gateway**, + a nie Twojego lokalnego laptopa). - Wskazówka: jeśli chcesz trwałego zachowania lub preferencji, poproś bota, aby **zapisał to w - AGENTS.md lub MEMORY.md**, zamiast polegać na historii czatu. + Wskazówka: jeśli chcesz trwałego zachowania lub preferencji, poproś bota, aby **zapisał je w + AGENTS.md albo MEMORY.md**, zamiast polegać na historii czatu. - Zobacz [Agent workspace](/pl/concepts/agent-workspace) i [Memory](/pl/concepts/memory). + Zobacz [Workspace agenta](/pl/concepts/agent-workspace) i [Pamięć](/pl/concepts/memory). - Umieść swój **workspace agenta** w **prywatnym** repozytorium git i twórz jego kopię zapasową gdzieś - prywatnie (na przykład na prywatnym GitHub). To obejmuje pamięć + pliki AGENTS/SOUL/USER - i pozwala później odtworzyć „umysł” asystenta. + Umieść swój **workspace agenta** w **prywatnym** repozytorium git i twórz kopie zapasowe + w prywatnym miejscu (na przykład w prywatnym GitHub). Dzięki temu zachowasz pamięć + pliki AGENTS/SOUL/USER + i później odtworzysz „umysł” asystenta. **Nie** commituj niczego z `~/.openclaw` (poświadczeń, sesji, tokenów ani zaszyfrowanych ładunków sekretów). - Jeśli potrzebujesz pełnego odtworzenia, utwórz osobno kopię zapasową zarówno workspace, jak i katalogu stanu + Jeśli potrzebujesz pełnego odtworzenia, twórz osobne kopie zapasowe zarówno workspace, jak i katalogu stanu (zobacz pytanie o migrację powyżej). - Dokumentacja: [Agent workspace](/pl/concepts/agent-workspace). + Dokumentacja: [Workspace agenta](/pl/concepts/agent-workspace). - Zobacz osobny przewodnik: [Uninstall](/pl/install/uninstall). + Zobacz osobny przewodnik: [Odinstalowanie](/pl/install/uninstall). - Tak. Workspace to **domyślny cwd** i punkt odniesienia dla pamięci, a nie twardy sandbox. + Tak. Workspace to **domyślny cwd** i kotwica pamięci, a nie twardy sandbox. Ścieżki względne są rozwiązywane wewnątrz workspace, ale ścieżki bezwzględne mogą uzyskiwać dostęp do innych - lokalizacji hosta, chyba że sandboxing jest włączony. Jeśli potrzebujesz izolacji, użyj - [`agents.defaults.sandbox`](/pl/gateway/sandboxing) lub ustawień sandbox per agent. Jeśli - chcesz, aby repozytorium było domyślnym katalogiem roboczym, wskaż `workspace` + lokalizacji hosta, chyba że włączony jest sandboxing. Jeśli potrzebujesz izolacji, użyj + [`agents.defaults.sandbox`](/pl/gateway/sandboxing) albo ustawień sandbox per agent. Jeśli chcesz, aby + repozytorium było domyślnym katalogiem roboczym, ustaw `workspace` tego agenta na katalog główny repozytorium. Repozytorium OpenClaw to tylko kod źródłowy; trzymaj - workspace osobno, chyba że celowo chcesz, aby agent pracował w nim. + workspace osobno, chyba że celowo chcesz, aby agent pracował wewnątrz niego. - Przykład (repozytorium jako domyślny cwd): + Przykład (repo jako domyślny cwd): ```json5 { @@ -1482,8 +1483,8 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. - - Stan sesji należy do **hosta Gateway**. Jeśli działasz w trybie zdalnym, interesujący cię magazyn sesji znajduje się na zdalnej maszynie, a nie na twoim lokalnym laptopie. Zobacz [Session management](/pl/concepts/session). + + Stan sesji należy do **hosta gateway**. Jeśli jesteś w trybie zdalnym, interesujący Cię magazyn sesji jest na maszynie zdalnej, a nie na Twoim lokalnym laptopie. Zobacz [Zarządzanie sesjami](/pl/concepts/session). @@ -1497,15 +1498,15 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. $OPENCLAW_CONFIG_PATH ``` - Jeśli plik nie istnieje, używane są dość bezpieczne ustawienia domyślne (w tym domyślny workspace `~/.openclaw/workspace`). + Jeśli plik nie istnieje, używane są dość bezpieczne wartości domyślne (w tym domyślny workspace `~/.openclaw/workspace`). - - Powiązania inne niż loopback **wymagają prawidłowej ścieżki uwierzytelniania Gateway**. W praktyce oznacza to: + + Powiązania nie-loopback **wymagają prawidłowej ścieżki uwierzytelniania gateway**. W praktyce oznacza to: - - uwierzytelnianie wspólnym sekretem: token lub hasło - - `gateway.auth.mode: "trusted-proxy"` za poprawnie skonfigurowanym, świadomym tożsamości reverse proxy innym niż loopback + - uwierzytelnianie wspólnym sekretem: token albo hasło + - `gateway.auth.mode: "trusted-proxy"` za poprawnie skonfigurowanym reverse proxy ze świadomością tożsamości, działającym poza loopback ```json5 { @@ -1521,31 +1522,31 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. Uwagi: - - `gateway.remote.token` / `.password` same w sobie **nie** włączają lokalnego uwierzytelniania Gateway. - - Lokalne ścieżki wywołań mogą używać `gateway.remote.*` jako fallbacku tylko wtedy, gdy `gateway.auth.*` nie jest ustawione. - - W przypadku uwierzytelniania hasłem ustaw `gateway.auth.mode: "password"` oraz `gateway.auth.password` (lub `OPENCLAW_GATEWAY_PASSWORD`). - - Jeśli `gateway.auth.token` / `gateway.auth.password` jest jawnie skonfigurowane przez SecretRef i nierozwiązane, rozwiązywanie kończy się bezpiecznym odrzuceniem (brak maskującego fallbacku zdalnego). - - Konfiguracje Control UI ze wspólnym sekretem uwierzytelniają się przez `connect.params.auth.token` lub `connect.params.auth.password` (przechowywane w ustawieniach aplikacji/UI). Tryby oparte na tożsamości, takie jak Tailscale Serve lub `trusted-proxy`, używają zamiast tego nagłówków żądania. Unikaj umieszczania wspólnych sekretów w URL. - - Przy `gateway.auth.mode: "trusted-proxy"` reverse proxy loopback na tym samym hoście nadal **nie** spełniają wymagań uwierzytelniania trusted-proxy. Zaufane proxy musi być skonfigurowanym źródłem innym niż loopback. + - `gateway.remote.token` / `.password` same z siebie **nie** włączają lokalnego uwierzytelniania gateway. + - Lokalne ścieżki wywołań mogą używać `gateway.remote.*` jako fallback tylko wtedy, gdy `gateway.auth.*` nie jest ustawione. + - Dla uwierzytelniania hasłem ustaw zamiast tego `gateway.auth.mode: "password"` oraz `gateway.auth.password` (albo `OPENCLAW_GATEWAY_PASSWORD`). + - Jeśli `gateway.auth.token` / `gateway.auth.password` jest jawnie skonfigurowane przez SecretRef i nierozwiązane, rozwiązywanie kończy się bezpiecznym odrzuceniem (brak maskującego zdalnego fallbacku). + - Konfiguracje Control UI ze wspólnym sekretem uwierzytelniają się przez `connect.params.auth.token` albo `connect.params.auth.password` (przechowywane w ustawieniach aplikacji/UI). Tryby przenoszące tożsamość, takie jak Tailscale Serve albo `trusted-proxy`, używają zamiast tego nagłówków żądań. Unikaj umieszczania wspólnych sekretów w URL. + - Przy `gateway.auth.mode: "trusted-proxy"` reverse proxy loopback na tym samym hoście nadal **nie** spełniają wymagań uwierzytelniania trusted-proxy. Zaufane proxy musi być skonfigurowanym źródłem spoza loopback. - OpenClaw domyślnie wymusza uwierzytelnianie Gateway, także dla loopback. W zwykłej ścieżce domyślnej oznacza to uwierzytelnianie tokenem: jeśli nie skonfigurowano jawnie ścieżki uwierzytelniania, uruchamianie Gateway przechodzi do trybu tokenu i automatycznie go generuje, zapisując w `gateway.auth.token`, więc **lokalni klienci WS muszą się uwierzytelniać**. To blokuje innym lokalnym procesom wywoływanie Gateway. + OpenClaw domyślnie wymusza uwierzytelnianie gateway, również dla loopback. W normalnej domyślnej ścieżce oznacza to uwierzytelnianie tokenem: jeśli nie skonfigurowano jawnej ścieżki uwierzytelniania, uruchomienie gateway przechodzi w tryb tokena i automatycznie go generuje, zapisując go w `gateway.auth.token`, więc **lokalni klienci WS muszą się uwierzytelnić**. To blokuje innym lokalnym procesom możliwość wywoływania Gateway. - Jeśli wolisz inną ścieżkę uwierzytelniania, możesz jawnie wybrać tryb hasła (lub, dla reverse proxy świadomych tożsamości innych niż loopback, `trusted-proxy`). Jeśli **naprawdę** chcesz otwarty loopback, ustaw jawnie `gateway.auth.mode: "none"` w konfiguracji. Doctor może wygenerować token w dowolnym momencie: `openclaw doctor --generate-gateway-token`. + Jeśli wolisz inną ścieżkę uwierzytelniania, możesz jawnie wybrać tryb hasła (albo, dla reverse proxy ze świadomością tożsamości spoza loopback, `trusted-proxy`). Jeśli **naprawdę** chcesz otwarty loopback, ustaw jawnie `gateway.auth.mode: "none"` w konfiguracji. Doctor może w dowolnym momencie wygenerować dla Ciebie token: `openclaw doctor --generate-gateway-token`. - + Gateway obserwuje konfigurację i obsługuje hot-reload: - - `gateway.reload.mode: "hybrid"` (domyślnie): bezpieczne zmiany stosuje na gorąco, krytyczne wymagają restartu + - `gateway.reload.mode: "hybrid"` (domyślnie): bezpieczne zmiany stosowane na gorąco, krytyczne wymagają restartu - obsługiwane są też `hot`, `restart`, `off` - + Ustaw `cli.banner.taglineMode` w konfiguracji: ```json5 @@ -1558,33 +1559,33 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. } ``` - - `off`: ukrywa tekst hasła, ale zachowuje linię tytułu/wersji banera. - - `default`: zawsze używa `All your chats, one OpenClaw.`. - - `random`: rotujące zabawne/sezonowe hasła (domyślne zachowanie). + - `off`: ukrywa tekst sloganu, ale pozostawia linię tytułu/wersji banera. + - `default`: za każdym razem używa `All your chats, one OpenClaw.`. + - `random`: rotujące zabawne/sezonowe slogany (domyślne zachowanie). - Jeśli nie chcesz żadnego banera, ustaw zmienną środowiskową `OPENCLAW_HIDE_BANNER=1`. - + `web_fetch` działa bez klucza API. `web_search` zależy od wybranego dostawcy: - - Dostawcy oparci na API, tacy jak Brave, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax Search, Perplexity i Tavily, wymagają standardowej konfiguracji klucza API. + - Dostawcy opierający się na API, tacy jak Brave, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax Search, Perplexity i Tavily, wymagają standardowej konfiguracji klucza API. - Ollama Web Search nie wymaga klucza, ale używa skonfigurowanego hosta Ollama i wymaga `ollama signin`. - DuckDuckGo nie wymaga klucza, ale jest to nieoficjalna integracja oparta na HTML. - - SearXNG nie wymaga klucza/jest self-hosted; skonfiguruj `SEARXNG_BASE_URL` lub `plugins.entries.searxng.config.webSearch.baseUrl`. + - SearXNG nie wymaga klucza/jest self-hosted; skonfiguruj `SEARXNG_BASE_URL` albo `plugins.entries.searxng.config.webSearch.baseUrl`. **Zalecane:** uruchom `openclaw configure --section web` i wybierz dostawcę. - Alternatywy w zmiennych środowiskowych: + Alternatywy przez zmienne środowiskowe: - Brave: `BRAVE_API_KEY` - Exa: `EXA_API_KEY` - Firecrawl: `FIRECRAWL_API_KEY` - Gemini: `GEMINI_API_KEY` - Grok: `XAI_API_KEY` - - Kimi: `KIMI_API_KEY` lub `MOONSHOT_API_KEY` - - MiniMax Search: `MINIMAX_CODE_PLAN_KEY`, `MINIMAX_CODING_API_KEY` lub `MINIMAX_API_KEY` - - Perplexity: `PERPLEXITY_API_KEY` lub `OPENROUTER_API_KEY` + - Kimi: `KIMI_API_KEY` albo `MOONSHOT_API_KEY` + - MiniMax Search: `MINIMAX_CODE_PLAN_KEY`, `MINIMAX_CODING_API_KEY` albo `MINIMAX_API_KEY` + - Perplexity: `PERPLEXITY_API_KEY` albo `OPENROUTER_API_KEY` - SearXNG: `SEARXNG_BASE_URL` - Tavily: `TAVILY_API_KEY` @@ -1610,7 +1611,7 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. }, fetch: { enabled: true, - provider: "firecrawl", // opcjonalne; pomiń dla auto-detekcji + provider: "firecrawl", // opcjonalne; pomiń dla automatycznego wykrywania }, }, }, @@ -1619,57 +1620,57 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. Konfiguracja wyszukiwania w sieci specyficzna dla dostawcy znajduje się teraz pod `plugins.entries..config.webSearch.*`. Starsze ścieżki dostawców `tools.web.search.*` nadal są tymczasowo wczytywane dla zgodności, ale nie powinny być używane w nowych konfiguracjach. - Konfiguracja fallbacku Firecrawl dla web-fetch znajduje się pod `plugins.entries.firecrawl.config.webFetch.*`. + Konfiguracja fallbacku web-fetch dla Firecrawl znajduje się pod `plugins.entries.firecrawl.config.webFetch.*`. Uwagi: - - Jeśli używasz allowlist, dodaj `web_search`/`web_fetch`/`x_search` lub `group:web`. - - `web_fetch` jest domyślnie włączone (chyba że jawnie je wyłączysz). - - Jeśli `tools.web.fetch.provider` zostanie pominięte, OpenClaw automatycznie wykrywa pierwszego gotowego dostawcę fallback dla fetch na podstawie dostępnych poświadczeń. Obecnie dołączonym dostawcą jest Firecrawl. - - Demony odczytują zmienne środowiskowe z `~/.openclaw/.env` (lub ze środowiska usługi). + - Jeśli używasz allowlist, dodaj `web_search`/`web_fetch`/`x_search` albo `group:web`. + - `web_fetch` jest domyślnie włączone (chyba że zostanie jawnie wyłączone). + - Jeśli `tools.web.fetch.provider` zostanie pominięte, OpenClaw automatycznie wykrywa pierwszego gotowego dostawcę fallbacku fetch na podstawie dostępnych poświadczeń. Obecnie dołączonym dostawcą jest Firecrawl. + - Demony odczytują zmienne środowiskowe z `~/.openclaw/.env` (albo ze środowiska usługi). - Dokumentacja: [Web tools](/pl/tools/web). + Dokumentacja: [Narzędzia webowe](/pl/tools/web). - + `config.apply` zastępuje **całą konfigurację**. Jeśli wyślesz obiekt częściowy, wszystko inne zostanie usunięte. Odzyskiwanie: - - Przywróć z kopii zapasowej (git lub skopiowane `~/.openclaw/openclaw.json`). - - Jeśli nie masz kopii zapasowej, uruchom ponownie `openclaw doctor` i skonfiguruj kanały/modele od nowa. - - Jeśli było to nieoczekiwane, zgłoś błąd i dołącz ostatnią znaną konfigurację lub dowolną kopię zapasową. - - Lokalny agent kodujący często potrafi odtworzyć działającą konfigurację na podstawie logów lub historii. + - Przywróć z kopii zapasowej (git albo skopiowany `~/.openclaw/openclaw.json`). + - Jeśli nie masz kopii zapasowej, uruchom ponownie `openclaw doctor` i ponownie skonfiguruj kanały/modele. + - Jeśli było to nieoczekiwane, zgłoś błąd i dołącz ostatnią znaną konfigurację albo jakąkolwiek kopię zapasową. + - Lokalny agent kodujący często potrafi odtworzyć działającą konfigurację z logów albo historii. - Jak tego uniknąć: + Jak tego unikać: - Używaj `openclaw config set` do małych zmian. - - Używaj `openclaw configure` do edycji interaktywnych. - - Najpierw użyj `config.schema.lookup`, jeśli nie masz pewności co do dokładnej ścieżki lub kształtu pola; zwraca płytki węzeł schematu oraz podsumowania bezpośrednich dzieci do dalszego zagłębiania się. - - Używaj `config.patch` do częściowych edycji RPC; zachowaj `config.apply` wyłącznie do pełnej zamiany konfiguracji. - - Jeśli używasz narzędzia `gateway` tylko dla właściciela z uruchomienia agenta, nadal będzie ono odrzucać zapisy do `tools.exec.ask` / `tools.exec.security` (w tym starsze aliasy `tools.bash.*`, które normalizują się do tych samych chronionych ścieżek exec). + - Używaj `openclaw configure` do interaktywnych edycji. + - Najpierw użyj `config.schema.lookup`, gdy nie masz pewności co do dokładnej ścieżki lub kształtu pola; zwraca płytki węzeł schematu oraz podsumowania bezpośrednich elementów podrzędnych do dalszej analizy. + - Używaj `config.patch` do częściowych edycji przez RPC; zachowaj `config.apply` wyłącznie do pełnej wymiany konfiguracji. + - Jeśli używasz narzędzia `gateway` dostępnego tylko dla ownera z poziomu uruchomienia agenta, nadal będzie ono odrzucać zapisy do `tools.exec.ask` / `tools.exec.security` (w tym starsze aliasy `tools.bash.*`, które normalizują się do tych samych chronionych ścieżek exec). - Dokumentacja: [Config](/cli/config), [Configure](/cli/configure), [Doctor](/pl/gateway/doctor). + Dokumentacja: [Konfiguracja](/cli/config), [Configure](/cli/configure), [Doctor](/pl/gateway/doctor). - Typowy wzorzec to **jeden Gateway** (np. Raspberry Pi) plus **Nodes** i **agenci**: + Typowy wzorzec to **jeden Gateway** (np. Raspberry Pi) plus **nodes** i **agenci**: - - **Gateway (centralny):** zarządza kanałami (Signal/WhatsApp), rutingiem i sesjami. - - **Nodes (urządzenia):** Mac/iOS/Android łączą się jako peryferia i udostępniają lokalne narzędzia (`system.run`, `canvas`, `camera`). - - **Agenci (workery):** oddzielne „mózgi”/workspace dla specjalnych ról (np. „Hetzner ops”, „Dane osobiste”). - - **Sub-agenci:** uruchamiają pracę w tle z głównego agenta, gdy chcesz równoległości. + - **Gateway (centralny):** zarządza kanałami (Signal/WhatsApp), routingiem i sesjami. + - **Nodes (urządzenia):** komputery Mac/iOS/Android łączą się jako urządzenia peryferyjne i udostępniają lokalne narzędzia (`system.run`, `canvas`, `camera`). + - **Agenci (workery):** oddzielne „mózgi”/workspace dla wyspecjalizowanych ról (np. „Hetzner ops”, „Dane osobiste”). + - **Sub-agenci:** uruchamiają pracę w tle z głównego agenta, gdy potrzebujesz równoległości. - **TUI:** łączy się z Gateway i przełącza agentów/sesje. - Dokumentacja: [Nodes](/pl/nodes), [Remote access](/pl/gateway/remote), [Multi-Agent Routing](/pl/concepts/multi-agent), [Sub-agents](/pl/tools/subagents), [TUI](/web/tui). + Dokumentacja: [Nodes](/pl/nodes), [Dostęp zdalny](/pl/gateway/remote), [Routing wieloagentowy](/pl/concepts/multi-agent), [Sub-agenci](/pl/tools/subagents), [TUI](/web/tui). - - Tak. To opcja konfiguracji: + + Tak. To opcja konfiguracyjna: ```json5 { @@ -1682,89 +1683,90 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. } ``` - Domyślnie jest `false` (z interfejsem). Tryb headless z większym prawdopodobieństwem uruchamia kontrole antybotowe na niektórych stronach. Zobacz [Browser](/pl/tools/browser). + Wartość domyślna to `false` (z interfejsem graficznym). Tryb bez interfejsu graficznego częściej uruchamia mechanizmy antybotowe na niektórych stronach. Zobacz [Przeglądarka](/pl/tools/browser). - Tryb headless używa **tego samego silnika Chromium** i działa w większości przypadków automatyzacji (formularze, kliknięcia, scraping, logowanie). Główne różnice: + Tryb headless używa **tego samego silnika Chromium** i działa przy większości automatyzacji (formularze, kliknięcia, scraping, logowania). Główne różnice: - Brak widocznego okna przeglądarki (jeśli potrzebujesz obrazu, używaj zrzutów ekranu). - - Niektóre strony są bardziej rygorystyczne wobec automatyzacji w trybie headless (CAPTCHA, antybot). + - Niektóre strony są bardziej restrykcyjne wobec automatyzacji w trybie headless (CAPTCHA, antybot). Na przykład X/Twitter często blokuje sesje headless. - Ustaw `browser.executablePath` na binarkę Brave (lub dowolnej przeglądarki opartej na Chromium) i zrestartuj Gateway. - Pełne przykłady konfiguracji znajdziesz w [Browser](/pl/tools/browser#use-brave-or-another-chromium-based-browser). + Ustaw `browser.executablePath` na binarkę Brave (lub dowolnej przeglądarki opartej na Chromium) i uruchom ponownie Gateway. + Pełne przykłady konfiguracji znajdziesz w [Przeglądarka](/pl/tools/browser#use-brave-or-another-chromium-based-browser). -## Zdalne Gateway i Nodes +## Zdalne gateway i nodes - - Wiadomości Telegram są obsługiwane przez **Gateway**. Gateway uruchamia agenta i - dopiero wtedy wywołuje Nodes przez **Gateway WebSocket**, gdy potrzebne jest narzędzie Node: + + Wiadomości Telegram są obsługiwane przez **gateway**. Gateway uruchamia agenta i + dopiero potem wywołuje nodes przez **Gateway WebSocket**, gdy potrzebne jest narzędzie node: Telegram → Gateway → Agent → `node.*` → Node → Gateway → Telegram - Nodes nie widzą przychodzącego ruchu od dostawców; otrzymują tylko wywołania RPC Node. + Nodes nie widzą przychodzącego ruchu dostawców; otrzymują tylko wywołania RPC node. - Krótka odpowiedź: **sparuj swój komputer jako Node**. Gateway działa gdzie indziej, ale może - wywoływać narzędzia `node.*` (ekran, kamera, system) na twojej lokalnej maszynie przez Gateway WebSocket. + Krótka odpowiedź: **sparuj swój komputer jako node**. Gateway działa gdzie indziej, ale może + wywoływać narzędzia `node.*` (ekran, kamera, system) na Twoim lokalnym komputerze przez Gateway WebSocket. Typowa konfiguracja: 1. Uruchom Gateway na stale działającym hoście (VPS/serwer domowy). 2. Umieść host Gateway i swój komputer w tym samym tailnet. - 3. Upewnij się, że Gateway WS jest osiągalny (bind tailnet lub tunel SSH). - 4. Otwórz lokalnie aplikację macOS i połącz się w trybie **Remote over SSH** (lub bezpośrednio przez tailnet), - aby mogła zarejestrować się jako Node. - 5. Zatwierdź Node na Gateway: + 3. Upewnij się, że Gateway WS jest osiągalny (bind tailnet albo tunel SSH). + 4. Otwórz lokalnie aplikację macOS i połącz się w trybie **Remote over SSH** (albo bezpośrednio przez tailnet), + aby mogła zarejestrować się jako node. + 5. Zatwierdź node na Gateway: ```bash openclaw devices list openclaw devices approve ``` - Nie jest wymagany osobny most TCP; Nodes łączą się przez Gateway WebSocket. + Oddzielny most TCP nie jest wymagany; nodes łączą się przez Gateway WebSocket. - Przypomnienie dotyczące bezpieczeństwa: sparowanie Node macOS umożliwia `system.run` na tej maszynie. Paryj tylko zaufane urządzenia i zapoznaj się z [Security](/pl/gateway/security). + Przypomnienie o bezpieczeństwie: sparowanie node macOS pozwala na `system.run` na tej maszynie. Paryj + tylko zaufane urządzenia i zapoznaj się z [Bezpieczeństwo](/pl/gateway/security). - Dokumentacja: [Nodes](/pl/nodes), [Gateway protocol](/pl/gateway/protocol), [macOS remote mode](/pl/platforms/mac/remote), [Security](/pl/gateway/security). + Dokumentacja: [Nodes](/pl/nodes), [Protokół Gateway](/pl/gateway/protocol), [tryb zdalny macOS](/pl/platforms/mac/remote), [Bezpieczeństwo](/pl/gateway/security). - + Sprawdź podstawy: - Gateway działa: `openclaw gateway status` - - Zdrowie Gateway: `openclaw status` - - Zdrowie kanałów: `openclaw channels status` + - Kondycja Gateway: `openclaw status` + - Kondycja kanałów: `openclaw channels status` - Następnie zweryfikuj uwierzytelnianie i ruting: + Następnie sprawdź uwierzytelnianie i routing: - Jeśli używasz Tailscale Serve, upewnij się, że `gateway.auth.allowTailscale` jest ustawione poprawnie. - Jeśli łączysz się przez tunel SSH, potwierdź, że lokalny tunel działa i wskazuje właściwy port. - - Potwierdź, że allowlisty (DM lub grupowe) obejmują twoje konto. + - Potwierdź, że Twoje allowlisty (DM albo grupa) obejmują Twoje konto. - Dokumentacja: [Tailscale](/pl/gateway/tailscale), [Remote access](/pl/gateway/remote), [Channels](/pl/channels). + Dokumentacja: [Tailscale](/pl/gateway/tailscale), [Dostęp zdalny](/pl/gateway/remote), [Kanały](/pl/channels). - Tak. Nie ma wbudowanego mostu „bot-do-bota”, ale możesz to połączyć na kilka + Tak. Nie ma wbudowanego mostu „bot-do-bota”, ale można to połączyć na kilka niezawodnych sposobów: **Najprościej:** użyj zwykłego kanału czatu, do którego oba boty mają dostęp (Telegram/Slack/WhatsApp). Niech Bot A wyśle wiadomość do Bota B, a potem Bot B odpowie jak zwykle. **Most CLI (ogólny):** uruchom skrypt, który wywołuje drugi Gateway przez - `openclaw agent --message ... --deliver`, kierując do czatu, na którym drugi bot - nasłuchuje. Jeśli jeden bot działa na zdalnym VPS, skieruj CLI na ten zdalny Gateway - przez SSH/Tailscale (zobacz [Remote access](/pl/gateway/remote)). + `openclaw agent --message ... --deliver`, kierując wiadomość do czatu, na którym drugi bot + nasłuchuje. Jeśli jeden bot działa na zdalnym VPS, skieruj swoje CLI na ten zdalny Gateway + przez SSH/Tailscale (zobacz [Dostęp zdalny](/pl/gateway/remote)). Przykładowy wzorzec (uruchamiany z maszyny, która może osiągnąć docelowy Gateway): @@ -1772,58 +1774,58 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. openclaw agent --message "Hello from local bot" --deliver --channel telegram --reply-to ``` - Wskazówka: dodaj zabezpieczenie, aby oba boty nie zapętliły się bez końca (tylko wzmianki, allowlisty kanałów albo reguła „nie odpowiadaj na wiadomości botów”). + Wskazówka: dodaj ograniczenie ochronne, aby oba boty nie zapętliły się bez końca (tylko wzmianki, allowlisty kanałów albo reguła „nie odpowiadaj na wiadomości botów”). - Dokumentacja: [Remote access](/pl/gateway/remote), [Agent CLI](/cli/agent), [Agent send](/pl/tools/agent-send). + Dokumentacja: [Dostęp zdalny](/pl/gateway/remote), [CLI Agent](/cli/agent), [Wysyłanie przez agenta](/pl/tools/agent-send). - + Nie. Jeden Gateway może hostować wielu agentów, z których każdy ma własny workspace, domyślne modele - i ruting. To jest normalna konfiguracja i jest znacznie tańsza oraz prostsza niż uruchamianie + i routing. To normalna konfiguracja i jest znacznie tańsza oraz prostsza niż uruchamianie jednego VPS na agenta. - Używaj osobnych VPS-ów tylko wtedy, gdy potrzebujesz twardej izolacji (granic bezpieczeństwa) albo bardzo + Używaj oddzielnych VPS tylko wtedy, gdy potrzebujesz twardej izolacji (granice bezpieczeństwa) albo bardzo różnych konfiguracji, których nie chcesz współdzielić. W przeciwnym razie zachowaj jeden Gateway i - używaj wielu agentów lub sub-agentów. + używaj wielu agentów albo sub-agentów. - - Tak — Nodes to rozwiązanie pierwszej klasy do uzyskiwania dostępu do laptopa ze zdalnego Gateway i - oferują więcej niż tylko dostęp do powłoki. Gateway działa na macOS/Linux (Windows przez WSL2) i jest - lekki (wystarczy mały VPS lub urządzenie klasy Raspberry Pi; 4 GB RAM to aż nadto), więc częstą - konfiguracją jest stale działający host plus twój laptop jako Node. + + Tak — nodes to podstawowy sposób uzyskania dostępu do laptopa ze zdalnego Gateway i + dają więcej niż tylko dostęp do powłoki. Gateway działa na macOS/Linux (Windows przez WSL2) i jest + lekki (wystarczy mały VPS lub urządzenie klasy Raspberry Pi; 4 GB RAM to aż nadto), więc częsta + konfiguracja to stale działający host plus Twój laptop jako node. - - **Brak potrzeby przychodzącego SSH.** Nodes łączą się wychodząco z Gateway WebSocket i używają parowania urządzeń. - - **Bezpieczniejsze kontrole wykonywania.** `system.run` jest ograniczone przez allowlisty/zatwierdzenia Node na tym laptopie. + - **Bez przychodzącego SSH.** Nodes łączą się wychodząco z Gateway WebSocket i używają parowania urządzeń. + - **Bezpieczniejsza kontrola wykonywania.** `system.run` jest ograniczane przez allowlisty/zatwierdzenia node na tym laptopie. - **Więcej narzędzi urządzenia.** Nodes udostępniają `canvas`, `camera` i `screen` oprócz `system.run`. - - **Lokalna automatyzacja przeglądarki.** Zachowaj Gateway na VPS, ale uruchamiaj Chrome lokalnie przez hosta Node na laptopie albo podłącz się do lokalnego Chrome na hoście przez Chrome MCP. + - **Lokalna automatyzacja przeglądarki.** Zachowaj Gateway na VPS, ale uruchamiaj Chrome lokalnie przez hosta node na laptopie albo podłącz się do lokalnego Chrome na hoście przez Chrome MCP. - SSH jest w porządku do doraźnego dostępu do powłoki, ale Nodes są prostsze dla ciągłych przepływów pracy agenta i - automatyzacji urządzeń. + SSH jest w porządku do doraźnego dostępu do powłoki, ale nodes są prostsze dla ciągłych przepływów pracy agenta i + automatyzacji urządzenia. - Dokumentacja: [Nodes](/pl/nodes), [Nodes CLI](/cli/nodes), [Browser](/pl/tools/browser). + Dokumentacja: [Nodes](/pl/nodes), [CLI Nodes](/cli/nodes), [Przeglądarka](/pl/tools/browser). - - Nie. Na hoście powinien działać tylko **jeden Gateway**, chyba że celowo uruchamiasz izolowane profile (zobacz [Multiple gateways](/pl/gateway/multiple-gateways)). Nodes to urządzenia peryferyjne, które łączą się - z Gateway (Nodes iOS/Android albo tryb „node mode” w aplikacji macOS w pasku menu). Informacje o bezgłowych - hostach Node i sterowaniu przez CLI znajdziesz w [Node host CLI](/cli/node). + + Nie. Na hoście powinien działać tylko **jeden gateway**, chyba że celowo uruchamiasz izolowane profile (zobacz [Wiele gateway](/pl/gateway/multiple-gateways)). Nodes to urządzenia peryferyjne, które łączą + się z gateway (nodes iOS/Android albo tryb „node mode” macOS w aplikacji paska menu). Informacje o bezgłowych + hostach node i sterowaniu z CLI znajdziesz w [CLI hosta node](/cli/node). - Pełny restart jest wymagany dla zmian `gateway`, `discovery` i `canvasHost`. + Pełny restart jest wymagany przy zmianach `gateway`, `discovery` i `canvasHost`. - + Tak. - - `config.schema.lookup`: sprawdza jedno poddrzewo konfiguracji wraz z jego płytkim węzłem schematu, dopasowaną wskazówką UI i podsumowaniami bezpośrednich dzieci przed zapisem + - `config.schema.lookup`: sprawdza jedno poddrzewo konfiguracji wraz z jego płytkim węzłem schematu, dopasowaną wskazówką UI i podsumowaniami bezpośrednich elementów podrzędnych przed zapisem - `config.get`: pobiera bieżącą migawkę + hash - - `config.patch`: bezpieczna częściowa aktualizacja (zalecana dla większości edycji RPC); wykonuje hot-reload, gdy to możliwe, i restart, gdy jest wymagany - - `config.apply`: waliduje i zastępuje pełną konfigurację; wykonuje hot-reload, gdy to możliwe, i restart, gdy jest wymagany - - Narzędzie runtime `gateway` tylko dla właściciela nadal odmawia przepisywania `tools.exec.ask` / `tools.exec.security`; starsze aliasy `tools.bash.*` normalizują się do tych samych chronionych ścieżek exec + - `config.patch`: bezpieczna częściowa aktualizacja (preferowana dla większości edycji RPC); stosuje hot-reload, gdy to możliwe, i restartuje, gdy to wymagane + - `config.apply`: weryfikuje + zastępuje pełną konfigurację; stosuje hot-reload, gdy to możliwe, i restartuje, gdy to wymagane + - Narzędzie środowiska uruchomieniowego `gateway`, dostępne tylko dla ownera, nadal odmawia przepisywania `tools.exec.ask` / `tools.exec.security`; starsze aliasy `tools.bash.*` normalizują się do tych samych chronionych ścieżek exec @@ -1835,21 +1837,21 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. } ``` - To ustawia twój workspace i ogranicza, kto może uruchamiać bota. + To ustawia Twój workspace i ogranicza, kto może wywołać bota. - + Minimalne kroki: - 1. **Zainstaluj i zaloguj się na VPS** + 1. **Zainstaluj + zaloguj się na VPS** ```bash curl -fsSL https://tailscale.com/install.sh | sh sudo tailscale up ``` - 2. **Zainstaluj i zaloguj się na swoim Mac** + 2. **Zainstaluj + zaloguj się na swoim Macu** - Użyj aplikacji Tailscale i zaloguj się do tego samego tailnet. 3. **Włącz MagicDNS (zalecane)** - W konsoli administracyjnej Tailscale włącz MagicDNS, aby VPS miał stabilną nazwę. @@ -1857,59 +1859,59 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. - SSH: `ssh user@your-vps.tailnet-xxxx.ts.net` - Gateway WS: `ws://your-vps.tailnet-xxxx.ts.net:18789` - Jeśli chcesz używać Control UI bez SSH, uruchom Tailscale Serve na VPS: + Jeśli chcesz używać Control UI bez SSH, użyj Tailscale Serve na VPS: ```bash openclaw gateway --tailscale serve ``` - To pozostawia Gateway powiązany z loopback i udostępnia HTTPS przez Tailscale. Zobacz [Tailscale](/pl/gateway/tailscale). + Dzięki temu gateway pozostaje zbindowany do loopback i jest udostępniany przez HTTPS przez Tailscale. Zobacz [Tailscale](/pl/gateway/tailscale). - - Serve udostępnia **Gateway Control UI + WS**. Nodes łączą się przez ten sam endpoint Gateway WS. + + Serve udostępnia **Control UI + WS Gateway**. Nodes łączą się przez ten sam endpoint Gateway WS. Zalecana konfiguracja: 1. **Upewnij się, że VPS i Mac są w tym samym tailnet**. - 2. **Użyj aplikacji macOS w trybie Remote** (celem SSH może być nazwa hosta tailnet). - Aplikacja utworzy tunel dla portu Gateway i połączy się jako Node. - 3. **Zatwierdź Node** na Gateway: + 2. **Użyj aplikacji macOS w trybie Remote** (cel SSH może być nazwą hosta tailnet). + Aplikacja utworzy tunel portu Gateway i połączy się jako node. + 3. **Zatwierdź node** na gateway: ```bash openclaw devices list openclaw devices approve ``` - Dokumentacja: [Gateway protocol](/pl/gateway/protocol), [Discovery](/pl/gateway/discovery), [macOS remote mode](/pl/platforms/mac/remote). + Dokumentacja: [Protokół Gateway](/pl/gateway/protocol), [Discovery](/pl/gateway/discovery), [tryb zdalny macOS](/pl/platforms/mac/remote). - - Jeśli potrzebujesz tylko **lokalnych narzędzi** (ekran/kamera/exec) na drugim laptopie, dodaj go jako - **Node**. Dzięki temu zachowujesz jeden Gateway i unikasz duplikowania konfiguracji. Lokalne narzędzia Node są - obecnie dostępne tylko na macOS, ale planujemy rozszerzyć je na inne systemy operacyjne. + + Jeśli potrzebujesz tylko **lokalnych narzędzi** (screen/camera/exec) na drugim laptopie, dodaj go jako + **node**. Pozwala to zachować jeden Gateway i unika zduplikowanej konfiguracji. Lokalne narzędzia node są + obecnie dostępne tylko dla macOS, ale planujemy rozszerzyć je na inne systemy operacyjne. - Drugi Gateway instaluj tylko wtedy, gdy potrzebujesz **twardej izolacji** lub dwóch całkowicie oddzielnych botów. + Drugi Gateway instaluj tylko wtedy, gdy potrzebujesz **twardej izolacji** albo dwóch całkowicie oddzielnych botów. - Dokumentacja: [Nodes](/pl/nodes), [Nodes CLI](/cli/nodes), [Multiple gateways](/pl/gateway/multiple-gateways). + Dokumentacja: [Nodes](/pl/nodes), [CLI Nodes](/cli/nodes), [Wiele gateway](/pl/gateway/multiple-gateways). -## Zmienne środowiskowe i ładowanie `.env` +## Zmienne środowiskowe i ładowanie .env OpenClaw odczytuje zmienne środowiskowe z procesu nadrzędnego (powłoka, launchd/systemd, CI itd.) i dodatkowo ładuje: - `.env` z bieżącego katalogu roboczego - - globalny zapasowy `.env` z `~/.openclaw/.env` (czyli `$OPENCLAW_STATE_DIR/.env`) + - globalny awaryjny `.env` z `~/.openclaw/.env` (czyli `$OPENCLAW_STATE_DIR/.env`) - Żaden z plików `.env` nie nadpisuje istniejących zmiennych środowiskowych. + Żaden plik `.env` nie nadpisuje istniejących zmiennych środowiskowych. - Możesz też zdefiniować wbudowane zmienne środowiskowe w konfiguracji (stosowane tylko wtedy, gdy brakuje ich w środowisku procesu): + Możesz też definiować inline zmienne środowiskowe w konfiguracji (stosowane tylko wtedy, gdy brakuje ich w env procesu): ```json5 { @@ -1920,15 +1922,15 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. } ``` - Pełny opis priorytetów i źródeł znajdziesz w [/environment](/pl/help/environment). + Pełny priorytet i źródła znajdziesz w [/environment](/pl/help/environment). - - Dwie typowe poprawki: + + Dwie częste poprawki: - 1. Umieść brakujące klucze w `~/.openclaw/.env`, aby były pobierane nawet wtedy, gdy usługa nie dziedziczy zmiennych środowiskowych z twojej powłoki. - 2. Włącz import z powłoki (opcjonalne ułatwienie): + 1. Umieść brakujące klucze w `~/.openclaw/.env`, aby były pobierane nawet wtedy, gdy usługa nie dziedziczy env Twojej powłoki. + 2. Włącz import powłoki (wygoda opt-in): ```json5 { @@ -1941,18 +1943,18 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. } ``` - To uruchamia twoją powłokę logowania i importuje tylko brakujące oczekiwane klucze (nigdy nie nadpisuje). Odpowiedniki w zmiennych środowiskowych: + To uruchamia Twoją login shell i importuje tylko brakujące oczekiwane klucze (nigdy nie nadpisuje). Odpowiedniki w zmiennych środowiskowych: `OPENCLAW_LOAD_SHELL_ENV=1`, `OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000`. - - `openclaw models status` raportuje, czy **import zmiennych środowiskowych z powłoki** jest włączony. „Shell env: off” - **nie** oznacza, że twoje zmienne środowiskowe są nieobecne — oznacza tylko, że OpenClaw nie będzie - automatycznie ładować twojej powłoki logowania. + + `openclaw models status` raportuje, czy **import env z powłoki** jest włączony. „Shell env: off” + **nie** oznacza, że brakuje Twoich zmiennych środowiskowych — oznacza tylko, że OpenClaw nie będzie + automatycznie ładować Twojej login shell. Jeśli Gateway działa jako usługa (launchd/systemd), nie odziedziczy środowiska - twojej powłoki. Napraw to na jeden z poniższych sposobów: + Twojej powłoki. Napraw to na jeden z tych sposobów: 1. Umieść token w `~/.openclaw/.env`: @@ -1960,16 +1962,16 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. COPILOT_GITHUB_TOKEN=... ``` - 2. Albo włącz import z powłoki (`env.shellEnv.enabled: true`). - 3. Albo dodaj go do bloku `env` w konfiguracji (stosuje się tylko wtedy, gdy brakuje). + 2. Albo włącz import powłoki (`env.shellEnv.enabled: true`). + 3. Albo dodaj go do bloku `env` w konfiguracji (stosowane tylko, jeśli go brakuje). - Następnie zrestartuj Gateway i sprawdź ponownie: + Następnie zrestartuj gateway i sprawdź ponownie: ```bash openclaw models status ``` - Tokeny Copilot są odczytywane z `COPILOT_GITHUB_TOKEN` (także `GH_TOKEN` / `GITHUB_TOKEN`). + Tokeny Copilot są odczytywane z `COPILOT_GITHUB_TOKEN` (również `GH_TOKEN` / `GITHUB_TOKEN`). Zobacz [/concepts/model-providers](/pl/concepts/model-providers) i [/environment](/pl/help/environment). @@ -1979,14 +1981,14 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. - Wyślij `/new` lub `/reset` jako samodzielną wiadomość. Zobacz [Session management](/pl/concepts/session). + Wyślij `/new` lub `/reset` jako samodzielną wiadomość. Zobacz [Zarządzanie sesjami](/pl/concepts/session). - Sesje mogą wygasać po `session.idleMinutes`, ale domyślnie jest to **wyłączone** (domyślnie **0**). - Ustaw wartość dodatnią, aby włączyć wygaszanie bezczynności. Gdy jest włączone, **następna** + Sesje mogą wygasać po `session.idleMinutes`, ale ta funkcja jest **domyślnie wyłączona** (wartość domyślna **0**). + Ustaw wartość dodatnią, aby włączyć wygasanie bezczynności. Gdy jest włączone, **następna** wiadomość po okresie bezczynności rozpoczyna nowy identyfikator sesji dla tego klucza czatu. - Nie usuwa to transkrypcji — tylko rozpoczyna nową sesję. + Nie usuwa to transkryptów — po prostu rozpoczyna nową sesję. ```json5 { @@ -1998,35 +2000,35 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. - - Tak, przez **routing multi-agent** i **sub-agentów**. Możesz utworzyć jednego agenta - koordynującego i kilku agentów roboczych z własnymi workspace i modelami. + + Tak, przez **routing wieloagentowy** i **sub-agentów**. Możesz utworzyć jednego koordynującego + agenta i kilku agentów roboczych z własnymi workspace i modelami. - Warto jednak traktować to raczej jako **zabawny eksperyment**. Zużywa dużo tokenów i często - jest mniej wydajne niż używanie jednego bota z osobnymi sesjami. Typowy model, który - mamy na myśli, to jeden bot, z którym rozmawiasz, z różnymi sesjami do pracy równoległej. Ten - bot może też uruchamiać sub-agentów, gdy to potrzebne. + Mimo to najlepiej traktować to jako **zabawny eksperyment**. Zużywa dużo tokenów i często + jest mniej wydajne niż używanie jednego bota z oddzielnymi sesjami. Typowy model, który + sobie wyobrażamy, to jeden bot, z którym rozmawiasz, z różnymi sesjami do pracy równoległej. Taki + bot może też w razie potrzeby uruchamiać sub-agentów. - Dokumentacja: [Multi-agent routing](/pl/concepts/multi-agent), [Sub-agents](/pl/tools/subagents), [Agents CLI](/cli/agents). + Dokumentacja: [Routing wieloagentowy](/pl/concepts/multi-agent), [Sub-agenci](/pl/tools/subagents), [CLI Agents](/cli/agents). - - Kontekst sesji jest ograniczony oknem modelu. Długie czaty, duże wyjścia narzędzi lub wiele - plików mogą wywołać Compaction albo obcięcie. + + Kontekst sesji jest ograniczony przez okno modelu. Długie czaty, duże dane wyjściowe narzędzi albo wiele + plików mogą wywołać compaction albo obcięcie. Co pomaga: - - Poproś bota o podsumowanie bieżącego stanu i zapisanie go do pliku. - - Używaj `/compact` przed długimi zadaniami oraz `/new` przy zmianie tematu. - - Trzymaj ważny kontekst w workspace i poproś bota, by odczytał go ponownie. + - Poproś bota, aby podsumował bieżący stan i zapisał go do pliku. + - Używaj `/compact` przed długimi zadaniami i `/new` przy zmianie tematu. + - Trzymaj ważny kontekst w workspace i poproś bota, aby go ponownie odczytał. - Używaj sub-agentów do długiej lub równoległej pracy, aby główny czat pozostawał mniejszy. - Wybierz model z większym oknem kontekstu, jeśli to zdarza się często. - - Użyj polecenia resetowania: + + Użyj polecenia reset: ```bash openclaw reset @@ -2046,13 +2048,13 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. Uwagi: - - Onboarding oferuje też opcję **Reset**, jeśli wykryje istniejącą konfigurację. Zobacz [Onboarding (CLI)](/pl/start/wizard). - - Jeśli używałeś profili (`--profile` / `OPENCLAW_PROFILE`), zresetuj każdy katalog stanu (domyślnie są to `~/.openclaw-`). - - Reset deweloperski: `openclaw gateway --dev --reset` (tylko dla dev; czyści konfigurację dev + poświadczenia + sesje + workspace). + - Onboarding oferuje też **Reset**, jeśli wykryje istniejącą konfigurację. Zobacz [Onboarding (CLI)](/pl/start/wizard). + - Jeśli używałeś/używałaś profili (`--profile` / `OPENCLAW_PROFILE`), zresetuj każdy katalog stanu (domyślne to `~/.openclaw-`). + - Reset dla developmentu: `openclaw gateway --dev --reset` (tylko development; czyści konfigurację deweloperską + poświadczenia + sesje + workspace). - + Użyj jednej z tych opcji: - **Compaction** (zachowuje rozmowę, ale podsumowuje starsze tury): @@ -2070,33 +2072,33 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. /reset ``` - Jeśli to wciąż się zdarza: + Jeśli to się powtarza: - - Włącz lub dostrój **session pruning** (`agents.defaults.contextPruning`), aby przycinać stare wyjścia narzędzi. + - Włącz lub dostrój **pruning sesji** (`agents.defaults.contextPruning`), aby przycinać stare dane wyjściowe narzędzi. - Używaj modelu z większym oknem kontekstu. - Dokumentacja: [Compaction](/pl/concepts/compaction), [Session pruning](/pl/concepts/session-pruning), [Session management](/pl/concepts/session). + Dokumentacja: [Compaction](/pl/concepts/compaction), [Pruning sesji](/pl/concepts/session-pruning), [Zarządzanie sesjami](/pl/concepts/session). - To błąd walidacji dostawcy: model wygenerował blok `tool_use` bez wymaganego + To błąd walidacji dostawcy: model zwrócił blok `tool_use` bez wymaganego `input`. Zwykle oznacza to, że historia sesji jest nieaktualna lub uszkodzona (często po długich wątkach albo zmianie narzędzia/schematu). - Naprawa: rozpocznij nową sesję przez `/new` (samodzielna wiadomość). + Naprawa: rozpocznij nową sesję za pomocą `/new` (samodzielna wiadomość). - Heartbeat działa domyślnie co **30m** (**1h** przy użyciu uwierzytelniania OAuth). Dostosuj lub wyłącz go: + Heartbeat uruchamia się domyślnie co **30 min** (**1 h** przy użyciu uwierzytelniania OAuth). Dostosuj lub wyłącz go: ```json5 { agents: { defaults: { heartbeat: { - every: "2h", // lub "0m", aby wyłączyć + every: "2h", // albo "0m", aby wyłączyć }, }, }, @@ -2104,18 +2106,18 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. ``` Jeśli `HEARTBEAT.md` istnieje, ale jest w praktyce pusty (tylko puste linie i nagłówki - Markdown, takie jak `# Heading`), OpenClaw pomija uruchomienie Heartbeat, aby oszczędzać wywołania API. - Jeśli pliku brakuje, Heartbeat nadal się uruchamia, a model decyduje, co zrobić. + Markdown, takie jak `# Heading`), OpenClaw pomija uruchomienie heartbeat, aby oszczędzać wywołania API. + Jeśli pliku nie ma, heartbeat nadal działa i model decyduje, co zrobić. Nadpisania per agent używają `agents.list[].heartbeat`. Dokumentacja: [Heartbeat](/pl/gateway/heartbeat). - Nie. OpenClaw działa na **twoim własnym koncie**, więc jeśli jesteś w grupie, OpenClaw może ją widzieć. - Domyślnie odpowiedzi grupowe są blokowane, dopóki nie zezwolisz nadawcom (`groupPolicy: "allowlist"`). + Nie. OpenClaw działa na **Twoim własnym koncie**, więc jeśli jesteś w grupie, OpenClaw może ją widzieć. + Domyślnie odpowiedzi w grupach są blokowane do czasu zezwolenia nadawcom (`groupPolicy: "allowlist"`). - Jeśli chcesz, aby tylko **ty** mógł wywoływać odpowiedzi grupowe: + Jeśli chcesz, aby tylko **Ty** móc wywoływać odpowiedzi w grupie: ```json5 { @@ -2131,7 +2133,7 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. - Opcja 1 (najszybsza): śledź logi i wyślij wiadomość testową do grupy: + Opcja 1 (najszybciej): śledź logi i wyślij wiadomość testową w grupie: ```bash openclaw logs --follow --json @@ -2140,102 +2142,102 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. Szukaj `chatId` (lub `from`) kończącego się na `@g.us`, na przykład: `1234567890-1234567890@g.us`. - Opcja 2 (jeśli jest już skonfigurowane/dodane do allowlist): wyświetl grupy z konfiguracji: + Opcja 2 (jeśli już skonfigurowane/na allowlist): wylistuj grupy z konfiguracji: ```bash openclaw directory groups list --channel whatsapp ``` - Dokumentacja: [WhatsApp](/pl/channels/whatsapp), [Directory](/cli/directory), [Logs](/cli/logs). + Dokumentacja: [WhatsApp](/pl/channels/whatsapp), [Directory](/cli/directory), [Logi](/cli/logs). Dwie częste przyczyny: - - Filtrowanie po wzmiankach jest włączone (domyślnie). Musisz użyć @wzmianki o bocie (lub dopasować `mentionPatterns`). - - Skonfigurowałeś `channels.whatsapp.groups` bez `"*"`, a grupa nie znajduje się na allowlist. + - Ograniczanie przez wzmianki jest włączone (domyślnie). Musisz oznaczyć bota przez @mention (albo dopasować `mentionPatterns`). + - Skonfigurowałeś/-aś `channels.whatsapp.groups` bez `"*"`, a grupa nie znajduje się na allowliście. - Zobacz [Groups](/pl/channels/groups) i [Group messages](/pl/channels/group-messages). + Zobacz [Grupy](/pl/channels/groups) i [Wiadomości grupowe](/pl/channels/group-messages). - Czaty bezpośrednie domyślnie zwijają się do głównej sesji. Grupy/kanały mają własne klucze sesji, a tematy Telegram / wątki Discord to oddzielne sesje. Zobacz [Groups](/pl/channels/groups) i [Group messages](/pl/channels/group-messages). + Czaty bezpośrednie są domyślnie zwijane do głównej sesji. Grupy/kanały mają własne klucze sesji, a tematy Telegram / wątki Discord to oddzielne sesje. Zobacz [Grupy](/pl/channels/groups) i [Wiadomości grupowe](/pl/channels/group-messages). - Nie ma sztywnych limitów. Dziesiątki (a nawet setki) są w porządku, ale zwracaj uwagę na: + Brak sztywnych limitów. Dziesiątki (a nawet setki) są w porządku, ale zwracaj uwagę na: - - **Przyrost zajętości dysku:** sesje + transkrypcje znajdują się w `~/.openclaw/agents//sessions/`. - - **Koszt tokenów:** więcej agentów oznacza większe równoczesne użycie modeli. + - **Przyrost danych na dysku:** sesje + transkrypty znajdują się w `~/.openclaw/agents//sessions/`. + - **Koszt tokenów:** więcej agentów oznacza większe równoległe użycie modeli. - **Narzut operacyjny:** profile uwierzytelniania per agent, workspace i routing kanałów. Wskazówki: - - Utrzymuj jeden **aktywny** workspace na agenta (`agents.defaults.workspace`). - - Przycinaj stare sesje (usuwaj wpisy JSONL lub wpisy w magazynie), jeśli zajętość dysku rośnie. + - Zachowaj jeden **aktywny** workspace na agenta (`agents.defaults.workspace`). + - Przycinaj stare sesje (usuwaj wpisy JSONL lub wpisy magazynu), jeśli zużycie dysku rośnie. - Używaj `openclaw doctor`, aby wykrywać osierocone workspace i niedopasowania profili. - - Tak. Użyj **Multi-Agent Routing**, aby uruchamiać wiele odizolowanych agentów i kierować wiadomości przychodzące według - kanału/konta/peera. Slack jest obsługiwany jako kanał i może być przypisany do określonych agentów. + + Tak. Użyj **routingu wieloagentowego**, aby uruchamiać wiele odizolowanych agentów i kierować wiadomości przychodzące według + kanału/konta/peer. Slack jest obsługiwany jako kanał i może być przypisywany do określonych agentów. - Dostęp do przeglądarki jest potężny, ale nie oznacza „wszystkiego, co może człowiek” — antyboty, CAPTCHA i MFA nadal mogą + Dostęp do przeglądarki jest potężny, ale nie oznacza „zrób wszystko, co może człowiek” — mechanizmy antybotowe, CAPTCHA i MFA nadal mogą blokować automatyzację. Aby uzyskać najbardziej niezawodne sterowanie przeglądarką, używaj lokalnego Chrome MCP na hoście albo CDP na maszynie, która faktycznie uruchamia przeglądarkę. - Konfiguracja zgodna z najlepszymi praktykami: + Konfiguracja zgodna z dobrymi praktykami: - - Stale działający host Gateway (VPS/Mac mini). + - Host Gateway działający zawsze (VPS/Mac mini). - Jeden agent na rolę (powiązania). - - Kanał(y) Slack przypisane do tych agentów. - - Lokalna przeglądarka przez Chrome MCP lub Node, gdy jest potrzebna. + - Kanały Slack przypisane do tych agentów. + - Lokalna przeglądarka przez Chrome MCP albo node, gdy jest potrzebna. - Dokumentacja: [Multi-Agent Routing](/pl/concepts/multi-agent), [Slack](/pl/channels/slack), - [Browser](/pl/tools/browser), [Nodes](/pl/nodes). + Dokumentacja: [Routing wieloagentowy](/pl/concepts/multi-agent), [Slack](/pl/channels/slack), + [Przeglądarka](/pl/tools/browser), [Nodes](/pl/nodes). -## Modele: domyślne, wybór, aliasy, przełączanie +## Modele: wartości domyślne, wybór, aliasy, przełączanie - Domyślny model OpenClaw to to, co ustawisz jako: + Domyślny model OpenClaw to ten, który ustawisz jako: ``` agents.defaults.model.primary ``` - Do modeli odwołuje się jako `provider/model` (przykład: `openai/gpt-5.4`). Jeśli pominiesz dostawcę, OpenClaw najpierw próbuje aliasu, potem unikalnego dopasowania skonfigurowanego dostawcy dla dokładnie tego identyfikatora modelu, a dopiero potem wraca do skonfigurowanego domyślnego dostawcy jako przestarzałej ścieżki zgodności. Jeśli ten dostawca nie udostępnia już skonfigurowanego modelu domyślnego, OpenClaw przechodzi na pierwszy skonfigurowany dostawca/model zamiast ujawniać nieaktualny domyślny model usuniętego dostawcy. Nadal jednak powinieneś **jawnie** ustawiać `provider/model`. + Do modeli odwołuje się jako `provider/model` (przykład: `openai/gpt-5.4`). Jeśli pominiesz dostawcę, OpenClaw najpierw próbuje aliasu, potem unikalnego dopasowania skonfigurowanego dostawcy dla tego dokładnego identyfikatora modelu, a dopiero potem wraca do skonfigurowanego dostawcy domyślnego jako przestarzałej ścieżki zgodności. Jeśli ten dostawca nie udostępnia już skonfigurowanego modelu domyślnego, OpenClaw wraca do pierwszego skonfigurowanego dostawcy/modelu zamiast pokazywać nieaktualny domyślny model z usuniętego dostawcy. Nadal powinieneś/powinnaś **jawnie** ustawiać `provider/model`. - **Zalecany model domyślny:** używaj najmocniejszego modelu najnowszej generacji dostępnego w twoim stosie dostawców. - **Dla agentów z włączonymi narzędziami lub obsługujących niezaufane dane wejściowe:** stawiaj siłę modelu ponad kosztem. - **Dla rutynowego czatu / zadań o niskiej stawce:** używaj tańszych modeli zapasowych i kieruj według roli agenta. + **Zalecany model domyślny:** używaj najmocniejszego modelu najnowszej generacji dostępnego w Twoim stosie dostawców. + **Dla agentów z narzędziami lub z niezaufanym wejściem:** stawiaj siłę modelu ponad koszt. + **Do rutynowego/niskiego ryzyka czatu:** używaj tańszych modeli zapasowych i kieruj według roli agenta. - MiniMax ma własną dokumentację: [MiniMax](/pl/providers/minimax) i - [Local models](/pl/gateway/local-models). + MiniMax ma własną dokumentację: [MiniMax](/pl/providers/minimax) oraz + [Modele lokalne](/pl/gateway/local-models). - Zasada praktyczna: używaj **najlepszego modelu, na jaki cię stać** do zadań o wysokiej stawce, a tańszego + Zasada praktyczna: używaj **najlepszego modelu, na jaki Cię stać** do zadań wysokiej stawki, a tańszego modelu do rutynowego czatu lub podsumowań. Możesz kierować modele per agent i używać sub-agentów do - równoległego wykonywania długich zadań (każdy sub-agent zużywa tokeny). Zobacz [Models](/pl/concepts/models) i - [Sub-agents](/pl/tools/subagents). + równoległego wykonywania długich zadań (każdy sub-agent zużywa tokeny). Zobacz [Modele](/pl/concepts/models) i + [Sub-agenci](/pl/tools/subagents). - Mocne ostrzeżenie: słabsze / zbyt mocno skwantyzowane modele są bardziej podatne na prompt - injection i niebezpieczne zachowania. Zobacz [Security](/pl/gateway/security). + Mocne ostrzeżenie: słabsze/nadmiernie skwantyzowane modele są bardziej podatne na prompt + injection i niebezpieczne zachowania. Zobacz [Bezpieczeństwo](/pl/gateway/security). - Więcej kontekstu: [Models](/pl/concepts/models). + Więcej kontekstu: [Modele](/pl/concepts/models). - - Używaj **poleceń modelu** albo edytuj tylko pola **modelu**. Unikaj pełnej zamiany konfiguracji. + + Używaj **poleceń modelu** albo edytuj tylko pola **modelu**. Unikaj pełnej wymiany konfiguracji. Bezpieczne opcje: @@ -2244,46 +2246,46 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. - `openclaw configure --section model` (interaktywnie) - edytuj `agents.defaults.model` w `~/.openclaw/openclaw.json` - Unikaj `config.apply` z obiektem częściowym, chyba że zamierzasz zastąpić całą konfigurację. - Przy edycjach RPC najpierw sprawdź przez `config.schema.lookup` i preferuj `config.patch`. Ładunek lookup daje znormalizowaną ścieżkę, płytką dokumentację/ograniczenia schematu oraz podsumowania bezpośrednich dzieci + Unikaj `config.apply` z obiektem częściowym, chyba że chcesz zastąpić całą konfigurację. + W przypadku edycji RPC najpierw sprawdzaj przez `config.schema.lookup` i preferuj `config.patch`. Ładunek lookup zawiera znormalizowaną ścieżkę, płytką dokumentację/ograniczenia schematu oraz podsumowania bezpośrednich elementów podrzędnych dla częściowych aktualizacji. - Jeśli nadpisałeś konfigurację, przywróć ją z kopii zapasowej albo uruchom ponownie `openclaw doctor`, aby ją naprawić. + Jeśli nadpisałeś/-aś konfigurację, przywróć ją z kopii zapasowej albo ponownie uruchom `openclaw doctor`, aby ją naprawić. - Dokumentacja: [Models](/pl/concepts/models), [Configure](/cli/configure), [Config](/cli/config), [Doctor](/pl/gateway/doctor). + Dokumentacja: [Modele](/pl/concepts/models), [Configure](/cli/configure), [Konfiguracja](/cli/config), [Doctor](/pl/gateway/doctor). - Tak. Ollama to najłatwiejsza ścieżka do modeli lokalnych. + Tak. Ollama to najprostsza ścieżka do modeli lokalnych. Najszybsza konfiguracja: 1. Zainstaluj Ollama z `https://ollama.com/download` - 2. Pobierz model lokalny, na przykład `ollama pull gemma4` + 2. Pobierz lokalny model, na przykład `ollama pull gemma4` 3. Jeśli chcesz też modele chmurowe, uruchom `ollama signin` 4. Uruchom `openclaw onboard` i wybierz `Ollama` 5. Wybierz `Local` albo `Cloud + Local` Uwagi: - - `Cloud + Local` daje ci modele chmurowe plus twoje lokalne modele Ollama - - modele chmurowe, takie jak `kimi-k2.5:cloud`, nie wymagają lokalnego pobierania - - do ręcznego przełączania używaj `openclaw models list` i `openclaw models set ollama/` + - `Cloud + Local` daje Ci modele chmurowe plus Twoje lokalne modele Ollama + - modele chmurowe, takie jak `kimi-k2.5:cloud`, nie wymagają lokalnego pobrania + - do ręcznego przełączania używaj `openclaw models list` oraz `openclaw models set ollama/` Uwaga dotycząca bezpieczeństwa: mniejsze lub mocno skwantyzowane modele są bardziej podatne na prompt injection. Zdecydowanie zalecamy **duże modele** dla każdego bota, który może używać narzędzi. Jeśli mimo to chcesz małych modeli, włącz sandboxing i ścisłe allowlisty narzędzi. - Dokumentacja: [Ollama](/pl/providers/ollama), [Local models](/pl/gateway/local-models), - [Model providers](/pl/concepts/model-providers), [Security](/pl/gateway/security), + Dokumentacja: [Ollama](/pl/providers/ollama), [Modele lokalne](/pl/gateway/local-models), + [Dostawcy modeli](/pl/concepts/model-providers), [Bezpieczeństwo](/pl/gateway/security), [Sandboxing](/pl/gateway/sandboxing). - - Te wdrożenia mogą się różnić i zmieniać w czasie; nie ma stałej rekomendacji dotyczącej dostawcy. - - Sprawdź bieżące ustawienie środowiska uruchomieniowego na każdym Gateway przez `openclaw models status`. - - Dla agentów wrażliwych na bezpieczeństwo / z włączonymi narzędziami używaj najmocniejszego dostępnego modelu najnowszej generacji. + - Te wdrożenia mogą się różnić i zmieniać w czasie; nie ma stałej rekomendacji dostawcy. + - Sprawdź bieżące ustawienie środowiska uruchomieniowego na każdym gateway przez `openclaw models status`. + - W przypadku agentów wrażliwych na bezpieczeństwo/z włączonymi narzędziami używaj najmocniejszego modelu najnowszej generacji. @@ -2299,17 +2301,17 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. /model gemini-flash-lite ``` - To są wbudowane aliasy. Własne aliasy można dodać przez `agents.defaults.models`. + To są wbudowane aliasy. Niestandardowe aliasy można dodać przez `agents.defaults.models`. - Możesz wyświetlić dostępne modele przez `/model`, `/model list` lub `/model status`. + Dostępne modele możesz wyświetlić przez `/model`, `/model list` albo `/model status`. - `/model` (i `/model list`) pokazuje kompaktowy, numerowany wybór. Wybierz numerem: + `/model` (oraz `/model list`) pokazuje zwięzły, numerowany selektor. Wybieraj po numerze: ``` /model 3 ``` - Możesz też wymusić określony profil uwierzytelniania dla dostawcy (per sesja): + Możesz też wymusić konkretny profil uwierzytelniania dla dostawcy (per sesja): ``` /model opus@anthropic:default @@ -2317,17 +2319,17 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. ``` Wskazówka: `/model status` pokazuje, który agent jest aktywny, który plik `auth-profiles.json` jest używany i który profil uwierzytelniania zostanie wypróbowany jako następny. - Pokazuje też skonfigurowany endpoint dostawcy (`baseUrl`) i tryb API (`api`), gdy są dostępne. + Pokazuje też skonfigurowany endpoint dostawcy (`baseUrl`) oraz tryb API (`api`), gdy są dostępne. **Jak odpiąć profil ustawiony przez @profile?** - Uruchom `/model` ponownie **bez** sufiksu `@profile`: + Uruchom ponownie `/model` **bez** sufiksu `@profile`: ``` /model anthropic/claude-opus-4-6 ``` - Jeśli chcesz wrócić do domyślnego, wybierz go z `/model` (albo wyślij `/model `). + Jeśli chcesz wrócić do wartości domyślnej, wybierz ją z `/model` (albo wyślij `/model `). Użyj `/model status`, aby potwierdzić, który profil uwierzytelniania jest aktywny. @@ -2335,18 +2337,18 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. Tak. Ustaw jeden jako domyślny i przełączaj w razie potrzeby: - - **Szybkie przełączenie (per sesja):** `/model gpt-5.4` do codziennych zadań, `/model openai-codex/gpt-5.4` do kodowania z Codex OAuth. - - **Domyślny + przełączanie:** ustaw `agents.defaults.model.primary` na `openai/gpt-5.4`, a potem przełączaj na `openai-codex/gpt-5.4` przy kodowaniu (albo odwrotnie). - - **Sub-agenci:** kieruj zadania związane z kodowaniem do sub-agentów z innym modelem domyślnym. + - **Szybkie przełączanie (per sesja):** `/model gpt-5.4` do codziennych zadań, `/model openai-codex/gpt-5.4` do kodowania z Codex OAuth. + - **Domyślny + przełączanie:** ustaw `agents.defaults.model.primary` na `openai/gpt-5.4`, a potem przełączaj na `openai-codex/gpt-5.4` podczas kodowania (albo odwrotnie). + - **Sub-agenci:** kieruj zadania kodowania do sub-agentów z innym modelem domyślnym. - Zobacz [Models](/pl/concepts/models) i [Slash commands](/pl/tools/slash-commands). + Zobacz [Modele](/pl/concepts/models) i [Polecenia slash](/pl/tools/slash-commands). - Użyj przełącznika sesji albo domyślnego ustawienia w konfiguracji: + Użyj przełącznika sesji albo ustawienia domyślnego w konfiguracji: - - **Per sesja:** wyślij `/fast on`, gdy sesja używa `openai/gpt-5.4` lub `openai-codex/gpt-5.4`. + - **Per sesja:** wyślij `/fast on`, gdy sesja używa `openai/gpt-5.4` albo `openai-codex/gpt-5.4`. - **Domyślnie per model:** ustaw `agents.defaults.models["openai/gpt-5.4"].params.fastMode` na `true`. - **Także dla Codex OAuth:** jeśli używasz również `openai-codex/gpt-5.4`, ustaw tam tę samą flagę. @@ -2373,13 +2375,13 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. } ``` - W przypadku OpenAI fast mode mapuje się na `service_tier = "priority"` w obsługiwanych natywnych żądaniach Responses. Sesyjne nadpisania `/fast` mają wyższy priorytet niż ustawienia domyślne w konfiguracji. + Dla OpenAI fast mode mapuje się na `service_tier = "priority"` przy obsługiwanych natywnych żądaniach Responses. Sesyjne nadpisania `/fast` mają wyższy priorytet niż wartości domyślne z konfiguracji. - Zobacz [Thinking and fast mode](/pl/tools/thinking) i [OpenAI fast mode](/pl/providers/openai#openai-fast-mode). + Zobacz [Thinking i fast mode](/pl/tools/thinking) oraz [OpenAI fast mode](/pl/providers/openai#openai-fast-mode). - + Jeśli ustawione jest `agents.defaults.models`, staje się ono **allowlistą** dla `/model` i wszelkich nadpisań sesji. Wybranie modelu, którego nie ma na tej liście, zwraca: @@ -2387,25 +2389,25 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. Model "provider/model" is not allowed. Use /model to list available models. ``` - Ten błąd jest zwracany **zamiast** zwykłej odpowiedzi. Naprawa: dodaj model do + Ten błąd jest zwracany **zamiast** normalnej odpowiedzi. Naprawa: dodaj model do `agents.defaults.models`, usuń allowlistę albo wybierz model z `/model list`. - Oznacza to, że **dostawca nie jest skonfigurowany** (nie znaleziono konfiguracji dostawcy MiniMax ani - profilu uwierzytelniania), więc model nie może zostać rozpoznany. + To oznacza, że **dostawca nie jest skonfigurowany** (nie znaleziono konfiguracji dostawcy MiniMax ani + profilu uwierzytelniania), więc modelu nie da się rozwiązać. Lista kontrolna naprawy: - 1. Zaktualizuj do bieżącego wydania OpenClaw (albo uruchamiaj ze źródłowego `main`), a następnie zrestartuj Gateway. - 2. Upewnij się, że MiniMax jest skonfigurowany (kreator lub JSON) albo że istnieje uwierzytelnianie MiniMax - w env/profilach uwierzytelniania, aby pasujący dostawca mógł zostać wstrzyknięty + 1. Zaktualizuj do bieżącej wersji OpenClaw (albo uruchamiaj ze źródła `main`), a następnie zrestartuj gateway. + 2. Upewnij się, że MiniMax jest skonfigurowany (kreator albo JSON) albo że uwierzytelnianie MiniMax + istnieje w env/profilach uwierzytelniania, aby pasujący dostawca mógł zostać wstrzyknięty (`MINIMAX_API_KEY` dla `minimax`, `MINIMAX_OAUTH_TOKEN` albo zapisane OAuth MiniMax dla `minimax-portal`). - 3. Użyj dokładnego identyfikatora modelu (uwzględniającego wielkość liter) dla swojej ścieżki uwierzytelniania: - `minimax/MiniMax-M2.7` albo `minimax/MiniMax-M2.7-highspeed` dla konfiguracji - z kluczem API, albo `minimax-portal/MiniMax-M2.7` / + 3. Użyj dokładnego identyfikatora modelu (z rozróżnieniem wielkości liter) dla swojej ścieżki uwierzytelniania: + `minimax/MiniMax-M2.7` albo `minimax/MiniMax-M2.7-highspeed` dla konfiguracji z kluczem API, + albo `minimax-portal/MiniMax-M2.7` / `minimax-portal/MiniMax-M2.7-highspeed` dla konfiguracji OAuth. 4. Uruchom: @@ -2415,13 +2417,13 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. i wybierz z listy (albo `/model list` na czacie). - Zobacz [MiniMax](/pl/providers/minimax) i [Models](/pl/concepts/models). + Zobacz [MiniMax](/pl/providers/minimax) i [Modele](/pl/concepts/models). - Tak. Używaj **MiniMax jako domyślnego** i przełączaj modele **per sesja**, kiedy to potrzebne. - Fallbacki są dla **błędów**, a nie dla „trudnych zadań”, więc użyj `/model` albo oddzielnego agenta. + Tak. Użyj **MiniMax jako domyślnego** i przełączaj modele **per sesja** w razie potrzeby. + Fallbacki są dla **błędów**, a nie dla „trudnych zadań”, więc używaj `/model` albo osobnego agenta. **Opcja A: przełączanie per sesja** @@ -2450,13 +2452,13 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. - Agent A domyślnie: MiniMax - Agent B domyślnie: OpenAI - - Kieruj według agenta albo użyj `/agent`, aby się przełączyć + - Kieruj według agenta albo użyj `/agent`, aby przełączyć - Dokumentacja: [Models](/pl/concepts/models), [Multi-Agent Routing](/pl/concepts/multi-agent), [MiniMax](/pl/providers/minimax), [OpenAI](/pl/providers/openai). + Dokumentacja: [Modele](/pl/concepts/models), [Routing wieloagentowy](/pl/concepts/multi-agent), [MiniMax](/pl/providers/minimax), [OpenAI](/pl/providers/openai). - + Tak. OpenClaw dostarcza kilka domyślnych skrótów (stosowanych tylko wtedy, gdy model istnieje w `agents.defaults.models`): - `opus` → `anthropic/claude-opus-4-6` @@ -2468,11 +2470,11 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. - `gemini-flash` → `google/gemini-3-flash-preview` - `gemini-flash-lite` → `google/gemini-3.1-flash-lite-preview` - Jeśli ustawisz własny alias o tej samej nazwie, twoja wartość ma pierwszeństwo. + Jeśli ustawisz własny alias o tej samej nazwie, Twoja wartość ma pierwszeństwo. - + Aliasy pochodzą z `agents.defaults.models..alias`. Przykład: ```json5 @@ -2523,9 +2525,9 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. } ``` - Jeśli odwołasz się do `provider/model`, ale brakuje wymaganego klucza dostawcy, otrzymasz błąd uwierzytelniania w czasie działania (np. `No API key found for provider "zai"`). + Jeśli odwołujesz się do `provider/model`, ale brakuje wymaganego klucza dostawcy, dostaniesz błąd uwierzytelniania w środowisku uruchomieniowym (np. `No API key found for provider "zai"`). - **Po dodaniu nowego agenta pojawia się „No API key found for provider”** + **Nie znaleziono klucza API dla dostawcy po dodaniu nowego agenta** Zwykle oznacza to, że **nowy agent** ma pusty magazyn uwierzytelniania. Uwierzytelnianie jest per agent i jest przechowywane w: @@ -2536,119 +2538,120 @@ pod kątem użycia/rozliczeń i w razie potrzeby zwiększ limity. Opcje naprawy: - - Uruchom `openclaw agents add ` i skonfiguruj uwierzytelnianie w kreatorze. + - Uruchom `openclaw agents add ` i skonfiguruj uwierzytelnianie podczas działania kreatora. - Albo skopiuj `auth-profiles.json` z `agentDir` głównego agenta do `agentDir` nowego agenta. - **Nie** używaj tego samego `agentDir` dla wielu agentów; powoduje to kolizje uwierzytelniania i sesji. + **Nie** używaj ponownie `agentDir` między agentami; powoduje to kolizje uwierzytelniania/sesji. -## Failover modeli i „All models failed” +## Fallback modeli i „All models failed” - Failover działa w dwóch etapach: + Failover odbywa się dwuetapowo: 1. **Rotacja profili uwierzytelniania** w obrębie tego samego dostawcy. 2. **Fallback modelu** do następnego modelu w `agents.defaults.model.fallbacks`. - Do profili kończących się błędami stosowane są cooldowny (wykładniczy backoff), dzięki czemu OpenClaw może nadal odpowiadać nawet wtedy, gdy dostawca ma rate limit albo chwilowo zawodzi. + Dla nieudanych profili stosowane są cooldowny (wykładniczy backoff), dzięki czemu OpenClaw może nadal odpowiadać nawet wtedy, gdy dostawca ma rate limit albo tymczasowo zawodzi. - Bucket rate limit obejmuje coś więcej niż zwykłe odpowiedzi `429`. OpenClaw - traktuje też komunikaty takie jak `Too many concurrent requests`, + Koszyk rate limit obejmuje więcej niż zwykłe odpowiedzi `429`. OpenClaw + traktuje również komunikaty takie jak `Too many concurrent requests`, `ThrottlingException`, `concurrency limit reached`, `workers_ai ... quota limit exceeded`, `resource exhausted` oraz okresowe - limity okna użycia (`weekly/monthly limit reached`) jako - kwalifikujące się do failover rate limity. + limity okien użycia (`weekly/monthly limit reached`) jako + rate limit kwalifikujący się do failover. - Niektóre odpowiedzi wyglądające na związane z rozliczeniami nie mają kodu `402`, a niektóre odpowiedzi HTTP `402` - również pozostają w tym przejściowym bucketcie. Jeśli dostawca zwraca - jawny tekst rozliczeniowy przy `401` lub `403`, OpenClaw nadal może zachować to + Niektóre odpowiedzi wyglądające na rozliczeniowe nie mają kodu `402`, a niektóre odpowiedzi HTTP `402` + również pozostają w tym przejściowym koszyku. Jeśli dostawca zwróci + jawny tekst rozliczeniowy przy `401` albo `403`, OpenClaw nadal może trzymać to w ścieżce rozliczeniowej, ale dopasowania tekstu specyficzne dla dostawcy pozostają ograniczone do dostawcy, który jest ich właścicielem (na przykład OpenRouter `Key limit exceeded`). Jeśli komunikat `402` - wygląda raczej jak okno użycia możliwe do ponowienia próby albo + wygląda natomiast jak ponawialne okno użycia albo limit wydatków organizacji/workspace (`daily limit reached, resets tomorrow`, - `organization spending limit exceeded`), OpenClaw traktuje go jako - `rate_limit`, a nie długotrwałe wyłączenie z powodów rozliczeniowych. + `organization spending limit exceeded`), OpenClaw traktuje to jako + `rate_limit`, a nie długotrwałe wyłączenie rozliczeń. Błędy przepełnienia kontekstu są inne: sygnatury takie jak `request_too_large`, `input exceeds the maximum number of tokens`, `input token count exceeds the maximum number of input tokens`, `input is too long for the model` albo `ollama error: context length - exceeded` pozostają na ścieżce Compaction/ponownej próby zamiast przechodzić do fallbacku modelu. + exceeded` pozostają na ścieżce compaction/retry zamiast uruchamiać + fallback modelu. - Generyczny tekst błędu serwera jest celowo węższy niż „wszystko z - unknown/error w środku”. OpenClaw traktuje jako kwalifikujące się do failover - sygnały timeout/przeciążenia zależne od kontekstu dostawcy, takie jak gołe - `An unknown error occurred` w Anthropic, gołe `Provider returned error` w OpenRouter, - błędy stop-reason takie jak `Unhandled stop reason: + Ogólny tekst błędu serwera jest celowo węższy niż „wszystko, co + zawiera unknown/error”. OpenClaw traktuje jednak przejściowe wzorce zależne od dostawcy, + takie jak samo `An unknown error occurred` z Anthropic, samo + `Provider returned error` z OpenRouter, błędy z powodem zatrzymania typu `Unhandled stop reason: error`, ładunki JSON `api_error` z przejściowym tekstem błędu serwera (`internal server error`, `unknown error, 520`, `upstream error`, `backend - error`) oraz błędy zajętości dostawcy, takie jak `ModelNotReadyException`, gdy kontekst - dostawcy pasuje. + error`) oraz błędy zajętości dostawcy, takie jak `ModelNotReadyException`, jako + sygnały timeout/przeciążenia kwalifikujące się do failover, gdy kontekst dostawcy + pasuje. Ogólny wewnętrzny tekst fallbacku, taki jak `LLM request failed with an unknown - error.`, pozostaje konserwatywny i sam z siebie nie wywołuje fallbacku modelu. + error.`, pozostaje zachowawczy i sam z siebie nie wywołuje fallbacku modelu. - Oznacza to, że system próbował użyć identyfikatora profilu uwierzytelniania `anthropic:default`, ale nie mógł znaleźć poświadczeń dla niego w oczekiwanym magazynie uwierzytelniania. + Oznacza to, że system próbował użyć identyfikatora profilu uwierzytelniania `anthropic:default`, ale nie znalazł dla niego poświadczeń w oczekiwanym magazynie uwierzytelniania. **Lista kontrolna naprawy:** - **Potwierdź, gdzie znajdują się profile uwierzytelniania** (nowe vs starsze ścieżki) - - Bieżąca: `~/.openclaw/agents//agent/auth-profiles.json` - - Starsza: `~/.openclaw/agent/*` (migrowana przez `openclaw doctor`) - - **Potwierdź, że twoja zmienna środowiskowa jest załadowana przez Gateway** - - Jeśli ustawisz `ANTHROPIC_API_KEY` w swojej powłoce, ale uruchamiasz Gateway przez systemd/launchd, może jej nie dziedziczyć. Umieść ją w `~/.openclaw/.env` albo włącz `env.shellEnv`. + - Obecnie: `~/.openclaw/agents//agent/auth-profiles.json` + - Starsze: `~/.openclaw/agent/*` (migrowane przez `openclaw doctor`) + - **Potwierdź, że zmienna środowiskowa jest ładowana przez Gateway** + - Jeśli ustawisz `ANTHROPIC_API_KEY` w swojej powłoce, ale uruchamiasz Gateway przez systemd/launchd, może jej nie odziedziczyć. Umieść ją w `~/.openclaw/.env` albo włącz `env.shellEnv`. - **Upewnij się, że edytujesz właściwego agenta** - - Konfiguracje multi-agent oznaczają, że może istnieć wiele plików `auth-profiles.json`. - - **Sprawdzenie podstawowe stanu modelu/uwierzytelniania** + - W konfiguracjach wieloagentowych może istnieć wiele plików `auth-profiles.json`. + - **Sprawdź poprawność stanu modelu/uwierzytelniania** - Użyj `openclaw models status`, aby zobaczyć skonfigurowane modele i to, czy dostawcy są uwierzytelnieni. **Lista kontrolna naprawy dla „No credentials found for profile anthropic”** Oznacza to, że uruchomienie jest przypięte do profilu uwierzytelniania Anthropic, ale Gateway - nie może go znaleźć w swoim magazynie uwierzytelniania. + nie może znaleźć go w swoim magazynie uwierzytelniania. - **Użyj Claude CLI** - - Uruchom `openclaw models auth login --provider anthropic --method cli --set-default` na hoście Gateway. + - Uruchom `openclaw models auth login --provider anthropic --method cli --set-default` na hoście gateway. - **Jeśli zamiast tego chcesz używać klucza API** - - Umieść `ANTHROPIC_API_KEY` w `~/.openclaw/.env` na **hoście Gateway**. - - Wyczyść wszelką przypiętą kolejność wymuszającą brakujący profil: + - Umieść `ANTHROPIC_API_KEY` w `~/.openclaw/.env` na **hoście gateway**. + - Wyczyść każde przypięte uporządkowanie, które wymusza brakujący profil: ```bash openclaw models auth order clear --provider anthropic ``` - - **Potwierdź, że uruchamiasz polecenia na hoście Gateway** - - W trybie zdalnym profile uwierzytelniania znajdują się na maszynie Gateway, a nie na twoim laptopie. + - **Potwierdź, że uruchamiasz polecenia na hoście gateway** + - W trybie zdalnym profile uwierzytelniania znajdują się na maszynie gateway, a nie na Twoim laptopie. - - Jeśli konfiguracja twojego modelu obejmuje Google Gemini jako fallback (albo przełączyłeś się na skrót Gemini), OpenClaw spróbuje go podczas fallbacku modelu. Jeśli nie skonfigurowałeś poświadczeń Google, zobaczysz `No API key found for provider "google"`. + + Jeśli konfiguracja modelu zawiera Google Gemini jako fallback (albo przełączyłeś/-aś się na skrót Gemini), OpenClaw spróbuje go podczas fallbacku modelu. Jeśli nie skonfigurowałeś/-aś poświadczeń Google, zobaczysz `No API key found for provider "google"`. Naprawa: albo podaj uwierzytelnianie Google, albo usuń/unikaj modeli Google w `agents.defaults.model.fallbacks` / aliasach, aby fallback tam nie kierował. **LLM request rejected: thinking signature required (Google Antigravity)** - Przyczyna: historia sesji zawiera **bloki thinking bez podpisów** (często z - przerwanego/niepełnego streamu). Google Antigravity wymaga podpisów dla bloków thinking. + Przyczyna: historia sesji zawiera **bloki thinking bez sygnatur** (często z + przerwanego/częściowego strumienia). Google Antigravity wymaga sygnatur dla bloków thinking. - Naprawa: OpenClaw usuwa teraz niepodpisane bloki thinking dla Google Antigravity Claude. Jeśli nadal się pojawia, rozpocznij **nową sesję** albo ustaw `/thinking off` dla tego agenta. + Naprawa: OpenClaw teraz usuwa niepodpisane bloki thinking dla Claude Google Antigravity. Jeśli nadal się pojawia, rozpocznij **nową sesję** albo ustaw `/thinking off` dla tego agenta. ## Profile uwierzytelniania: czym są i jak nimi zarządzać -Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywanie tokenów, wzorce dla wielu kont) +Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywanie tokenów, wzorce wielu kont) - Profil uwierzytelniania to nazwany rekord poświadczeń (OAuth lub klucz API) powiązany z dostawcą. Profile znajdują się w: + Profil uwierzytelniania to nazwany rekord poświadczeń (OAuth albo klucz API) powiązany z dostawcą. Profile znajdują się w: ``` ~/.openclaw/agents//agent/auth-profiles.json @@ -2661,29 +2664,29 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa - `anthropic:default` (częste, gdy nie istnieje tożsamość e-mail) - `anthropic:` dla tożsamości OAuth - - własne identyfikatory, które wybierzesz (np. `anthropic:work`) + - niestandardowe identyfikatory wybrane przez Ciebie (np. `anthropic:work`) - + Tak. Konfiguracja obsługuje opcjonalne metadane profili i kolejność per dostawca (`auth.order.`). To **nie** przechowuje sekretów; mapuje identyfikatory na dostawcę/tryb i ustawia kolejność rotacji. - OpenClaw może tymczasowo pominąć profil, jeśli jest w krótkim **cooldownie** (rate limity/timeouty/błędy uwierzytelniania) albo w dłuższym stanie **disabled** (rozliczenia/niewystarczające środki). Aby to sprawdzić, uruchom `openclaw models status --json` i sprawdź `auth.unusableProfiles`. Strojenie: `auth.cooldowns.billingBackoffHours*`. + OpenClaw może tymczasowo pominąć profil, jeśli jest w krótkim **cooldownie** (rate limit, timeouty, błędy uwierzytelniania) albo w dłuższym stanie **disabled** (rozliczenia/niewystarczające środki). Aby to sprawdzić, uruchom `openclaw models status --json` i sprawdź `auth.unusableProfiles`. Strojenie: `auth.cooldowns.billingBackoffHours*`. Cooldowny rate limit mogą być ograniczone do modelu. Profil, który jest w cooldownie - dla jednego modelu, może nadal być używalny dla siostrzanego modelu u tego samego dostawcy, + dla jednego modelu, może nadal nadawać się do użycia dla sąsiedniego modelu u tego samego dostawcy, podczas gdy okna billing/disabled nadal blokują cały profil. - Możesz też ustawić nadpisanie kolejności **per agent** (przechowywane w `auth-state.json` tego agenta) przez CLI: + Możesz także ustawić nadpisanie kolejności **per agent** (przechowywane w `auth-state.json` tego agenta) przez CLI: ```bash - # Domyślnie używa skonfigurowanego agenta domyślnego (pomiń --agent) + # Domyślnie dotyczy skonfigurowanego agenta domyślnego (pomiń --agent) openclaw models auth order get --provider anthropic - # Zablokuj rotację do jednego profilu (próbuj tylko tego jednego) + # Zablokuj rotację do jednego profilu (próbuj tylko tego) openclaw models auth order set --provider anthropic anthropic:default - # Albo ustaw jawną kolejność (fallback w obrębie dostawcy) + # Albo ustaw jawny porządek (fallback w obrębie dostawcy) openclaw models auth order set --provider anthropic anthropic:work anthropic:default # Wyczyść nadpisanie (powrót do config auth.order / round-robin) @@ -2696,24 +2699,24 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa openclaw models auth order set --provider anthropic --agent main anthropic:default ``` - Aby sprawdzić, co faktycznie będzie próbowane, użyj: + Aby zweryfikować, co faktycznie będzie próbowane, użyj: ```bash openclaw models status --probe ``` - Jeśli zapisany profil jest pominięty w jawnej kolejności, sonda zgłasza + Jeśli zapisany profil zostanie pominięty w jawnym porządku, probe raportuje `excluded_by_auth_order` dla tego profilu zamiast próbować go po cichu. - OpenClaw obsługuje oba podejścia: + OpenClaw obsługuje oba warianty: - - **OAuth** często wykorzystuje dostęp subskrypcyjny (tam, gdzie ma to zastosowanie). - - **Klucze API** używają rozliczania pay-per-token. + - **OAuth** często wykorzystuje dostęp subskrypcyjny (tam, gdzie ma zastosowanie). + - **Klucze API** używają rozliczania za token. - Kreator jawnie obsługuje Anthropic Claude CLI, OpenAI Codex OAuth i klucze API. + Kreator jawnie obsługuje Anthropic Claude CLI, OpenAI Codex OAuth oraz klucze API. @@ -2722,29 +2725,29 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa - `gateway.port` kontroluje pojedynczy multipleksowany port dla WebSocket + HTTP (Control UI, hooki itd.). + `gateway.port` steruje pojedynczym multipleksowanym portem dla WebSocket + HTTP (Control UI, hooki itd.). Priorytet: ``` - --port > OPENCLAW_GATEWAY_PORT > gateway.port > default 18789 + --port > OPENCLAW_GATEWAY_PORT > gateway.port > domyślnie 18789 ``` - Ponieważ „running” to widok **supervisora** (launchd/systemd/schtasks). Sonda RPC oznacza, że CLI faktycznie łączy się z Gateway WebSocket i wywołuje `status`. + Ponieważ „running” to widok **supervisora** (launchd/systemd/schtasks). Sonda RPC to CLI, które faktycznie łączy się z gateway WebSocket i wywołuje `status`. Użyj `openclaw gateway status` i ufaj tym liniom: - `Probe target:` (URL, którego sonda faktycznie użyła) - - `Listening:` (co faktycznie nasłuchuje na porcie) - - `Last gateway error:` (częsta przyczyna źródłowa, gdy proces żyje, ale port nie nasłuchuje) + - `Listening:` (co jest faktycznie zbindowane na porcie) + - `Last gateway error:` (częsta przyczyna źródłowa, gdy proces działa, ale port nie nasłuchuje) - - Edytujesz jeden plik konfiguracyjny, podczas gdy usługa działa na innym (często jest to niedopasowanie `--profile` / `OPENCLAW_STATE_DIR`). + + Edytujesz jeden plik konfiguracyjny, podczas gdy usługa działa na innym (często chodzi o niedopasowanie `--profile` / `OPENCLAW_STATE_DIR`). Naprawa: @@ -2752,19 +2755,19 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa openclaw gateway install --force ``` - Uruchom to z tego samego `--profile` / środowiska, którego ma używać usługa. + Uruchom to z tego samego `--profile` / środowiska, którego usługa ma używać. - OpenClaw wymusza blokadę środowiska uruchomieniowego przez natychmiastowe powiązanie nasłuchiwania WebSocket przy starcie (domyślnie `ws://127.0.0.1:18789`). Jeśli powiązanie nie powiedzie się z `EADDRINUSE`, zgłaszany jest `GatewayLockError`, wskazujący, że inna instancja już nasłuchuje. + OpenClaw wymusza blokadę środowiska uruchomieniowego przez natychmiastowe zbindowanie listenera WebSocket przy starcie (domyślnie `ws://127.0.0.1:18789`). Jeśli bind zwróci błąd `EADDRINUSE`, rzucany jest `GatewayLockError`, wskazujący, że inna instancja już nasłuchuje. Naprawa: zatrzymaj drugą instancję, zwolnij port albo uruchom z `openclaw gateway --port `. - - Ustaw `gateway.mode: "remote"` i wskaż zdalny URL WebSocket, opcjonalnie z poświadczeniami zdalnymi opartymi na wspólnym sekrecie: + + Ustaw `gateway.mode: "remote"` i wskaż zdalny URL WebSocket, opcjonalnie ze zdalnymi poświadczeniami wspólnego sekretu: ```json5 { @@ -2781,54 +2784,54 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa Uwagi: - - `openclaw gateway` uruchamia się tylko wtedy, gdy `gateway.mode` ma wartość `local` (albo przekażesz flagę nadpisującą). - - Aplikacja macOS obserwuje plik konfiguracji i przełącza tryby na żywo, gdy te wartości się zmieniają. - - `gateway.remote.token` / `.password` to tylko poświadczenia zdalne po stronie klienta; same w sobie nie włączają lokalnego uwierzytelniania Gateway. + - `openclaw gateway` uruchamia się tylko wtedy, gdy `gateway.mode` ma wartość `local` (albo przekażesz flagę nadpisania). + - Aplikacja macOS obserwuje plik konfiguracyjny i przełącza tryby na żywo, gdy te wartości się zmieniają. + - `gateway.remote.token` / `.password` to tylko zdalne poświadczenia po stronie klienta; same z siebie nie włączają lokalnego uwierzytelniania gateway. - - Ścieżka uwierzytelniania Gateway i metoda uwierzytelniania UI nie pasują do siebie. + + Ścieżka uwierzytelniania Twojego gateway i metoda uwierzytelniania UI nie pasują do siebie. Fakty (z kodu): - - Control UI przechowuje token w `sessionStorage` dla bieżącej sesji karty przeglądarki i wybranego URL Gateway, więc odświeżenia w tej samej karcie nadal działają bez przywracania długotrwałego przechowywania tokenu w localStorage. - - Przy `AUTH_TOKEN_MISMATCH` zaufani klienci mogą wykonać jedną ograniczoną ponowną próbę z użyciem pamiętanego tokenu urządzenia, gdy Gateway zwróci wskazówki do ponowienia (`canRetryWithDeviceToken=true`, `recommendedNextStep=retry_with_device_token`). - - Ta ponowna próba z tokenem z cache używa teraz ponownie zatwierdzonych zakresów zapisanych wraz z tokenem urządzenia. Wywołania z jawnym `deviceToken` / jawnymi `scopes` nadal zachowują żądany zestaw zakresów zamiast dziedziczyć zakresy z cache. + - Control UI przechowuje token w `sessionStorage` dla bieżącej sesji karty przeglądarki i wybranego URL gateway, więc odświeżenia tej samej karty nadal działają bez przywracania trwałego przechowywania tokena w localStorage. + - Przy `AUTH_TOKEN_MISMATCH` zaufani klienci mogą wykonać jedną ograniczoną ponowną próbę z użyciem zbuforowanego tokena urządzenia, gdy gateway zwraca wskazówki ponowienia (`canRetryWithDeviceToken=true`, `recommendedNextStep=retry_with_device_token`). + - To ponowienie z użyciem zbuforowanego tokena wykorzystuje teraz ponownie zbuforowane zatwierdzone zakresy przechowywane z tokenem urządzenia. Wywołania z jawnym `deviceToken` / jawnymi `scopes` nadal zachowują żądany zestaw zakresów zamiast dziedziczyć zakresy z pamięci podręcznej. - Poza tą ścieżką ponowienia priorytet uwierzytelniania połączenia wygląda następująco: najpierw jawny współdzielony token/hasło, potem jawny `deviceToken`, potem zapisany token urządzenia, a na końcu token bootstrap. - - Kontrole zakresu tokenu bootstrap są prefiksowane rolą. Wbudowana allowlista operatora dla bootstrap spełnia tylko żądania operatora; Node lub inne role niebędące operatorem nadal potrzebują zakresów pod własnym prefiksem roli. + - Kontrole zakresu tokena bootstrap mają prefiksy ról. Wbudowana allowlista operatora bootstrap spełnia tylko żądania operatora; node lub inne role niebędące operatorem nadal wymagają zakresów pod własnym prefiksem roli. Naprawa: - - Najszybciej: `openclaw dashboard` (wypisuje i kopiuje URL dashboardu, próbuje otworzyć; przy trybie headless pokazuje wskazówkę SSH). - - Jeśli nie masz jeszcze tokenu: `openclaw doctor --generate-gateway-token`. + - Najszybciej: `openclaw dashboard` (wypisuje + kopiuje URL dashboardu, próbuje otworzyć; pokazuje wskazówkę SSH, jeśli działa bez interfejsu graficznego). + - Jeśli nie masz jeszcze tokena: `openclaw doctor --generate-gateway-token`. - Jeśli zdalnie, najpierw utwórz tunel: `ssh -N -L 18789:127.0.0.1:18789 user@host`, a następnie otwórz `http://127.0.0.1:18789/`. - Tryb wspólnego sekretu: ustaw `gateway.auth.token` / `OPENCLAW_GATEWAY_TOKEN` albo `gateway.auth.password` / `OPENCLAW_GATEWAY_PASSWORD`, a następnie wklej pasujący sekret w ustawieniach Control UI. - - Tryb Tailscale Serve: upewnij się, że `gateway.auth.allowTailscale` jest włączone i że otwierasz URL Serve, a nie surowy URL loopback/tailnet, który omija nagłówki tożsamości Tailscale. - - Tryb trusted-proxy: upewnij się, że łączysz się przez skonfigurowane, świadome tożsamości proxy inne niż loopback, a nie przez proxy loopback na tym samym hoście ani surowy URL Gateway. - - Jeśli niedopasowanie utrzymuje się po tej jednej próbie, obróć / ponownie zatwierdź sparowany token urządzenia: + - Tryb Tailscale Serve: upewnij się, że `gateway.auth.allowTailscale` jest włączone i że otwierasz URL Serve, a nie surowy URL loopback/tailnet omijający nagłówki tożsamości Tailscale. + - Tryb trusted-proxy: upewnij się, że ruch przechodzi przez skonfigurowane proxy ze świadomością tożsamości spoza loopback, a nie przez proxy loopback na tym samym hoście ani surowy URL gateway. + - Jeśli niedopasowanie utrzymuje się po jednej próbie ponowienia, obróć/ponownie zatwierdź sparowany token urządzenia: - `openclaw devices list` - `openclaw devices rotate --device --role operator` - - Jeśli to wywołanie rotate mówi, że zostało odrzucone, sprawdź dwie rzeczy: - - sesje sparowanego urządzenia mogą obracać tylko **własne** urządzenie, chyba że mają też `operator.admin` - - jawne wartości `--scope` nie mogą przekraczać bieżących zakresów operatora wywołującego - - Nadal utknąłeś? Uruchom `openclaw status --all` i postępuj zgodnie z [Troubleshooting](/pl/gateway/troubleshooting). Szczegóły uwierzytelniania znajdziesz w [Dashboard](/web/dashboard). + - Jeśli to polecenie rotate mówi, że zostało odrzucone, sprawdź dwie rzeczy: + - sesje sparowanych urządzeń mogą obracać tylko **własne** urządzenie, chyba że mają też `operator.admin` + - jawne wartości `--scope` nie mogą wykraczać poza bieżące zakresy operatora wywołującego + - Nadal utknąłeś/utknęłaś? Uruchom `openclaw status --all` i postępuj zgodnie z [Rozwiązywanie problemów](/pl/gateway/troubleshooting). Szczegóły uwierzytelniania znajdziesz w [Dashboard](/web/dashboard). - - Powiązanie `tailnet` wybiera adres IP Tailscale z interfejsów sieciowych (100.64.0.0/10). Jeśli maszyna nie jest w Tailscale (albo interfejs nie działa), nie ma do czego się powiązać. + + Bind `tailnet` wybiera adres IP Tailscale z interfejsów sieciowych (100.64.0.0/10). Jeśli maszyna nie jest w Tailscale (albo interfejs nie działa), nie ma do czego się zbindować. Naprawa: - - Uruchom Tailscale na tym hoście (aby miał adres 100.x), albo + - Uruchom Tailscale na tym hoście (tak aby miał adres 100.x), albo - Przełącz na `gateway.bind: "loopback"` / `"lan"`. - Uwaga: `tailnet` jest jawne. `auto` preferuje loopback; użyj `gateway.bind: "tailnet"`, gdy chcesz powiązania tylko z tailnet. + Uwaga: `tailnet` jest jawne. `auto` preferuje loopback; użyj `gateway.bind: "tailnet"`, gdy chcesz bind tylko do tailnet. - + Zwykle nie — jeden Gateway może obsługiwać wiele kanałów komunikacyjnych i agentów. Używaj wielu Gateway tylko wtedy, gdy potrzebujesz redundancji (np. rescue bot) albo twardej izolacji. Tak, ale musisz odizolować: @@ -2845,24 +2848,24 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa - Zainstaluj usługę per profil: `openclaw --profile gateway install`. Profile dodają też sufiksy do nazw usług (`ai.openclaw.`; starsze `com.openclaw.*`, `openclaw-gateway-.service`, `OpenClaw Gateway ()`). - Pełny przewodnik: [Multiple gateways](/pl/gateway/multiple-gateways). + Pełny przewodnik: [Wiele gateway](/pl/gateway/multiple-gateways). - Gateway to **serwer WebSocket** i oczekuje, że pierwszą wiadomością - będzie ramka `connect`. Jeśli otrzyma cokolwiek innego, zamyka połączenie + Gateway jest **serwerem WebSocket** i oczekuje, że pierwsza wiadomość będzie + ramką `connect`. Jeśli otrzyma coś innego, zamyka połączenie kodem **1008** (naruszenie zasad). Typowe przyczyny: - - Otworzyłeś adres **HTTP** w przeglądarce (`http://...`) zamiast klienta WS. - - Użyłeś niewłaściwego portu lub ścieżki. - - Proxy albo tunel usunęły nagłówki uwierzytelniania albo wysłały żądanie inne niż do Gateway. + - Otworzyłeś/-aś adres **HTTP** w przeglądarce (`http://...`) zamiast klienta WS. + - Użyto niewłaściwego portu lub ścieżki. + - Proxy lub tunel usunęły nagłówki uwierzytelniania albo wysłały żądanie niebędące żądaniem Gateway. - Szybkie naprawy: + Szybkie poprawki: - 1. Użyj adresu WS: `ws://:18789` (albo `wss://...`, jeśli HTTPS). + 1. Użyj URL WS: `ws://:18789` (albo `wss://...`, jeśli HTTPS). 2. Nie otwieraj portu WS w zwykłej karcie przeglądarki. 3. Jeśli uwierzytelnianie jest włączone, dołącz token/hasło w ramce `connect`. @@ -2872,12 +2875,12 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa openclaw tui --url ws://:18789 --token ``` - Szczegóły protokołu: [Gateway protocol](/pl/gateway/protocol). + Szczegóły protokołu: [Protokół Gateway](/pl/gateway/protocol). -## Logowanie i debugowanie +## Rejestrowanie i debugowanie @@ -2887,42 +2890,42 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa /tmp/openclaw/openclaw-YYYY-MM-DD.log ``` - Możesz ustawić stałą ścieżkę przez `logging.file`. Poziom logów plikowych jest kontrolowany przez `logging.level`. Szczegółowość konsoli jest kontrolowana przez `--verbose` i `logging.consoleLevel`. + Możesz ustawić stałą ścieżkę przez `logging.file`. Poziom logów plikowych jest sterowany przez `logging.level`. Szczegółowość konsoli jest sterowana przez `--verbose` i `logging.consoleLevel`. - Najszybsze śledzenie logów: + Najszybsze śledzenie logu: ```bash openclaw logs --follow ``` - Logi usługi/supervisora (gdy Gateway działa przez launchd/systemd): + Logi usługi/supervisora (gdy gateway działa przez launchd/systemd): - macOS: `$OPENCLAW_STATE_DIR/logs/gateway.log` i `gateway.err.log` (domyślnie: `~/.openclaw/logs/...`; profile używają `~/.openclaw-/logs/...`) - Linux: `journalctl --user -u openclaw-gateway[-].service -n 200 --no-pager` - Windows: `schtasks /Query /TN "OpenClaw Gateway ()" /V /FO LIST` - Więcej informacji znajdziesz w [Troubleshooting](/pl/gateway/troubleshooting). + Więcej informacji znajdziesz w [Rozwiązywanie problemów](/pl/gateway/troubleshooting). - - Użyj pomocników gateway: + + Użyj pomocniczych poleceń gateway: ```bash openclaw gateway status openclaw gateway restart ``` - Jeśli uruchamiasz Gateway ręcznie, `openclaw gateway --force` może przejąć port. Zobacz [Gateway](/pl/gateway). + Jeśli uruchamiasz gateway ręcznie, `openclaw gateway --force` może przejąć port. Zobacz [Gateway](/pl/gateway). - + Istnieją **dwa tryby instalacji w Windows**: - **1) WSL2 (zalecane):** Gateway działa wewnątrz Linux. + **1) WSL2 (zalecane):** Gateway działa wewnątrz Linuxa. - Otwórz PowerShell, wejdź do WSL, a następnie wykonaj restart: + Otwórz PowerShell, wejdź do WSL, a następnie zrestartuj: ```powershell wsl @@ -2930,7 +2933,7 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa openclaw gateway restart ``` - Jeśli nigdy nie zainstalowałeś usługi, uruchom go na pierwszym planie: + Jeśli nigdy nie instalowałeś/-aś usługi, uruchom ją na pierwszym planie: ```bash openclaw gateway run @@ -2951,12 +2954,12 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa openclaw gateway run ``` - Dokumentacja: [Windows (WSL2)](/pl/platforms/windows), [Gateway service runbook](/pl/gateway). + Dokumentacja: [Windows (WSL2)](/pl/platforms/windows), [Runbook usługi Gateway](/pl/gateway). - - Zacznij od szybkiego sprawdzenia kondycji: + + Zacznij od szybkiego przeglądu kondycji: ```bash openclaw status @@ -2967,14 +2970,14 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa Typowe przyczyny: - - Uwierzytelnianie modelu nie zostało załadowane na **hoście Gateway** (sprawdź `models status`). - - Parowanie kanału / allowlist blokują odpowiedzi (sprawdź konfigurację kanału + logi). - - WebChat/Dashboard jest otwarty bez właściwego tokenu. + - Uwierzytelnianie modelu nie zostało załadowane na **hoście gateway** (sprawdź `models status`). + - Parowanie kanału/allowlista blokuje odpowiedzi (sprawdź konfigurację kanału + logi). + - WebChat/Dashboard jest otwarty bez właściwego tokena. - Jeśli działasz zdalnie, potwierdź, że tunel / połączenie Tailscale działa i że + Jeśli działasz zdalnie, potwierdź, że tunel/połączenie Tailscale działa i że Gateway WebSocket jest osiągalny. - Dokumentacja: [Channels](/pl/channels), [Troubleshooting](/pl/gateway/troubleshooting), [Remote access](/pl/gateway/remote). + Dokumentacja: [Kanały](/pl/channels), [Rozwiązywanie problemów](/pl/gateway/troubleshooting), [Dostęp zdalny](/pl/gateway/remote). @@ -2984,7 +2987,7 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa 1. Czy Gateway działa? `openclaw gateway status` 2. Czy Gateway jest zdrowy? `openclaw status` 3. Czy UI ma właściwy token? `openclaw dashboard` - 4. Jeśli zdalnie, czy tunel / połączenie Tailscale działa? + 4. Jeśli zdalnie, czy tunel/połączenie Tailscale działa? Następnie śledź logi: @@ -2992,11 +2995,11 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa openclaw logs --follow ``` - Dokumentacja: [Dashboard](/web/dashboard), [Remote access](/pl/gateway/remote), [Troubleshooting](/pl/gateway/troubleshooting). + Dokumentacja: [Dashboard](/web/dashboard), [Dostęp zdalny](/pl/gateway/remote), [Rozwiązywanie problemów](/pl/gateway/troubleshooting). - + Zacznij od logów i statusu kanału: ```bash @@ -3006,16 +3009,16 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa Następnie dopasuj błąd: - - `BOT_COMMANDS_TOO_MUCH`: menu Telegram ma zbyt wiele wpisów. OpenClaw już przycina je do limitu Telegram i ponawia próbę z mniejszą liczbą poleceń, ale niektóre wpisy nadal trzeba usunąć. Ogranicz polecenia pluginów/Skills/własne albo wyłącz `channels.telegram.commands.native`, jeśli nie potrzebujesz menu. - - `TypeError: fetch failed`, `Network request for 'setMyCommands' failed!` lub podobne błędy sieciowe: jeśli jesteś na VPS albo za proxy, potwierdź, że wychodzący HTTPS jest dozwolony i że DNS działa dla `api.telegram.org`. + - `BOT_COMMANDS_TOO_MUCH`: menu Telegram ma zbyt wiele wpisów. OpenClaw już przycina je do limitu Telegram i ponawia próbę z mniejszą liczbą poleceń, ale niektóre wpisy menu nadal trzeba usunąć. Ogranicz polecenia Plugin/Skill/niestandardowe albo wyłącz `channels.telegram.commands.native`, jeśli nie potrzebujesz menu. + - `TypeError: fetch failed`, `Network request for 'setMyCommands' failed!` albo podobne błędy sieciowe: jeśli jesteś na VPS albo za proxy, potwierdź, że wychodzące HTTPS jest dozwolone i DNS działa dla `api.telegram.org`. - Jeśli Gateway jest zdalny, upewnij się, że patrzysz na logi na hoście Gateway. + Jeśli Gateway jest zdalny, upewnij się, że sprawdzasz logi na hoście Gateway. - Dokumentacja: [Telegram](/pl/channels/telegram), [Channel troubleshooting](/pl/channels/troubleshooting). + Dokumentacja: [Telegram](/pl/channels/telegram), [Rozwiązywanie problemów z kanałami](/pl/channels/troubleshooting). - + Najpierw potwierdź, że Gateway jest osiągalny i agent może działać: ```bash @@ -3024,45 +3027,45 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa openclaw logs --follow ``` - W TUI użyj `/status`, aby zobaczyć bieżący stan. Jeśli oczekujesz odpowiedzi na czacie - kanału, upewnij się, że dostarczanie jest włączone (`/deliver on`). + W TUI użyj `/status`, aby zobaczyć bieżący stan. Jeśli oczekujesz odpowiedzi w kanale + czatu, upewnij się, że dostarczanie jest włączone (`/deliver on`). - Dokumentacja: [TUI](/web/tui), [Slash commands](/pl/tools/slash-commands). + Dokumentacja: [TUI](/web/tui), [Polecenia slash](/pl/tools/slash-commands). - Jeśli zainstalowałeś usługę: + Jeśli zainstalowałeś/-aś usługę: ```bash openclaw gateway stop openclaw gateway start ``` - To zatrzymuje / uruchamia **nadzorowaną usługę** (launchd w macOS, systemd w Linux). + To zatrzymuje/uruchamia **nadzorowaną usługę** (launchd w macOS, systemd w Linuxie). Używaj tego, gdy Gateway działa w tle jako demon. - Jeśli uruchamiasz na pierwszym planie, zatrzymaj przez Ctrl-C, a następnie: + Jeśli uruchamiasz w pierwszym planie, zatrzymaj przez Ctrl-C, a następnie: ```bash openclaw gateway run ``` - Dokumentacja: [Gateway service runbook](/pl/gateway). + Dokumentacja: [Runbook usługi Gateway](/pl/gateway). - + - `openclaw gateway restart`: restartuje **usługę działającą w tle** (launchd/systemd). - - `openclaw gateway`: uruchamia Gateway **na pierwszym planie** dla tej sesji terminala. + - `openclaw gateway`: uruchamia gateway **w pierwszym planie** dla tej sesji terminala. - Jeśli zainstalowałeś usługę, używaj poleceń gateway. Używaj `openclaw gateway`, gdy - chcesz jednorazowego uruchomienia na pierwszym planie. + Jeśli masz zainstalowaną usługę, używaj poleceń gateway. Używaj `openclaw gateway`, gdy + chcesz jednorazowego uruchomienia w pierwszym planie. - - Uruchom Gateway z `--verbose`, aby uzyskać bardziej szczegółowe informacje w konsoli. Następnie sprawdź plik logu pod kątem uwierzytelniania kanału, rutingu modelu i błędów RPC. + + Uruchom Gateway z `--verbose`, aby uzyskać więcej szczegółów w konsoli. Następnie sprawdź plik logu pod kątem uwierzytelniania kanału, routingu modelu i błędów RPC. @@ -3070,7 +3073,7 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa - Wychodzące załączniki od agenta muszą zawierać wiersz `MEDIA:` (w osobnym wierszu). Zobacz [OpenClaw assistant setup](/pl/start/openclaw) i [Agent send](/pl/tools/agent-send). + Wychodzące załączniki od agenta muszą zawierać linię `MEDIA:` (w osobnej linii). Zobacz [Konfiguracja asystenta OpenClaw](/pl/start/openclaw) i [Wysyłanie przez agenta](/pl/tools/agent-send). Wysyłanie przez CLI: @@ -3080,12 +3083,12 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa Sprawdź też: - - Czy docelowy kanał obsługuje media wychodzące i nie jest blokowany przez allowlisty. - - Czy plik mieści się w limitach rozmiaru dostawcy (obrazy są zmniejszane do maks. 2048 px). - - `tools.fs.workspaceOnly=true` ogranicza wysyłanie ścieżek lokalnych do workspace, temp/media-store i plików zwalidowanych przez sandbox. + - Kanał docelowy obsługuje wysyłanie multimediów i nie jest blokowany przez allowlisty. + - Plik mieści się w limitach rozmiaru dostawcy (obrazy są zmniejszane maksymalnie do 2048 px). + - `tools.fs.workspaceOnly=true` ogranicza wysyłanie ścieżek lokalnych do workspace, temp/media-store i plików zweryfikowanych przez sandbox. - `tools.fs.workspaceOnly=false` pozwala `MEDIA:` wysyłać lokalne pliki hosta, które agent już może odczytać, ale tylko dla multimediów oraz bezpiecznych typów dokumentów (obrazy, audio, wideo, PDF i dokumenty Office). Zwykły tekst i pliki przypominające sekrety są nadal blokowane. - Zobacz [Images](/pl/nodes/images). + Zobacz [Obrazy](/pl/nodes/images). @@ -3093,72 +3096,72 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa ## Bezpieczeństwo i kontrola dostępu - - Traktuj przychodzące DM jako niezaufane dane wejściowe. Ustawienia domyślne zostały zaprojektowane tak, aby zmniejszać ryzyko: + + Traktuj przychodzące DM jako niezaufane dane wejściowe. Wartości domyślne są zaprojektowane tak, aby zmniejszać ryzyko: - - Domyślne zachowanie w kanałach obsługujących DM to **pairing**: - - Nieznani nadawcy otrzymują kod parowania; bot nie przetwarza ich wiadomości. + - Domyślne zachowanie na kanałach obsługujących DM to **pairing**: + - Nieznani nadawcy otrzymują kod pairing; bot nie przetwarza ich wiadomości. - Zatwierdź przez: `openclaw pairing approve --channel [--account ] ` - Oczekujące żądania są ograniczone do **3 na kanał**; sprawdź `openclaw pairing list --channel [--account ]`, jeśli kod nie dotarł. - - Publiczne otwarcie DM wymaga jawnego opt-in (`dmPolicy: "open"` i allowlisty `"*"`). + - Publiczne otwarcie DM wymaga jawnego opt-in (`dmPolicy: "open"` i allowlista `"*"`). - Uruchom `openclaw doctor`, aby wykryć ryzykowne polityki DM. + Uruchom `openclaw doctor`, aby wykryć ryzykowne zasady DM. Nie. Prompt injection dotyczy **niezaufanej treści**, a nie tylko tego, kto może wysłać DM do bota. - Jeśli twój asystent odczytuje zewnętrzną treść (wyszukiwanie/pobieranie z sieci, strony w przeglądarce, e-maile, + Jeśli Twój asystent odczytuje zewnętrzne treści (web search/fetch, strony w przeglądarce, e-maile, dokumenty, załączniki, wklejone logi), ta treść może zawierać instrukcje próbujące - przejąć kontrolę nad modelem. Może się to zdarzyć, nawet jeśli **ty jesteś jedynym nadawcą**. + przejąć model. Może się to zdarzyć, nawet jeśli **Ty jesteś jedynym nadawcą**. - Największe ryzyko pojawia się, gdy włączone są narzędzia: model może zostać nakłoniony do - wycieku kontekstu lub wywoływania narzędzi w twoim imieniu. Ogranicz promień rażenia przez: + Największe ryzyko pojawia się wtedy, gdy włączone są narzędzia: model może zostać nakłoniony do + wyprowadzania kontekstu albo wywoływania narzędzi w Twoim imieniu. Ogranicz promień rażenia przez: - - używanie agenta „czytelnika” tylko do odczytu lub bez narzędzi do podsumowywania niezaufanej treści + - używanie agenta „czytelnika” tylko do odczytu lub z wyłączonymi narzędziami do podsumowywania niezaufanych treści - utrzymywanie `web_search` / `web_fetch` / `browser` wyłączonych dla agentów z włączonymi narzędziami - traktowanie zdekodowanego tekstu plików/dokumentów również jako niezaufanego: OpenResponses - `input_file` oraz ekstrakcja treści z załączników multimedialnych opakowują wyodrębniony tekst w + `input_file` oraz ekstrakcja z załączników multimedialnych opakowują wyodrębniony tekst w jawne znaczniki granic treści zewnętrznej zamiast przekazywać surowy tekst pliku - sandboxing i ścisłe allowlisty narzędzi - Szczegóły: [Security](/pl/gateway/security). + Szczegóły: [Bezpieczeństwo](/pl/gateway/security). - - Tak, w większości konfiguracji. Izolowanie bota przy użyciu oddzielnych kont i numerów telefonów + + Tak, w większości konfiguracji. Izolowanie bota za pomocą osobnych kont i numerów telefonów zmniejsza promień rażenia, jeśli coś pójdzie nie tak. Ułatwia to też rotację - poświadczeń lub cofanie dostępu bez wpływu na twoje osobiste konta. + poświadczeń lub cofnięcie dostępu bez wpływu na Twoje osobiste konta. - Zacznij od małej skali. Daj dostęp tylko do narzędzi i kont, których rzeczywiście potrzebujesz, i rozszerzaj go + Zacznij od małej skali. Daj dostęp tylko do narzędzi i kont, których naprawdę potrzebujesz, i rozszerzaj później, jeśli będzie to wymagane. - Dokumentacja: [Security](/pl/gateway/security), [Pairing](/pl/channels/pairing). + Dokumentacja: [Bezpieczeństwo](/pl/gateway/security), [Pairing](/pl/channels/pairing). - **Nie** zalecamy pełnej autonomii nad twoimi prywatnymi wiadomościami. Najbezpieczniejszy wzorzec to: + **Nie** zalecamy pełnej autonomii nad Twoimi osobistymi wiadomościami. Najbezpieczniejszy wzorzec to: - - Utrzymuj DM w trybie **pairing** albo z ciasną allowlistą. - - Używaj **oddzielnego numeru lub konta**, jeśli chcesz, aby pisał wiadomości w twoim imieniu. - - Pozwól mu tworzyć szkice, a potem **zatwierdzaj przed wysłaniem**. + - Trzymaj DM w **trybie pairing** albo na ścisłej allowliście. + - Używaj **oddzielnego numeru lub konta**, jeśli chcesz, aby wysyłał wiadomości w Twoim imieniu. + - Pozwól mu przygotować szkic, a potem **zatwierdź przed wysłaniem**. - Jeśli chcesz eksperymentować, rób to na dedykowanym koncie i utrzymuj izolację. Zobacz - [Security](/pl/gateway/security). + Jeśli chcesz eksperymentować, rób to na dedykowanym koncie i zachowaj izolację. Zobacz + [Bezpieczeństwo](/pl/gateway/security). - Tak, **jeśli** agent obsługuje tylko czat, a dane wejściowe są zaufane. Mniejsze warianty są - bardziej podatne na przejmowanie instrukcji, więc unikaj ich w przypadku agentów z włączonymi narzędziami - lub przy odczytywaniu niezaufanej treści. Jeśli musisz używać mniejszego modelu, zablokuj - narzędzia i uruchamiaj w sandboxie. Zobacz [Security](/pl/gateway/security). + Tak, **jeśli** agent służy tylko do czatu, a dane wejściowe są zaufane. Mniejsze poziomy są + bardziej podatne na przejmowanie instrukcji, więc unikaj ich dla agentów z włączonymi narzędziami + albo przy odczytywaniu niezaufanych treści. Jeśli musisz używać mniejszego modelu, zablokuj + narzędzia i uruchamiaj wewnątrz sandboxa. Zobacz [Bezpieczeństwo](/pl/gateway/security). - - Kody parowania są wysyłane **tylko** wtedy, gdy nieznany nadawca napisze do bota i + + Kody pairing są wysyłane **tylko** wtedy, gdy nieznany nadawca napisze do bota i `dmPolicy: "pairing"` jest włączone. Samo `/start` nie generuje kodu. Sprawdź oczekujące żądania: @@ -3167,27 +3170,27 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa openclaw pairing list telegram ``` - Jeśli chcesz natychmiastowego dostępu, dodaj identyfikator nadawcy do allowlisty albo ustaw `dmPolicy: "open"` + Jeśli chcesz natychmiastowego dostępu, dodaj swój sender id do allowlisty albo ustaw `dmPolicy: "open"` dla tego konta. - Nie. Domyślna polityka DM WhatsApp to **pairing**. Nieznani nadawcy dostają tylko kod parowania, a ich wiadomość **nie jest przetwarzana**. OpenClaw odpowiada tylko na czaty, które otrzymuje, albo na jawne wysyłki, które sam wywołasz. + Nie. Domyślna zasada DM WhatsApp to **pairing**. Nieznani nadawcy dostają tylko kod pairing, a ich wiadomość **nie jest przetwarzana**. OpenClaw odpowiada tylko na czaty, które otrzymuje, albo na jawne wysyłki, które sam wywołasz. - Zatwierdź parowanie przez: + Zatwierdzanie pairing: ```bash openclaw pairing approve whatsapp ``` - Wyświetl oczekujące żądania: + Lista oczekujących żądań: ```bash openclaw pairing list whatsapp ``` - Prompt kreatora dotyczący numeru telefonu: służy do ustawienia twojej **allowlisty / właściciela**, aby twoje własne DM były dozwolone. Nie jest używany do automatycznego wysyłania. Jeśli działasz na swoim prywatnym numerze WhatsApp, użyj tego numeru i włącz `channels.whatsapp.selfChatMode`. + Monit kreatora o numer telefonu: służy do ustawienia Twojej **allowlisty/ownera**, aby Twoje własne DM były dozwolone. Nie służy do automatycznego wysyłania. Jeśli uruchamiasz na własnym numerze WhatsApp, użyj tego numeru i włącz `channels.whatsapp.selfChatMode`. @@ -3196,8 +3199,7 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa - Większość wewnętrznych komunikatów lub komunikatów narzędzi pojawia się tylko wtedy, gdy dla tej sesji - włączone są **verbose**, **trace** albo **reasoning**. + Większość komunikatów wewnętrznych lub narzędziowych pojawia się tylko wtedy, gdy dla tej sesji włączone są **verbose**, **trace** lub **reasoning**. Napraw to na czacie, na którym to widzisz: @@ -3208,15 +3210,15 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa ``` Jeśli nadal jest zbyt głośno, sprawdź ustawienia sesji w Control UI i ustaw verbose - na **inherit**. Potwierdź też, że nie używasz profilu bota z ustawieniem `verboseDefault` - ustawionym w konfiguracji na `on`. + na **inherit**. Potwierdź też, że nie używasz profilu bota z ustawionym `verboseDefault` + na `on` w konfiguracji. - Dokumentacja: [Thinking and verbose](/pl/tools/thinking), [Security](/pl/gateway/security#reasoning-verbose-output-in-groups). + Dokumentacja: [Thinking i verbose](/pl/tools/thinking), [Bezpieczeństwo](/pl/gateway/security#reasoning-verbose-output-in-groups). - - Wyślij dowolny z poniższych tekstów **jako samodzielną wiadomość** (bez ukośnika): + + Wyślij dowolne z tych poleceń **jako samodzielną wiadomość** (bez ukośnika): ``` stop @@ -3242,23 +3244,23 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa To są wyzwalacze przerwania (nie polecenia slash). - W przypadku procesów działających w tle (z narzędzia exec) możesz poprosić agenta o uruchomienie: + Dla procesów w tle (z narzędzia exec) możesz poprosić agenta o uruchomienie: ``` process action:kill sessionId:XXX ``` - Przegląd poleceń slash: zobacz [Slash commands](/pl/tools/slash-commands). + Przegląd poleceń slash: zobacz [Polecenia slash](/pl/tools/slash-commands). - Większość poleceń musi zostać wysłana jako **samodzielna** wiadomość zaczynająca się od `/`, ale kilka skrótów (takich jak `/status`) działa też inline dla nadawców z allowlisty. + Większość poleceń musi być wysłana jako **samodzielna** wiadomość zaczynająca się od `/`, ale kilka skrótów (jak `/status`) działa także inline dla nadawców z allowlisty. - - OpenClaw domyślnie blokuje wiadomości **między różnymi dostawcami**. Jeśli wywołanie narzędzia jest powiązane - z Telegram, nie wyśle do Discord, chyba że jawnie na to zezwolisz. + + OpenClaw domyślnie blokuje wiadomości **między dostawcami**. Jeśli wywołanie narzędzia jest powiązane + z Telegramem, nie wyśle na Discord, chyba że jawnie na to zezwolisz. - Włącz komunikację między dostawcami dla agenta: + Włącz wiadomości między dostawcami dla agenta: ```json5 { @@ -3273,17 +3275,17 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa } ``` - Po edycji konfiguracji zrestartuj Gateway. + Po edycji konfiguracji zrestartuj gateway. - - Tryb kolejki kontroluje, jak nowe wiadomości wchodzą w interakcję z trwającym uruchomieniem. Użyj `/queue`, aby zmienić tryb: + + Tryb kolejki kontroluje, jak nowe wiadomości wchodzą w interakcję z trwającym uruchomieniem. Użyj `/queue`, aby zmienić tryby: - `steer` - nowe wiadomości przekierowują bieżące zadanie - `followup` - uruchamia wiadomości jedna po drugiej - `collect` - grupuje wiadomości i odpowiada raz (domyślnie) - - `steer-backlog` - przekierowuje teraz, a potem przetwarza backlog + - `steer-backlog` - przekierowuje teraz, potem przetwarza backlog - `interrupt` - przerywa bieżące uruchomienie i zaczyna od nowa Możesz dodać opcje takie jak `debounce:2s cap:25 drop:summarize` dla trybów followup. @@ -3294,11 +3296,11 @@ Powiązane: [/concepts/oauth](/pl/concepts/oauth) (przepływy OAuth, przechowywa ## Różne - - W OpenClaw poświadczenia i wybór modelu są oddzielne. Ustawienie `ANTHROPIC_API_KEY` (albo zapisanie klucza API Anthropic w profilach uwierzytelniania) włącza uwierzytelnianie, ale faktyczny model domyślny to to, co skonfigurujesz w `agents.defaults.model.primary` (na przykład `anthropic/claude-sonnet-4-6` albo `anthropic/claude-opus-4-6`). Jeśli widzisz `No credentials found for profile "anthropic:default"`, oznacza to, że Gateway nie mógł znaleźć poświadczeń Anthropic w oczekiwanym `auth-profiles.json` dla uruchomionego agenta. + + W OpenClaw poświadczenia i wybór modelu są od siebie oddzielone. Ustawienie `ANTHROPIC_API_KEY` (albo zapisanie klucza API Anthropic w profilach uwierzytelniania) włącza uwierzytelnianie, ale faktyczny model domyślny to ten, który skonfigurujesz w `agents.defaults.model.primary` (na przykład `anthropic/claude-sonnet-4-6` albo `anthropic/claude-opus-4-6`). Jeśli widzisz `No credentials found for profile "anthropic:default"`, oznacza to, że Gateway nie mógł znaleźć poświadczeń Anthropic w oczekiwanym `auth-profiles.json` dla uruchomionego agenta. --- -Nadal utknąłeś? Zapytaj na [Discord](https://discord.com/invite/clawd) albo otwórz [dyskusję na GitHub](https://github.com/openclaw/openclaw/discussions). +Nadal utknąłeś/utknęłaś? Zapytaj na [Discord](https://discord.com/invite/clawd) albo otwórz [dyskusję na GitHubie](https://github.com/openclaw/openclaw/discussions). diff --git a/docs/pl/install/index.md b/docs/pl/install/index.md index 7edd0e481..c603665b9 100644 --- a/docs/pl/install/index.md +++ b/docs/pl/install/index.md @@ -1,15 +1,15 @@ --- read_when: - - Potrzebujesz metody instalacji innej niż szybki start z Getting Started - - Chcesz wdrożyć rozwiązanie na platformie chmurowej - - Musisz zaktualizować, zmigrować lub odinstalować -summary: Instalacja OpenClaw — skrypt instalacyjny, npm/pnpm/bun, ze źródeł, Docker i nie tylko -title: Instalacja + - Potrzebujesz metody instalacji innej niż szybki start w sekcji Wprowadzenie + - Chcesz wdrożyć na platformie chmurowej + - Musisz zaktualizować, przeprowadzić migrację lub odinstalować +summary: Zainstaluj OpenClaw — skrypt instalacyjny, npm/pnpm/bun, ze źródła, Docker i nie tylko +title: Zainstaluj x-i18n: - generated_at: "2026-04-05T13:57:36Z" + generated_at: "2026-04-19T09:34:04Z" model: gpt-5.4 provider: openai - source_hash: eca17c76a2a66166b3d8cda9dc3144ab920d30ad0ed2a220eb9389d7a383ba5d + source_hash: ad0a5fdbbf13dcaf2fed6840f35aa22b2e9e458509509f98303c8d87c2556a6f source_path: install/index.md workflow: 15 --- @@ -18,7 +18,7 @@ x-i18n: ## Zalecane: skrypt instalacyjny -Najszybszy sposób instalacji. Wykrywa system operacyjny, instaluje Node, jeśli to potrzebne, instaluje OpenClaw i uruchamia onboarding. +Najszybszy sposób instalacji. Wykrywa Twój system operacyjny, instaluje Node w razie potrzeby, instaluje OpenClaw i uruchamia onboarding. @@ -48,31 +48,31 @@ Aby zainstalować bez uruchamiania onboardingu: -Wszystkie flagi oraz opcje CI/automatyzacji opisano w [Installer internals](/install/installer). +Wszystkie flagi oraz opcje CI/automatyzacji znajdziesz w [Wewnętrzne działanie instalatora](/pl/install/installer). ## Wymagania systemowe -- **Node 24** (zalecane) lub Node 22.14+ — skrypt instalacyjny obsługuje to automatycznie -- **macOS, Linux lub Windows** — obsługiwane są zarówno natywny Windows, jak i WSL2; WSL2 jest stabilniejsze. Zobacz [Windows](/platforms/windows). -- `pnpm` jest potrzebne tylko wtedy, gdy budujesz ze źródeł +- **Node 24** (zalecany) lub Node 22.14+ — skrypt instalacyjny obsługuje to automatycznie +- **macOS, Linux lub Windows** — obsługiwane są zarówno natywny Windows, jak i WSL2; WSL2 jest stabilniejszy. Zobacz [Windows](/pl/platforms/windows). +- `pnpm` jest potrzebny tylko wtedy, gdy kompilujesz ze źródeł ## Alternatywne metody instalacji ### Instalator z lokalnym prefiksem (`install-cli.sh`) -Użyj tej opcji, jeśli chcesz przechowywać OpenClaw i Node pod lokalnym prefiksem, takim jak -`~/.openclaw`, bez zależności od systemowej instalacji Node: +Użyj tej opcji, jeśli chcesz, aby OpenClaw i Node były przechowywane pod lokalnym prefiksem, takim jak +`~/.openclaw`, bez zależności od instalacji Node w całym systemie: ```bash curl -fsSL https://openclaw.ai/install-cli.sh | bash ``` -Domyślnie obsługuje instalacje npm, a także instalacje checkoutów git w tym samym -przepływie opartym na prefiksie. Pełne informacje referencyjne: [Installer internals](/install/installer#install-clish). +Domyślnie obsługuje instalacje npm, a także instalacje z checkoutu git w ramach tego samego +przepływu z prefiksem. Pełna dokumentacja: [Wewnętrzne działanie instalatora](/pl/install/installer#install-clish). ### npm, pnpm lub bun -Jeśli już samodzielnie zarządzasz Node: +Jeśli samodzielnie zarządzasz Node: @@ -89,7 +89,7 @@ Jeśli już samodzielnie zarządzasz Node: ``` - pnpm wymaga jawnego zatwierdzenia dla pakietów z build scripts. Po pierwszej instalacji uruchom `pnpm approve-builds -g`. + pnpm wymaga jawnego zatwierdzenia dla pakietów zawierających skrypty build. Po pierwszej instalacji uruchom `pnpm approve-builds -g`. @@ -100,14 +100,14 @@ Jeśli już samodzielnie zarządzasz Node: ``` - Bun jest obsługiwany dla ścieżki globalnej instalacji CLI. Dla runtime Gateway zalecanym runtime demona pozostaje Node. + Bun jest obsługiwany dla ścieżki globalnej instalacji CLI. Dla środowiska uruchomieniowego Gateway Node pozostaje zalecanym środowiskiem uruchomieniowym daemona. - - Jeśli `sharp` kończy się błędem z powodu globalnie zainstalowanego libvips: + + Jeśli `sharp` kończy się niepowodzeniem z powodu globalnie zainstalowanego libvips: ```bash SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest @@ -122,12 +122,12 @@ Dla współtwórców lub osób, które chcą uruchamiać z lokalnego checkoutu: ```bash git clone https://github.com/openclaw/openclaw.git cd openclaw -pnpm install && pnpm ui:build && pnpm build +pnpm install && pnpm build && pnpm ui:build pnpm link --global openclaw onboard --install-daemon ``` -Albo pomiń linkowanie i używaj `pnpm openclaw ...` z wnętrza repozytorium. Pełne przepływy deweloperskie znajdziesz w [Setup](/start/setup). +Możesz też pominąć linkowanie i używać `pnpm openclaw ...` wewnątrz repozytorium. Pełne przepływy pracy deweloperskiej znajdziesz w [Konfiguracja](/pl/start/setup). ### Instalacja z GitHub main @@ -138,71 +138,71 @@ npm install -g github:openclaw/openclaw#main ### Kontenery i menedżery pakietów - - Wdrożenia kontenerowe lub headless. + + Wdrożenia kontenerowe lub bezgłowe. - - Rootless alternatywa kontenerowa dla Docker. + + Alternatywa kontenerowa bez roota dla Docker. - + Deklaratywna instalacja przez Nix flake. - - Zautomatyzowany provisioning flot. + + Zautomatyzowane provisioning floty. - - Użycie tylko CLI przez runtime Bun. + + Użycie wyłącznie CLI przez środowisko uruchomieniowe Bun. -## Zweryfikuj instalację +## Weryfikacja instalacji ```bash openclaw --version # potwierdź, że CLI jest dostępne -openclaw doctor # sprawdź problemy z config -openclaw gateway status # potwierdź, że Gateway działa +openclaw doctor # sprawdź problemy z konfiguracją +openclaw gateway status # sprawdź, czy Gateway działa ``` -Jeśli po instalacji chcesz mieć zarządzany start: +Jeśli po instalacji chcesz mieć zarządzane uruchamianie: - macOS: LaunchAgent przez `openclaw onboard --install-daemon` lub `openclaw gateway install` - Linux/WSL2: usługa użytkownika systemd przez te same polecenia -- Natywny Windows: najpierw Scheduled Task, a jeśli utworzenie zadania zostanie odrzucone — zapasowy element logowania w folderze Startup per użytkownik +- Natywny Windows: najpierw Scheduled Task, z zapasowym elementem logowania w folderze Startup dla użytkownika, jeśli utworzenie zadania zostanie odrzucone ## Hosting i wdrożenie Wdróż OpenClaw na serwerze chmurowym lub VPS: - Dowolny Linux VPS - Wspólne kroki Docker - K8s - Fly.io - Hetzner - Google Cloud - Azure - Railway - Render - Northflank + Dowolny Linux VPS + Wspólne kroki dla Docker + K8s + Fly.io + Hetzner + Google Cloud + Azure + Railway + Render + Northflank ## Aktualizacja, migracja lub odinstalowanie - - Utrzymuj OpenClaw na bieżąco. + + Utrzymuj OpenClaw w aktualnej wersji. - - Przenieś na nową maszynę. + + Przenieś się na nową maszynę. - - Usuń OpenClaw całkowicie. + + Całkowicie usuń OpenClaw. ## Rozwiązywanie problemów: nie znaleziono `openclaw` -Jeśli instalacja się powiodła, ale `openclaw` nie jest znajdowany w terminalu: +Jeśli instalacja zakończyła się powodzeniem, ale `openclaw` nie jest znajdowany w terminalu: ```bash node -v # Node zainstalowany? @@ -216,4 +216,4 @@ Jeśli `$(npm prefix -g)/bin` nie znajduje się w Twoim `$PATH`, dodaj go do pli export PATH="$(npm prefix -g)/bin:$PATH" ``` -Następnie otwórz nowy terminal. Więcej informacji znajdziesz w [Node setup](/install/node). +Następnie otwórz nowy terminal. Więcej szczegółów znajdziesz w [Konfiguracja Node](/pl/install/node). diff --git a/docs/pl/platforms/windows.md b/docs/pl/platforms/windows.md index 8c87f78be..43f600142 100644 --- a/docs/pl/platforms/windows.md +++ b/docs/pl/platforms/windows.md @@ -2,14 +2,14 @@ read_when: - Instalowanie OpenClaw w systemie Windows - Wybór między natywnym Windowsem a WSL2 - - Szukanie informacji o stanie aplikacji towarzyszącej dla Windows -summary: 'Obsługa systemu Windows: natywne ścieżki instalacji i WSL2, demon oraz aktualne ograniczenia' + - Sprawdzanie statusu aplikacji towarzyszącej dla Windows +summary: 'Obsługa Windows: natywne i WSL2 ścieżki instalacji, demon oraz obecne zastrzeżenia' title: Windows x-i18n: - generated_at: "2026-04-05T14:00:38Z" + generated_at: "2026-04-19T09:34:05Z" model: gpt-5.4 provider: openai - source_hash: 7d9819206bdd65cf03519c1bc73ed0c7889b0ab842215ea94343262300adfd14 + source_hash: 1e7451c785a1d75c809522ad93e2c44a00b211f77f14c5c489fd0b01840d3fe2 source_path: platforms/windows.md workflow: 15 --- @@ -18,58 +18,58 @@ x-i18n: OpenClaw obsługuje zarówno **natywny Windows**, jak i **WSL2**. WSL2 to bardziej stabilna ścieżka i zalecana opcja dla pełnego doświadczenia — CLI, Gateway oraz -narzędzia działają wewnątrz Linuksa z pełną zgodnością. Natywny Windows działa -dla podstawowego użycia CLI i Gateway, z pewnymi ograniczeniami opisanymi poniżej. +narzędzia działają wewnątrz Linuksa z pełną kompatybilnością. Natywny Windows działa +dla podstawowego użycia CLI i Gateway, z pewnymi zastrzeżeniami opisanymi poniżej. Natywne aplikacje towarzyszące dla Windows są planowane. ## WSL2 (zalecane) -- [Pierwsze kroki](/start/getting-started) (używaj wewnątrz WSL) +- [Pierwsze kroki](/pl/start/getting-started) (używaj wewnątrz WSL) - [Instalacja i aktualizacje](/pl/install/updating) - Oficjalny przewodnik WSL2 (Microsoft): [https://learn.microsoft.com/windows/wsl/install](https://learn.microsoft.com/windows/wsl/install) -## Stan natywnego Windows +## Status natywnego Windows -Przepływy CLI dla natywnego Windows są ulepszane, ale WSL2 nadal pozostaje zalecaną ścieżką. +Przepływy CLI na natywnym Windows stale się poprawiają, ale WSL2 nadal pozostaje zalecaną ścieżką. -Co dziś działa dobrze w natywnym Windows: +Co dziś działa dobrze na natywnym Windows: -- instalator ze strony internetowej przez `install.ps1` +- instalator ze strony przez `install.ps1` - lokalne użycie CLI, takie jak `openclaw --version`, `openclaw doctor` oraz `openclaw plugins list --json` -- osadzony test lokalnego agenta/dostawcy, taki jak: +- osadzony lokalny smoke test agenta/dostawcy, taki jak: ```powershell openclaw agent --local --agent main --thinking low -m "Reply with exactly WINDOWS-HATCH-OK." ``` -Aktualne ograniczenia: +Obecne zastrzeżenia: -- `openclaw onboard --non-interactive` nadal oczekuje osiągalnej lokalnej bramy, chyba że przekażesz `--skip-health` -- `openclaw onboard --non-interactive --install-daemon` oraz `openclaw gateway install` najpierw próbują użyć Zaplanowanych zadań systemu Windows -- jeśli utworzenie Zaplanowanego zadania zostanie odrzucone, OpenClaw przechodzi do elementu logowania dla bieżącego użytkownika w folderze Autostart i natychmiast uruchamia bramę -- jeśli samo `schtasks` się zawiesi lub przestanie odpowiadać, OpenClaw teraz szybko przerywa tę ścieżkę i przechodzi do rozwiązania zapasowego zamiast zawieszać się bez końca -- Zaplanowane zadania są nadal preferowane, gdy są dostępne, ponieważ zapewniają lepszy stan nadzorcy +- `openclaw onboard --non-interactive` nadal oczekuje dostępnego lokalnego gatewaya, chyba że podasz `--skip-health` +- `openclaw onboard --non-interactive --install-daemon` oraz `openclaw gateway install` najpierw próbują użyć Windows Scheduled Tasks +- jeśli utworzenie Scheduled Task zostanie odrzucone, OpenClaw przechodzi w tryb awaryjny do elementu logowania w folderze Startup dla bieżącego użytkownika i natychmiast uruchamia Gateway +- jeśli samo `schtasks` się zawiesi lub przestanie odpowiadać, OpenClaw teraz szybko przerywa tę ścieżkę i przełącza się na fallback zamiast zawieszać się bez końca +- Scheduled Tasks są nadal preferowane, gdy są dostępne, ponieważ zapewniają lepszy status nadzorcy -Jeśli chcesz tylko natywnego CLI, bez instalacji usługi bramy, użyj jednego z tych poleceń: +Jeśli chcesz tylko natywnego CLI, bez instalacji usługi Gateway, użyj jednej z tych opcji: ```powershell openclaw onboard --non-interactive --skip-health openclaw gateway run ``` -Jeśli chcesz zarządzane uruchamianie przy starcie w natywnym Windows: +Jeśli chcesz zarządzane uruchamianie przy starcie na natywnym Windows: ```powershell openclaw gateway install openclaw gateway status --json ``` -Jeśli utworzenie Zaplanowanego zadania jest zablokowane, zapasowy tryb usługi nadal uruchamia się automatycznie po zalogowaniu przez folder Autostart bieżącego użytkownika. +Jeśli utworzenie Scheduled Task jest zablokowane, zapasowy tryb usługi nadal uruchamia się automatycznie po zalogowaniu przez folder Startup bieżącego użytkownika. ## Gateway -- [Przewodnik po Gateway](/pl/gateway) +- [Instrukcja operacyjna Gateway](/pl/gateway) - [Konfiguracja](/pl/gateway/configuration) ## Instalacja usługi Gateway (CLI) @@ -102,10 +102,10 @@ openclaw doctor ## Automatyczne uruchamianie Gateway przed logowaniem do Windows -W przypadku konfiguracji bezobsługowych upewnij się, że pełny łańcuch uruchamiania działa nawet wtedy, gdy nikt nie loguje się do +W przypadku konfiguracji bezobsługowych upewnij się, że cały łańcuch uruchamiania działa nawet wtedy, gdy nikt nie loguje się do Windows. -### 1) Utrzymuj usługi użytkownika działające bez logowania +### 1) Utrzymuj usługi użytkownika uruchomione bez logowania Wewnątrz WSL: @@ -113,7 +113,7 @@ Wewnątrz WSL: sudo loginctl enable-linger "$(whoami)" ``` -### 2) Zainstaluj usługę użytkownika bramy OpenClaw +### 2) Zainstaluj usługę użytkownika Gateway OpenClaw Wewnątrz WSL: @@ -121,7 +121,7 @@ Wewnątrz WSL: openclaw gateway install ``` -### 3) Uruchamiaj WSL automatycznie podczas startu Windows +### 3) Uruchamiaj WSL automatycznie przy starcie Windows W PowerShell jako Administrator: @@ -129,7 +129,7 @@ W PowerShell jako Administrator: schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec /bin/true" /sc onstart /ru SYSTEM ``` -Zastąp `Ubuntu` nazwą swojej dystrybucji z polecenia: +Zastąp `Ubuntu` nazwą swojej dystrybucji z: ```powershell wsl --list --verbose @@ -137,17 +137,17 @@ wsl --list --verbose ### Zweryfikuj łańcuch uruchamiania -Po ponownym uruchomieniu (przed zalogowaniem do Windows), sprawdź z WSL: +Po ponownym uruchomieniu (przed zalogowaniem do Windows) sprawdź z WSL: ```bash systemctl --user is-enabled openclaw-gateway.service systemctl --user status openclaw-gateway.service --no-pager ``` -## Zaawansowane: udostępnianie usług WSL przez LAN (portproxy) +## Zaawansowane: udostępnianie usług WSL w sieci LAN (portproxy) -WSL ma własną sieć wirtualną. Jeśli inne urządzenie ma uzyskać dostęp do usługi -uruchomionej **wewnątrz WSL** (SSH, lokalny serwer TTS lub Gateway), musisz +WSL ma własną wirtualną sieć. Jeśli inna maszyna ma uzyskać dostęp do usługi +działającej **wewnątrz WSL** (SSH, lokalny serwer TTS lub Gateway), musisz przekierować port Windows na bieżący adres IP WSL. Adres IP WSL zmienia się po restartach, więc może być konieczne odświeżenie reguły przekierowania. @@ -172,7 +172,7 @@ New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound ` -Protocol TCP -LocalPort $ListenPort -Action Allow ``` -Odśwież `portproxy` po restarcie WSL: +Odśwież portproxy po restarcie WSL: ```powershell netsh interface portproxy delete v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 | Out-Null @@ -182,11 +182,11 @@ netsh interface portproxy add v4tov4 listenport=$ListenPort listenaddress=0.0.0. Uwagi: -- SSH z innego urządzenia kieruj na **adres IP hosta Windows** (na przykład: `ssh user@windows-host -p 2222`). -- Węzły zdalne muszą wskazywać **osiągalny** adres URL Gateway (nie `127.0.0.1`); użyj +- SSH z innej maszyny kieruj na **adres IP hosta Windows** (przykład: `ssh user@windows-host -p 2222`). +- Zdalne Node muszą wskazywać **osiągalny** URL Gateway (nie `127.0.0.1`); użyj `openclaw status --all`, aby to potwierdzić. -- Użyj `listenaddress=0.0.0.0` dla dostępu przez LAN; `127.0.0.1` pozostawia dostęp tylko lokalny. -- Jeśli chcesz to zautomatyzować, zarejestruj Zaplanowane zadanie, aby uruchamiało krok +- Użyj `listenaddress=0.0.0.0` dla dostępu z sieci LAN; `127.0.0.1` pozostawia go tylko lokalnie. +- Jeśli chcesz to zautomatyzować, zarejestruj Scheduled Task, aby uruchamiał krok odświeżania przy logowaniu. ## Instalacja WSL2 krok po kroku @@ -197,14 +197,14 @@ Otwórz PowerShell (Administrator): ```powershell wsl --install -# Lub wybierz dystrybucję jawnie: +# Or pick a distro explicitly: wsl --list --online wsl --install -d Ubuntu-24.04 ``` Uruchom ponownie komputer, jeśli Windows o to poprosi. -### 2) Włącz systemd (wymagane do instalacji bramy) +### 2) Włącz systemd (wymagane do instalacji Gateway) W terminalu WSL: @@ -221,7 +221,7 @@ Następnie w PowerShell: wsl --shutdown ``` -Ponownie otwórz Ubuntu, a następnie zweryfikuj: +Otwórz Ubuntu ponownie, a następnie zweryfikuj: ```bash systemctl --user status @@ -229,20 +229,30 @@ systemctl --user status ### 3) Zainstaluj OpenClaw (wewnątrz WSL) -Postępuj zgodnie z przepływem Pierwszych kroków dla Linuksa wewnątrz WSL: +W przypadku standardowej pierwszej konfiguracji wewnątrz WSL postępuj zgodnie z przepływem Pierwszych kroków dla Linuksa: ```bash git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install -pnpm ui:build # auto-installs UI deps on first run pnpm build -openclaw onboard +pnpm ui:build +pnpm openclaw onboard --install-daemon ``` -Pełny przewodnik: [Pierwsze kroki](/start/getting-started) +Jeśli rozwijasz ze źródeł zamiast wykonywać pierwsze wdrożenie, użyj +deweloperskiej pętli ze źródła z [Konfiguracja](/pl/start/setup): + +```bash +pnpm install +# First run only (or after resetting local OpenClaw config/workspace) +pnpm openclaw setup +pnpm gateway:watch +``` + +Pełny przewodnik: [Pierwsze kroki](/pl/start/getting-started) ## Aplikacja towarzysząca dla Windows Nie mamy jeszcze aplikacji towarzyszącej dla Windows. Wkład społeczności jest mile widziany, jeśli chcesz -pomóc to urzeczywistnić. +pomóc w jej powstaniu. diff --git a/docs/pl/start/setup.md b/docs/pl/start/setup.md index 5da5f391b..1a74075f4 100644 --- a/docs/pl/start/setup.md +++ b/docs/pl/start/setup.md @@ -1,14 +1,14 @@ --- read_when: - Konfigurowanie nowej maszyny - - Chcesz mieć „latest + greatest” bez psucia swojej osobistej konfiguracji -summary: Zaawansowane przepływy konfiguracji i rozwoju dla OpenClaw + - Chcesz mieć „najnowsze i najlepsze” bez psucia swojej osobistej konfiguracji +summary: Zaawansowana konfiguracja oraz przepływy pracy programistycznej dla OpenClaw title: Konfiguracja x-i18n: - generated_at: "2026-04-05T14:06:29Z" + generated_at: "2026-04-19T09:34:02Z" model: gpt-5.4 provider: openai - source_hash: be4e280dde7f3a224345ca557ef2fb35a9c9db8520454ff63794ac6f8d4e71e7 + source_hash: 773cdbef5f38b069303b5e13fca5fcdc28f082746869f17b8b92aab1610b95a8 source_path: start/setup.md workflow: 15 --- @@ -16,42 +16,42 @@ x-i18n: # Konfiguracja -Jeśli konfigurujesz wszystko po raz pierwszy, zacznij od [Pierwsze kroki](/start/getting-started). -Szczegóły dotyczące onboardingu znajdziesz w [Onboarding (CLI)](/start/wizard). +Jeśli konfigurujesz wszystko po raz pierwszy, zacznij od [Pierwsze kroki](/pl/start/getting-started). +Szczegóły wdrożenia znajdziesz w [Wdrożenie (CLI)](/pl/start/wizard). -## TL;DR +## W skrócie -- **Dostosowanie znajduje się poza repozytorium:** `~/.openclaw/workspace` (workspace) + `~/.openclaw/openclaw.json` (config). +- **Dostosowanie znajduje się poza repozytorium:** `~/.openclaw/workspace` (workspace) + `~/.openclaw/openclaw.json` (konfiguracja). - **Stabilny przepływ pracy:** zainstaluj aplikację macOS; pozwól jej uruchamiać dołączony Gateway. -- **Przepływ bleeding edge:** uruchamiaj Gateway samodzielnie przez `pnpm gateway:watch`, a następnie pozwól aplikacji macOS podłączyć się w trybie Local. +- **Przepływ pracy bleeding edge:** uruchamiaj Gateway samodzielnie przez `pnpm gateway:watch`, a następnie pozwól aplikacji macOS dołączyć w trybie Local. ## Wymagania wstępne (ze źródeł) -- Zalecany Node 24 (obsługiwany jest też Node 22 LTS, obecnie `22.14+`) -- Preferowany `pnpm` (lub Bun, jeśli świadomie używasz [przepływu Bun](/pl/install/bun)) -- Docker (opcjonalny; tylko do konfiguracji/testów e2e w kontenerach — zobacz [Docker](/pl/install/docker)) +- Zalecany Node 24 (Node 22 LTS, obecnie `22.14+`, nadal jest obsługiwany) +- Preferowany `pnpm` (lub Bun, jeśli celowo używasz [przepływu pracy Bun](/pl/install/bun)) +- Docker (opcjonalnie; tylko do konfiguracji skonteneryzowanej/e2e — zobacz [Docker](/pl/install/docker)) -## Strategia dostosowywania (żeby aktualizacje nie szkodziły) +## Strategia dostosowania (żeby aktualizacje nie sprawiały problemów) -Jeśli chcesz mieć coś „w 100% dostosowanego do mnie” _i_ łatwe aktualizacje, trzymaj własne dostosowania w: +Jeśli chcesz mieć „w 100% dostosowane do mnie” _i_ łatwe aktualizacje, trzymaj swoje dostosowania w: -- **Config:** `~/.openclaw/openclaw.json` (JSON/JSON5-ish) -- **Workspace:** `~/.openclaw/workspace` (Skills, prompty, pamięci; najlepiej jako prywatne repozytorium git) +- **Konfiguracja:** `~/.openclaw/openclaw.json` (w stylu JSON/JSON5) +- **Workspace:** `~/.openclaw/workspace` (Skills, prompty, pamięci; zrób z tego prywatne repozytorium git) -Zainicjalizuj to raz: +Jednorazowa inicjalizacja: ```bash openclaw setup ``` -Z wnętrza tego repozytorium użyj lokalnego punktu wejścia CLI: +Z poziomu tego repozytorium użyj lokalnego wpisu CLI: ```bash openclaw setup ``` -Jeśli nie masz jeszcze globalnej instalacji, uruchom to przez `pnpm openclaw setup` (lub `bun run openclaw setup`, jeśli używasz przepływu Bun). +Jeśli nie masz jeszcze instalacji globalnej, uruchom to przez `pnpm openclaw setup` (lub `bun run openclaw setup`, jeśli używasz przepływu pracy Bun). ## Uruchamianie Gateway z tego repozytorium @@ -64,9 +64,9 @@ node openclaw.mjs gateway --port 18789 --verbose ## Stabilny przepływ pracy (najpierw aplikacja macOS) 1. Zainstaluj i uruchom **OpenClaw.app** (pasek menu). -2. Ukończ checklistę onboardingu/uprawnień (prompty TCC). -3. Upewnij się, że Gateway jest ustawiony jako **Local** i działa (aplikacja nim zarządza). -4. Połącz powierzchnie integracji (na przykład: WhatsApp): +2. Ukończ checklistę wdrożenia/uprawnień (monity TCC). +3. Upewnij się, że Gateway działa w trybie **Local** i jest uruchomiony (aplikacja nim zarządza). +4. Połącz powierzchnie komunikacyjne (na przykład: WhatsApp): ```bash openclaw channels login @@ -78,36 +78,42 @@ openclaw channels login openclaw health ``` -Jeśli onboarding nie jest dostępny w twoim buildzie: +Jeśli wdrożenie nie jest dostępne w Twojej kompilacji: -- Uruchom `openclaw setup`, potem `openclaw channels login`, a następnie ręcznie uruchom Gateway (`openclaw gateway`). +- Uruchom `openclaw setup`, potem `openclaw channels login`, a następnie uruchom Gateway ręcznie (`openclaw gateway`). -## Przepływ bleeding edge (Gateway w terminalu) +## Przepływ pracy bleeding edge (Gateway w terminalu) -Cel: pracować nad TypeScript Gateway, mieć hot reload i jednocześnie pozostawić podłączony interfejs aplikacji macOS. +Cel: pracować nad TypeScript Gateway, mieć hot reload i nadal mieć podłączony interfejs aplikacji macOS. ### 0) (Opcjonalnie) Uruchom także aplikację macOS ze źródeł -Jeśli chcesz mieć także aplikację macOS w wersji bleeding edge: +Jeśli chcesz też mieć aplikację macOS w wersji bleeding edge: ```bash ./scripts/restart-mac.sh ``` -### 1) Uruchom deweloperski Gateway +### 1) Uruchom Gateway w trybie deweloperskim ```bash pnpm install +# Tylko przy pierwszym uruchomieniu (lub po zresetowaniu lokalnej konfiguracji/workspace OpenClaw) +pnpm openclaw setup pnpm gateway:watch ``` -`gateway:watch` uruchamia gateway w trybie watch i przeładowuje go po odpowiednich zmianach w źródłach, -config oraz metadanych wbudowanych wtyczek. +`gateway:watch` uruchamia Gateway w trybie watch i przeładowuje go przy odpowiednich zmianach w źródłach, +konfiguracji i metadanych dołączonych Plugin. +`pnpm openclaw setup` to jednorazowy krok inicjalizacji lokalnej konfiguracji/workspace dla świeżo sklonowanego repozytorium. +`pnpm gateway:watch` nie przebudowuje `dist/control-ui`, więc po zmianach w `ui/` uruchom ponownie `pnpm ui:build` albo użyj `pnpm ui:dev` podczas pracy nad Control UI. -Jeśli świadomie używasz przepływu Bun, równoważne polecenia to: +Jeśli celowo używasz przepływu pracy Bun, równoważne polecenia to: ```bash bun install +# Tylko przy pierwszym uruchomieniu (lub po zresetowaniu lokalnej konfiguracji/workspace OpenClaw) +bun run openclaw setup bun run gateway:watch ``` @@ -116,64 +122,64 @@ bun run gateway:watch W **OpenClaw.app**: - Tryb połączenia: **Local** - Aplikacja podłączy się do działającego gateway na skonfigurowanym porcie. + Aplikacja dołączy do działającego gateway na skonfigurowanym porcie. -### 3) Weryfikacja +### 3) Zweryfikuj -- Stan Gateway w aplikacji powinien brzmieć **„Using existing gateway …”** -- Lub przez CLI: +- W aplikacji status Gateway powinien brzmieć **„Using existing gateway …”** +- Albo przez CLI: ```bash openclaw health ``` -### Częste pułapki +### Typowe pułapki -- **Zły port:** Gateway WS domyślnie używa `ws://127.0.0.1:18789`; utrzymuj aplikację i CLI na tym samym porcie. +- **Niewłaściwy port:** domyślny WS Gateway to `ws://127.0.0.1:18789`; aplikacja i CLI muszą używać tego samego portu. - **Gdzie znajduje się stan:** - - Stan kanałów/dostawców: `~/.openclaw/credentials/` - - Profile auth modeli: `~/.openclaw/agents//agent/auth-profiles.json` + - Stan kanałów/providerów: `~/.openclaw/credentials/` + - Profile uwierzytelniania modeli: `~/.openclaw/agents//agent/auth-profiles.json` - Sesje: `~/.openclaw/agents//sessions/` - Logi: `/tmp/openclaw/` ## Mapa przechowywania poświadczeń -Użyj tego podczas debugowania auth lub decydowania, co należy archiwizować: +Użyj tego podczas debugowania uwierzytelniania albo przy decydowaniu, co warto zarchiwizować: - **WhatsApp**: `~/.openclaw/credentials/whatsapp//creds.json` -- **Token bota Telegram**: config/env lub `channels.telegram.tokenFile` (tylko zwykły plik; symlinki są odrzucane) +- **Token bota Telegram**: config/env lub `channels.telegram.tokenFile` (tylko zwykły plik; dowiązania symboliczne są odrzucane) - **Token bota Discord**: config/env lub SecretRef (dostawcy env/file/exec) - **Tokeny Slack**: config/env (`channels.slack.*`) -- **Listy dozwolonych dla parowania**: +- **Listy dozwolonych parowań**: - `~/.openclaw/credentials/-allowFrom.json` (konto domyślne) - `~/.openclaw/credentials/--allowFrom.json` (konta inne niż domyślne) -- **Profile auth modeli**: `~/.openclaw/agents//agent/auth-profiles.json` -- **Ładunek sekretów opartych na pliku (opcjonalnie)**: `~/.openclaw/secrets.json` +- **Profile uwierzytelniania modeli**: `~/.openclaw/agents//agent/auth-profiles.json` +- **Ładunek sekretów oparty na pliku (opcjonalny)**: `~/.openclaw/secrets.json` - **Import starszego OAuth**: `~/.openclaw/credentials/oauth.json` Więcej szczegółów: [Bezpieczeństwo](/pl/gateway/security#credential-storage-map). -## Aktualizacje (bez niszczenia konfiguracji) +## Aktualizowanie (bez demolowania konfiguracji) -- Traktuj `~/.openclaw/workspace` i `~/.openclaw/` jako „twoje rzeczy”; nie umieszczaj osobistych promptów/config w repozytorium `openclaw`. -- Aktualizacja ze źródeł: `git pull` + wybrany krok instalacji menedżera pakietów (`pnpm install` domyślnie; `bun install` dla przepływu Bun) + dalsze używanie pasującego polecenia `gateway:watch`. +- Traktuj `~/.openclaw/workspace` i `~/.openclaw/` jako „Twoje rzeczy”; nie umieszczaj osobistych promptów/konfiguracji w repozytorium `openclaw`. +- Aktualizacja źródeł: `git pull` + wybrany krok instalacji menedżera pakietów (`pnpm install` domyślnie; `bun install` dla przepływu pracy Bun) + dalsze używanie odpowiedniego polecenia `gateway:watch`. ## Linux (usługa użytkownika systemd) -Instalacje Linux używają usługi użytkownika systemd. Domyślnie systemd zatrzymuje usługi użytkownika -po wylogowaniu/bezczynności, co wyłącza Gateway. Onboarding próbuje włączyć -lingering za Ciebie (może poprosić o sudo). Jeśli nadal jest wyłączony, uruchom: +Instalacje na Linuxie używają usługi użytkownika systemd. Domyślnie systemd zatrzymuje +usługi użytkownika po wylogowaniu/bezczynności, co wyłącza Gateway. Wdrożenie próbuje +włączyć lingering za Ciebie (może wymagać sudo). Jeśli nadal jest wyłączone, uruchom: ```bash sudo loginctl enable-linger $USER ``` -Dla serwerów zawsze włączonych lub wieloużytkownikowych rozważ użycie usługi systemowej zamiast -usługi użytkownika (nie wymaga lingering). Zobacz [Instrukcja Gateway](/pl/gateway), aby przeczytać uwagi o systemd. +W przypadku serwerów zawsze włączonych lub wieloużytkownikowych rozważ usługę **systemową** zamiast +usługi użytkownika (wtedy lingering nie jest potrzebny). Zobacz [Instrukcja operacyjna Gateway](/pl/gateway), aby poznać uwagi dotyczące systemd. ## Powiązana dokumentacja -- [Instrukcja Gateway](/pl/gateway) (flagi, nadzór, porty) -- [Konfiguracja Gateway](/pl/gateway/configuration) (schemat config + przykłady) +- [Instrukcja operacyjna Gateway](/pl/gateway) (flagi, nadzór, porty) +- [Konfiguracja Gateway](/pl/gateway/configuration) (schemat konfiguracji + przykłady) - [Discord](/pl/channels/discord) i [Telegram](/pl/channels/telegram) (tagi odpowiedzi + ustawienia replyToMode) -- [Konfiguracja asystenta OpenClaw](/start/openclaw) -- [Aplikacja macOS](/platforms/macos) (cykl życia gateway) +- [Konfiguracja asystenta OpenClaw](/pl/start/openclaw) +- [Aplikacja macOS](/pl/platforms/macos) (cykl życia gateway)