chore(i18n): refresh pl translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
9fa2b2c0a9
commit
e9c2157fc8
1916
docs/pl/help/faq.md
1916
docs/pl/help/faq.md
File diff suppressed because it is too large
Load Diff
@ -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.
|
||||
|
||||
<Tabs>
|
||||
<Tab title="macOS / Linux / WSL2">
|
||||
@ -48,31 +48,31 @@ Aby zainstalować bez uruchamiania onboardingu:
|
||||
</Tab>
|
||||
</Tabs>
|
||||
|
||||
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:
|
||||
|
||||
<Tabs>
|
||||
<Tab title="npm">
|
||||
@ -89,7 +89,7 @@ Jeśli już samodzielnie zarządzasz Node:
|
||||
```
|
||||
|
||||
<Note>
|
||||
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`.
|
||||
</Note>
|
||||
|
||||
</Tab>
|
||||
@ -100,14 +100,14 @@ Jeśli już samodzielnie zarządzasz Node:
|
||||
```
|
||||
|
||||
<Note>
|
||||
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.
|
||||
</Note>
|
||||
|
||||
</Tab>
|
||||
</Tabs>
|
||||
|
||||
<Accordion title="Rozwiązywanie problemów: błędy buildu sharp (npm)">
|
||||
Jeśli `sharp` kończy się błędem z powodu globalnie zainstalowanego libvips:
|
||||
<Accordion title="Rozwiązywanie problemów: błędy kompilacji sharp (npm)">
|
||||
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
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Docker" href="/install/docker" icon="container">
|
||||
Wdrożenia kontenerowe lub headless.
|
||||
<Card title="Docker" href="/pl/install/docker" icon="container">
|
||||
Wdrożenia kontenerowe lub bezgłowe.
|
||||
</Card>
|
||||
<Card title="Podman" href="/install/podman" icon="container">
|
||||
Rootless alternatywa kontenerowa dla Docker.
|
||||
<Card title="Podman" href="/pl/install/podman" icon="container">
|
||||
Alternatywa kontenerowa bez roota dla Docker.
|
||||
</Card>
|
||||
<Card title="Nix" href="/install/nix" icon="snowflake">
|
||||
<Card title="Nix" href="/pl/install/nix" icon="snowflake">
|
||||
Deklaratywna instalacja przez Nix flake.
|
||||
</Card>
|
||||
<Card title="Ansible" href="/install/ansible" icon="server">
|
||||
Zautomatyzowany provisioning flot.
|
||||
<Card title="Ansible" href="/pl/install/ansible" icon="server">
|
||||
Zautomatyzowane provisioning floty.
|
||||
</Card>
|
||||
<Card title="Bun" href="/install/bun" icon="zap">
|
||||
Użycie tylko CLI przez runtime Bun.
|
||||
<Card title="Bun" href="/pl/install/bun" icon="zap">
|
||||
Użycie wyłącznie CLI przez środowisko uruchomieniowe Bun.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
## 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:
|
||||
|
||||
<CardGroup cols={3}>
|
||||
<Card title="VPS" href="/vps">Dowolny Linux VPS</Card>
|
||||
<Card title="Docker VM" href="/install/docker-vm-runtime">Wspólne kroki Docker</Card>
|
||||
<Card title="Kubernetes" href="/install/kubernetes">K8s</Card>
|
||||
<Card title="Fly.io" href="/install/fly">Fly.io</Card>
|
||||
<Card title="Hetzner" href="/install/hetzner">Hetzner</Card>
|
||||
<Card title="GCP" href="/install/gcp">Google Cloud</Card>
|
||||
<Card title="Azure" href="/install/azure">Azure</Card>
|
||||
<Card title="Railway" href="/install/railway">Railway</Card>
|
||||
<Card title="Render" href="/install/render">Render</Card>
|
||||
<Card title="Northflank" href="/install/northflank">Northflank</Card>
|
||||
<Card title="VPS" href="/pl/vps">Dowolny Linux VPS</Card>
|
||||
<Card title="Docker VM" href="/pl/install/docker-vm-runtime">Wspólne kroki dla Docker</Card>
|
||||
<Card title="Kubernetes" href="/pl/install/kubernetes">K8s</Card>
|
||||
<Card title="Fly.io" href="/pl/install/fly">Fly.io</Card>
|
||||
<Card title="Hetzner" href="/pl/install/hetzner">Hetzner</Card>
|
||||
<Card title="GCP" href="/pl/install/gcp">Google Cloud</Card>
|
||||
<Card title="Azure" href="/pl/install/azure">Azure</Card>
|
||||
<Card title="Railway" href="/pl/install/railway">Railway</Card>
|
||||
<Card title="Render" href="/pl/install/render">Render</Card>
|
||||
<Card title="Northflank" href="/pl/install/northflank">Northflank</Card>
|
||||
</CardGroup>
|
||||
|
||||
## Aktualizacja, migracja lub odinstalowanie
|
||||
|
||||
<CardGroup cols={3}>
|
||||
<Card title="Updating" href="/install/updating" icon="refresh-cw">
|
||||
Utrzymuj OpenClaw na bieżąco.
|
||||
<Card title="Aktualizacja" href="/pl/install/updating" icon="refresh-cw">
|
||||
Utrzymuj OpenClaw w aktualnej wersji.
|
||||
</Card>
|
||||
<Card title="Migrating" href="/install/migrating" icon="arrow-right">
|
||||
Przenieś na nową maszynę.
|
||||
<Card title="Migracja" href="/pl/install/migrating" icon="arrow-right">
|
||||
Przenieś się na nową maszynę.
|
||||
</Card>
|
||||
<Card title="Uninstall" href="/install/uninstall" icon="trash-2">
|
||||
Usuń OpenClaw całkowicie.
|
||||
<Card title="Odinstalowanie" href="/pl/install/uninstall" icon="trash-2">
|
||||
Całkowicie usuń OpenClaw.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
## 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).
|
||||
|
||||
@ -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.
|
||||
|
||||
@ -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
|
||||
|
||||
<Note>
|
||||
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).
|
||||
</Note>
|
||||
|
||||
## 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/<agentId>/agent/auth-profiles.json`
|
||||
- Stan kanałów/providerów: `~/.openclaw/credentials/`
|
||||
- Profile uwierzytelniania modeli: `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`
|
||||
- Sesje: `~/.openclaw/agents/<agentId>/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/<accountId>/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/<channel>-allowFrom.json` (konto domyślne)
|
||||
- `~/.openclaw/credentials/<channel>-<accountId>-allowFrom.json` (konta inne niż domyślne)
|
||||
- **Profile auth modeli**: `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`
|
||||
- **Ładunek sekretów opartych na pliku (opcjonalnie)**: `~/.openclaw/secrets.json`
|
||||
- **Profile uwierzytelniania modeli**: `~/.openclaw/agents/<agentId>/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)
|
||||
|
||||
Loading…
Reference in New Issue
Block a user