system.run.
Potrzebne są tylko CLI i Gateway? Zacznij od Wprowadzenia.
Pobieranie
Pobierz kompilacje aplikacji macOS ze strony wydań OpenClaw w GitHub. Jeśli wydanie zawiera zasoby aplikacji macOS, szukaj:OpenClaw-<version>.dmg(zalecane)OpenClaw-<version>.zip
Pierwsze uruchomienie
- Zainstaluj i uruchom OpenClaw.app.
- Wybierz This Mac dla lokalnego Gateway albo połącz się ze zdalnym Gateway.
- Poczekaj, aż aplikacja zainstaluje zgodne środowisko uruchomieniowe CLI. W trybie lokalnym również instaluje i uruchamia Gateway.
- Nawiąż wnioskowanie za pomocą testu aktywnego modelu. Po pomyślnym przejściu testu OpenClaw zajmie się pozostałą konfiguracją.
- Ukończ listę kontrolną uprawnień macOS i wyślij testową wiadomość wdrożeniową.
Aktualizacje
Karta aktualizacji na pulpicie wskazuje, co aplikacja zaktualizuje:- Aktualizuj aplikację Mac + Gateway oznacza, że podpisana aplikacja zarządza lokalnym Gateway uruchamianym przez launchd. Sparkle najpierw aktualizuje aplikację; po jej ponownym uruchomieniu aplikacja automatycznie aktualizuje i ponownie uruchamia swój Gateway w zgodnej wersji, a następnie weryfikuje połączenie.
- Aktualizuj Gateway oznacza, że aplikacja jest połączona ze zdalnym Gateway, ręcznie zarządzanym lokalnym Gateway lub inną instalacją, którą aplikacja nie zarządza. Przycisk uruchamia standardowy proces aktualizacji tego Gateway zamiast zmieniać aplikację Mac.
extended-stable.
Po udanej aktualizacji aplikacja znajduje ostatnio używaną przez człowieka
bezpośrednią sesję najwyższego poziomu i przekazuje temu agentowi jednorazowe zdarzenie aktualizacji. Aktywność Heartbeat
i Cron nie wpływa na ten wybór. Agent może następnie powitać ponownie
w najprawdopodobniej ostatnio używanej rozmowie. W trybie zdalnym aplikacja
aktualizuje tylko lokalne środowisko uruchomieniowe Node na Macu i pomija powiadomienie, gdy
zdalny Gateway jest starszy niż aplikacja.
Sparkle przestrzega ustawienia update.channel Gateway. Wartości beta i dev włączają
wersje beta aplikacji; stable, extended-stable oraz brakujące lub nieznane wartości
pozostawiają stabilne wersje aplikacji.
Otwieranie linków na pulpicie
Kliknięcie zewnętrznego linku w osadzonym pulpicie aplikacji macOS otwiera go w bocznym panelu przeglądarki o regulowanej szerokości, domyślnie zajmującym połowę okna, przy zachowaniu widocznej nawigacji pulpitu. Przeciągnij separator, aby wybrać inną szerokość; aplikacja ją zapamięta. Każdy link otwiera się na osobnej karcie, pasek kart pojawia się po otwarciu wielu stron, a ponowne kliknięcie tego samego linku wykorzystuje istniejącą kartę. Przeciągaj karty, aby zmieniać ich kolejność, zamykaj je przyciskiem zamykania karty lub środkowym przyciskiem myszy, a także kliknij kartę prawym przyciskiem myszy, aby wybrać Open in Default Browser, Copy Link, Reload, Close Tab lub Close Other Tabs. Przyciski wstecz/dalej na pasku tytułu okna oraz gesty na gładziku służą do poruszania się po historii pulpitu; własne przyciski wstecz/dalej panelu bocznego służą do poruszania się po historii aktywnej karty. Panel boczny zawiera również elementy sterujące ponownym ładowaniem, otwieraniem w domyślnej przeglądarce i zamykaniem. Elementy sterujące na pasku tytułu dostosowują się do panelu bocznego aplikacji: gdy jest rozwinięty, przyciski wstecz/dalej znajdują się przy jego prawej krawędzi obok przełącznika panelu bocznego; gdy jest zwinięty, ustępują miejsca przyciskowi wyszukiwania (otwierającemu paletę poleceń) i przyciskowi nowej sesji. Kliknij zewnętrzny link prawym przyciskiem myszy, aby wybrać Open in Sidebar, Open in Default Browser lub Copy Link. Kliknięcia z klawiszem modyfikującym i aktywowane przez użytkownika linki otwierające nowe okno z pulpitu nadal otwierają się w domyślnej przeglądarce; linki otwierające nowe okno wewnątrz panelu bocznego otwierają się jako nowe karty tego panelu. Zwykłe strony interfejsu Control UI hostowane w przeglądarce zachowują standardowe działanie linków i menu kontekstowego przeglądarki.Importowanie danych logowania z przeglądarki
Gdy panel boczny przeglądarki zostanie otwarty po raz pierwszy podczas działania aplikacji z lokalnym Gateway, pulpit wyświetli możliwy do odrzucenia baner, jeśli na Macu istnieje profil przeglądarki z rodziny Chrome zawierający pliki cookie. Baner umożliwia skopiowanie tych plików cookie do izolowanego, zarządzanego profilu używanego przez agentów do przeglądania. Wybierz profil za pomocą elementu Import (może być wymagany Touch ID); postęp i liczba zaimportowanych plików cookie pojawiają się w tym samym miejscu, a kopiowane są wyłącznie pliki cookie — hasła nigdy nie opuszczają przeglądarki źródłowej. Odrzucenie banera zapisuje ten wybór; ścieżka Settings → General → Browser login → Import… umożliwia ponowne wykonanie tej operacji w dowolnym momencie. Zobacz Przeglądarkę, aby poznać bazowy proces importowania i warunekbrowser.allowSystemProfileImport.
Wybór trybu Gateway
Oba tryby wymagają zainstalowanego CLI
openclaw, ponieważ aplikacja ponownie wykorzystuje jego środowisko uruchomieniowe
hosta Node. Na nowym Macu aplikacja automatycznie instaluje zgodne CLI; tryb lokalny
uruchamia następnie kreator Gateway, natomiast tryb zdalny łączy się z wybranym
Gateway bez uruchamiania drugiego lokalnego Gateway.
Instrukcje ręcznego odzyskiwania zawiera strona Gateway w systemie macOS.
Elementy zarządzane przez aplikację
- Stan paska menu, powiadomienia, kondycja i WebChat.
- Monity o uprawnienia macOS dotyczące ekranu, mikrofonu, mowy, automatyzacji i dostępności.
- Jeden Node Maca, który łączy natywne funkcje Canvas, przechwytywanie obrazu z kamery/ekranu, powiadomienia, lokalizację i sterowanie komputerem z poleceniami systemowymi, przeglądarki, pluginów, umiejętności i MCP hosta Node CLI.
- Monity o zatwierdzanie wykonywania poleceń hostowanych na Macu.
- Wykonywanie zatwierdzonych poleceń powłoki w kontekście aplikacji, z zachowaniem przypisania uprawnień macOS do aplikacji, podczas gdy środowisko uruchomieniowe CLI zarządza współdzielonymi zasadami Node.
- Tunele SSH w trybie zdalnym lub bezpośrednie połączenia z Gateway.