Kreator onboardingu (CLI)

Kreator onboardingu to zalecany sposób konfiguracji OpenClaw na macOS, Linux lub Windows (przez WSL2; mocno zalecane). Konfiguruje lokalny Gateway lub połączenie ze zdalnym Gateway, plus kanały, skills i domyślne ustawienia workspace w jednym prowadzonym przepływie.

openclaw onboard

Info: Najszybszy pierwszy czat: otwórz Control UI (nie trzeba konfigurować kanału). Uruchom openclaw dashboard i czatuj w przeglądarce. Dokumentacja: Dashboard.

Żeby później przekonfigurować:

openclaw configure
openclaw agents add <name>

Uwaga: --json nie implikuje trybu nieinteraktywnego. Dla skryptów użyj --non-interactive.

Wskazówka: Kreator onboardingu zawiera krok web search, w którym możesz wybrać providera (Perplexity, Brave, Gemini, Grok lub Kimi) i wkleić API key, żeby agent mógł używać web_search. Możesz to też skonfigurować później openclaw configure --section web. Dokumentacja: Narzędzia web.

QuickStart vs Zaawansowany

Kreator zaczyna od QuickStart (domyślne) vs Zaawansowany (pełna kontrola).

QuickStart (domyślne)

- Lokalny gateway (loopback)
- Domyślny workspace (lub istniejący workspace)
- Port Gateway **18789**
- Auth Gateway **Token** (automatycznie generowany, nawet na loopback)
- Domyślna polityka narzędzi dla nowych lokalnych konfiguracji: `tools.profile: "coding"` (istniejący jawny profil jest zachowywany)
- Domyślna izolacja DM: lokalny onboarding zapisuje `session.dmScope: "per-channel-peer"` gdy nieustawione. Szczegóły: [Referencja CLI onboardingu](/docs/start/wizard-cli-reference#outputs-and-internals)
- Ekspozycja Tailscale **Wyłączona**
- Telegram + WhatsApp DM domyślnie na **allowlist** (zostaniesz poproszony o numer telefonu)

Zaawansowany (pełna kontrola)

- Pokazuje każdy krok (tryb, workspace, gateway, kanały, daemon, skills).

Co kreator konfiguruje

Tryb lokalny (domyślny) prowadzi cię przez te kroki:

  1. Model/Auth — wybierz dowolny wspierany provider/przepływ auth (API key, OAuth lub setup-token), w tym Custom Provider (OpenAI-compatible, Anthropic-compatible lub Unknown auto-detect). Wybierz domyślny model. Uwaga bezpieczeństwa: jeśli ten agent będzie uruchamiał narzędzia lub przetwarzał treści webhook/hooks, preferuj najsilniejszy dostępny model najnowszej generacji i utrzymuj ścisłą politykę narzędzi. Słabsze/starsze poziomy są łatwiejsze do prompt injection. Dla uruchomień nieinteraktywnych, --secret-input-mode ref przechowuje env-backed refy w profilach auth zamiast wartości plaintext API key. W trybie nieinteraktywnym ref, zmienna środowiskowa providera musi być ustawiona; podanie inline flag key bez tej zmiennej powoduje natychmiastowy błąd. W uruchomieniach interaktywnych, po wybraniu trybu secret reference możesz wskazać na zmienną środowiskową lub skonfigurowaną referencję providera (file lub exec), z szybką walidacją preflight przed zapisem.
  2. Workspace — Lokalizacja plików agenta (domyślnie ~/.openclaw/workspace). Tworzy pliki bootstrap.
  3. Gateway — Port, adres bind, tryb auth, ekspozycja Tailscale. W trybie interaktywnym token, wybierz między domyślnym przechowywaniem tokena plaintext a opt-in SecretRef. Nieinteraktywna ścieżka token SecretRef: --gateway-token-ref-env <ENV_VAR>.
  4. Kanały — WhatsApp, Telegram, Discord, Google Chat, Mattermost, Signal, BlueBubbles lub iMessage.
  5. Daemon — Instaluje LaunchAgent (macOS) lub systemd user unit (Linux/WSL2). Jeśli auth tokena wymaga tokena a gateway.auth.token jest zarządzany przez SecretRef, instalacja daemona waliduje go, ale nie utrwala rozwiązanego tokena w metadanych środowiska usługi nadzorcy. Jeśli auth tokena wymaga tokena a skonfigurowany token SecretRef jest nierozwiązany, instalacja daemona jest blokowana z wskazówkami do działania. Jeśli zarówno gateway.auth.token jak i gateway.auth.password są skonfigurowane a gateway.auth.mode nie jest ustawiony, instalacja daemona jest blokowana do jawnego ustawienia trybu.
  6. Health check — Uruchamia Gateway i weryfikuje, że działa.
  7. Skills — Instaluje zalecane skills i opcjonalne zależności.

Uwaga: Ponowne uruchomienie kreatora nie kasuje niczego, chyba że jawnie wybierzesz Reset (lub podasz --reset). CLI --reset domyślnie do konfiguracji, danych logowania i sesji; użyj --reset-scope full, żeby uwzględnić workspace. Jeśli konfiguracja jest nieprawidłowa lub zawiera legacy keys, kreator prosi o uruchomienie openclaw doctor najpierw.

Tryb zdalny konfiguruje tylko lokalnego klienta do połączenia z Gateway gdzie indziej. Nie instaluje ani nie zmienia niczego na zdalnym hoście.

Dodaj kolejnego agenta

Użyj openclaw agents add <name>, żeby stworzyć osobnego agenta z własnym workspace, sesjami i profilami auth. Uruchomienie bez --workspace startuje kreator.

Co ustawia:

  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir

Uwagi:

  • Domyślne workspace’y mają schemat ~/.openclaw/workspace-<agentId>.
  • Dodaj bindings, żeby routować przychodzące wiadomości (kreator może to zrobić).
  • Flagi nieinteraktywne: --model, --agent-dir, --bind, --non-interactive.

Pełna referencja

Po szczegółowe rozkłady krok po kroku i wyjścia konfiguracji, zobacz Referencja CLI onboardingu. Po przykłady nieinteraktywne, zobacz CLI Automation. Po głębszą referencję techniczną, w tym szczegóły RPC, zobacz Referencja kreatora.

Powiązane dokumenty

arrow_back
Poprzedni
Onboarding Overview
Następny
Onboarding
arrow_forward