--- read_when: - Wyszukiwanie konkretnego kroku onboardingu lub flagi - Automatyzowanie procesu wprowadzania w trybie nieinteraktywnym - Debugowanie zachowania procesu onboardingu sidebarTitle: Onboarding Reference summary: 'Pełne odniesienie dla wdrażania przez CLI: każdy krok, flaga i pole konfiguracji' title: Dokumentacja referencyjna procesu wdrażania x-i18n: generated_at: "2026-05-10T19:55:04Z" model: gpt-5.5 provider: openai source_hash: be3e45f152700f02a212a390cdc02d5432ff531716a089f531de3bb6cc368cc9 source_path: reference/wizard.md workflow: 16 --- To jest pełna dokumentacja referencyjna dla `openclaw onboard`. Ogólny przegląd znajdziesz w sekcji [Onboarding (CLI)](/pl/start/wizard). ## Szczegóły przepływu (tryb lokalny) - Jeśli `~/.openclaw/openclaw.json` istnieje, wybierz **Zachowaj bieżące wartości**, **Przejrzyj i zaktualizuj** albo **Zresetuj przed konfiguracją**. - Ponowne uruchomienie onboardingu **nie** usuwa niczego, chyba że wyraźnie wybierzesz **Reset** (albo przekażesz `--reset`). - CLI `--reset` domyślnie obejmuje `config+creds+sessions`; użyj `--reset-scope full`, aby usunąć także obszar roboczy. - Jeśli konfiguracja jest nieprawidłowa albo zawiera starsze klucze, kreator zatrzymuje się i prosi o uruchomienie `openclaw doctor` przed kontynuowaniem. - Reset używa `trash` (nigdy `rm`) i oferuje zakresy: - Tylko konfiguracja - Konfiguracja + dane uwierzytelniające + sesje - Pełny reset (usuwa także obszar roboczy) - **Klucz API Anthropic**: używa `ANTHROPIC_API_KEY`, jeśli jest obecny, albo prosi o klucz, a następnie zapisuje go do użycia przez demona. - **Klucz API Anthropic**: preferowany wybór asystenta Anthropic w onboardingu/konfiguracji. - **Token konfiguracyjny Anthropic**: nadal dostępny w onboardingu/konfiguracji, chociaż OpenClaw preferuje teraz ponowne użycie Claude CLI, gdy jest dostępne. - **Subskrypcja OpenAI Code (Codex) (OAuth)**: przepływ w przeglądarce; wklej `code#state`. - Ustawia `agents.defaults.model` na `openai/gpt-5.5` przez środowisko uruchomieniowe Codex, gdy model nie jest ustawiony albo należy już do rodziny OpenAI. - **Subskrypcja OpenAI Code (Codex) (parowanie urządzenia)**: przepływ parowania w przeglądarce z krótkotrwałym kodem urządzenia. - Ustawia `agents.defaults.model` na `openai/gpt-5.5` przez środowisko uruchomieniowe Codex, gdy model nie jest ustawiony albo należy już do rodziny OpenAI. - **Klucz API OpenAI**: używa `OPENAI_API_KEY`, jeśli jest obecny, albo prosi o klucz, a następnie zapisuje go w profilach uwierzytelniania. - Ustawia `agents.defaults.model` na `openai/gpt-5.5`, gdy model nie jest ustawiony, ma postać `openai/*` albo `openai-codex/*`. - **Klucz API xAI (Grok)**: prosi o `XAI_API_KEY` i konfiguruje xAI jako dostawcę modeli. - **OpenCode**: prosi o `OPENCODE_API_KEY` (albo `OPENCODE_ZEN_API_KEY`, pobierz go z https://opencode.ai/auth) i pozwala wybrać katalog Zen albo Go. - **Ollama**: najpierw oferuje **Chmura + lokalnie**, **Tylko chmura** albo **Tylko lokalnie**. `Cloud only` prosi o `OLLAMA_API_KEY` i używa `https://ollama.com`; tryby oparte na hoście proszą o bazowy URL Ollama, wykrywają dostępne modele i w razie potrzeby automatycznie pobierają wybrany model lokalny; `Cloud + Local` sprawdza także, czy dany host Ollama jest zalogowany do dostępu w chmurze. - Więcej szczegółów: [Ollama](/pl/providers/ollama) - **Klucz API**: zapisuje klucz za Ciebie. - **Vercel AI Gateway (proxy wielomodelowe)**: prosi o `AI_GATEWAY_API_KEY`. - Więcej szczegółów: [Vercel AI Gateway](/pl/providers/vercel-ai-gateway) - **Cloudflare AI Gateway**: prosi o identyfikator konta, identyfikator Gateway i `CLOUDFLARE_AI_GATEWAY_API_KEY`. - Więcej szczegółów: [Cloudflare AI Gateway](/pl/providers/cloudflare-ai-gateway) - **MiniMax**: konfiguracja jest zapisywana automatycznie; domyślny model hostowany to `MiniMax-M2.7`. Konfiguracja z kluczem API używa `minimax/...`, a konfiguracja OAuth używa `minimax-portal/...`. - Więcej szczegółów: [MiniMax](/pl/providers/minimax) - **StepFun**: konfiguracja jest zapisywana automatycznie dla standardowego StepFun albo Step Plan na punktach końcowych w Chinach lub globalnych. - Standardowo obecnie obejmuje `step-3.5-flash`, a Step Plan obejmuje także `step-3.5-flash-2603`. - Więcej szczegółów: [StepFun](/pl/providers/stepfun) - **Synthetic (zgodny z Anthropic)**: prosi o `SYNTHETIC_API_KEY`. - Więcej szczegółów: [Synthetic](/pl/providers/synthetic) - **Moonshot (Kimi K2)**: konfiguracja jest zapisywana automatycznie. - **Kimi Coding**: konfiguracja jest zapisywana automatycznie. - Więcej szczegółów: [Moonshot AI (Kimi + Kimi Coding)](/pl/providers/moonshot) - **Pomiń**: uwierzytelnianie nie jest jeszcze skonfigurowane. - Wybierz model domyślny z wykrytych opcji (albo ręcznie wpisz dostawcę/model). Dla najlepszej jakości i niższego ryzyka wstrzykiwania promptów wybierz najsilniejszy model najnowszej generacji dostępny w Twoim stosie dostawców. - Onboarding uruchamia sprawdzenie modelu i ostrzega, jeśli skonfigurowany model jest nieznany albo brakuje uwierzytelniania. - Tryb przechowywania kluczy API domyślnie używa wartości profilu uwierzytelniania w postaci zwykłego tekstu. Użyj `--secret-input-mode ref`, aby zamiast tego przechowywać odwołania oparte na zmiennych środowiskowych (na przykład `keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" }`). - Profile uwierzytelniania znajdują się w `~/.openclaw/agents//agent/auth-profiles.json` (klucze API + OAuth). `~/.openclaw/credentials/oauth.json` służy tylko do importu ze starszego formatu. - Więcej szczegółów: [/concepts/oauth](/pl/concepts/oauth) Wskazówka dla środowisk bezgłowych/serwerowych: ukończ OAuth na maszynie z przeglądarką, a następnie skopiuj `auth-profiles.json` tego agenta (na przykład `~/.openclaw/agents//agent/auth-profiles.json` albo odpowiadającą mu ścieżkę `$OPENCLAW_STATE_DIR/...`) na host Gateway. `credentials/oauth.json` jest tylko starszym źródłem importu. - Domyślnie `~/.openclaw/workspace` (konfigurowalne). - Wypełnia obszar roboczy plikami potrzebnymi do rytuału bootstrapu agenta. - Pełny układ obszaru roboczego + przewodnik po kopiach zapasowych: [Obszar roboczy agenta](/pl/concepts/agent-workspace) - Port, wiązanie, tryb uwierzytelniania, ekspozycja Tailscale. - Zalecenie dotyczące uwierzytelniania: zachowaj **Token** nawet dla loopback, aby lokalni klienci WS musieli się uwierzytelniać. - W trybie tokenu konfiguracja interaktywna oferuje: - **Wygeneruj/zapisz token jako zwykły tekst** (domyślnie) - **Użyj SecretRef** (opcjonalnie) - Quickstart ponownie używa istniejących SecretRefs `gateway.auth.token` przez dostawców `env`, `file` i `exec` na potrzeby sondy onboardingu/bootstrapu panelu. - Jeśli ten SecretRef jest skonfigurowany, ale nie można go rozwiązać, onboarding kończy się wcześnie z jasnym komunikatem naprawczym zamiast po cichu obniżać poziom uwierzytelniania środowiska uruchomieniowego. - W trybie hasła konfiguracja interaktywna obsługuje także przechowywanie zwykłego tekstu albo SecretRef. - Nieinteraktywna ścieżka SecretRef tokenu: `--gateway-token-ref-env `. - Wymaga niepustej zmiennej środowiskowej w środowisku procesu onboardingu. - Nie można łączyć z `--gateway-token`. - Wyłącz uwierzytelnianie tylko wtedy, gdy w pełni ufasz każdemu procesowi lokalnemu. - Wiązania inne niż loopback nadal wymagają uwierzytelniania. - [WhatsApp](/pl/channels/whatsapp): opcjonalne logowanie QR. - [Telegram](/pl/channels/telegram): token bota. - [Discord](/pl/channels/discord): token bota. - [Google Chat](/pl/channels/googlechat): JSON konta usługi + odbiorcy webhooka. - [Mattermost](/pl/channels/mattermost) (plugin): token bota + bazowy URL. - [Signal](/pl/channels/signal): opcjonalna instalacja `signal-cli` + konfiguracja konta. - [iMessage](/pl/channels/imessage): ścieżka CLI `imsg` + dostęp do bazy danych Messages; użyj wrappera SSH, gdy Gateway działa poza komputerem Mac. - Bezpieczeństwo wiadomości prywatnych: domyślnie używane jest parowanie. Pierwsza wiadomość prywatna wysyła kod; zatwierdź przez `openclaw pairing approve ` albo użyj list dozwolonych. - Wybierz obsługiwanego dostawcę, takiego jak Brave, DuckDuckGo, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax Search, Ollama Web Search, Perplexity, SearXNG albo Tavily (albo pomiń). - Dostawcy oparci na API mogą używać zmiennych środowiskowych albo istniejącej konfiguracji do szybkiej konfiguracji; dostawcy bez klucza używają zamiast tego swoich wymagań wstępnych. - Pomiń za pomocą `--skip-search`. - Skonfiguruj później: `openclaw configure --section web`. - macOS: LaunchAgent - Wymaga zalogowanej sesji użytkownika; dla środowiska bezgłowego użyj własnego LaunchDaemon (niedostarczany). - Linux (i Windows przez WSL2): jednostka użytkownika systemd - Onboarding próbuje włączyć utrzymywanie sesji przez `loginctl enable-linger `, aby Gateway pozostał uruchomiony po wylogowaniu. - Może poprosić o sudo (zapisuje `/var/lib/systemd/linger`); najpierw próbuje bez sudo. - **Wybór środowiska uruchomieniowego:** Node (zalecane; wymagane dla WhatsApp/Telegram). Bun **nie jest zalecany**. - Jeśli uwierzytelnianie tokenem wymaga tokenu, a `gateway.auth.token` jest zarządzany przez SecretRef, instalacja demona sprawdza go, ale nie utrwala rozwiązanych wartości tokenu w postaci zwykłego tekstu w metadanych środowiska usługi nadzorcy. - Jeśli uwierzytelnianie tokenem wymaga tokenu, a skonfigurowanego SecretRef tokenu nie można rozwiązać, instalacja demona jest blokowana z praktycznymi wskazówkami. - Jeśli skonfigurowane są jednocześnie `gateway.auth.token` i `gateway.auth.password`, a `gateway.auth.mode` nie jest ustawiony, instalacja demona jest blokowana do czasu jawnego ustawienia trybu. - Uruchamia Gateway (jeśli trzeba) i wykonuje `openclaw health`. - Wskazówka: `openclaw status --deep` dodaje sondę kondycji działającego gatewaya do wyjścia statusu, w tym sondy kanałów, gdy są obsługiwane (wymaga osiągalnego gatewaya). - Odczytuje dostępne skills i sprawdza wymagania. - Pozwala wybrać menedżera node: **npm / pnpm** (bun niezalecany). - Instaluje opcjonalne zależności (niektóre używają Homebrew w macOS). - Podsumowanie + kolejne kroki, w tym prompt **Jak chcesz wykluć swojego agenta?** dla terminala, przeglądarki albo później. Jeśli nie zostanie wykryty interfejs GUI, onboarding wypisuje instrukcje przekierowania portu SSH dla interfejsu sterowania zamiast otwierać przeglądarkę. Jeśli brakuje zasobów interfejsu sterowania, onboarding próbuje je zbudować; rozwiązaniem awaryjnym jest `pnpm ui:build` (automatycznie instaluje zależności UI). ## Tryb nieinteraktywny Użyj `--non-interactive`, aby zautomatyzować lub oskryptować onboarding: ```bash openclaw onboard --non-interactive \ --mode local \ --auth-choice apiKey \ --anthropic-api-key "$ANTHROPIC_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopback \ --install-daemon \ --daemon-runtime node \ --skip-skills ``` Dodaj `--json`, aby uzyskać podsumowanie czytelne maszynowo. Gateway token SecretRef w trybie nieinteraktywnym: ```bash export OPENCLAW_GATEWAY_TOKEN="your-token" openclaw onboard --non-interactive \ --mode local \ --auth-choice skip \ --gateway-auth token \ --gateway-token-ref-env OPENCLAW_GATEWAY_TOKEN ``` `--gateway-token` i `--gateway-token-ref-env` wzajemnie się wykluczają. `--json` **nie** oznacza trybu nieinteraktywnego. W skryptach używaj `--non-interactive` (i `--workspace`). Przykłady poleceń specyficzne dla dostawców znajdują się w sekcji [Automatyzacja CLI](/pl/start/wizard-cli-automation#provider-specific-examples). Użyj tej strony referencyjnej do semantyki flag i kolejności kroków. ### Dodawanie agenta (nieinteraktywnie) ```bash openclaw agents add work \ --workspace ~/.openclaw/workspace-work \ --model openai/gpt-5.5 \ --bind whatsapp:biz \ --non-interactive \ --json ``` ## RPC kreatora Gateway Gateway udostępnia przepływ onboardingu przez RPC (`wizard.start`, `wizard.next`, `wizard.cancel`, `wizard.status`). Klienci (aplikacja macOS, interfejs sterowania) mogą renderować kroki bez ponownej implementacji logiki onboardingu. ## Konfiguracja Signal (signal-cli) Onboarding może zainstalować `signal-cli` z wydań GitHub: - Pobiera odpowiedni zasób wydania. - Przechowuje go w `~/.openclaw/tools/signal-cli//`. - Zapisuje `channels.signal.cliPath` w Twojej konfiguracji. Uwagi: - Kompilacje JVM wymagają **Java 21**. - Kompilacje natywne są używane, gdy są dostępne. - Windows używa WSL2; instalacja signal-cli przebiega zgodnie z przepływem dla Linuksa wewnątrz WSL. ## Co zapisuje kreator Typowe pola w `~/.openclaw/openclaw.json`: - `agents.defaults.workspace` - `agents.defaults.model` / `models.providers` (jeśli wybrano Minimax) - `tools.profile` (lokalne wdrażanie domyślnie używa `"coding"`, gdy wartość nie jest ustawiona; istniejące jawne wartości są zachowywane) - `gateway.*` (tryb, powiązanie, uwierzytelnianie, tailscale) - `session.dmScope` (szczegóły zachowania: [Dokumentacja konfiguracji CLI](/pl/start/wizard-cli-reference#outputs-and-internals)) - `channels.telegram.botToken`, `channels.discord.token`, `channels.matrix.*`, `channels.signal.*`, `channels.imessage.*` - Listy dozwolonych kanałów (Slack/Discord/Matrix/Microsoft Teams), gdy włączysz je w monitach (nazwy są rozwiązywane do identyfikatorów, gdy to możliwe). - `skills.install.nodeManager` - `setup --node-manager` akceptuje `npm`, `pnpm` lub `bun`. - Konfiguracja ręczna nadal może używać `yarn`, ustawiając bezpośrednio `skills.install.nodeManager`. - `wizard.lastRunAt` - `wizard.lastRunVersion` - `wizard.lastRunCommit` - `wizard.lastRunCommand` - `wizard.lastRunMode` `openclaw agents add` zapisuje `agents.list[]` oraz opcjonalne `bindings`. Dane uwierzytelniające WhatsApp trafiają do `~/.openclaw/credentials/whatsapp//`. Sesje są przechowywane w `~/.openclaw/agents//sessions/`. Niektóre kanały są dostarczane jako pluginy. Gdy wybierzesz taki kanał podczas konfiguracji, proces wdrażania wyświetli monit o jego instalację (z npm lub ścieżki lokalnej), zanim będzie można go skonfigurować. ## Powiązana dokumentacja - Omówienie wdrażania: [Wdrażanie (CLI)](/pl/start/wizard) - Wdrażanie aplikacji macOS: [Wdrażanie](/pl/start/onboarding) - Dokumentacja konfiguracji: [Konfiguracja Gateway](/pl/gateway/configuration) - Dostawcy: [WhatsApp](/pl/channels/whatsapp), [Telegram](/pl/channels/telegram), [Discord](/pl/channels/discord), [Google Chat](/pl/channels/googlechat), [Signal](/pl/channels/signal), [iMessage](/pl/channels/imessage) - Skills: [Skills](/pl/tools/skills), [Konfiguracja Skills](/pl/tools/skills-config)