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
- [Szybki start i konfiguracja przy pierwszym uruchomieniu]
- Utknąłem — jaki jest najszybszy sposób, aby ruszyć dalej?
- Jaki jest zalecany sposób instalacji i konfiguracji OpenClaw?
- Jak otworzyć pulpit po onboardingu?
- Jak uwierzytelnić pulpit (token) na localhost vs zdalnie?
- Jakiego środowiska uruchomieniowego potrzebuję?
- Czy działa na Raspberry Pi?
- Czy są jakieś wskazówki dla instalacji na Raspberry Pi?
- Zatrzymało się na „wake up my friend” / onboarding się nie uruchamia. Co teraz?
- Czy mogę przenieść konfigurację na nową maszynę (Mac mini) bez ponownego onboardingu?
- Gdzie zobaczę nowości w najnowszej wersji?
- Nie mogę uzyskać dostępu do docs.openclaw.ai (błąd SSL). Co teraz?
- Jaka jest różnica między stable a beta?
- Jak zainstalować wersję beta i czym różni się beta od dev?
- Jak wypróbować najnowsze zmiany?
- Ile zwykle trwa instalacja i onboarding?
- Instalator się zawiesił? Jak uzyskać więcej informacji?
- Instalacja na Windows zgłasza „git not found” lub „openclaw not recognized”
- Dokumentacja nie odpowiedziała na moje pytanie — jak uzyskać lepszą odpowiedź?
- Jak zainstalować OpenClaw na Linuxie?
- Jak zainstalować OpenClaw na VPS?
- Gdzie są poradniki instalacji w chmurze/VPS?
- Czy mogę poprosić OpenClaw, aby sam się zaktualizował?
- Co faktycznie robi kreator onboardingu?
- Czy potrzebuję subskrypcji Claude lub OpenAI, aby to uruchomić?
- Czy mogę używać subskrypcji Claude Max bez klucza API
- Jak działa uwierzytelnianie Anthropic „setup-token”?
- Gdzie znaleźć setup-token Anthropic?
- Czy obsługujecie uwierzytelnianie subskrypcji Claude (Claude Pro lub Max)?
- Dlaczego widzę
HTTP 429: rate_limit_errorz Anthropic? - Czy AWS Bedrock jest obsługiwany?
- Jak działa uwierzytelnianie Codex?
- Czy obsługujecie uwierzytelnianie subskrypcji OpenAI (Codex OAuth)?
- Jak skonfigurować OAuth Gemini CLI
- Czy lokalny model nadaje się do luźnych rozmów?
- Jak utrzymać ruch do modeli hostowanych w określonym regionie?
- Czy muszę kupić Mac mini, aby to zainstalować?
- Czy potrzebuję Mac mini do obsługi iMessage?
- Jeśli kupię Mac mini do uruchamiania OpenClaw, czy mogę połączyć go z MacBook Pro?
- Czy mogę używać Bun?
- Telegram: co wpisuje się w
allowFrom? - Czy wiele osób może używać jednego numeru WhatsApp z różnymi instancjami OpenClaw?
- Czy mogę uruchomić agenta „szybkiej rozmowy” oraz agenta „Opus do kodowania”?
- Czy Homebrew działa na Linuxie?
- Jaka jest różnica między instalacją „hackowalną” (git) a instalacją npm?
- Czy mogę później przełączać się między instalacją npm a git?
- Czy powinienem uruchamiać Gateway na laptopie czy na VPS?
- Jak ważne jest uruchamianie OpenClaw na dedykowanej maszynie?
- Jakie są minimalne wymagania VPS i zalecany system operacyjny?
- Czy mogę uruchomić OpenClaw w maszynie wirtualnej i jakie są wymagania
- Czym jest OpenClaw?
- Czym jest OpenClaw w jednym akapicie?
- Jaka jest propozycja wartości?
- Właśnie to skonfigurowałem — co powinienem zrobić najpierw
- Jakie są pięć najczęstszych codziennych zastosowań OpenClaw
- Czy OpenClaw może pomóc w lead gen, outreach, reklamach i blogach dla SaaS
- Jakie są zalety w porównaniu z Claude Code przy tworzeniu stron internetowych?
- Skills i automatyzacja
- Jak dostosować skills bez brudzenia repozytorium?
- Czy mogę ładować skills z niestandardowego folderu?
- Jak mogę używać różnych modeli do różnych zadań?
- Bot zawiesza się podczas ciężkiej pracy. Jak to odciążyć?
- Cron lub przypomnienia nie uruchamiają się. Co sprawdzić?
- Jak zainstalować skills na Linuxie?
- Czy OpenClaw może uruchamiać zadania według harmonogramu lub ciągle w tle?
- Czy mogę uruchamiać skills tylko dla macOS z Linuxa?
- Czy macie integrację z Notion lub HeyGen?
- Jak zainstalować rozszerzenie Chrome do przejmowania przeglądarki?
- Sandboxing i pamięć
- Gdzie dane są zapisywane na dysku
- Czy wszystkie dane używane przez OpenClaw są zapisywane lokalnie?
- Gdzie OpenClaw przechowuje swoje dane?
- Gdzie powinny znajdować się AGENTS.md / SOUL.md / USER.md / MEMORY.md?
- Jaka jest zalecana strategia kopii zapasowych?
- Jak całkowicie odinstalować OpenClaw?
- Czy agenci mogą pracować poza obszarem roboczym?
- Jestem w trybie zdalnym — gdzie jest magazyn sesji?
- Podstawy konfiguracji
- Jaki format ma konfiguracja? Gdzie się znajduje?
- Ustawiłem
gateway.bind: "lan"(lub"tailnet") i teraz nic nie nasłuchuje / UI mówi „unauthorized” - Dlaczego teraz potrzebuję tokenu na localhost?
- Czy muszę restartować po zmianie konfiguracji?
- Jak włączyć wyszukiwanie w sieci (i web fetch)?
- config.apply wyczyścił moją konfigurację. Jak odzyskać i uniknąć tego?
- Jak uruchomić centralny Gateway z wyspecjalizowanymi workerami na różnych urządzeniach?
- Czy przeglądarka OpenClaw może działać w trybie headless?
- Jak używać Brave do sterowania przeglądarką?
- Zdalne gatewaye i węzły
- Jak polecenia propagują się między Telegramem, gatewayem i węzłami?
- Jak agent może uzyskać dostęp do mojego komputera, jeśli Gateway jest hostowany zdalnie?
- Tailscale jest połączony, ale nie otrzymuję odpowiedzi. Co teraz?
- Czy dwie instancje OpenClaw mogą ze sobą rozmawiać (lokalnie + VPS)?
- Czy potrzebuję osobnych VPS dla wielu agentów
- Czy jest korzyść z używania węzła na moim laptopie zamiast SSH z VPS?
- Czy węzły uruchamiają usługę gateway?
- Czy istnieje sposób API / RPC na zastosowanie konfiguracji?
- Jaka jest minimalna „rozsądna” konfiguracja dla pierwszej instalacji?
- Jak skonfigurować Tailscale na VPS i połączyć się z Maca?
- Jak podłączyć węzeł Mac do zdalnego Gateway (Tailscale Serve)?
- Czy powinienem instalować na drugim laptopie czy po prostu dodać węzeł?
- Zmienne środowiskowe i ładowanie .env
- Sesje i wiele czatów
- Jak rozpocząć nową rozmowę?
- Czy sesje resetują się automatycznie, jeśli nigdy nie wyślę
/new? - Czy da się stworzyć zespół instancji OpenClaw: jeden CEO i wielu agentów
- Dlaczego kontekst został ucięty w trakcie zadania? Jak temu zapobiec?
- Jak całkowicie zresetować OpenClaw, zachowując instalację?
- Otrzymuję błędy „context too large” — jak zresetować lub skompaktować?
- Dlaczego widzę „LLM request rejected: messages.N.content.X.tool_use.input: Field required”?
- Dlaczego otrzymuję komunikaty heartbeat co 30 minut?
- Czy muszę dodać „konto bota” do grupy WhatsApp?
- Jak uzyskać JID grupy WhatsApp?
- Dlaczego OpenClaw nie odpowiada w grupie?
- Czy grupy/wątki współdzielą kontekst z DM-ami?
- Ile obszarów roboczych i agentów mogę utworzyć?
- Czy mogę uruchamiać wiele botów lub czatów jednocześnie (Slack) i jak to skonfigurować?
- Modele: domyślne, wybór, aliasy, przełączanie
- Czym jest „domyślny model”?
- Jaki model polecacie?
- Jak przełączyć modele bez czyszczenia konfiguracji?
- Czy mogę używać modeli hostowanych samodzielnie (llama.cpp, vLLM, Ollama)?
- Jakich modeli używają OpenClaw, Flawd i Krill?
- Jak przełączyć modele w locie (bez restartu)?
- Czy mogę używać GPT 5.2 do codziennych zadań i Codex 5.3 do kodowania
- Dlaczego widzę „Model … is not allowed”, a potem brak odpowiedzi?
- Dlaczego widzę „Unknown model: minimax/MiniMax-M2.1”?
- Czy mogę używać MiniMax jako domyślnego i OpenAI do złożonych zadań?
- Czy opus / sonnet / gpt to wbudowane skróty?
- Jak zdefiniować/nadpisać skróty modeli (aliasy)?
- Jak dodać modele od innych dostawców, takich jak OpenRouter lub Z.AI?
- Failover modeli i „All models failed”
- Profile uwierzytelniania: czym są i jak nimi zarządzać
- Gateway: porty, „already running” i tryb zdalny
- Jakiego portu używa Gateway?
- Dlaczego
openclaw gateway statuspokazujeRuntime: running, aleRPC probe: failed? - Dlaczego
openclaw gateway statuspokazujeConfig (cli)iConfig (service)jako różne? - Co oznacza „another gateway instance is already listening”?
- Jak uruchomić OpenClaw w trybie zdalnym (klient łączy się z Gateway gdzie indziej)?
- UI sterowania mówi „unauthorized” (lub ciągle się łączy ponownie). Co teraz?
- Ustawiłem
gateway.bind: "tailnet", ale nie może zbindować / nic nie nasłuchuje - Czy mogę uruchamiać wiele Gateway na tym samym hoście?
- Co oznacza „invalid handshake” / kod 1008?
- Logowanie i debugowanie
- Gdzie są logi?
- Jak uruchomić/zatrzymać/zrestartować usługę Gateway?
- Zamknąłem terminal na Windows — jak zrestartować OpenClaw?
- Gateway działa, ale odpowiedzi nigdy nie docierają. Co sprawdzić?
- „Disconnected from gateway: no reason” — co teraz?
- Telegram setMyCommands kończy się błędami sieci. Co sprawdzić?
- TUI nie pokazuje wyjścia. Co sprawdzić?
- Jak całkowicie zatrzymać, a następnie uruchomić Gateway?
- ELI5:
openclaw gateway restartkontraopenclaw gateway - Jaki jest najszybszy sposób uzyskania większej liczby szczegółów, gdy coś zawiedzie?
- Media i załączniki
- Bezpieczeństwo i kontrola dostępu
- Czy bezpieczne jest wystawienie OpenClaw na przychodzące DM-y?
- Czy prompt injection dotyczy tylko botów publicznych?
- Czy mój bot powinien mieć własny e‑mail, konto GitHub lub numer telefonu
- Czy mogę dać mu autonomię nad moimi wiadomościami tekstowymi i czy to jest bezpieczne
- Czy mogę używać tańszych modeli do zadań asystenta osobistego?
- Uruchomiłem
/startw Telegramie, ale nie dostałem kodu parowania - WhatsApp: czy będzie wysyłać wiadomości do moich kontaktów? Jak działa parowanie?
- Polecenia czatu, przerywanie zadań i „nie chce się zatrzymać”
Pierwsze 60 sekund, gdy coś nie działa
-
Szybki status (pierwsze sprawdzenie)
Szybkie lokalne podsumowanie: system operacyjny + aktualizacja, dostępność gateway/usługi, agenci/sesje, konfiguracja dostawców + problemy środowiska uruchomieniowego (gdy gateway jest osiągalny).
-
Raport do wklejenia (bezpieczny do udostępnienia)
Diagnostyka tylko do odczytu z końcówką logów (tokeny zanonimizowane).
-
Stan demona i portów
Pokazuje środowisko uruchomieniowe nadzorcy vs dostępność RPC, docelowy URL sondy oraz którą konfigurację usługa prawdopodobnie użyła.
-
Głębokie sondy
Uruchamia kontrole zdrowia gateway + sondy dostawców (wymaga osiągalnego gateway). Zobacz Health.
-
Podgląd najnowszego logu
Jeśli RPC nie działa, użyj zapasowo:Logi plikowe są oddzielne od logów usługi; zobacz Logging oraz Rozwiązywanie problemów.
-
Uruchom lekarza (naprawy)
Naprawia/migruje konfigurację i stan + uruchamia kontrole zdrowia. Zobacz Doctor.
-
Migawka Gateway
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ć.- **Kod Claude **: https://www.anthropic.com/claude-code/
- OpenAI Codex: https://openai.com/codex/
--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):
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.
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ń: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(lubOPENCLAW_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).
- Seria ogonowa (zalecane): zachowaj powiązaną pętlę, uruchom
openclaw gateway --tailscale serve, otwórzhttps://<magicdns>/. Jeśligateway.auth.allowTailscalejesttrue, nagłówki tożsamości spełniają autoryzację (bez tokenu). - Wiązanie sieci ogonowej: uruchom
openclaw gateway --bind tailnet --token "<token>", otwórzhttp://<tailscale-ip>:18789/, wklej token w ustawieniach tablicy. - Tunel SSH:
ssh -N -L 18789:127.0.0.1:18789 user@hosti otwórzhttp://127.0.0.1:18789/i wklej token w ustawieniach Control UI.
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.
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.- Zrestartuj Gateway:
- Sprawdź status + autoryzacja:
- Jeżeli nadal się zawiesza, bieg:
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:- Zainstaluj OpenClaw na nowym komputerze.
- Skopiuj
$OPENCLAW_STATE_DIR(domyślnie:~/.openclaw) ze starej maszyny. - Skopiuj swój projekt (domyślnie:
~/.openclaw/workspace). - Uruchom
openclaw doctori uruchom ponownie usługę bramy.
~/.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= stabilnebeta= wczesna kompilacja do testów
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 npmbeta (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):
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
Jak spróbować najnowszych bitów
Dwa opcje:- Kanał deweloperski (git checkout):
main i aktualizacje ze źródła.
- Instalacja Hackable (z strony instalatora):
Instalator utknął jak uzyskać więcej opinii
Uruchom ponownie instalator z dokładnym wyjściem: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
gitjest na Twoim PATH. - Zamknij i ponownie otwórz PowerShell, a następnie uruchom ponownie instalator.
- Twój globalny katalog npm nie jest na PATH.
-
Sprawdź ścieżkę:
-
Upewnij się, że
<prefix>\\binjest na PATH (w większości systemów, to%AppData%\\npm). - Zamknij i ponownie otwórz PowerShell po aktualizacji PATH.
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ć.Jak zainstalować OpenClaw na Linux
Krótka odpowiedź: postępuj zgodnie z przewodnikiem Linux, a następnie uruchom kreatora wdrożenia.- Szybka ścieżka Linux + instalacja usług: Linux.
- Pełne przechodzenie: Pierwsze kroki.
- Instalator + aktualizacje: Instalacja i aktualizacje.
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:- VPS hosting (wszyscy dostawcy w jednym miejscu)
- Fly.io
- Hetzner
- exe.dev
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: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
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: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 naopenai-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 wopenclaw.json.
Kroki:
- Włącz wtyczkę:
openclaw plugins włącza google-gemini-cli-auth - Logowanie:
openclaw models auth login --provider google-gemini-cli --set-default
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ącmodels.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ą.
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 isystem.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 listaby to zobaczyć.
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 --followi przeczytajfrom.id.
- DM twojego bota, a następnie wywołaj
https://api.telegram.org/bot<bot_token>/getUpdatesi przeczytajmessage.from.id.
- Plik
@userinfobotlub@getidsbot.
Można używać jednego numeru WhatsApp z różnymi instancjami OpenClaw
Tak, przez przekierowywanie wielu agentów. Bind each sender’s WhatsApp DM (peerkind: "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:/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 , , , ) 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.
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:
--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.
- 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.
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.
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.
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.
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.
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.
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
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
modelna jedno zadanie. - Subagentów: trasa zadań do odrębnych agentów z różnymi modelami domyślnymi.
- Przełącznik na żądanie: użyj
/modelaby zmienić obecny model sesji w dowolnym momencie.
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) iOPENCLAW_SKIP_CRONnie są ustawione. - Sprawdź, czy brama jest uruchomiona 24/7 (bez uśpienia/restartów).
- Zweryfikuj ustawienia strefy czasowej dla zadania (
--tzvs host zone).
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):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.
Czy mogę korzystać z umiejętności Apple macOS tylko z Linux?
Niebezpośrednio. umiejętności macOS są bramkowane przezmetadata.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.
-
Utwórz opakowanie SSH dla binarnego (np.
memodla Apple Notes): -
Umieść opakowanie na pliku
PATHna serwerze Linux (na przykład~/bin/memo). -
Zastąp metadane umiejętności (obszar roboczy lub
~/.openclaw/skills), aby umożliwić Linux: - 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.
- Jedna strona pojęcia na klienta (kontekst + preferencje + aktywna praca).
- Poproś agenta o pobranie tej strony na początku sesji.
. 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: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 thenode user, so it does not
include system packages, Homebrew, or bundled browsers. Dla pełniejszej konfiguracji:
- Utrzymaj
/home/nodeużywającOPENCLAW_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_PATHi upewnij się, że ścieżka jest kontynuowana.
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
Ustawagents.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)
Pamięć nieustannie zapomina o rzeczach, jak to zrobić
Poproś bota o zapis faktu do pamięci. Notatki długoterminowe należą doMEMORY.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.
Gdzie OpenClaw przechowuje swoje dane
Wszystko żyje pod$OPENCLAW_STATE_DIR (domyślnie: ~/.openclaw):
| Ścieżka | Przeznaczenie |
|---|---|
$OPENCLAW_STATE_DIR/openclaw.json | Główna konfiguracja (JSON5) |
$OPENCLAW_STATE_DIR/credentials/oauth.json | Dotychczasowy import OAuth (skopiowany do profili autoryzacji przy pierwszym użyciu) |
$OPENCLAW_STATE_DIR/agents/<agentId>/agent/auth-profiles.json | Profile autoryzacji (OAuth + klucze API) |
$OPENCLAW_STATE_DIR/agents/<agentId>/agent/auth.json | Pamięć 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.json | Metadane sesji (na 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(lubmemory.md),memory/YYYY-MM-DD.md, opcjonalnyHEARTBEAT.md. - Dziennik stanu (
~/.openclaw): config, dane logowania, profile uwierzytelniania, sesje, dzienniki, i wspólne umiejętności (~/.openclaw/skills).
~/.openclaw/workspace, konfigurowalne przez:
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):
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/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. Konfigurujgateway.auth.mode + gateway.auth.token (lub użyj OPENCLAW_GATEWAY_TOKEN).
gateway.remote.tokenjest 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 krytycznychhot,restart,offsą 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
.
- Jeśli używasz dozwolonych list dodaj
web_search/web_fetchlubgroup:web. web_fetchjest włączone domyślnie (chyba że zostanie jawnie wyłączone).- Daemons czyta var z
~/.openclaw/.env(lub środowiska usług).
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.
Czy przeglądarka OpenClaw może działać bez słuchawek
Tak. Jest to opcja konfiguracyjna: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
Ustawbrowser.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ędzianode.* (ekran, kamera, system) na lokalnej maszynie przez Gateway WebSocket.
Typowa konfiguracja:
- Uruchom bramę na ciągłym serwerze (VPS/serwer domowy).
- Umieść host bramy + swój komputer w tej samej sieci ogonowej.
- Upewnij się, że brama WS jest osiągalna (bind lub tunel SSH).
- 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ł.
-
Zatwierdź węzeł na bramie:
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
- Jeśli korzystasz z Tailscale Serve, upewnij się, że plik
gateway.auth.allowTailscalejest 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.
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ę zopenclaw 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):
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.runjest bramkowane przez węzły dopuszczalne/zatwierdzenia na tym laptopie. - Więcej narzędzi urządzenia. Nody pokazują
canvas,camera, iscreenopróczsystem.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.
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 zmiangateway, 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 doctori 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.
- Użyj
openclaw config setdla małych zmian. - Użyj
openclaw configuredo interaktywnych edycji.
Jaka jest minimalna konfiguracja dla pierwszej instalacji
Jak skonfigurować Skalę Ogonową na VPS i połączyć się z Mac
Minimalne kroki:-
Zainstaluj + zaloguj się na VPS
-
Zainstaluj + zaloguj się na Mac
- Użyj aplikacji skali ogonowej i zaloguj się do tej samej sieci ogonowej.
-
Włącz MagicDNS (zalecane)
- W konsoli administratora w skali Ogonowej włącz MagicDNS, aby VPS miał stabilną nazwę.
-
Użyj nazwy hosta sieci ogonowej
- SSH:
ssh [email protected] - Brama WS:
ws://your-vps.tailnet-xxxx.ts.net:18789
- SSH:
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:- Upewnij się, że VPS + Mac są na tej samej sieci ogonowej.
- 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ł.
-
Zatwierdź węzeł na bramce:
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:.envz bieżącego katalogu roboczego- globalny fallback
.envz~/.openclaw/.env(czyli$OPENCLAW_STATE_DIR/.env)
.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):
Uruchomiłem bramę przez serwis, a moje vary env zniknęły co teraz
Dwa częste poprawki:- Umieść brakujące klucze w
~/.openclaw/.envwięc są one pobierane nawet wtedy, gdy usługa nie odziedziczy twojego pocisku. - Włącz import powłoki (wygoda opt-in):
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:
-
Umieść token w
~/.openclaw/.env: -
Lub włącz import powłoki (
env.shellEnv.enabled: true). -
Lub dodaj go do bloku
envkonfiguracji (dotyczy tylko jeśli brakuje).
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ą posession.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ę.
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
/compactprzed długimi zadaniami i/newpodczas 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:- 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):
lub
/compact <instructions>aby poprowadzić podsumowanie. -
Zresetuj (nowy identyfikator sesji dla tego samego klucza czatu):
- Włącz lub dostosuj sesje pruning (
agents.defaults.contextPruning) do przycinania starego wyjścia narzędzia. - Użyj modelu z większym oknem kontekstowym.
Dlaczego widzę wymagane pole polecenia LLM odrzucające wiadomościXtooluseinput
To jest błąd walidacji dostawcy: model wysłał bloktool_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: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:
Jak uzyskać JID grupy WhatsApp
Opcja 1 (najszybsza): kłody ogona i wysłanie komunikatu testowego w grupie: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:
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.groupsbez"*"i grupa nie jest dozwolona.
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.
- 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 doctoraby 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.
Modele: domyślne, wybór, aliasy, przełączanie
Jaki jest model domyślny
Domyślny model OpenClawa to cokolwiek ustawiłeś: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:/modelna czacie (szybka, na sesję)openclaw models set ...(aktualizuje tylko konfigurację modelu)openclaw configure --section model(interaktywny)- edytuj
agents.defaults.modelw~/.openclaw/openclaw.json
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, /model, lub /model.
/model (i /model list) pokazuje kompaktowy, numerowany selektor. Wybierz według liczby:
/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 (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.2dla zadań dziennych,/model gpt-5.3-codexdla kodowania. - Domyślnie + switch: ustaw
agents.defaults.model.primarynaopenai/gpt-5.2, a następnie przełącz naopenai-codex/gpt-5.3-codexpodczas kodowania (lub w odwrotnym kierunku). - Subagentów: kodowanie trasy zadań dla podagentów z innym domyślnym modelem.
Dlaczego widzę model nie jest dozwolony, a następnie nie ma odpowiedzi
Jeśliagents.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:
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ą:-
Uaktualnij do 2026.1.12 (lub uruchom z źródłowego
main), a następnie zrestartuj bramę. - 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.
-
Użyj dokładnego identyfikatora modelu (rozróżniana jest wielkość liter):
minimax/MiniMax-M2.1lubminimax/MiniMax-M2.1-lightning. -
Run:
i wybierz z listy (lub
/model listna czacie).
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ę
- Agent A domyślnie: MiniMax
- Domyślny agent B: OpenAI
- Trasa według agenta lub użyj
/agentdo przełączania
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 wagents.defaults.models):
opus→anthropic/claude-opus-4-6sonnet→anthropic/claude-sonnet-4-5gpt→openai/gpt-5.2gpt-mini→openai/gpt-5-minigemini→google/gemini-3-pro-previewgemini-flash→google/gemini-3-flash-preview
Jak zdefiniować aliasy skrótów modelu
Aliasy pochodzą zagents.defaults.models.<modelId>.alias. Przykład:
/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):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:
- Uruchom
openclaw agent add <id>i skonfiguruj autoryzację podczas kreatora. - Lub skopiuj
auth-profiles.jsonzagentDirgłównego konsultanta doagentDir.
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:- Obrót profilu uwierzytelniania w ramach tego samego dostawcy.
- Przełączanie awaryjne modelu do następnego modelu w
agents.defaults.model.fallbacks.
Co oznacza ten błąd
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 przezopenclaw doktor)
- Aktualnie:
- **Potwierdź, że Twój var env jest załadowany przez bramę **
- Jeśli ustawisz
ANTHROPIC_API_KEYw swojej powłoki, ale uruchom bramę za pomocą systemu/uruchamiania, może nie dziedziczyć. Umieść go w~/.openclaw/.envlub włączenv.shellEnv.
- Jeśli ustawisz
- Upewnij się, że edytujesz właściwego agenta
- Konfiguracja wielu agentów oznacza, że może być wiele plików
auth-profiles.json.
- Konfiguracja wielu agentów oznacza, że może być wiele plików
- Sprawdzanie modelu/statusu uwierzytelniania
- Użyj
openclaw models statusaby zobaczyć skonfigurowane modele i czy dostawcy są uwierzytelniani.
- Użyj
-
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.
- Uruchom
-
Jeśli chcesz zamiast tego użyć klucza API
-
Umieść
ANTHROPIC_API_KEYw~/.openclaw/.envna hostze bramy. -
Wyczyść dowolną przypiętą kolejność, która wymusza brakujący profil:
-
Umieść
-
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 wagents.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: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:
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.
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:
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łaniemstatus.
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:
--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ślniews://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
Ustawgateway.mode: "remote" i ustaw zdalny adres URL WebSocket, opcjonalnie z tokenem/hasłem:
openclaw gatewayzaczyna się tylko, gdygateway.modejestlocal(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.
- 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@hosti otwórzhttp://127.0.0.1:18789/. - Ustaw
gateway.auth.token(lubOPENCLAW_GATEWAY_TOKEN) na hostze bramy. - W ustawieniach interfejsu sterowania, wklej ten sam token.
- Wciąż utknąłeś? Uruchom
openclaw status --alli 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".
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)
- Użyj
openclaw --profile <name> …na instancję (automatycznie tworzy~/.openclaw-<name>). - Ustaw unikalny
gateway.portw każdej konfiguracji profilu (lub przejdź--portdo ręcznego uruchomienia). - Install a per-profile service:
openclaw --profile <name> gateway install.
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.
- Użyj adresu URL WS:
ws://<host>:18789(lubwss://...jeśli HTTPS). - Nie otwieraj portu WS w normalnej karcie przeglądarki.
- Jeśli autoryzacja jest włączona, dołącz token lub hasło do ramki
connect.
Logowanie i debugowanie
Gdzie są logi
Logi plików (strukturalne):logging.file. Poziom dziennika pliku jest kontrolowany przez logging.level. Werbosity konsoli jest kontrolowany przez --verbose i logging.consoleLevel.
Najszybszy ogon dziennika:
- macOS:
$OPENCLAW_STATE_DIR/logs/gateway.logigateway.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
Jak zacząć uruchamiać usługę bramy
Użyj pomocników bramy: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:Brama jest aktywna, ale odpowiedzi nigdy nie dotrą do co powinienem sprawdzić
Zacznij od szybkiego przeglądu zdrowia:- 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.
Odłączono od bramy bez powodu, co teraz
Zazwyczaj oznacza to, że interfejs użytkownika utracił połączenie WebSocket. Sprawdź:- Czy brama jest uruchomiona?
openclaw gateway status - Czy brama jest zdrowa?
openclaw status - Czy interfejs ma odpowiedni token?
openclaw dashboard - Jeśli jest zdalny, czy tunel / skala dostosowana do góry?
Telegram setMyCommands nie powiódł się z błędami sieciowymi Co powinienem sprawdzić
Rozpocznij z logami i statusem kanału:TUI nie pokazuje wyjścia co należy sprawdzić
Najpierw potwierdź, że brama jest dostępna i agent może uruchomić:/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 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.
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ć wierszMEDIA:<path-or-url> (na jego własnym wierszu). Zobacz OpenClaw assistant setup i Agent send.
Wysyłanie CLI:
- 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).
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"*").
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/browserdla agentów z dostępem do narzędzi - piaskownica i ścisłe listy dozwolonych narzędzi
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.
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 idmPolicy: "pairing" jest włączony. /start sam w sobie nie generuje kodu.
Sprawdź oczekujące żądania:
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: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: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):/, 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.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 zadaniefollowup- uruchom wiadomości jednorazowocollect- wiadomości zbiorcze i odpowiedź raz (domyślnie)steer-backlog- steer teraz, a następnie przetwarzaj backloginterrupt- przerwanie bieżącego biegu i rozpoczęcie nowego
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. UstawienieANTHROPIC_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.