Przejdź do głównej treści

FAQ

Szybkie odpowiedzi oraz pogłębione rozwiązywanie problemów dla rzeczywistych konfiguracji (lokalne środowisko deweloperskie, VPS, wiele agentów, OAuth/klucze API, przełączanie modeli). W przypadku diagnostyki czasu działania zobacz Rozwiązywanie problemów. Pełne odniesienie do konfiguracji znajdziesz w Konfiguracja.

Spis treści

Pierwsze 60 sekund, gdy coś nie działa

  1. Szybki status (pierwsze sprawdzenie)
    openclaw status
    
    Szybkie lokalne podsumowanie: system operacyjny + aktualizacja, dostępność gateway/usługi, agenci/sesje, konfiguracja dostawców + problemy środowiska uruchomieniowego (gdy gateway jest osiągalny).
  2. Raport do wklejenia (bezpieczny do udostępnienia)
    openclaw status --all
    
    Diagnostyka tylko do odczytu z końcówką logów (tokeny zanonimizowane).
  3. Stan demona i portów
    openclaw gateway status
    
    Pokazuje środowisko uruchomieniowe nadzorcy vs dostępność RPC, docelowy URL sondy oraz którą konfigurację usługa prawdopodobnie użyła.
  4. Głębokie sondy
    openclaw status --deep
    
    Uruchamia kontrole zdrowia gateway + sondy dostawców (wymaga osiągalnego gateway). Zobacz Health.
  5. Podgląd najnowszego logu
    openclaw logs --follow
    
    Jeśli RPC nie działa, użyj zapasowo:
    tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"
    
    Logi plikowe są oddzielne od logów usługi; zobacz Logging oraz Rozwiązywanie problemów.
  6. Uruchom lekarza (naprawy)
    openclaw doctor
    
    Naprawia/migruje konfigurację i stan + uruchamia kontrole zdrowia. Zobacz Doctor.
  7. Migawka Gateway
    openclaw health --json
    openclaw health --verbose   # shows the target URL + config path on errors
    
    Pyta działający gateway o pełną migawkę (tylko WS). Zobacz Health.

Szybki start i konfiguracja przy pierwszym uruchomieniu

Utknęłem to, co najszybszy sposób na odklejenie

Użyj lokalnego agenta AI, który może zobaczyć Twoją maszynę. Jest to o wiele skuteczniejsze niż zapytanie na Discordzie, ponieważ większość przypadków “Jestem utknięty” to lokalne problemy z konfiguracją lub środowiskiem, których zdalni pomocnicy nie mogą sprawdzić. Narzędzia te mogą odczytywać repo, uruchamiać polecenia, przeglądać dzienniki i pomóc naprawić konfigurację twojego poziomu (usługi PATH, uprawnienia, pliki autoryzacyjne). Daj im pełną płatność źródłową poprzez instalację hakowalną (git):
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
To instaluje OpenClaw z git checkout, aby agent mógł przeczytać kod + dokumenty i przyczynę dokładnej wersji, którą działasz. Zawsze możesz wrócić do stabilnego później poprzez ponowne uruchomienie instalatora bez --install-method git. Wskazówka: poproś agenta o zaplanowanie i nadzór naprawę (krok po kroku), a następnie wykonaj tylko potrzebne polecenia . To sprawia, że zmiany są małe i łatwiejsze do kontrolowania. Jeśli odkryjesz prawdziwy błąd lub poprawkę, proszę zgłosić problem z GitHub lub wysłać PR: https://github.com/openclaw/openclaw/issues https://github.com/openclaw/openclaw/pulls Zacznij od tych poleceń (udostępniaj dane wyjściowe, gdy poproś o pomoc):
status openclaw
openclaw models status
openclaw lekarz
Co robią:
  • openclaw status: szybki zrzut batewa/agent health + podstawowe konfiguracje.
  • openclaw model: sprawdza autoryzację dostawcy + dostępność modelu.
  • openclaw doktorem: sprawdza i naprawia wspólne problemy z konfiguracją/stanem.
Inne przydatne sprawdzenie CLI: openclaw --all, openclaw logs --follow, status bramy otwartej, openclaw health --verbose. Pętla szybkiego debugowania: Pierwsze 60 sekund jeśli coś się zepsuje. Zainstaluj dokumenty: Install, flagi instalatora, Updating.

Jaki jest zalecany sposób instalacji i konfiguracji OpenClaw

Repozytorium zaleca korzystanie ze źródła i korzystanie z kreatora wdrożeń:
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw na board --install-daemon
Kreator może również automatycznie budować zasoby interfejsu. Po wejściu na pokład, zazwyczaj uruchamiasz bramę na porcie 18789. Z źródła (współtwórcy/dev):
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build # auto-installs UI deps przy pierwszym uruchomieniu
openclaw na pokładzie
Jeśli nie masz jeszcze globalnej instalacji, uruchom ją przez pnpm openclaw onboard.

Jak otworzyć pulpit po wprowadzeniu

Kreator otwiera przeglądarkę z czystym (nietokenizowanym) pulpitu URL bezpośrednio po wprowadzeniu i wyświetla link w podsumowaniu. Pozostaw tę kartę otwarte; jeśli nie uruchomi się, skopiuj/wklej wydrukowany adres URL na tym samym komputerze.

Jak uwierzytelnić token pulpitu nawigacyjnego na localhost vs remote

Localhost (ta sama maszyna):
  • Otwórz http://127.0.0.1:18789/.
  • Jeśli prosi o autoryzację, wklej token z gateway.auth.token (lub OPENCLAW_GATEWAY_TOKEN) do ustawień interfejsu użytkownika.
  • Pobierz go z hosta bramy: openclaw config get gateway.auth.token (lub wygeneruj: openclaw doctor --generate-gateway-token).
Nie na serwerze:
  • Seria ogonowa (zalecane): zachowaj powiązaną pętlę, uruchom openclaw gateway --tailscale serve, otwórz https://<magicdns>/. Jeśli gateway.auth.allowTailscale jest true, nagłówki tożsamości spełniają autoryzację (bez tokenu).
  • Wiązanie sieci ogonowej: uruchom openclaw gateway --bind tailnet --token "<token>", otwórz http://<tailscale-ip>:18789/, wklej token w ustawieniach tablicy.
  • Tunel SSH: ssh -N -L 18789:127.0.0.1:18789 user@host i otwórz http://127.0.0.1:18789/ i wklej token w ustawieniach Control UI.
Zobacz Dashboard i powierzchnie internetowe dla trybów łączenia i uwierzytelniania.

Jaki czas pracy potrzebuję

Węzeł >= 22 jest wymagany. pnpm jest zalecane. Bun nie jest zalecany dla bramy.

Czy działa na Raspberry Pi

Tak. Brama jest lekka - dokumentacja 512MB-1GB RAM, 1 rdzenia, i około 500MB na dysku wystarczająco dużo do użytku osobistego i pamiętaj, że Raspberry Pi 4 może go uruchomić. Jeśli potrzebujesz dodatkowych nagród (dzienniki, media, inne usługi), rekomendowane jest 2G, ale to nie jest twardym minimum. Wskazówka: mały Pi/VPS może hostować bramę i możesz sparować węzły na laptop/telefon dla lokalnego ekranu/kamera/płótna lub polecenia. Zobacz Nodes.

Dowolne wskazówki dla instalacji Raspberry Pi

Krótka wersja: zadziała, ale oczekuje przybliżonych krawędzi.
  • Użyj 64-bitowego OS i zachowaj węzeł >= 22.
  • Preferuj hackable (git) install, aby można było szybko zobaczyć logi i zaktualizować.
  • Zacznij bez kanałów/umiejętności, a następnie dodaj je jeden po drugim.
  • Jeśli uderzysz w dziwne problemy binarne, to zazwyczaj jest to problem kompatybilności ARM.
Dokumenty: Linux, Install.

To utknęło na pobudce mojego przyjaciela na pokładzie nie wykluje się co teraz

Ten ekran zależy od tego, czy brama jest dostępna i uwierzytelniana. TUI wysyła również “Wybudź się, mój przyjacielu!” automatycznie na pierwszym luku. Jeśli widzisz tę linię bez odpowiedzi i tokeny pozostają na 0, przedstawiciel nigdy nie ranking.
  1. Zrestartuj Gateway:
openclaw gateway restart
  1. Sprawdź status + autoryzacja:
status openclaw
openclaw models status
openclaw logi --follow
  1. Jeżeli nadal się zawiesza, bieg:
openclaw doctor
Jeśli brama jest zdalna, upewnij się, że połączenie z tunelem/skalą ailscale jest gotowe i że interfejs użytkownika jest zaznaczony na odpowiedniej bramie. Zobacz Remote access.

Czy mogę przenieść moją konfigurację na nową maszynę Mac mini bez ponownego wprowadzania na pokład?

Tak. Skopiuj katalog stanów i obszar roboczy, a następnie uruchom Doctor jeden raz. To utrzymuje Twój bot “dokładnie identyczny” (pamięć, historia sesji, autoryzacja i kanał ), o ile kopiujesz obydwa lokalizacje:
  1. Zainstaluj OpenClaw na nowym komputerze.
  2. Skopiuj $OPENCLAW_STATE_DIR (domyślnie: ~/.openclaw) ze starej maszyny.
  3. Skopiuj swój projekt (domyślnie: ~/.openclaw/workspace).
  4. Uruchom openclaw doctor i uruchom ponownie usługę bramy.
Zachowuje konfigurację, profile uwierzytelniania, tworzenie WhatsApp, sesje i pamięć. Jeśli jesteś w trybie zdalnym , zapamiętaj gospodarza bramy posiada sklep sesji i obszar roboczy. Important: if you only commit/push your workspace to GitHub, you’re backing up memory + bootstrap files, but not session history or auth. Te żywe pod adresem ~/.openclaw/ (na przykład ~/.openclaw/agents/<agentId>/sessions/). Powiązano: Migrating, Gdzie rzeczy żyją na dysku, Obszar roboczy agenta, Doctor, Tryb zdalny.

Gdzie widzę co nowego w najnowszej wersji

Sprawdź listę zmian GitHub: https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md Najnowsze wpisy znajdują się u góry. Jeśli górna część jest oznaczona Niezwolniona, kolejna sekcja jest najnowszą wersją wysłaną. Wpisy są pogrupowane według Podkreślania, Zmian, i Naprawione (plus dokumentacja/inne sekcje w razie potrzeby).

Nie mam dostępu do docs.openclaw.ai błąd SSL

Niektóre połączenia kompresji / Xfinity niepoprawnie blokują docs.openclaw.ai przez Xfinity Zaawansowane Bezpieczeństwo. Wyłącz lub zezwól na listę docs.openclaw.ai, a następnie spróbuj ponownie. Więcej szczegóły: Troubleshooting. Pomóż nam odblokować, zgłaszając tutaj: https://spa.xfinity.com/check_url_status. Jeśli nadal nie możesz dotrzeć do witryny, dokumenty są lustrzane na GitHub: https://github.com/openclaw/openclaw/tree/main/docs

Jaka jest różnica między stabilną a beta

Stabilne i beta to npm dist-tags, a nie oddzielne linie kodu:
  • latest = stabilne
  • beta = wczesna kompilacja do testów
Wysyłamy do beta, przetestujemy je, a gdy budowa będzie solidna, promujemy i tę samą wersję latest. Dlatego beta i stabilne mogą wskazywać na tej samej wersji. Zobacz co zmienione: https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

Jak zainstalować wersję beta i jaka jest różnica między beta i dev

Beta jest znacznikiem dystansowym npm beta (może pasować do latest). Dev jest ruchomą głową main (git); po publikacji używa on npm dist-tag dev. Jednolinijkowe polecenia (macOS/Linux):
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git
Instalator Windows (PowerShell): https://openclaw.ai/install.ps1 Więcej informacji: kanały deweloperskie i flagi instalatora.

Jak długo trwa instalacja i wdrożenie

Prosty przewodnik:
  • Zainstaluj: 2-5 minut
  • Włączanie: 5-15 minut w zależności od ile kanałów/modeli konfigurujesz
Jeśli powiesza się, użyj Installer stuck i pętli szybkiego debugowania w Im stuck.

Jak spróbować najnowszych bitów

Dwa opcje:
  1. Kanał deweloperski (git checkout):
aktualizacja openclaw --channel dev
To przełącza się na gałąź main i aktualizacje ze źródła.
  1. Instalacja Hackable (z strony instalatora):
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
To daje Ci lokalne repozytorium które możesz edytować, a następnie aktualizować za pomocą git. Jeśli wolisz czysty klon, należy użyć:
Klon git https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm
Dokumenty: Update, kanały rozwoju, Install.

Instalator utknął jak uzyskać więcej opinii

Uruchom ponownie instalator z dokładnym wyjściem:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --verbose
Instalacja Beta z verbose:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --beta --verbose
Dla instalacji hakowalnej (git):
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose
Więcej opcji: flagi instalatora.

Windows install mówi, że git nie został znaleziony lub openclaw nie został rozpoznany

Dwa częste problemy z systemem Windows: 1) błąd spawn git / git nie znaleziony
  • Zainstaluj Git dla Windows i upewnij się, że git jest na Twoim PATH.
  • Zamknij i ponownie otwórz PowerShell, a następnie uruchom ponownie instalator.
2) openclaw nie jest rozpoznany po zainstalowaniu
  • Twój globalny katalog npm nie jest na PATH.
  • Sprawdź ścieżkę:
    npm config get prefix
    
  • Upewnij się, że <prefix>\\bin jest na PATH (w większości systemów, to %AppData%\\npm).
  • Zamknij i ponownie otwórz PowerShell po aktualizacji PATH.
Jeśli chcesz, aby najpłynniejsza konfiguracja Windows, użyj WSL2 zamiast natywnych Windows. Dokumenty: Windows.

Dokumentacja nie odpowiedziała na moje pytanie, jak uzyskać lepszą odpowiedź

Użyj hackable (git) install, aby mieć wszystkie źródła i dokumentację lokalnie, następnie zapytaj swojego bota (lub Claude/Codex) z tego folderu aby mógł dokładnie odczytać repozytorium i odpowiedzieć.
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
Więcej informacji: Install i flagi instalatora.

Jak zainstalować OpenClaw na Linux

Krótka odpowiedź: postępuj zgodnie z przewodnikiem Linux, a następnie uruchom kreatora wdrożenia.

Jak zainstalować OpenClaw na VPS

Każdy system VPS Linux działa. Zainstaluj na serwerze, a następnie użyj SSH/Tailscale aby dotrzeć do bramy. Przewodniki: exe.dev, Hetzner, Fly.io. Zdalny dostęp: Brama zdalna.

Gdzie są przewodniki instalacji cloudVPS

Utrzymujemy węzeł hostingowy ze wspólnymi dostawcami. Wybierz jeden i postępuj zgodnie z przewodnikiem: Jak działa w chmurze: Brama działa na serwerze, i uzyskujesz dostęp do niej z laptopa/telefonu za pośrednictwem interfejsu użytkownika sterowania (lub skala/SSH). Twój stan + obszar roboczy na żywo na serwerze, więc traktuj hosta jako źródło prawdy i zapisuj go ponownie. Możesz sparować węzły (Mac/iOS/Android/headless) z tą bramą chmury aby uzyskać dostęp do lokalnego ekranu/kamery/płótna lub uruchomić polecenia na swoim laptopie, trzymając bramę w chmurze. Hub: Platforms. Zdalny dostęp: Brama zdalna. Nodes: Nodes, Nodes CLI.

Czy mogę prosić OpenClaw o aktualizację

Krótka odpowiedź: możliwa, nie zalecana. Przepływ aktualizacji może zrestartować bramę (która usuwa aktywną sesję), może potrzebować czystego zamówienia gita, a może poprosić o potwierdzenie. Bezpieczniej: uruchom aktualizacje z powłoki jako operatora. Użyj CLI:
openclaw update
openclaw update
openclaw update --channel stable|beta|dev
openclaw update --tag <dist-tag|version>
openclaw update --no-restart
Jeśli musisz zautomatyzować od agenta:
aktualizacja openclaw --yes --no-restart
uruchom ponownie bramę otwierania
Dokumenty: Update, Updating.

Co faktycznie robi kreator wdrażania

openclaw onboard jest zalecaną ścieżką konfiguracji. W trybie lokalnym przechodzisz przez Ciebie:
  • Model/auth setup (Antropowy setup-token zalecany dla subskrypcji Claude’a, obsługiwany OpenAI Codex OAuth, klucze API opcjonalne, lokalne modele LM Studio)
  • Obszar roboczy lokalizacja + pliki bootstrap
  • **Ustawienia bramy ** (bind/port/auth/tailscale)
  • Dostawcy (WhatsApp, Telegram, Discord, Najlepsze (plugin), Signal, iMessage)
  • Instalacja Daemona (LaunchAgent na macOS; jednostka użytkownika systemu na Linux/WSL2)
  • Wybór Ocena zdrowia i umiejętności
Ostrzega również, czy skonfigurowany model jest nieznany lub brakuje autoryzacji.

Potrzebuję subskrypcji Claude lub OpenAI aby uruchomić to

Nie. You can run OpenClaw with API keys (Anthropic/OpenAI/others) or with local-only models so your data stays on your device. Subskrypcje (Claude Pro/Max lub OpenAI Codex) są opcjonalnymi sposobami uwierzytelniania tych dostawców. Dokumenty: Anthropic, OpenAI, modele lokalne, Models.

Czy mogę używać subskrypcji Claude Max bez klucza API

Tak. Możesz uwierzytelnić się za pomocą tokenu setup-token zamiast klucza API. To jest ścieżka subskrypcji. Subskrypcje Claude Pro/Max nie zawierają klucza API, więc jest to poprawna metoda dla kont subskrypcji. Ważne: musisz zweryfikować z Antropię, że to użycie jest dozwolone zgodnie z ich zasadami i warunkami subskrypcji. Jeśli chcesz najbardziej wyraźna, obsługiwana ścieżka, użyj Antropicznego klucza API.

Jak działa autoryzacja antropowego setuptoken

claude setup-token generuje ciąg tokenów za pośrednictwem kodu Claude Code CLI (nie jest on dostępny w konsoli internetowej). Możesz uruchomić go na każdej maszynie. Wybierz Token Antropiczny (wklej token setup-token) w kreatorze lub wklej go za pomocą openclaw models auth paste-token --provider antropiczny. Token jest przechowywany jako profil autoryzacji dostawcy antropicznego i używany jako klucz API (bez automatycznego odświeżania). Więcej szczegółów: OAuth.

Gdzie znajdę Antropiczny setuptoken

To nie w konsoli Antropicznej. Token konfiguracyjny jest generowany przez **CLI kodu Claude ** na dowolnej maszynie:
claude setup-token
Skopiuj token wydrukowany, a następnie wybierz **Antropiczny token (wklej token konfiguracyjny) ** w kreatorze. Jeśli chcesz uruchomić go na serwerze bramy, użyj openclaw models auth setup-token --provider antropiczny. Jeśli używałeś claude setup-token gdzie indziej, wklej go do hosta bramy openclaw models auth paste-token --provider anthropic. Zobacz Anthropic.

Czy wspierasz autoryzację subskrypcji Claude (Claude Pro lub Max)

Tak - przez setup-token. OpenClaw nie używa już tokenów Claude Code CLI OAuth; użyj tokenu konfiguracyjnego lub Antropowego API. Wygeneruj token gdziekolwiek i wklej go do hosta bramy. Zobacz Anthropic i OAuth. Uwaga: Dostęp do subskrypcji Claude podlega warunkom Antropii. Dla produkcji lub wielu użytkowników klucze API są zazwyczaj bezpieczniejszym wyborem.

Dlaczego widzę błąd stawki HTTP 429 z Antropic

Oznacza to, że Twój limit Antropiczny jest wyczerpany dla bieżącego okna. If you use a Claude subscription (setup-token or Claude Code OAuth), wait for the window to reset or upgrade your plan. Jeśli używasz Antropowego klucza API, sprawdź Antropic Console pod kątem użycia/rozliczeń i podnieś limity w razie potrzeby. Wskazówka: ustaw model awaryjny, aby OpenClaw mógł nadal odpowiadać podczas gdy dostawca jest ograniczony stawkami. Zobacz Models i OAuth.

Czy AWS jest obsługiwany

Tak - poprzez dostawcę Amazon Bedrock (Converse) z manualną konfiguracją. Musisz podać dane logowania/region AWS na serwerze bramki i dodać wpis dostawcy Bedrock do konfiguracji modeli. Zob. Amazon Bedrock i Model providers. Jeśli wolisz obsługiwany przepływ klucza, proxy kompatybilne z OpenAI przed Bedrock jest nadal poprawną opcją.

Jak działa autoryzacja Codex

OpenClaw obsługuje OpenAI Code (Codex) poprzez OAuth (ChatGPT Log-in). Kreator może uruchomić przepływ OAuth i w stosownych przypadkach ustawiy domyślny model na openai-codex/gpt-5.3-codex. Zobacz dostawcy modelu i Wizard.

Czy wspierasz subskrypcję OpenAI auth Codex OAuth

Tak. OpenClaw w pełni obsługuje OpenAI Code (Codex) subskrypcję OAuth. Kreator wdrażania może uruchomić dla Ciebie przepływ OAuth. Zobacz OAuth, Dostawcy modelów i Wizard.

Jak skonfigurować Gemini CLI OAuth

Gemini CLI używa automatycznego przepływu wtyczek, a nie identyfikatora klienta lub tajnego w openclaw.json. Kroki:
  1. Włącz wtyczkę: openclaw plugins włącza google-gemini-cli-auth
  2. Logowanie: openclaw models auth login --provider google-gemini-cli --set-default
To przechowuje tokeny OAuth w profilach uwierzytelniania na serwerze bramy. Szczegóły: Dostawcy modelu.

Jest lokalnym modelem OK dla czatów dorywczych

Zazwyczaj nr OpenClaw potrzebuje dużego kontekstu + silnego bezpieczeństwa; małe karty są obcięte i przecieki. Jeśli musisz uruchomić największe wersję MiniMax M2.1 możesz lokalnie (LM Studio) i zobaczyć /gateway/local-models. Mniejsze/kwantyfikowane modele zwiększają ryzyko szybkiego zatłaczania - zobacz Security.

Jak mogę utrzymać ruch modelowy w określonym regionie

Wybierz przypięte do regionu punkty końcowe. OpenRouter ujawnia opcje hostowane przez USA dla MiniMax, Kim i GLM; wybierz wariant hostowany przez US, aby przechowywać dane w regionie. Nadal możesz wyświetlić listę Anthropic/OpenAI wraz z nimi używając models.mode: "merge" więc rezerwa pozostanie dostępna przy jednoczesnym poszanowaniu wybranego przez Ciebie regionalnego dostawcy.

Czy muszę kupić Mac Mini aby to zainstalować

Nie. OpenClaw działa na macOS lub Linux (Windows via WSL2). Mac mini jest opcjonalny - niektórzy ludzie kupują go jako zawsze gościa, ale działa również mały VPS, serwer domowy lub Raspberry Piklasa. Potrzebujesz tylko Maca dla narzędzi macOS. Dla iMessage, użyj BlueBubbles (zalecane) - serwer BlueBubbles działa na dowolnym komputerze Mac, a brama może działać na Linux lub gdzie indziej. Jeśli chcesz użyć innych narzędzi macOS, uruchom bramę na Mac lub sparowaj węzeł macOS. Dokumenty: BlueBubbles, Nodes, Tryb zdalny Mac.

Potrzebuję Mac mini dla wsparcia iMessage

Potrzebujesz jakiegoś urządzenia macOS zalogowanego do wiadomości. To nie musi być Mac mini - żaden Mac działa. Użyj BlueBubbles (zalecane) dla iMessage - serwer BlueBubbles działa na macOS, podczas gdy brama może działać na Linux lub gdzie indziej. Częste konfiguracje:
  • Uruchom bramę na Linux/VPS i uruchom serwer BlueBubbles na dowolnym Mac podpisanym w wiadomości.
  • Uruchom wszystko na Macie, jeśli chcesz najprostszą konfigurację jednomaszynową.
Dokumenty: BlueBubbles, Nodes, Tryb zdalny Mac.

Jeśli kupię Mac mini do uruchomienia OpenClaw mogę podłączyć go do mojego MacBook Pro

Tak. Mac mini może uruchomić bramę, a Twój MacBook Pro może połączyć się jako węzeł (urządzenie towarzyszące). Węzły nie uruchamiają bramy - zapewniają dodatkowe możliwości , takie jak ekran, kamera/płótno i system.run na tym urządzeniu. Często wzorze:
  • Brama na Mac mini (zawsze włączona).
  • MacBook Pro uruchamia aplikację macOS lub host węzła i pary do bramy.
  • Użyj openclaw nodes status / openclaw nodes list aby to zobaczyć.
Dokumentacja: Nodes, Nodes CLI.

Mogę używać Buna

Bun jest niezalecany. Widzimy błędy czasu pracy, zwłaszcza z WhatsApp i Telegram. Użyj węzła dla stabilnych bram. Jeśli nadal chcesz eksperymentować z Bunem, zrób to na bramie nieprodukcyjnej bez WhatsApp/Telegram.

Telegram co jest dozwolone

channels.telegram.allowFrom jest ID użytkownika użytkownika Telegrama (numerycznie, zalecane) lub @username. To nie jest nazwa użytkownika bota. Bezpieczniej (bez bota podmiotu trzeciego):
  • DM twojego bota, a następnie uruchom openclaw logs --follow i przeczytaj from.id.
Oficjalny bot API:
  • DM twojego bota, a następnie wywołaj https://api.telegram.org/bot<bot_token>/getUpdates i przeczytaj message.from.id.
Podmiot trzeci (mniej prywatne):
  • Plik @userinfobot lub @getidsbot.
Zobacz /channels/telegram.

Można używać jednego numeru WhatsApp z różnymi instancjami OpenClaw

Tak, przez przekierowywanie wielu agentów. Bind each sender’s WhatsApp DM (peer kind: "direct", sender E.164 like +15551234567) to a different agentId, so each person gets their own workspace and session store. Odpowiedzi nadal pochodzą z tego samego konta WhatsApp, a kontrola dostępu DM (channels.whatsapp.dmPolicy / channels.whatsapp.allowFrom) jest globalna dla konta WhatsApp. Zobacz dzwonienie wielu agentów i WhatsApp.

Czy mogę uruchomić szybki agent czatu i Opus dla agenta kodującego

Tak. Użyj przekierowywania wielu agentów: daj każdemu agentowi swój własny domyślny model, a następnie połącz trasy przychodzące (konto dostawcy lub konkretne partnery) z każdym agentem. Przykładowa konfiguracja życia w dzwonieniu wielu agentów. Zobacz również Models i Configuration.

Homebrew pracuje na Linux

Tak. Homebrew obsługuje Linux (Linuxbrew). Szybka konfiguracja:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profile
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
brew install <formula>
Jeśli uruchomisz OpenClaw za pośrednictwem systemu, upewnij się, że usługa PATH zawiera /home/linuxbrew/.linuxbrew/bin (lub twój prefiks brajski), więc narzędzia zainstalowane w powłokach nie logowania. Ostatnie kompilacje poprzedzają również zwykłe bloki użytkowników na usługach systemu Linux (na przykład /.local/bin, /.npm-global/bin, /.local/share/pnpm, /. un/bin) i honor PNPM_HOME, NPM_CONFIG_PREFIX, BUN_INSTALL, VOLTA_HOME, ASDF_DATA_DIR, NVM_DIR, oraz FNM_DIR`, gdy ustawione.

Jaka jest różnica między instalacją hackable git a instalacją npm

  • Instalacja hackable (git): pełne zamówienie źródłowe, edytowalne, najlepsze dla współtwórców. Uruchamiasz wersje lokalnie i możesz aktualizować kod/dokumenty.
  • npm install: globalna instalacja CLI, brak repozytorium, najlepsze dla “po prostu uruchom go”. Aktualizacje pochodzą z npm dist-tags.
Dokumenty: Pierwsze kroki, Updating.

Mogę przełączyć się między instalacjami npm i git później

Tak. Zainstaluj inny aromat i uruchom Doctor tak, aby punkty usługi łączności na nowym punkcie wejścia. To nie usuwa Twoich danych - zmienia tylko instalację kodu OpenClaw. Twój stan (~/.openclaw) i obszar roboczy (~/.openclaw/workspace) pozostają niezmienione. Od npm → git:
[PLACEHOLDER] git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
openclaw lekarz
openclaw gateway restart
Od git → npm:
npm install -g openclaw@latest
openclaw lekarz
uruchom ponownie bramę openclaw
Doktor wykrywa niedopasowanie wejściowego punktu usługi i oferuje przepisanie konfiguracji usługi do dopasowania do bieżącej instalacji (użyj --repair w automatyzacji). Wskazówki dotyczące kopii zapasowej: zobacz Kopia zapasowa.

Powinienem uruchomić bramę na moim laptopie lub VPS

Krótka odpowiedź: jeśli chcesz mieć niezawodność 24/7, użyj VPS. Jeśli chcesz, aby najniższe tarcie i dobrze jesteś w stanie snu/restartować, uruchom je lokalnie. **Laptop (lokalna brama) **
  • Pros: brak kosztów serwera, bezpośredni dostęp do plików lokalnych, okno przeglądarki na żywo.
  • Cons: uśpienia/uśpienie sieci = odłączanie, przerywanie aktualizacji systemu operacyjnego/restartów, musi pozostać wybudzone.
VPS / chmura
  • Pros: zawsze, stabilna sieć, bez problemów ze snem laptopa, łatwiejsze do utrzymania.
  • Cons: często uruchamiaj bezgłowne (używaj zrzutów ekranu), tylko zdalny dostęp do plików, musisz mieć SSH dla aktualizacji.
Notatka specyficzna dla OpenClaw: WhatsApp/Telegram/Slack/Mattermost (wtyczka)/Discord wszystko działa poprawnie z VPS. Jedynym prawdziwym kompromisem jest bezgłowna przeglądarka w porównaniu z widocznym oknem. Zobacz Browser. Rekomendowane domyślne: VPS jeśli masz wcześniej odłączoną bramę. Lokalny jest świetny, gdy aktywnie używasz Maca i chcesz mieć dostęp do plików lokalnych lub automatyzację interfejsu użytkownika z widoczną przeglądarką.

Jak ważne jest uruchomienie OpenClaw na dedykowanym urządzeniu

Niewymagane, ale zalecane dla niezawodności i izolacji.
  • Dedykowany host (VPS/Mac mini/Pi): zawsze, mniej przerw w uśpieniu/restarcie, czystsze uprawnienia, łatwiejsze do dalszego działania.
  • Współdzielony laptop/desktop: całkowicie dobrze, jeśli chodzi o testowanie i aktywne użytkowanie, ale oczekujemy pauzy, gdy maszyna uśpi lub aktualizuje.
Jeśli chcecie najlepszych z obu światów, zachowaj bramę na dedykowanym serwerze i sparowuj swój laptopa jako węzeł dla lokalnych narzędzi ekranu/kamery/exec. Zobacz Nodes. Aby uzyskać wskazówki dotyczące bezpieczeństwa, przeczytaj Security.

Jakie są minimalne wymogi VPS i zalecane systemy operacyjne.

OpenClaw jest lekki. Dla podstawowej bramy + jeden kanał czatu:
  • Bezwzględne minimum: 1 vCPU, 1GB RAM, ~500MB dysku.
  • Zalecane: 1-2 vCPU, 2GB RAM lub więcej dla głowy (logów, mediów, wielu kanałów). Narzędzia węzła i automatyzacja przeglądarki mogą być głodne zasoby.
OS: użyj Ubuntu LTS (lub dowolnego nowoczesnego Debian/Ubuntu). Ścieżka instalacyjna Linux jest tam najlepiej przetestowana. Dokumenty: Linux, VPS hosting.

Czy mogę uruchomić OpenClaw w VM i jakie są wymagania

Tak. Traktuj VM tak samo jak VPS: zawsze musi być włączony, osiągalny, i masz wystarczającą ilość pamięci RAM dla bramy i wszystkich kanałów, które włączysz. Przewodnik wyjściowy:
  • Bezwzględne minimum: 1 vCPU, 1 GB RAM.
  • Zalecane: 2GB RAM lub więcej jeśli używasz wielu kanałów, automatyzacji przeglądarki lub narzędzi multimedialnych.
  • OS: Ubuntu LTS lub innego nowoczesnego Debian/Ubuntu.
Jeśli korzystasz z systemu Windows, **WSL2 jest najprostszą konfiguracją stylu VM ** i ma najlepszą kompatybilność z oprogramowaniem . Zobacz Windows, [hosting] VPS (/vps). Jeśli używasz macOS w VM, zobacz macOS VM.

Czym jest OpenClaw?

Co to jest OpenClaw w jednym ustępie

OpenClaw jest osobistym asystentem AI, który pracujesz na własnych urządzeniach. Odpowiada na powierzchnie wiadomości, które już używasz (WhatsApp, Telegram, Slack, Mattermost (plugin), Discord, Czat Google, Signal, iMessage, WebChat) i może również głosować + na żywo płótno na obsługiwanych platformach. **Brama ** jest samolotem kontrolnym zawsze używanym; asystentem jest produkt.

Jaka jest propozycja wartości

OpenClaw to nie tylko opakowanie Claude To lokalny samolot kontrolny, który pozwala Ci uruchomić zdolnego asystenta na własnym urządzeniu, osiągalny dzięki aplikacjom na czacie, które już używasz, za pomocą sesji, pamięci i narzędzi - bez kontroli przepływu pracy do hostowanego SaaS. Wyróżnienia:
  • Twoje urządzenia, Twoje dane: uruchom bramę gdziekolwiek chcesz, (Mac, Linux, VPS) i utrzymuj obszar roboczy* historię sesji lokalnie.
  • Kanały rzeczywiste, a nie piaskownica internetowa: WhatsApp/Telegram/Slack/Discord/Signal/iMessage/etc, plus głos mobilny i płótno na obsługiwanych platformach.
  • Model-agnostic: używaj Antropii, OpenAI, MiniMax, OpenRouter, itp., z podziałem na agentów trasowania i przegrywania.
  • Opcja tylko lokalna: uruchamia modele lokalne, więc wszystkie dane mogą pozostać na Twoim urządzeniu, jeśli chcesz.
  • Przekierowanie wielu agentów: osobno dla każdego kanału, konta lub zadania, każdy z własnymi obszarami roboczymi i domyślnymi.
  • Otwarte źródło i hackable: sprawdzaj, rozszerzaj i samemu hostowi bez blokady dostawcy.
Dokumenty: Gateway, Channels, Multi-agent, Memory.

Właśnie stworzyłem to, co powinienem zrobić najpierw

Dobre pierwsze projekty:
  • Zbuduj stronę internetową (WordPress, Shopify lub prostą witrynę statyczną).
  • prototyp aplikacji mobilnej (obrys, ekrany, plan API).
  • Organizuj pliki i foldery (czyszczenie, nazwa, znakowanie).
  • Połącz Gmail i zautomatyzuj podsumowania lub obserwacje.
Może obsługiwać duże zadania, ale działa najlepiej, gdy podzielisz je na fazy i używasz podagentów do pracy równoległej.

Jakie są pięć najlepszych przypadków codziennego stosowania OpenClaw

Codzienna wygrana wygląda zwykle jako:
  • Osobiste streszczenia: streszczenia skrzynki odbiorczej, kalendarza i wiadomości, których się interesują.
  • Badania i redagowanie: szybkie badania, podsumowania i pierwsze szkice wiadomości e-mail lub dokumentów.
  • Przypomnienia i obserwacje: cron lub bicie serca impulsów i listy kontrolne.
  • Automatyzacja przeglądarki: wypełnianie formularzy, zbieranie danych i powtarzanie zadań internetowych.
  • Koordynacja poprzeczna urządzenia: wyślij zadanie z telefonu, pozwól, aby brama działała na serwerze i odebrać wynik z powrotem na czacie.

Można pomóc OpenClaw w kontaktach z potencjalnymi genami i blogami dla SaaS

Tak dla badań, kwalifikacji i projektowania. Może skanować strony, budować krótkie listy, podsumować perspektywy i pisać kontakty informacyjne lub kopiować szkice reklam. Dla działań informacyjnych lub reklamowych, zachowaj ludzkość w pętli. Unikaj spamu, przestrzegaj lokalnych przepisów i zasad platformy i sprawdzaj cokolwiek zanim zostanie wysłane. The safest pattern is to let OpenClaw draft and you approve. Dokumenty: Security.

Jakie są korzyści w porównaniu z kodem Claude dla rozwoju sieci

OpenClaw jest osobistym asystentem i warstwą koordynacyjną, a nie zastępcą IDE. Użyj Claude Code lub Codex dla najszybszej bezpośredniej pętli kodowania wewnątrz repozytorium. Użyj OpenClaw, gdy chcesz trwałą pamięć, dostęp między urządzeniami i orkiestrację narzędzi. Zalety:
  • Trwała pamięć + obszar roboczy w trakcie sesji
  • Dostęp wieloplatformowy (WhatsApp, Telegram, TUI, WebChat)
  • Orkiestracja narzędzi (browser, pliki, planowanie, haczyki)
  • **Brama zawsze włączona ** (uruchom na VPS, interakcja z dowolnego miejsca)
  • Nodes dla lokalnej przeglądarki/ekranu/kamery/exec
Pokaż: https://openclaw.ai/showcase

Umiejętności i automatyzacja

Jak dostosować umiejętności bez zachowywania brudności repozytorium

Użyj zarządzanych nadpisań zamiast edycji kopii repozytorium. Umieść swoje zmiany w ~/.openclaw/skills/<name>/SKILL.md (lub dodaj folder za pomocą skills.load.extraDirs w ~/.openclaw/openclaw.json). Precedence is <workspace>/skills > ~/.openclaw/skills > wiązane, więc zarządzane nadpisywanie wygrywa bez dotykania git. Tylko edycje warte na wcześniejszych etapach powinny żyć w repozytorium i wychodzić jako PR.

Mogę załadować umiejętności z niestandardowego folderu

Tak. Dodaj dodatkowe katalogi za pomocą skills.load.extraDirs w ~/.openclaw/openclaw.json (najniższy pierwszeństwo). Domyślny pierwszeństwo pozostało: <workspace>/skills~/.openclaw/skills → połączone → skills.load.extraDirs. clawhub instaluje się domyślnie do ./skills, co OpenClaw traktuje jako <workspace>/skills.

Jak mogę używać różnych modeli dla różnych zadań

Dziś wspierane wzorce są następujące:
  • Zadania Cron: izolowane zadania mogą ustawić nadpisanie model na jedno zadanie.
  • Subagentów: trasa zadań do odrębnych agentów z różnymi modelami domyślnymi.
  • Przełącznik na żądanie: użyj /model aby zmienić obecny model sesji w dowolnym momencie.
Zobacz Cron jobs, Wielu Agentów i Komendy Slash Slash .

Bot zamraża się podczas wykonywania ciężkiej pracy Jak je odładuję

Użyj subagentów do długich lub równoległych zadań. Subagenci działają na własnej sesji, zwraca podsumowanie i zachowaj odpowiedź głównego czatu. Poproś bota o “spawn subagent dla tego zadania” lub użyj /subagents. Użyj /status na czacie, aby zobaczyć, co brama robi teraz (i czy jest zajęta). Wskazówka: długie zadania i subagenci zużywają tokeny. Jeśli koszt jest obawą, ustaw tańszy model dla podagentów poprzez agents.defaults.subagents.model. Dokumenty: Sub-agents.

Cron lub przypomnienia nie wystrzeliwują Co należy sprawdzić

Cron działa wewnątrz procesu bramy. Jeśli brama nie działa ciągle, zaplanowane zadania nie będą działać. Lista kontrolna:
  • Potwierdź włączenie cron (cron.enabled) i OPENCLAW_SKIP_CRON nie są ustawione.
  • Sprawdź, czy brama jest uruchomiona 24/7 (bez uśpienia/restartów).
  • Zweryfikuj ustawienia strefy czasowej dla zadania (--tz vs host zone).
Debug:
openclaw cron run <jobId> --force
openclaw cron uruchamia --id <jobId> --limit 50
Dokumenty: Cron jobs, Cron vs Heartbeat.

Jak zainstalować umiejętności na Linux

Użyj ClawHub (CLI) lub umieść umiejętności w swoim obszarze roboczym. Umiejętności macOS nie są dostępne na Linux. Przeglądaj umiejętności na https://clawhub.com. Zainstaluj ClawHub CLI (wybierz jeden menedżer pakietów):
npm i -g clawhub
pnpm add -g clawhub

Może OpenClaw uruchamiać zadania na harmonogramie lub ciągle w tle

Tak. Użyj harmonogramu bram:
  • Zadania Crona dla zaplanowanych lub powtarzających się zadań (utrzymują się podczas restartów).
  • Bicie serca dla okresowych kontroli “głównej sesji”.
  • Pojedyncze miejsca pracy dla niezależnych agentów, którzy publikują podsumowania lub dostarczają na czat.
Dokumenty: Cron jobs, Cron vs Heartbeat, Heartbeat.

Czy mogę korzystać z umiejętności Apple macOS tylko z Linux?

Niebezpośrednio. umiejętności macOS są bramkowane przez metadata.openclaw.os plus wymagane binary, a umiejętności pojawiają się tylko wtedy, gdy kwalifikują się na Gateway host. Na Linuksie, umiejętności darwin-only (takie jak apple-notes, apple-reminders, things-mac) nie będą ładowane, chyba że nadpiszesz bramkę. Masz trzy wspierane wzory: **Opcja A - uruchom bramę na Mac (najprostszy). * Uruchom bramę, w której istnieją pliki binarne macOS, a następnie połącz się z Linux w trybie zdalnym lub w skali Tailscale. Zwykle ładuje się umiejętności, ponieważ gospodarzem bramy jest macOS. **Opcja B - użyj węzła macOS (bez SSH). * Uruchom bramę na Linux, paruj węzeł macOS (aplikacja paska menu), i ustaw polecenia uruchamiania węzła na “Always Ask” lub “Always Allow” na Mac. OpenClaw może traktować umiejętności tylko macOS jako kwalifikujące się, gdy wymagane pliki binarne istnieją na węźle. Agent obsługuje te umiejętności za pomocą narzędzia nodes. Jeśli wybierzesz “Zawsze pytaj się”, zatwierdzając “Zawsze Zezwalaj” w okienku dodaje to polecenie do listy dozwolonych. **Opcja C - proxy macOS w SSH (zaawansowane). * Zachowaj bramę na Linux, ale spraw, aby wymagane pliki binarne CLI rozwiązywały na opakowania SSH uruchamiane na Mac. Następnie nadpisz umiejętność, aby umożliwić Linuksowi więc pozostanie kwalifikowalna.
  1. Utwórz opakowanie SSH dla binarnego (np. memo dla Apple Notes):
    #!/usr/bin/env bash
    ustaw -euo pipefailed
    exec ssh -T user@mac-host /opt/homebrew/bin/memo "$@"
    
  2. Umieść opakowanie na pliku PATH na serwerze Linux (na przykład ~/bin/memo).
  3. Zastąp metadane umiejętności (obszar roboczy lub ~/.openclaw/skills), aby umożliwić Linux:
    ---
    nazwa: opis japple-notes
    : Zarządzaj notatkami Apple poprzez notatkę CLI na macOS.
    metadane: { "openclaw": { "os": ["darwin", "linux"], "Requres": { "bins": ["memo"] } } }
    ---
    
  4. Rozpocznij nową sesję, aby odświeżyć zrzut umiejętności.

Masz koncepcję lub integrację HeyGen

Dziś nie jest wbudowany. Opcje:
  • Niestandardowe umiejętności / wtyczka: najlepsze dla niezawodnego dostępu API (Notion/HeyGen oba mają API).
  • Automatyzacja przeglądarki: działa bez kodu, ale jest wolniejszy i bardziej kruchy.
Jeśli chcesz zachować kontekst dla każdego klienta (przepływ pracy agencji), prosty wzór:
  • Jedna strona pojęcia na klienta (kontekst + preferencje + aktywna praca).
  • Poproś agenta o pobranie tej strony na początku sesji.
Jeśli chcesz natywną integrację, otwórz żądanie funkcji lub zbuduj umiejętność ukierunkowaną na te API. Zainstaluj umiejętności:
zainstaluj klawhub <skill-slug>
aktualizacja klawhub --all
ClawHub instaluje się w . umiejętności w bieżącym katalogu (lub powróci do skonfigurowanego obszaru roboczego OpenClaw); OpenClaw traktuje to jako <workspace>/skills podczas następnej sesji. W przypadku wspólnych umiejętności między agentami umieść je w ~/.openclaw/skills/<name>/SKILL.md. Niektóre umiejętności oczekują plików binarnych zainstalowanych przez Homebrew; na Linux to znaczy Linuxbrew (zobacz powyższy wpis Homebrew Linux FAQ). Zobacz Skills i ClawHub.

Jak zainstalować rozszerzenie Chrome do przejęcia przeglądarki

Użyj wbudowanego instalatora, a następnie załaduj rozpakowane rozszerzenie w Chrome:
openclaw browser extension install
openclaw browser extension path
Następnie Chrome → chrome://extensions → włącz “Tryb programisty” → “Załaduj rozpakowane” → wybierz ten folder. Pełna instrukcja (w tym zdalna brama + zabezpieczenia): Rozszerzenie Chrome’a Jeśli brama działa na tym samym urządzeniu co Chrome (domyślna konfiguracja), zazwyczaj **nie potrzebujesz niczego dodatkowego. Jeśli Gateway działa gdzie indziej, uruchom host węzła na maszynie z przeglądarką, aby Gateway mógł pośredniczyć w akcjach przeglądarki. Nadal musisz kliknąć przycisk rozszerzenia na karcie, którą chcesz kontrolować (nie jest to automatyczne załącznik).

Skrzynki piaskowe i pamięć

Czy jest dedykowany dok piaskownicy

Tak. Zobacz Sandboxing. Ustawienia specyficzne dla dokera (pełna brama w oknie dokującym lub piaskownicach) zobacz Docker.

Dokujący czuje się ograniczony jak włączyć pełne funkcje

The default image is security-first and runs as the node user, so it does not include system packages, Homebrew, or bundled browsers. Dla pełniejszej konfiguracji:
  • Utrzymaj /home/node używając OPENCLAW_HOME_VOLUME, aby przetrwać.
  • Bądź na ekranie z OPENCLAW_DOCKER_APT_ULOTK.
  • Zainstaluj przeglądarki Playwright za pomocą pakietu CLI: node /app/node_modules/playwright-core/cli.js install chromium
  • Ustaw PLAYWRIGHT_BROWSERS_PATH i upewnij się, że ścieżka jest kontynuowana.
Dokumenty: Docker, Browser. Czy mogę zachować osobiste emotikony, ale upublicznić grupy z jednym agentem Tak, jeśli Twój prywatny ruch to DM, a Twój ruch publiczny to grupy. Użyj agents.defaults.sandbox.mode: "non-main" więc sesje grupowe/kanały (klucze niegłówne) uruchamiane w Docker, podczas gdy główna sesja DM pozostaje na serwerze. Następnie ograniczyć, jakie narzędzia są dostępne w sesjach piaskownicowych za pomocą tools.sandbox.tools. Konfiguracja walkthrough + przykładowa konfiguracja: Grupy: osobiste DM + publiczne grupy Sygnatura konfiguracji klucza: Konfiguracja bramy

Jak powiązać folder hosta z sandboxem

Ustaw agents.defaults.sandbox.docker.binds na ["host:path:mode"] (np. "/home/user/src:/src:ro"). Globalny + per-agent wiąże połączenia; powiązania dla agenta są ignorowane gdy zakres: "dzielona". Użyj :ro dla wszystkiego, co jest wrażliwe i zapamiętaj pominąć ściany systemu plików sandbox. Zobacz Sandboxing i Sandbox vs Tool Policy vs Elevated, aby uzyskać przykłady i informacje o bezpieczeństwie.

Jak działa pamięć

Pamięć OpenClaw to tylko pliki Markdown w obszarze roboczym agenta:
  • Dzienne notatki w memory/YYYY-MM-DD.md
  • Zaawansowane długoterminowe notatki w MEMORY.md (tylko sesje główne/prywatne)
OpenClaw uruchamia również cichą pamięć kompaktową, aby przypomnieć modelowi o zapisywaniu trwałych notatek przed automatycznym zagęszczaniem. To działa tylko wtedy, gdy obszar roboczy jest zapisywalny (pomijaj piaskownice tylko do odczytu). Zobacz Pamięć.

Pamięć nieustannie zapomina o rzeczach, jak to zrobić

Poproś bota o zapis faktu do pamięci. Notatki długoterminowe należą do MEMORY.md, kontekst krótkoterminowy zawiera memory/YYYY-MM-DD.md. Jest to obszar, który wciąż się poprawiamy. Pomaga to przypomnieć modelowi o przechowywaniu pamięci; będzie wiedział, co robić. Jeśli zapomni, sprawdź czy brama używa tego samego obszaru roboczego przy każdym uruchomieniu. Dokumenty: Memory, Agent workspace.

Wyszukiwanie pamięci semantycznej wymaga klucza API OpenAI

Tylko jeśli używasz **osadzonych OpenAI **. Codex OAuth pokrywa czat/uzupełnienia, a nie udziela dostępu do osadzeń, więc zalogowanie się za pomocą Codex (OAuth lub Codex CLI) nie pomaga w wyszukiwaniu pamięci semantycznej. OpenAI embeddings nadal potrzebuje prawdziwego klucza API (OPENAI_API_KEY lub models.providers.openai.apiKey). Jeśli nie ustawiłeś wyraźnie, OpenClaw automatycznie wybiera dostawcę, gdy może rozwiązać klucz API (profile auth profile, models.providers.*.apiKey, lub env vars). Wolą OpenAI jeśli klucz OpenAI rozwiązuje, w przeciwnym razie Gemini jeśli klucz Gemini się rozwiązuje. Jeśli żaden klucz nie jest dostępny, wyszukiwanie pamięci pozostaje wyłączone do czasu konfiguracji . Jeśli masz skonfigurowaną i obecną lokalną ścieżkę modelu, OpenClaw preferuje local. Jeśli chcesz pozostać lokalnym, ustaw memorySearch.provider = "local" (i opcjonalnie memorySearch.fallback = "none"). Jeśli chcesz, aby Gemini embeddings, ustaw memorySearch.provider = "gemini" i wprowadź GEMINI_API_KEY (lub memorySearch.remote.apiKey). Wspieramy OpenAI, Gemini, lub local osadzanie modeli* zobacz Memory, aby uzyskać szczegóły konfiguracji.

Pamięć utrzymuje się na zawsze co to są limity

Pliki pamięci na żywo na dysku i utrzymują się aż do ich usunięcia. Limit jest twoim magazynem a nie modelu. Kontekst sesji jest nadal ograniczony przez model kontekstu, tak długie rozmowy mogą być kompaktowe lub obcięte. Dlatego wyszukiwanie pamięci istnieje - pociąga tylko odpowiednie części z powrotem do kontekstu. Dokumenty: Memory, Context.

Gdzie rzeczy żyją na dysku

Czy wszystkie dane są używane w OpenClaw zapisywane lokalnie

Nie - Stan OpenClaw jest lokalny, ale zewnętrzne usługi wciąż widzą, co je wysyłasz.
  • Domyślnie lokalne: sesje, pliki pamięci, konfiguracje i obszar roboczy na żywo hosta bramy (~/.openclaw + Twój katalog roboczy).
  • Zdalnie od konieczności: wiadomości wysyłane do dostawców modeli (Antropiczka/OpenAI/itp.) przejdź do ich API i platformy czatu (WhatsApp/Telegram/Slack/etc.) przechowuj dane wiadomości na ich serwerach .
  • Kontrolujesz footprint: przy użyciu lokalnych modeli utrzymuje wskazówki na Twoim komputerze, ale ruch na kanale nadal przebiega przez serwery kanału.
Powiązano: Agent workspace, Memory.

Gdzie OpenClaw przechowuje swoje dane

Wszystko żyje pod $OPENCLAW_STATE_DIR (domyślnie: ~/.openclaw):
ŚcieżkaPrzeznaczenie
$OPENCLAW_STATE_DIR/openclaw.jsonGłówna konfiguracja (JSON5)
$OPENCLAW_STATE_DIR/credentials/oauth.jsonDotychczasowy import OAuth (skopiowany do profili autoryzacji przy pierwszym użyciu)
$OPENCLAW_STATE_DIR/agents/<agentId>/agent/auth-profiles.jsonProfile autoryzacji (OAuth + klucze API)
$OPENCLAW_STATE_DIR/agents/<agentId>/agent/auth.jsonPamięć podręczna autoryzacji (zarządzana automatycznie)
$OPENCLAW_STATE_DIR/credentials/Stan dostawcy (np. whatsapp/<accountId>/creds.json)
$OPENCLAW_STATE_DIR/agents/Stan agenta (agentDir + sesje)
$OPENCLAW_STATE_DIR/agents/<agentId>/sessions/Historia konwersacji i stan (na agenta)
$OPENCLAW_STATE_DIR/agents/<agentId>/sessions/sessions.jsonMetadane sesji (na agenta)
Starsza ścieżka jednego agenta: ~/.openclaw/agent/* (migrowana przez openclaw do). Twój obszar roboczy (AGENTS.md, pliki pamięci, umiejętności itp.) jest oddzielny i skonfigurowany przez agents.defaults.workspace (domyślnie: ~/.openclaw/workspace).

Gdzie powinien być AGENTSmd SOULmd USERmd MEMORYmd żyć

Te pliki są dostępne w obszarze roboczym agenta, a nie ~/.openclaw.
  • Obszar roboczy (na agenta): AGENTS.md, SOUL.md, IDENTITY.md, USER.md, MEMORY.md (lub memory.md), memory/YYYY-MM-DD.md, opcjonalny HEARTBEAT.md.
  • Dziennik stanu (~/.openclaw): config, dane logowania, profile uwierzytelniania, sesje, dzienniki, i wspólne umiejętności (~/.openclaw/skills).
Domyślnym obszarem roboczym jest ~/.openclaw/workspace, konfigurowalne przez:
{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}
Jeśli bot “zapomnisz” po ponownym uruchomieniu, potwierdź, że brama używa tego samego obszaru roboczego przy każdym uruchomieniu (i pamiętaj: tryb zdalny używa projektu hostów bramy , nie twój lokalny laptop). Wskazówka: jeśli chcesz zachować lub preferencje, poproś bota o **zapisanie go do AGENTS. a nie polegać na historii czatu. Zobacz Obszar roboczy Agenta i Memory.

Jaka jest zalecana strategia tworzenia kopii zapasowych

Umieść swój obszar roboczy agenta w prywatnym repozytorium git i utworzyć kopię zapasową gdzieś prywatny (na przykład GitHub prywatny). To przechwytuje pamięć + AGENTS/SOUL/USER i pozwala przywrócić “umysł” asystenta później. Nie zatwierdzaj cokolwiek pod ~/.openclaw (poświadczenia, sesje, tokeny). Jeśli potrzebujesz pełnego przywrócenia, wykonaj kopię zapasową zarówno obszaru roboczego, jak i katalogu stanu osobno (patrz pytanie migracji powyżej). Dokumenty: Agent workspace.

Jak całkowicie odinstalować OpenClaw

Zobacz dedykowany przewodnik: Uninstall.

Może pracować agenci poza obszarem roboczym

Tak. Obszar roboczy jest domyślnym cwd i kotwicą pamięci, a nie twardym piaskownikiem. Ścieżki względne rozwiązują wewnątrz obszaru roboczego, ale ścieżki bezwzględne mogą mieć dostęp do innych lokalizacji hosta , chyba że sandboxing jest włączony. Jeśli potrzebujesz izolacji, użyj ustawień agents.defaults.sandbox lub sandboxa dla agenta Jeśli chcesz, aby repozytorium było domyślnym katalogiem roboczym, ustaw ten agent workspace na roota repozytorium. Repozytorium OpenClaw jest tylko kodem źródłowym; zachowaj oddzielny obszar roboczy chyba że celowo chcesz, aby agent działał wewnątrz niego. Przykład (repozytorium jako domyślny cwd):
{
  agents: {
    defaults: {
      workspace: "~/Projects/my-repo",
    },
  },
}

Jestem w trybie zdalnym, gdzie jest sklep sesji

Stan sesji jest własnością hosta bramy. Jeśli jesteś w trybie zdalnym, magazyn sesyjny, którego jesteś zainteresowany, znajduje się na urządzeniu zdalnym, a nie na lokalnym laptopie. Zobacz Zarządzanie sesją.

Podstawy konfiguracji

Jaki jest format konfiguracji, Gdzie to jest

OpenClaw odczytuje opcjonalne konfiguracje JSON5 z $OPENCLAW_CONFIG_PATH (domyślnie: ~/.openclaw/openclaw.json):
$OPENCLAW_CONFIG_PATH
Jeśli brakuje pliku, używa on bezpiecznych ustawień domyślnych (w tym domyślnego obszaru roboczego ~/.openclaw/workspace).

Ustawiam gatewaybind lan lub tailnet i teraz nic nie słucha interfejsu użytkownika mówi o nieautoryzowanych

Powiązania niezwiązane z pętlą wymagają autora. Konfiguruj gateway.auth.mode + gateway.auth.token (lub użyj OPENCLAW_GATEWAY_TOKEN).
{
  gateway: {
    bind: "lan",
    auth: {
      mode: "token",
      token: "replace-me",
    },
  },
}
Uwagi:
  • gateway.remote.token jest tylko dla zdalnych połączeń CLI; nie włącza lokalnego uwierzytelniania bramy.
  • Interfejs sterowania uwierzytelnia się przez connect.params.auth.token (przechowywane w ustawieniach app/UI). Unikaj wprowadzania tokenów w adresach URL.

Dlaczego teraz potrzebuję tokenu na localhost

Kreator generuje domyślny token bramy (nawet przy pętli), więc lokalni klienci WS muszą uwierzytelniać się. To blokuje inne lokalne procesy wywoływania bramy. Wklej token do ustawień Control UI (lub konfiguracji klienta), aby się połączyć. Jeśli naprawdę chcesz otworzyć pętlę, usuń gateway.auth ze swojej konfiguracji. Doktor może wygenerować token dla Ciebie w dowolnym momencie: openclaw doctor --generate-gateway-token.

Czy muszę zrestartować po zmianie konfiguracji

Brama ogląda konfigurację i obsługuje przeładowanie na gorąco:
  • gateway.reload.mode: "hybrid" (domyślnie): Zastosuj bezpieczne zmiany, zrestartuj dla krytycznych
  • hot, restart, off są również obsługiwane

Jak włączyć wyszukiwanie i pobieranie stron internetowych

web_fetch działa bez klucza API. web_search wymaga klucza Brave Search API . Zalecane: uruchom openclaw configure --section web aby przechowywać go w tools.web.search.apiKey. Alternatywa środowiska naturalnego: ustaw BRAVE_API_KEY dla procesu bramy .
{
  tools: {
    web: {
      search: {
        enabled: true,
        apiKey: "BRAVE_API_KEY_HERE",
        maxResults: 5,
      },
      fetch: {
        enabled: true,
      },
    },
  },
}
Uwagi:
  • Jeśli używasz dozwolonych list dodaj web_search/web_fetch lub group:web.
  • web_fetch jest włączone domyślnie (chyba że zostanie jawnie wyłączone).
  • Daemons czyta var z ~/.openclaw/.env (lub środowiska usług).
Dokumentacja: Web tools.

Jak korzystać z centralnej bramy z wyspecjalizowanymi pracownikami we wszystkich urządzeniach

Powszechnym wzorcem jest jedna brama (np. Raspberry Pi) plus węzły i agentów:
  • Brama (centralna): jest właścicielem kanałów (Signal/WhatsApp), routingu i sesji.
  • Węzły (urządzenia): Macs/iOS/Android łączy się jako urządzenia peryferyjne i ujawnia lokalne narzędzia (system.run, canvas, camera).
  • Agenci (pracownicy): oddziel mózg/przestrzeń roboczą dla specjalnych ról (np. “Hetzner ops”, “Dane osobowe”).
  • Podagenty: spawn w tle działa od głównego agenta, gdy chcesz równolegle.
  • TUI: podłącz się do bramki i przełączników/sesji.
Dokumenty: Nodes, Dostęp zdalny, Wysyłanie wielu agentów, Sub-agents, TUI.

Czy przeglądarka OpenClaw może działać bez słuchawek

Tak. Jest to opcja konfiguracyjna:
{
  browser: { headless: true },
  agents: {
    defaults: {
      sandbox: { browser: { headless: true } },
    },
  },
}
Domyślnie jest false (headful). Prawdopodobieństwo uruchomienia kontroli przeciwbotów w niektórych miejscach jest bardziej prawdopodobne. Zobacz Browser. Bezgłowy używają tego samego silnika chromowego i pracują dla większości automatyzacji (formularze, kliknięcia, skrawanie, logowania). Główne różnice:
  • Brak widocznych okien przeglądarki (użyj zrzutów ekranu, jeśli potrzebujesz wizualności).
  • Niektóre strony są bardziej restrykcyjne w zakresie automatyzacji w trybie bezgłowy (CAPTCHA, antybot). Na przykład X/Twitter często blokuje sesje bezgłowne.

Jak używać Brave do kontroli przeglądarki

Ustaw browser.executablePath na swój plik binarny Brave (lub dowolną przeglądarkę opartą na Chromium) i zrestartuj bramę. Zobacz pełne przykłady konfiguracji w Browser.

Zdalne bramy i węzły

Jak propagować polecenia pomiędzy Telegramem a węzłami

Wiadomości Telegram są obsługiwane przez bramę. Brama uruchamia agenta i tylko wtedy wywołuje węzły nad Gateway WebSocket, gdy potrzebne jest narzędzie węzła: Telegram → Brama → Agent → node.* → Węzeł → Brama → Telegram Węzły nie widzą ruchu przychodzącego; odbierają tylko połączenia RPC z węzłem.

Jak mój agent ma dostęp do mojego komputera, jeśli brama jest zdalnie hostowana

Krótka odpowiedź: sparować komputer jako węzeł. Brama działa gdzie indziej, ale może wywołać narzędzia node.* (ekran, kamera, system) na lokalnej maszynie przez Gateway WebSocket. Typowa konfiguracja:
  1. Uruchom bramę na ciągłym serwerze (VPS/serwer domowy).
  2. Umieść host bramy + swój komputer w tej samej sieci ogonowej.
  3. Upewnij się, że brama WS jest osiągalna (bind lub tunel SSH).
  4. Otwórz aplikację macOS lokalnie i połącz się w trybie Zdalne przez SSH (lub bezpośredni net) , aby mógł zarejestrować się jako węzeł.
  5. Zatwierdź węzeł na bramie:
    openclaw nodes pending
    openclaw nodes approve <requestId>
    
Nie jest wymagany oddzielny most TCP; węzły łączą się przez bramę WebSocket. Przypomnienie bezpieczeństwa: parowanie węzła macOS pozwala na system.run na tym komputerze. Tylko paruj urządzenia, które ufasz, i przejrzyj Security. Dokumenty: Nodes, protokół bramy, tryb zdalny macOS, Security.

Skala ogona jest połączona, ale nie otrzymuję odpowiedzi Co teraz

Sprawdź podstawy:
  • Brama jest uruchomiona: openclaw gateway status
  • Zdrowie bramy : openclaw status
  • Zdrowie kanału: status kanałów openclaw
Następnie sprawdź autoryzację i przekierowanie:
  • Jeśli korzystasz z Tailscale Serve, upewnij się, że plik gateway.auth.allowTailscale jest poprawnie ustawiony.
  • Jeśli połączysz się przez tunel SSH, potwierdź, że miejscowy tunel jest w górę i wskazuje w prawym porcie.
  • Potwierdź swoje listy uprawnień (DM lub grupa) dołącz do swojego konta.
Dokumenty: Tailscale, dostęp zdalny, Channels.

Można rozmawiać ze sobą o dwóch instancjach OpenClaw

Tak. Nie ma wbudowanego mostu „bot-to-bot”, ale możesz go zdemontować za kilka niezawodnych sposobów: Proste: użyj normalnego kanału czatu, do którego mają dostęp oba boty (Telegram/Slack/WhatsApp). Bota A wyśle wiadomość do bota B, a następnie pozwól botowi B odpowiedzieć jak zwykle. Most CLI (generic): uruchom skrypt, który wywołuje drugą bramę z openclaw agent --mess... --deliver, ukierunkowanie czatu, w którym słucha innego bota . Jeśli jeden bot jest na zdalnym VPS, ustaw swój CLI na zdalnej bramie przez SSH/Tailscale (zob. [zdalny dostęp] (/gateway/remote)). Przykładowy wzór (biegnij z maszyny, która może dotrzeć do docelowej bramy):
openclaw agent --message "Hello from local bot" --deliver --channel telegram --reply-to <chat-id>
Wskazówka: dodaj strażnika, aby dwa boty nie pętlały bez końca (tylko do kanału dopuszczają listy lub reguła “nie odpowiadaj na wiadomości bota”). Dokumenty: zdalny dostęp, Agent CLI, Agent send.

Potrzebuję oddzielnych VPS dla wielu agentów

Nie. Jedna brama może hostować wielu agentów, z których każdy ma własny obszar roboczy, domyślne modele, i routing. To jest normalna konfiguracja i jest o wiele tańsza i prostsza niż działanie jednego VPS na agenta. Używaj oddzielnych VPSes tylko wtedy, gdy potrzebujesz twardej izolacji (granice bezpieczeństwa) lub bardzo różnych konfiguracji, których nie chcesz udostępniać. W przeciwnym razie utrzymuj jedną bramę i używaj wielu agentów lub subagentów.

Czy istnieje korzyść z używania węzła na moim osobistym laptopie zamiast SSH od VPS

Yes - nodes are the first-class way to reach your laptop from a remote Gateway, and they unlock more than shell access. Brama działa na macOS/Linux (Windows via WSL2) i jest lekka (małe pole klasy VPS lub Raspberry Pi-class jest w porządku; 4 GB pamięci RAM jest duży), więc powszechnie używanym jest zawsze domieszką hosta oraz laptopa jako węzeł.
  • Przychodzący SSH nie jest wymagany. Węzły podłącz się do Gateway WebSocket i użyj parowania urządzenia.
  • Bezpieczniejsze sterowanie wykonaniem. system.run jest bramkowane przez węzły dopuszczalne/zatwierdzenia na tym laptopie.
  • Więcej narzędzi urządzenia. Nody pokazują canvas, camera, i screen oprócz system.run.
  • **Automatyzacja lokalnej przeglądarki. * Zachowaj bramę w sieci VPS, ale uruchom Chrome lokalnie i przekaż kontrolę z rozszerzeniem Chrome + hostem węzła na laptopie.
SSH jest dobry dla dostępu do powłoki ad-hoc, ale węzły są prostsze dla bieżących przepływów pracy agenta i automatyzacji urządzenia. Dokumenty: Nodes, Nodes CLI, Chrome extension.

Powinienem zainstalować na drugim laptopie lub po prostu dodać węzeł

Jeśli potrzebujesz tylko narzędzi lokalnych (ekran/kamera/exec) na drugim laptopie, dodaj go jako węzeł. To utrzymuje jedną bramę i pozwala uniknąć duplikowanej konfiguracji. Narzędzia węzła lokalnego są obecnie tylko macOS, ale planujemy rozszerzyć je na inne systemy operacyjne. Zainstaluj drugą bramę tylko wtedy, gdy potrzebujesz twardej izolacji lub dwóch całkowicie oddzielnych botów. Dokumenty: Nodes, Węzły CLI, Wiele bram.

Zrób węzły uruchamiające usługę bramy

Nie. Tylko jedna brama powinna działać na hosta, chyba że celowo uruchomisz oddzielone profile (patrz Wiele bramek). Węzły są peryferiami, które łączą się z bramą (iOS/Android nodes, lub “tryb węzła” macOS w aplikacji paska menu). Dla węzła bezgłowy hosty i kontrola CLI zobacz CLI hosta. Wymagany jest pełny restart dla zmian gateway, discovery, i canvasHost.

Czy istnieje sposób API RPC do zastosowania konfiguracji

Tak. config.apply sprawdza + zapisuje pełną konfigurację i uruchamia bramę ponownie jako część operacji.

configapply wyczyścił moją konfigurację jak odzyskać i uniknąć tego

config.apply zastępuje całą konfigurację. Jeśli wyślesz obiekt częściowy, wszystko zostało usunięte. Odzyskanie:
  • Przywróć z kopii zapasowej (git lub skopiowany ~/.openclaw/openclaw.json).
  • Jeśli nie masz kopii zapasowej, uruchom ponownie openclaw doctor i skonfiguruj kanale/modele.
  • Jeśli to było niespodziewane, utwórz błąd i dołącz ostatnią znaną konfigurację lub dowolną kopię zapasową.
  • Lokalny agent kodowania często może odtworzyć działającą konfigurację z logów lub historii.
Unikaj:
  • Użyj openclaw config set dla małych zmian.
  • Użyj openclaw configure do interaktywnych edycji.
Dokumenty: Config, Configure, Doctor.

Jaka jest minimalna konfiguracja dla pierwszej instalacji

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}
Ustawia Twój obszar roboczy i ogranicza, kto może wyzwalać bota.

Jak skonfigurować Skalę Ogonową na VPS i połączyć się z Mac

Minimalne kroki:
  1. Zainstaluj + zaloguj się na VPS
    curl -fsSL https://tailscale.com/install.sh | sh
    sudo tailscale
    
  2. Zainstaluj + zaloguj się na Mac
    • Użyj aplikacji skali ogonowej i zaloguj się do tej samej sieci ogonowej.
  3. Włącz MagicDNS (zalecane)
    • W konsoli administratora w skali Ogonowej włącz MagicDNS, aby VPS miał stabilną nazwę.
  4. Użyj nazwy hosta sieci ogonowej
Jeśli chcesz, aby interfejs użytkownika bez SSH, użyj skali Ogonowej na VPS:
openclaw gateway --tailscale serve
Utrzymuje bramy związane z pętlą i wystawia HTTPS przez Tailscale. Zobacz Tailscale.

Jak podłączyć węzeł Mac do zdalnej bramy Gateway Tailscale Serve

Służba ujawnia interfejs interfejsu użytkownika Bramki + WS**. Węzły łączą się przez ten sam punkt końcowy WS bramy. Zalecane konfiguracje:
  1. Upewnij się, że VPS + Mac są na tej samej sieci ogonowej.
  2. Użyj aplikacji macOS w trybie zdalnym (celem SH może być nazwa hostnetu). Aplikacja będzie tunelować port bramy i połączyć się jako węzeł.
  3. Zatwierdź węzeł na bramce:
    openclaw nodes pending
    openclaw nodes approve <requestId>
    
Dokumenty: protokół bramy, Discovery, tryb zdalny macOS.

Wczytywanie var i .env

Jak OpenClaw ładuje zmienne środowiskowe

OpenClaw odczytuje zmienne środowiskowe z procesu nadrzędnego (powłoka, launchd/systemd, CI itd.) i dodatkowo obciążenia:
  • .env z bieżącego katalogu roboczego
  • globalny fallback .env z ~/.openclaw/.env (czyli $OPENCLAW_STATE_DIR/.env)
Żaden plik .env nie nadpisuje istniejących zmiennych środowiskowych. Możesz również zdefiniować var env in line w konfiguracji (stosowane tylko wtedy, gdy brakuje go w env):
{
  pl: {
    OPENROUTER_API_KEY: "sk-or-...",
    vars: { GROQ_API_KEY: "gsk-..." },
  },
}
Zobacz /environment, aby poznać pełną kolejność i źródła.

Uruchomiłem bramę przez serwis, a moje vary env zniknęły co teraz

Dwa częste poprawki:
  1. Umieść brakujące klucze w ~/.openclaw/.env więc są one pobierane nawet wtedy, gdy usługa nie odziedziczy twojego pocisku.
  2. Włącz import powłoki (wygoda opt-in):
{
  env: {
    shellEnv: {
      enabled: true,
      timeoutMs: 15000,
    },
  },
}
To uruchamia twoje pociski logowania i importuje tylko brakujące oczekiwane klucze (nigdy nie nadpisuj). Równoważniki Env var: OPENCLAW_LOAD_SHELL_ENV=1, OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000.

Ustawiam COPILOTGITHUBTOKEN, ale status modeli pokazuje Shell env off Dlaczego

openclaw model zgłasza czy shell env import jest włączony. “Shell env: off” nie oznacza, że brakuje twoich var env - po prostu oznacza, że OpenClaw nie załaduje twoich pocisków logowania automatycznie. Jeśli brama działa jako usługa (uruchomiona/systemowa), nie odziedziczy środowiska twojej powłoki. Napraw wykonując jedną z nich:
  1. Umieść token w ~/.openclaw/.env:
    COPILOT_GITHUB_TOKEN=...
    
  2. Lub włącz import powłoki (env.shellEnv.enabled: true).
  3. Lub dodaj go do bloku env konfiguracji (dotyczy tylko jeśli brakuje).
Następnie zrestartuj bramę i sprawdź:
openclaw models status
Kopiowanie tokenów jest odczytywane z COPILOT_GITHUB_TOKEN (także GH_TOKEN / GITHUB_TOKEN). Zobacz /concepts/model-providers i /environment.

Sesje i wiele czatów

Jak rozpocząć nową rozmowę

Wyślij /new lub /reset jako samodzielną wiadomość. Zobacz Zarządzanie sesją.

Zresetuj sesje automatycznie, jeśli nigdy nie wysyłam nowych

Tak. Sesje wygasają po session.idleMinutes (domyślnie 60). Następna wiadomość rozpoczyna nowe ID sesji dla tego klucza czatu. To nie usuwa transkryptów* po prostu rozpoczyna nową sesję.
{
  sesja: {
    idleMinutes: 240,
  },
}

Jest sposób na stworzenie zespołu OpenClaw instancji jednego CEO i wielu agentów

Tak, przez przekierowywanie wielu agentów i subagentów. Możesz utworzyć jednego koordynatora agenta i kilku pracowników z ich własnymi projektami i modelami. To powiedziawszy, najlepiej postrzegać to jako zabawny eksperyment. To token ciężki i często mniej wydajny niż jeden bot z osobnymi sesjami. Typowym modelem, który jest jeden bot, z którym rozmawiasz, z różnymi sesjami dla pracy równoległej. Bot może również pojawić podagentów w razie potrzeby. Dokumenty: Multi-agent routing, Sub-agents, Agent CLI.

Dlaczego kontekst uzyskał obcięte średnie zadanie, jak zapobiegać temu

Kontekst sesji jest ograniczony przez okno modelu. Długie czaty, duże wyjścia narzędzi lub wiele plików może wywołać zagęszczenie lub obcięcie. Co pomoże:
  • Poproś bota o podsumowanie bieżącego stanu i zapisanie go do pliku.
  • Użyj /compact przed długimi zadaniami i /new podczas przełączania tematów.
  • Zachowaj ważny kontekst w obszarze roboczym i poproś bota o odczyt go z powrotem.
  • Użyj podczynników do pracy długiej lub równoległej, aby główny czat pozostawał mniejszy.
  • Wybierz model z większym oknem kontekstowym, jeśli zdarza się to często.

Jak całkowicie zresetować OpenClaw ale zachować zainstalowane

Użyj polecenia resetującego:
openclaw reset
Nieinteraktywne pełne zresetowanie:
openclaw reset --scope pełne --yes --non-interactive
Następnie uruchom ponownie pokład:
openclaw onboard --install-daemon
Uwagi:
  • Kreator wdrożenia oferuje również Reset, jeśli widzi istniejącą konfigurację. Zobacz Wizard.
  • Jeśli używałeś profili (--profile / OPENCLAW_PROFILE), zresetuj każdy dir stanów (domyślnie ~/.openclaw-<profile>).
  • Zresetowanie deweloperów: openclaw gateway --dev --reset (dev-only; wyskakuje dev config + poświadczenia + sesje + obszar roboczy).

Otrzymuję kontekst zbyt duże błędy jak zresetować lub kompaktować

Użyj jednej z opcji:
  • Kompaktowa (zachowuje konwersację, ale podsumowuje starsze tury):
    /kompaktowy
    
    lub /compact <instructions> aby poprowadzić podsumowanie.
  • Zresetuj (nowy identyfikator sesji dla tego samego klucza czatu):
    /new
    /reset
    
Jeśli tak się stanie:
  • Włącz lub dostosuj sesje pruning (agents.defaults.contextPruning) do przycinania starego wyjścia narzędzia.
  • Użyj modelu z większym oknem kontekstowym.
Dokumenty: Compaction, Session pruning, Zarządzanie sesją.

Dlaczego widzę wymagane pole polecenia LLM odrzucające wiadomościXtooluseinput

To jest błąd walidacji dostawcy: model wysłał blok tool_use bez wymaganego input. Zazwyczaj oznacza to, że historia sesji jest przestarzała lub uszkodzona (często po długich wątkach lub zmianie narzędzia/schematu). Naprawda: rozpocznij nową sesję z /new (niezależna wiadomość).

Dlaczego co 30 minut odbieram wiadomości o biciu serca

Serce działają domyślnie co 30 m. Dostosuj lub wyłącz je:
{
  agents: {
    domyślnie: {
      heartbeat: {
        zawsze: "2h", // lub "0m", aby wyłączyć
      },
    },
  },
}
Jeśli HEARTBEAT.md istnieje, ale jest w praktyce puste (tylko puste linie i nagłówki Markdown, takie jak # Heading), OpenClaw pomija uruchomienie heartbeat, aby oszczędzać wywołania API. Jeśli plik nie istnieje, heartbeat nadal się uruchamia, a model decyduje, co zrobić. Nadpisywanie per-agenta używa agents.list[].uderzenie serca. Dokumenty: Heartbeat.

Czy muszę dodać konto bota do grupy WhatsApp

Nie. OpenClaw działa na Twoim koncie, więc jeśli jesteś w grupie, OpenClaw może to zobaczyć. Domyślnie odpowiedzi grupowe są zablokowane, dopóki nie zezwolisz nadawcom (groupPolicy: "allowlist"). Jeśli chcesz, aby **ty ** był w stanie wyzwalać odpowiedzi grupowe:
{
  kanałów: {
    whatsapp: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

Jak uzyskać JID grupy WhatsApp

Opcja 1 (najszybsza): kłody ogona i wysłanie komunikatu testowego w grupie:
dzienniki openclaw --follow --json
Szukaj chatId (lub from) kończącego się w @g.us, jak [email protected]. Opcja 2 (jeżeli jest już skonfigurowana/dozwolona): grupy list z konfiguracji:
lista grup katalogów openclaw --channel whatsapp
Dokumenty: WhatsApp, Directory, Logs.

Dlaczego nie odpowiada OpenClaw w grupie

Dwa wspólne przyczyny:
  • Bramowanie wzmiankowe jest włączone (domyślnie). Musisz @wspomnieć bota (lub dopasować wzmiankiPatterns).
  • Skonfigurowałeś channels.whatsapp.groups bez "*" i grupa nie jest dozwolona.
Zobacz Groups i Wiadomości grupowe.

Czy grupowe wątki dzielą kontekst z Mami

Bezpośrednie czaty upadają domyślnie do sesji głównej. Grupy/kanały mają własne klucze sesji, a tematy Telegram / wątki Discorda są oddzielnymi sesjami. Zobacz Groups i Wiadomości grupowe.

Ile miejsc roboczych i agentów mogę utworzyć

Brak twardych limitów. Dziesiątki (nawet setki) jest w porządku, ale uważaj:
  • Rozrost dysku: sesje + transkrypty są dostępne pod ~/.openclaw/agents/<agentId>/sessions/.
  • Koszt tokenu: więcej agentów oznacza większe jednoczesne użycie modelu.
  • Ops overhead: dla każdego agenta profil auth profile, obszar roboczy i routing kanałów.
Wskazówki:
  • Zachowaj jeden aktywny obszar roboczy na przedstawiciela (agents.defaults.workspace).
  • Wyczyść stare sesje (usuń JSONL lub zapisy sklepu), jeśli dysk rośnie.
  • Użyj openclaw doctor aby wykryć bezbarwne obszary robocze i niedopasowanie profilu.

Czy mogę uruchomić wiele botów lub czatów w tym samym czasie i jak powinienem to ustawić

Tak. Użyj dzwonka multiagenta do uruchamiania wielu izolowanych agentów i kierowania przychodzących wiadomości przez kanału/konto/peer. Slack jest obsługiwany jako kanał i może być związany z określonymi czynnikami. Dostęp do przeglądarki jest potężny, ale nie “zrób cokolwiek ludzkiego” - antybot, CAPTCHA i MFA mogą nadal blokować automatyzację. Dla najbardziej niezawodnej kontroli przeglądarki, użyj przekaźnika rozszerzeń Chrome na komputerze, który obsługuje przeglądarkę (i utrzymuje bramę gdziekolwiek). Najlepsza konfiguracja:
  • Trzyliterowy host bramki (VPS/Mac mini).
  • Jeden agent na rolę (wiążące).
  • Kanały luźne związane z tymi czynnikami.
  • Lokalna przeglądarka za pośrednictwem przekaźnika rozszerzeń (lub węzła) w razie potrzeby.
Dokumenty: Multi-Agent Routing, Slack, Browser, Chrome extension, Nodes.

Modele: domyślne, wybór, aliasy, przełączanie

Jaki jest model domyślny

Domyślny model OpenClawa to cokolwiek ustawiłeś:
agents.defaults.model.primary
Modele są określane jako provider/model (przykład: anthropic/claude-opus-4-6). Jeśli opuścisz dostawcę, OpenClaw obecnie przyjmuje anthropic jako tymczasowe rozwiązanie deprekacji - ale nadal powinieneś **jednoznacznie ** ustawić provider/model.

Jaki model rekomendujesz

Zalecane domyślne: anthropic/claude-opus-4-6. Dobra alternatywa: anthropic/claude-sonnet-4-5. Wiarygodny (mniej znaków): openai/gpt-5.2 - prawie tak dobry jak Opus, po prostu mniej osobowości. Budget: zai/glm-4.7. MiniMax M2.1 ma własne dokumenty: MiniMax i modele lokalne. Reguła kciuka: użyj najlepszego modelu, który możesz zapłacić dla pracy na wysokim poziomie i tańszego modelu dla rutynowego czatu lub podsumowań. Możesz przekierować modele na konsultanta i używać podagentów do równolegle do długich zadań (każdy subagent zużywa tokeny). Zobacz Models i Sub-agents. Silne ostrzeżenie: słabsze/zbyt ilościowe modele są bardziej podatne na szybkie wstrzyknięcie i niebezpieczne zachowanie. Zobacz Security. Więcej kontekstu: Models.

Mogę używać modeli samodzielnych llamacpp vLLM Ollama

Tak. Jeśli twój lokalny serwer wyświetla API kompatybilne z OpenAI, możesz wyznaczyć na niego niestandardowego dostawcę . Ollama jest obsługiwana bezpośrednio i jest najprostszą ścieżką. Uwaga dotycząca bezpieczeństwa: mniejsze lub bardzo ilościowe modele są bardziej podatne na szybkie wstrzyknięcie . Zdecydowanie zalecamy duże modele dla każdego bota, który może używać narzędzi. Jeśli nadal chcesz małe modele, włącz piaskownice i ścisłe listy dozwolonych narzędzi. Dokumenty: Ollama, modele lokalne, Dostawcy modelów, Security, Sandboxing.

Jak przełączyć modele bez usuwania mojej konfiguracji

Użyj poleceń modelu lub edytuj tylko pola model. Unikaj pełnych zamienników konfiguracji. Opcje bezpieczne:
  • /model na czacie (szybka, na sesję)
  • openclaw models set ... (aktualizuje tylko konfigurację modelu)
  • openclaw configure --section model (interaktywny)
  • edytuj agents.defaults.model w ~/.openclaw/openclaw.json
Unikaj config.apply z obiektem częściowym, chyba że zamierzasz zastąpić całą konfigurację. Jeśli nadpisałeś konfigurację, przywróć z kopii zapasowej lub ponownie uruchom openclaw doctor aby naprawić. Dokumenty: Models, Configure, Config, Doctor.

Co używa OpenClaw, Flawe i Krill do modelowania

  • OpenClaw + wadliwe: Antropic Opus (anthropic/claude-opus-4-6) - zobacz Anthropic.
  • Krill: MiniMax M2.1 (minimax/MiniMax-M2.1) - see MiniMax.

Jak włączyć modele na locie bez ponownego uruchamiania

Użyj komendy /model jako samodzielnej wiadomości:
/model sonnet
/model haiku
/model opus
/model gpt
/model gpt-mini
/model gemini
/model gemini-flash
Możesz wyświetlić dostępne modele z /model, /model, lub /model. /model (i /model list) pokazuje kompaktowy, numerowany selektor. Wybierz według liczby:
/wzór 3
Możesz również wymusić określony profil autoryzacji dla dostawcy (na sesję):
/model opus@anthropic:default
/model opus@anthropic:work
Wskazówka: /model status pokazuje który agent jest aktywny, który plik auth-profiles.json jest używany i który profil autoryzacji zostanie wypróbowany. Pokazuje również skonfigurowany punkt końcowy dostawcy (baseUrl) i tryb API (api), gdy jest dostępny. Jak odpiąć profil ustawiony z profilem Uruchom ponownie /model bez sufiks @profile:
/model antropikalny/claudeopus-4-6
Jeśli chcesz powrócić do domyślnego, wybierz go z /model (lub wyślij /model <default provider/model>). Użyj /model, aby potwierdzić, który profil autoryzacji jest aktywny.

Czy mogę używać GPT 5.2 do codziennych zadań i Kodeksu 5.3 do kodowania

Tak. Ustaw jeden jako domyślny i przełącz w razie potrzeby:
  • Szybki przełącznik (na sesję): /model gpt-5.2 dla zadań dziennych, /model gpt-5.3-codex dla kodowania.
  • Domyślnie + switch: ustaw agents.defaults.model.primary na openai/gpt-5.2, a następnie przełącz na openai-codex/gpt-5.3-codex podczas kodowania (lub w odwrotnym kierunku).
  • Subagentów: kodowanie trasy zadań dla podagentów z innym domyślnym modelem.
Zobacz Models i komendy Slash .

Dlaczego widzę model nie jest dozwolony, a następnie nie ma odpowiedzi

Jeśli agents.defaults.models jest ustawiony, staje się dopuszczalną listą dla /model i każdego nadpisania sesji . Wybór modelu, który nie znajduje się w tej liście zwrotów:
Model "provider/model" is not allowed. Use /model to list available models.
Ten błąd został zwrócony **zamiast ** zwykłą odpowiedź. Naprawda: dodaj model do agents.defaults.models, usuń dozwoloną listę lub wybierz model z /model.

Dlaczego widzę nieznany model minimaxMiniMaxM21

Oznacza to, że dostawca nie jest skonfigurowany (nie znaleziono profilu MiniMax dostawcy lub autoryzacja ), więc model nie może zostać rozwiązany. Naprawiona dla tej detekcji jest w 2026.1.12 (niezwolniona w momencie zapisu). Napraw listę kontrolną:
  1. Uaktualnij do 2026.1.12 (lub uruchom z źródłowego main), a następnie zrestartuj bramę.
  2. Upewnij się, że miniMax jest skonfigurowany (kreator lub JSON) lub że miniMax klucz API istnieje w profilach env/auth, aby dostawca mógł być wstrzyknięty.
  3. Użyj dokładnego identyfikatora modelu (rozróżniana jest wielkość liter): minimax/MiniMax-M2.1 lub minimax/MiniMax-M2.1-lightning.
  4. Run:
    openclaw models list
    
    i wybierz z listy (lub /model list na czacie).
Zobacz MiniMax i Models.

Czy mogę użyć MiniMax jako domyślnego i OpenAI dla skomplikowanych zadań

Tak. Użyj MiniMax jako domyślnego i w razie potrzeby przełącz modele na sesję. Fallbacks dotyczy błędów, nie “twardych zadań”, więc użyj /model lub osobnego agenta. Opcja A: przełącznik na sesję
{
  pl: { MINIMAX_API_KEY: "sk-...", OPENAI_API_KEY: "sk-... },
  agents: {
    defaults: {
      model: { primary: "minimax/MiniMax-M2. " },
      modele: {
        "minimax/MiniMax-M2. ": { alias: "minimax" },
        "openai/gpt-5. ": { alias: "gpt" },
      },
    },
  },
}
Następnie:
/model gpt
Wariant B: odrębne agenty
  • Agent A domyślnie: MiniMax
  • Domyślny agent B: OpenAI
  • Trasa według agenta lub użyj /agent do przełączania
Dokumenty: Models, dzwonek wielu agentów, MiniMax, OpenAI.

Czy są wbudowane skróty gp’a opus sonnet

Tak. OpenClaw statków kilka domyślnych skrótów (stosowanych tylko wtedy, gdy model istnieje w agents.defaults.models):
  • opusanthropic/claude-opus-4-6
  • sonnetanthropic/claude-sonnet-4-5
  • gptopenai/gpt-5.2
  • gpt-miniopenai/gpt-5-mini
  • geminigoogle/gemini-3-pro-preview
  • gemini-flashgoogle/gemini-3-flash-preview
Jeśli ustawisz swój własny alias o tej samej nazwie, Twoja wartość wygrywa.

Jak zdefiniować aliasy skrótów modelu

Aliasy pochodzą z agents.defaults.models.<modelId>.alias. Przykład:
{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      modely: {
        "anthropic/claude-opus-4-6": { alias: "opus" },
        "anthropic/claude-sonnet-4-5": { alias: "sonnet" },
        "anthropic/claude-haiku-4-5": { alias: "haiku" },
      },
    },
  },
}
Następnie /model sonnet (lub /<alias> gdy obsługiwany) rozwiązuje się do tego modelu ID.

Jak dodać modele od innych dostawców, takich jak OpenRouter lub ZAI

OpenRouter (pay-per token; wiele modeli):
{
  agents: {
    defaults: {
      model: { primary: "openrouter/anthropic/claude-sonnet-4-5" },
      modely: { "openrouter/anthropic/claude-sonnet-4-5": {} },
    },
  },
  pl: { OPENROUTER_API_KEY: "sk-or-. ." },
}
Z.AI (modele GLM):
{
  agents: {
    domyślnie: {
      model: { primary: "zai/glm-4. " },
      modele: { "zai/glm-4. ": {} },
    },
  },
  env: { ZAI_API_KEY: "..." },
}
Jeśli odwołujesz się do dostawcy/modelu, ale brakuje wymaganego klucza dostawcy, otrzymasz błąd autoryzacji runtime (e. . Nie znaleziono klucza API dla dostawcy "zai"). Nie znaleziono klucza API dla dostawcy po dodaniu nowego agenta Zazwyczaj oznacza to, że nowy agent ma pusty sklep autoryzacyjny. Auth jest dla agenta i przechowywany w:
~/.openclaw/agents/<agentId>/agent/auth-profiles.json
Opcje naprawy:
  • Uruchom openclaw agent add <id> i skonfiguruj autoryzację podczas kreatora.
  • Lub skopiuj auth-profiles.json z agentDir głównego konsultanta do agentDir.
Nie ponownie użyj agentDir przez różnych agentów; powoduje kolizje z autentykacją/sesją.

Model: przelover i “Wszystkie modele nie powiodły się”

Jak działa awaria

Porażka odbywa się w dwóch etapach:
  1. Obrót profilu uwierzytelniania w ramach tego samego dostawcy.
  2. Przełączanie awaryjne modelu do następnego modelu w agents.defaults.model.fallbacks.
Opóźnienia mają zastosowanie do upadających profili (backoff), więc OpenClaw może nadal odpowiadać nawet wtedy, gdy usługodawca jest ograniczony lub tymczasowo nie działa.

Co oznacza ten błąd

Nie znaleziono danych logowania dla profilu "anthropic:default"
Oznacza to, że system próbował użyć identyfikatora profilu autoryzacji anthropic:default, ale nie mógł znaleźć poświadczeń w oczekiwanym sklepie autoryzacyjnym.

Napraw listę kontrolną dla braku danych logowania dla profilu antropikalnego.

  • Potwierdź, gdzie żyją profile uwierzytelniania (nowe vs starsze ścieżki)
    • Aktualnie: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
    • Legacy: ~/.openclaw/agent/* (migrowany przez openclaw doktor)
  • **Potwierdź, że Twój var env jest załadowany przez bramę **
    • Jeśli ustawisz ANTHROPIC_API_KEY w swojej powłoki, ale uruchom bramę za pomocą systemu/uruchamiania, może nie dziedziczyć. Umieść go w ~/.openclaw/.env lub włącz env.shellEnv.
  • Upewnij się, że edytujesz właściwego agenta
    • Konfiguracja wielu agentów oznacza, że może być wiele plików auth-profiles.json.
  • Sprawdzanie modelu/statusu uwierzytelniania
    • Użyj openclaw models status aby zobaczyć skonfigurowane modele i czy dostawcy są uwierzytelniani.
Napraw listę kontrolną dla braku danych logowania dla profilu antropicznego Oznacza to, że operacja jest przypięta do profilu Antropowego autoryzacji, ale brama nie może znaleźć jej w swoim sklepie autoryzacyjnym.
  • Użyj tokenu konfiguracyjnego
    • Uruchom claude setup-token, a następnie wklej go za pomocą openclaw models auth setup-token --provider anthropic.
    • Jeśli token został utworzony na innej maszynie, użyj openclaw models auth paste-token --provider antropiczny.
  • Jeśli chcesz zamiast tego użyć klucza API
    • Umieść ANTHROPIC_API_KEY w ~/.openclaw/.env na hostze bramy.
    • Wyczyść dowolną przypiętą kolejność, która wymusza brakujący profil:
      czyste zlecenie autoryzacji modeli openclaw --provider antropic
      
  • Potwierdź, że używasz poleceń na serwerze bramy
    • W trybie zdalnym, profile uwierzytelniające na żywo na komputerze bramy, a nie na laptopie.

Dlaczego również wypróbowała Google Gemini i zakończyła się niepowodzeniem

Jeśli konfiguracja Twojego modelu zawiera Google Gemini jako rezerwę (lub przełączyłeś się na skrót Geminiego), OpenClaw spróbuje go podczas awaryjnego modelu. Jeśli nie skonfigurowałeś danych logowania Google, zobaczysz `Nie znaleziono klucza API dla dostawcy “google”. Naprawda: albo podaj autoryzację Google, albo usuń/unikaj modeli Google w agents.defaults.model.fallbacks / aliasy, więc rezerwacja nie jest tam trasą. Żądanie LLM odrzuciło wiadomość myślenia o podpisie wymaganą do google antigrawitacji Powód: historia sesji zawiera bloki myślenia bez podpisów (często z przerwanego/częściowego strumienia). Google Antigravity wymaga podpisów do myślenia bloków. Naprawda: OpenClaw oddziela niepodpisane bloki myślenia dla klauzuli antygrawitacji Google. Jeśli nadal się pojawi, rozpocznij nową sesję lub ustaw /thinking off dla tego agenta.

Profil uwierzytelniania: co oni są i jak zarządzać nimi

Powiązano: /concepts/oauth (OAuth flows, pamięć tokenów, wzory wielu kont)

Czym jest profil autoryzacji

Profil autoryzacji to nazwany rekord (klucz OAuth lub API) powiązany z dostawcą. Profile na żywo w:
~/.openclaw/agents/<agentId>/agent/auth-profiles.json

Jakie są typowe identyfikatory profilu

OpenClaw używa wcześniejszych identyfikatorów dostawcy, takich jak:
  • anthropic:default (często gdy nie istnieje żadna tożsamość e-mail)
  • anthropic:<email> dla tożsamości OAuth
  • wybrane niestandardowe identyfikatory (np. anthropic:work)

Czy mogę kontrolować, który profil autoryzacji jest najpierw wypróbowany

Tak. Konfiguracja obsługuje opcjonalne metadane dla profili i zamawiania według dostawcy (auth.order.<provider>). To nie przechowuje tajemnice; mapuje identyfikatory do dostawcy/trybu i ustawia kolejność obrotu. OpenClaw może tymczasowo pominąć profil, jeśli jest w krótkim czasie odnowienia (limity/czasy/błędy autoryzacji) lub w dłuższym wyłączonym stanie (rozliczenie/niewystarczające kredyty). Aby to sprawdzić, uruchom openclaw models status --json i sprawdź auth.unusableProfiles. Tuning: auth.cooldowns.billingBackoffHours*. Możesz również ustawić nadpisanie zamówienia per-agent (przechowywane w auth-profiles.json) tego agenta za pośrednictwem CLI:
# Domyślnie skonfigurowany domyślny agent (omit --agent)
openclaw model auth order get --provider antropic

# Zablokuj rotację do pojedynczego profilu (wypróbuj tylko tę opcję)
openclaw model auth order --provider antropic anthropic:default

# Lub ustaw wyraźne zamówienie (przejście wewnątrz dostawcy)
openclaw model auth order set --provider antropic anthropic:work antropic anthropic:default

# Wyczyść nadpisanie (powrót do autoryzacji konfiguracji). rder / okrągły robina)
Kolejność autoryzacji modeli openclaw jest jasna --provider antropic
Aby skierować konkretny agent:
zestaw autoryzacji modeli openclaw --provider antropic --agent główny antropiczny:default

OAuth vs API key what the difference

OpenClaw obsługuje oba:
  • OAuth często wykorzystuje dostęp do subskrypcji (w stosownych przypadkach).
  • Klucze API używaj płatności za token.
Kreator wyraźnie obsługuje Antropowy token konfiguracyjny i OpenAI Codex OAuth i może przechowywać dla Ciebie klucze API.

Brama: porty, “już uruchomione” i tryb zdalny

Jaki port używa brama

gateway.port kontroluje pojedynczy multipleksowany port dla WebSocket + HTTP (Control UI, hooks, itp.). Priorytet:
--port > OPENCLAW_GATEWAY_PORT > gateway.port > domyślnie 18789

Dlaczego status bramki openclaw mówi, że Runtime działa, ale sonda RPC nie powiodła się

Ponieważ “running” jest widokiem supervisor’s (launchd/systemd/schtasks). Sonda RPC jest prawdziwym połączeniem CLI z bramą WebSocket i wywołaniem status. Użyj statusu bramki openclaw i zaufaj tym liniom:
  • Probe target: (adres URL rzeczywiście użytej sondy)
  • Listening: (co jest faktycznie związane z portem)
  • Ostatni błąd bramy: (zwykła przyczyna główna, gdy proces jest żywy, ale port nie jest słuchany)

Dlaczego status bramki openclaw pokazuje inną usługę Config cli i Config

Edytujesz jeden plik konfiguracyjny podczas uruchamiania innej usługi (często niezgodność --profile / OPENCLAW_STATE_DIR). Naprawa:
instalacja bramy openclaw --force
Uruchom to z tego samego --profile / środowiska, którego usługa ma używać.

To, co robi inna instancja bramy, to już nasłuchiwanie średniej

OpenClaw egzekwuje blokadę przez powiązanie nasłuchu WebSocket natychmiast przy starcie (domyślnie ws://127.0.0.1:18789). Jeśli powiązanie nie powiedzie się z EADDRINUSE, rzuca GatewayLockError wskazując, że inna instancja jest już słuchana. Naprawda: zatrzymaj drugą instancję, uwolnij port lub uruchom openclaw gateway --port <port>.

Jak uruchomić OpenClaw w trybie zdalnym klient łączy się z bramą gdzie indziej

Ustaw gateway.mode: "remote" i ustaw zdalny adres URL WebSocket, opcjonalnie z tokenem/hasłem:
{
  gateway: {
    mode: "remote",
    remote: {
      url: "ws://gateway.tailnet:18789",
      token: "your-token",
      password: "your-password",
    },
  },
}
Uwagi:
  • openclaw gateway zaczyna się tylko, gdy gateway.mode jest local (lub przeszedłeś flagę zastąpienia).
  • Aplikacja macOS ogląda plik konfiguracyjny i przełącza tryby na żywo po zmianie tych wartości.

Interfejs sterowania mówi, że jest nieautoryzowany lub nadal łączy się ponownie co teraz

Twoja brama jest uruchomiona z włączoną autoryzacją (gateway.auth.*), ale interfejs użytkownika nie wysyła pasującego tokenu/hasła. Fakty (z kodu):
  • Interfejs sterowania przechowuje token w przeglądarce localStorage klucz openclaw.control.settings.v1.
Naprawa:
  • Najszybciej: openclaw dashboard (drukuje + kopiuje adres URL pulpitu menedżerskiego, próbuje otworzyć; pokazuje podpowiedź SSH, jeśli bez głowy).
  • Jeśli nie masz jeszcze tokenu: openclaw Lekarz --generate-gateway-token.
  • Jeśli zdalny tunel, najpierw ssh -N -L 18789:127.0.0.1:18789 user@host i otwórz http://127.0.0.1:18789/.
  • Ustaw gateway.auth.token (lub OPENCLAW_GATEWAY_TOKEN) na hostze bramy.
  • W ustawieniach interfejsu sterowania, wklej ten sam token.
  • Wciąż utknąłeś? Uruchom openclaw status --all i postępuj zgodnie z Troubleshooting. Zobacz szczegóły uwierzytelniania Dashboard.

Ustawiam gatewaybind tailnet, ale nie pasuje do nasłuchiwania

tailnet pobrał adres IP skali ogona z interfejsów sieciowych (100.64.0.0/10). Jeśli maszyna nie jest w skali ogonowej (lub interfejs jest w dół), nie ma nic do wiązania. Naprawa:
  • Rozpocznij skalę ognia na tym serwerze (aby miał adres 100.x), lub
  • Przełącz na gateway.bind: "loopback" / "lan".
Uwaga: tailnet jest jasny. auto preferuje pętlę zwrotną; użyj gateway.bind: "tailnet" gdy chcesz powiązać tylko sieć końcową.

Czy mogę uruchomić wiele bramek na tym samym hoście

Zazwyczaj nie - jedna brama może uruchomić wiele kanałów i agentów komunikacyjnych. Używaj wielu bramek tylko wtedy, gdy potrzebujesz nadmiarowości (np. bota ratunkowego) lub twardej izolacji. Tak, ale musisz odizolować:
  • OPENCLAW_CONFIG_PATH (konfiguracja dla każdej instancji)
  • OPENCLAW_STATE_DIR (stan na instancję)
  • agents.defaults.workspace (izolacja obszaru roboczego)
  • gateway.port (unikalne porty)
Szybka konfiguracja (zalecane):
  • Użyj openclaw --profile <name> … na instancję (automatycznie tworzy ~/.openclaw-<name>).
  • Ustaw unikalny gateway.port w każdej konfiguracji profilu (lub przejdź --port do ręcznego uruchomienia).
  • Install a per-profile service: openclaw --profile <name> gateway install.
Profile również nazwy usług sufiksu (bot.molt.<profile>; starsza com.openclaw.*, openclaw-gateway-<profile>.service, OpenClaw Bateway (<profile>)). Pełny przewodnik: Multiple gateways.

Co oznacza błędny kod handshake 1008

Brama jest **serwerem WebSocket **, i oczekuje, że pierwsza wiadomość do będzie ramką connect. Jeśli otrzyma cokolwiek innego, zamyka połączenie kodem 1008 (naruszenie zasad). Typowe przyczyny:
  • Otwierasz adres URL HTTP w przeglądarce (http://...) zamiast klienta WS.
  • Użyłeś złego portu lub ścieżki.
  • Proxy lub tunel usunął nagłówki uwierzytelniania lub wysłał żądanie nie-bramy.
Szybkie poprawki:
  1. Użyj adresu URL WS: ws://<host>:18789 (lub wss://... jeśli HTTPS).
  2. Nie otwieraj portu WS w normalnej karcie przeglądarki.
  3. Jeśli autoryzacja jest włączona, dołącz token lub hasło do ramki connect.
Jeśli używasz CLI lub TUI, adres URL powinien wyglądać jako:
openclaw tui --url ws://<host>:18789 --token <token>
Szczegóły protokołu: Gateway protocol.

Logowanie i debugowanie

Gdzie są logi

Logi plików (strukturalne):
/tmp/openclaw/openclaw-YYYY-MM-DD.log
Możesz ustawić stabilną ścieżkę za pomocą logging.file. Poziom dziennika pliku jest kontrolowany przez logging.level. Werbosity konsoli jest kontrolowany przez --verbose i logging.consoleLevel. Najszybszy ogon dziennika:
openclaw logs --follow
Dzienniki serwisu/przełożonego (gdy brama uruchamia się przez uruchomienie/system):
  • macOS: $OPENCLAW_STATE_DIR/logs/gateway.log i gateway.err.log (domyślnie: ~/.openclaw/logs/...; profile używają ~/.openclaw-<profile>/logs/...)
  • Linux: journalctl --user -u openclaw-gateway[-<profile>].service -n 200 --no-pager
  • Windows: schtasks /Query /TN "OpenClaw Bateway (<profile>)" /V /FO LIST
Zobacz Troubleshooting po więcej.

Jak zacząć uruchamiać usługę bramy

Użyj pomocników bramy:
status bramki openclaw
zrestartuj bramę otwierania
Jeśli uruchomisz bramę ręcznie, openclaw gateway --force może odzyskać port. Zobacz Gateway.

Zamknąłem terminal w systemie Windows, jak zrestartuję OpenClaw

Istnieją dwa tryby instalacji systemu Windows: 1) WSL2 (zalecane): Brama działa wewnątrz Linux. Otwórz PowerShell, wpisz WSL, a następnie zrestartuj:
wsl
status bramki otwartej
zrestartuj bramę otwierania
Jeśli nigdy nie zainstalowałeś usługi, uruchom ją na pierwszym planie:
openclaw gateway run
2) Natywne Windows (nie zalecane): Brama działa bezpośrednio w Windows. Otwórz PowerShell i uruchom:
status bramki openclaw
zrestartuj bramę otwierania
Jeśli uruchomisz go ręcznie (bez usługi), użyj:
openclaw gateway run
Dokumenty: Windows (WSL2), Bateway service runbook.

Brama jest aktywna, ale odpowiedzi nigdy nie dotrą do co powinienem sprawdzić

Zacznij od szybkiego przeglądu zdrowia:
status openclaw
openclaw models status
openclaw channels status
openclaw logs --follow
Typowe przyczyny:
  • Autoryzacja modelu nie załadowana do hosta wejściowego (sprawdź status modelów).
  • Kanał parowanie / dozwolone blokowanie odpowiedzi (sprawdź konfigurację kanału + log).
  • WebChat/Dashboard jest otwarty bez prawego tokenu.
Jeśli jesteś zdalny, potwierdź połączenie tunelu/skali ailscale i że WebSocket bramki jest osiągalny. Dokumenty: Channels, Troubleshooting, dostęp zdalny.

Odłączono od bramy bez powodu, co teraz

Zazwyczaj oznacza to, że interfejs użytkownika utracił połączenie WebSocket. Sprawdź:
  1. Czy brama jest uruchomiona? openclaw gateway status
  2. Czy brama jest zdrowa? openclaw status
  3. Czy interfejs ma odpowiedni token? openclaw dashboard
  4. Jeśli jest zdalny, czy tunel / skala dostosowana do góry?
Następnie dzienniki ogonów:
openclaw logs --follow
Dokumenty: Dashboard, dostęp zdalny, Troubleshooting.

Telegram setMyCommands nie powiódł się z błędami sieciowymi Co powinienem sprawdzić

Rozpocznij z logami i statusem kanału:
status kanałów openclaw
otwiera dzienniki kanałów --channel telegram
Jeśli jesteś na VPS lub za proxy, potwierdź wychodzący HTTPS, a DNS działa. Jeśli brama jest zdalna, upewnij się, że patrzysz na logi na Gateway host. Dokumenty: Telegram, Rozwiązywanie problemów z kanałem.

TUI nie pokazuje wyjścia co należy sprawdzić

Najpierw potwierdź, że brama jest dostępna i agent może uruchomić:
status openclaw
openclaw models status
openclaw logi --follow
W TUI użyj /status aby zobaczyć bieżący stan. Jeśli oczekujesz odpowiedzi na czacie , upewnij się, że dostawa jest włączona (/delivery on). Dokumenty: TUI, komendy Slash .

Jak całkowicie zatrzymać, a następnie uruchomić bramę

Po zainstalowaniu usługi:
brama openclaw stop
zaczyna się brama otwierania
To zatrzymuje/uruchamia nadzorowaną usługę (uruchom na macOS, systemd na Linux). Użyj tego, gdy brama działa w tle jako demon. Jeśli działasz na pierwszym planie, zatrzymaj się z Ctrl-C, następnie:
openclaw gateway run
Docs: Gateway service runbook.

Brama otwarta ELI5 zrestartowana vs openclaw bateway

  • openclaw Bateway restart: zrestartuje usługę w tle (uruchomiony/system).
  • openclaw gateway: uruchamia bramę **na pierwszym planie ** dla tej sesji terminalu.
Jeśli zainstalowałeś usługę, użyj poleceń bramy. Użyj openclaw gateway gdy chcesz uruchomić jednorazowo, na pierwszym planie.

Jaki jest najszybszy sposób, aby uzyskać więcej szczegółów gdy coś się nie powiedzie

Uruchom bramę z --verbose aby uzyskać więcej szczegółów konsoli. Następnie sprawdź plik dziennika w celu uzyskania autoryzacji kanału, routingu modeli i błędów RPC.

Media i załączniki

Moja umiejętność wygenerowała plik imagePDF ale nic nie zostało wysłane

Załączniki wychodzące od agenta muszą zawierać wiersz MEDIA:<path-or-url> (na jego własnym wierszu). Zobacz OpenClaw assistant setup i Agent send. Wysyłanie CLI:
wiadomość openclaw wysyła --target +15555550123 --message "Tutaj to" --media /path/to/file.png
Sprawdź:
  • Kanał docelowy obsługuje media wychodzące i nie jest blokowany przez dozwolone listy.
  • Plik znajduje się w granicach rozmiaru dostawcy (obrazy są przeskalowane do maksymalnie 2048px).
Zobacz Images.

Kontrola bezpieczeństwa i dostępu

Czy bezpieczne jest wystawianie OpenClaw na przychodzące DME

Traktuj przychodzące maszyny DM jako niezaufane dane wejściowe. Wartości domyślne mają na celu zmniejszenie ryzyka:
  • Domyślne zachowanie na kanałach DM-zdolnych to sparowanie:
    • Nieznani nadawcy otrzymują kod parowania; bot nie przetwarza wiadomości.
    • Zatwierdź według: openclaw pairing zatwierdza <channel> <code>
    • Oczekujące żądania są ograniczone do 3 na kanale; sprawdź openclaw parowanie listy <channel>, jeśli kod nie dotarł.
  • Otwieranie DM wymaga publicznego opt-in (dmPolicy: "open" i dopuszczaj "*").
Uruchom openclaw doctor do zasad DM ryzykownych powierzchni.

Jest szybkim wstrzyknięciem tylko dla robotów publicznych

Nie. Szybkie wstrzyknięcie dotyczy niezaufanej treści, a nie tylko kto może DM bota. Jeśli twój asystent czyta zewnętrzną zawartość (wyszukiwanie/pobieranie, strony przeglądarki, e-maile, docs, załączniki, wklejone wpisy), ta zawartość może zawierać instrukcje, które próbują przechwycić model. Może się to zdarzyć, nawet jeśli jesteś jedynym nadawcą. Największe ryzyko polega na włączeniu narzędzi: model może być wytrząsany do exfiltracji kontekstu lub wywoływania narzędzi w Twoim imieniu. Zmniejsz promień rażenia, stosując:
  • za pomocą agenta “czytnika” tylko do odczytu lub wyłączonego narzędziami do podsumowania niezaufanych treści
  • utrzymywanie web_search / web_fetch / browser dla agentów z dostępem do narzędzi
  • piaskownica i ścisłe listy dozwolonych narzędzi
Szczegóły: Security.

Czy mój bot ma własne konto lub numer telefonu na GitHub

Tak, dla większości konfiguracji. Izolacja bota z osobnymi kontami i numerami telefonów zmniejsza promień wybuchu, jeśli coś pójdzie nie tak. Ułatwia to również rotację poświadczeń lub cofnięcie dostępu bez wpływu na Twoje konta osobiste. Rozpocznij mało. Daj dostęp tylko do narzędzi i kont, których naprawdę potrzebujesz, i rozszerzaj w razie potrzeby. Dokumenty: Security, Pairing.

Mogę dać mu autonomię w stosunku do moich wiadomości tekstowych i jest to bezpieczne

Nie zalecamy pełną autonomię w odniesieniu do Twoich osobistych wiadomości. Najbezpieczniejszy wzór:
  • Trzymaj DM w trybie parowania lub w ścisłej liście dozwolonych.
  • Użyj osobnego numeru lub konta jeśli chcesz wysłać wiadomość w swoim imieniu.
  • Pozwól na wersję roboczą i zatwierdzić przed wysłaniem.
Jeśli chcesz eksperymentować, zrób to na dedykowanym koncie i zachowaj go w izolacji. Zobacz Security.

Czy mogę używać tańszych modeli do osobistych zadań asystentów

Tak, jeśli agent jest tylko czatem, a dane wejściowe są zaufane. Smaller tiers are more susceptible to instruction hijacking, so avoid them for tool-enabled agents or when reading untrusted content. Jeśli musisz użyć mniejszego modelu, zablokuj narzędzia i uruchom wewnątrz piaskownicy. Zobacz Security.

Uruchomiłem w Telegramie, ale nie otrzymałem kodu parowania

Kody parowania są wysyłane tylko gdy nieznany nadawca wiadomości bota i dmPolicy: "pairing" jest włączony. /start sam w sobie nie generuje kodu. Sprawdź oczekujące żądania:
openclaw pairing list telegram
Jeśli chcesz mieć natychmiastowy dostęp, zezwól na listę identyfikatora nadawcy lub ustaw dmPolicy: "open" dla tego konta.

WhatsApp będzie wysyłać wiadomości do moich kontaktów, jak działa parowanie

Nie. Domyślna polityka aplikacji WhatsApp to sparowanie. Nieznani nadawcy otrzymują tylko kod parowujący, a ich wiadomość nie jest przetworzona. OpenClaw odpowiada tylko na otrzymywane czaty lub na wyraźne wysłanie wyzwalaczy. Zatwierdź parowanie z:
openclaw pairing approve whatsapp <code>
Lista oczekujących żądań:
openclaw pairing list whatsapp
Zapytanie o numer telefonu kreatora: służy do ustawiania Twojej listy dozwolonych/właściciela, aby Twoje własne DM były dozwolone. Nie jest używany do automatycznego wysyłania. Jeśli używasz swojego osobistego numeru WhatsApp, użyj tego numeru i włącz channels.whatsapp.selfChatMode.

Polecenia czatu, przerywanie zadań i “nie zatrzyma się”

Jak zatrzymać wyświetlanie wewnętrznych komunikatów systemowych na czacie

Większość komunikatów wewnętrznych lub komunikatów narzędzi pojawia się tylko wtedy, gdy verbose lub rozumowanie jest włączone dla tej sesji. Napraw na czacie gdzie go widzisz:
/verbose off
/reason off
Jeśli nadal jest głośny, sprawdź ustawienia sesji w interfejsie sterowania i ustaw wierzchołek na dziedzicza. Potwierdź, że nie używasz profilu bota z verboseDefault ustaw na on w konfiguracji. Dokumenty: Myślenie i werbose, Security.

Jak zakończyć anulowanie uruchomionego zadania

Wyślij dowolną z tych jako samodzielną wiadomość (bez ukośnika):
stop
abort
esc
wait
exit
interrupt
To są przerwane wyzwalacze (nie ukośnik poleceń). Dla procesów w tle (z narzędzia exec), możesz poprosić agenta o uruchomienie:
akcja procesu:zabicie sessionId:XXX
Przegląd poleceń cięcia: zobacz komendy cięcia. Większość poleceń musi być wysyłana jako niezależna wiadomość, która zaczyna się od /, ale kilka skrótów (takich jak /status) działa również w linii dla dozwolonych nadawców.

Jak mogę wysłać wiadomość Discorda z Telegram Crosscontext wiadomoci zabronione

OpenClaw domyślnie blokuje wiadomości międzydostawcy. Jeśli połączenie narzędzi jest połączone z Telegramem, nie zostanie wysłane do Discorda, chyba że wyraźnie na to zezwolisz. Włącz komunikaty dla konsultantów:
{
  agents: {
    domyślnie: {
      tools: {
        message: {
          crossContext: {
            allowAcrossProviders: true, Znacznik
            { włączony: true, prefiks: "[z {channel}] },
          },
        },
      },
    },
  },
}
Uruchom ponownie bramę po edycji konfiguracji. Jeśli chcesz to tylko dla jednego agenta , ustaw go pod agents.list[].tools.message.

Dlaczego bot lekceważy komunikaty o szybkim ogniu

Tryb kolejki kontroluje interakcję nowych komunikatów z wykonywanym lotem. Użyj /qukoleje aby zmienić tryby:
  • steer - nowe wiadomości przekierowują bieżące zadanie
  • followup - uruchom wiadomości jednorazowo
  • collect - wiadomości zbiorcze i odpowiedź raz (domyślnie)
  • steer-backlog - steer teraz, a następnie przetwarzaj backlog
  • interrupt - przerwanie bieżącego biegu i rozpoczęcie nowego
Możesz dodać opcje takie jak debounce:2s cap:25 drop:summarize dla trybów monitorowania.

Odpowiedz na dokładne pytanie ze zrzutu ekranu/czatu

Pyt.: “Jaki jest domyślny model dla Antropii z kluczem API?” Odp.: W OpenClaw dane uwierzytelniające i wybór modelu są odrębne. Ustawienie ANTHROPIC_API_KEY (lub przechowywanie Antropicznego klucza API w profilach uwierzytelniających) umożliwia uwierzytelnianie, ale rzeczywisty model domyślny jest tym, co skonfigurowasz w agentach. efaults.model.primary (na przykład anthropic/claude-sonnet-4-5 lub anthropic/claude-opus-4-6). Jeśli widzisz Brak danych logowania dla profilu "anthropic:default", oznacza to, że brama nie mogła znaleźć danych Antropicznych w oczekiwanym profilach autoryzacji. son dla agenta, który jest uruchomiony.
Wciąż utknąłeś? Zapytaj na Discord lub otwórz dyskusję GitHub.