Wprowadzenie (CLI)

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.

Aby później zmienić konfigurację:

openclaw configureopenclaw agents add <name>

Szybki start a tryb zaawansowany

Onboarding zaczyna się od wyboru Szybkiego startu (ustawienia domyślne) albo Zaawansowanego (pełna kontrola).

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.

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

• Dokumentacja polecenia CLI: openclaw onboard
• Omówienie onboardingu: Omówienie onboardingu
• Onboarding aplikacji macOS: Onboarding
• Rytuał pierwszego uruchomienia agenta: Bootstrap agenta