Przejdź do głównej treści
Onboarding CLI jest zalecaną ścieżką konfiguracji terminalowej OpenClaw na macOS, Linux lub Windows. Użytkownicy pulpitu Windows mogą też zacząć od Centrum Windows. Konfiguruje lokalny Gateway albo połączenie ze zdalnym Gateway, a także kanały, Skills i domyślne ustawienia obszaru roboczego w jednym prowadzonym procesie. 
openclaw onboard
Szybki start zwykle zajmuje tylko kilka minut, ale pełny onboarding może potrwać dłużej, gdy logowanie do dostawcy, parowanie kanałów, instalacja demona, pobieranie z sieci, Skills lub opcjonalne Plugin wymagają dodatkowej konfiguracji. Kreator pokazuje ten harmonogram na początku, a kroki opcjonalne można pominąć i wrócić do nich później za pomocą openclaw configure.

​
Ustawienia regionalne

Kreator CLI lokalizuje stałe teksty onboardingu. Ustala ustawienia regionalne z OPENCLAW_LOCALE, następnie LC_ALL, potem LC_MESSAGES, potem LANG, a w razie potrzeby wraca do angielskiego. Obsługiwane ustawienia regionalne kreatora to en, zh-CN i zh-TW. 
OPENCLAW_LOCALE=zh-CN openclaw onboard
Nazwy i stabilne identyfikatory pozostają dosłowne: OpenClaw, Gateway, Tailscale, polecenia, klucze konfiguracji, adresy URL, identyfikatory dostawców, identyfikatory modeli oraz etykiety pluginów/kanałów nie są tłumaczone.
Najszybszy pierwszy czat: otwórz Control UI (konfiguracja kanału nie jest potrzebna). Uruchom openclaw dashboard i czatuj w przeglądarce. Dokumentacja: Panel.
Aby później zmienić konfigurację: 
openclaw configure
openclaw agents add <name>
--json nie oznacza trybu nieinteraktywnego. W skryptach użyj --non-interactive.
Onboarding CLI obejmuje krok wyszukiwania w sieci, w którym możesz wybrać dostawcę takiego jak Brave, DuckDuckGo, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax Search, Ollama Web Search, Perplexity, SearXNG lub Tavily. Niektórzy dostawcy wymagają klucza API, inni działają bez klucza. Możesz też skonfigurować to później za pomocą openclaw configure --section web. Dokumentacja: Narzędzia webowe.

​
Szybki start a tryb zaawansowany

Onboarding zaczyna się od wyboru Szybkiego startu (ustawienia domyślne) albo Zaawansowanego (pełna kontrola).
  • Lokalny Gateway (loopback)
  • Domyślny obszar roboczy (albo istniejący obszar roboczy)
  • Port Gateway 18789
  • Uwierzytelnianie Gateway Token (generowane automatycznie, nawet na loopback)
  • Domyślna polityka narzędzi dla nowych konfiguracji lokalnych: tools.profile: "coding" (istniejący jawny profil jest zachowywany)
  • Domyślna izolacja DM: lokalny onboarding zapisuje session.dmScope: "per-channel-peer", gdy nie jest ustawione. Szczegóły: Dokumentacja konfiguracji CLI
  • Ekspozycja Tailscale Wyłączona
  • DM Telegram + WhatsApp domyślnie używają listy dozwolonych (pojawi się prośba o podanie numeru telefonu)

​
Co konfiguruje onboarding

Tryb lokalny (domyślny) prowadzi przez te kroki:
  1. Model/Uwierzytelnianie — wybierz dowolnego obsługiwanego dostawcę/przepływ uwierzytelniania (klucz API, OAuth albo ręczne uwierzytelnianie specyficzne dla dostawcy), w tym Custom Provider (zgodny z OpenAI, zgodny z Anthropic albo automatyczne wykrywanie Unknown). Wybierz model domyślny. Uwaga dotycząca bezpieczeństwa: jeśli ten agent będzie uruchamiać narzędzia lub przetwarzać treści Webhook/hooków, preferuj najmocniejszy dostępny model najnowszej generacji i utrzymuj ścisłą politykę narzędzi. Słabsze/starsze poziomy łatwiej podatne są na prompt injection. W uruchomieniach nieinteraktywnych --secret-input-mode ref zapisuje referencje oparte na zmiennych środowiskowych w profilach uwierzytelniania zamiast wartości kluczy API w tekście jawnym. W nieinteraktywnym trybie ref zmienna środowiskowa dostawcy musi być ustawiona; przekazanie flag klucza inline bez tej zmiennej środowiskowej szybko kończy się błędem. W uruchomieniach interaktywnych wybór trybu referencji sekretu pozwala wskazać zmienną środowiskową albo skonfigurowaną referencję dostawcy (file lub exec), z szybką walidacją wstępną przed zapisaniem. Dla Anthropic interaktywny onboarding/konfiguracja oferuje Anthropic Claude CLI jako preferowaną ścieżkę lokalną oraz klucz API Anthropic jako zalecaną ścieżkę produkcyjną. Anthropic setup-token pozostaje też dostępny jako obsługiwana ścieżka uwierzytelniania tokenem.
  2. Obszar roboczy — lokalizacja plików agenta (domyślnie ~/.openclaw/workspace). Zasiewa pliki startowe.
  3. Gateway — port, adres bindowania, tryb uwierzytelniania, ekspozycja Tailscale. W interaktywnym trybie tokena wybierz domyślne przechowywanie tokena w tekście jawnym albo włącz SecretRef. Nieinteraktywna ścieżka SecretRef tokena: --gateway-token-ref-env <ENV_VAR>.
  4. Kanały — wbudowane i oficjalne kanały czatu Plugin, takie jak iMessage, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp i inne.
  5. Demon — instaluje LaunchAgent (macOS), jednostkę użytkownika systemd (Linux/WSL2) albo natywne zadanie Harmonogramu zadań Windows z awaryjną ścieżką folderu Startup dla użytkownika. Jeśli uwierzytelnianie tokenem wymaga tokena, a gateway.auth.token jest zarządzane przez SecretRef, instalacja demona je waliduje, ale nie utrwala rozwiązanego tokena w metadanych środowiska usługi nadzorującej. Jeśli uwierzytelnianie tokenem wymaga tokena, a skonfigurowany token SecretRef jest nierozwiązany, 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 ustawione, instalacja demona jest blokowana do czasu jawnego ustawienia trybu.
  6. Kontrola kondycji — uruchamia Gateway i sprawdza, czy działa.
  7. Skills — instaluje zalecane Skills i opcjonalne zależności.
Ponowne uruchomienie onboardingu nie usuwa niczego, chyba że jawnie wybierzesz Reset (albo przekażesz --reset). CLI --reset domyślnie obejmuje konfigurację, dane uwierzytelniające i sesje; użyj --reset-scope full, aby uwzględnić obszar roboczy. Jeśli konfiguracja jest nieprawidłowa albo zawiera starsze klucze, onboarding poprosi o wcześniejsze uruchomienie openclaw doctor.
Tryb zdalny konfiguruje tylko lokalnego klienta do łączenia się z Gateway w innym miejscu. Nie instaluje ani nie zmienia niczego na zdalnym hoście.

​
Dodaj kolejnego agenta

Użyj openclaw agents add <name>, aby utworzyć osobnego agenta z własnym obszarem roboczym, sesjami i profilami uwierzytelniania. Uruchomienie bez --workspace uruchamia onboarding. Co ustawia:
  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir
Uwagi:
  • Domyślne obszary robocze używają ~/.openclaw/workspace-<agentId>.
  • Dodaj bindings, aby kierować wiadomości przychodzące (onboarding może to zrobić).
  • Flagi nieinteraktywne: --model, --agent-dir, --bind, --non-interactive.

​
Pełna dokumentacja

Szczegółowy opis krok po kroku i dane wyjściowe konfiguracji znajdziesz w Dokumentacji konfiguracji CLI. Przykłady nieinteraktywne znajdziesz w Automatyzacji CLI. Głębszą dokumentację techniczną, w tym szczegóły RPC, znajdziesz w Dokumentacji onboardingu.

​
Powiązana dokumentacja