OpenClaw na maszynach wirtualnych macOS (sandboxing)¶
Zalecany domyślny wariant (dla większości użytkowników)¶
- Mały VPS z Linuksem jako zawsze włączony Gateway i niski koszt. Zobacz VPS hosting.
- Dedykowany sprzęt (Mac mini lub maszyna z Linuksem), jeśli chcesz pełnej kontroli oraz adresu IP rezydencyjnego do automatyzacji przeglądarki. Wiele witryn blokuje adresy IP centrów danych, więc lokalne przeglądanie często działa lepiej.
- Hybryda: trzymaj Gateway na tanim VPS, a Maca podłączaj jako węzeł, gdy potrzebujesz automatyzacji przeglądarki/UI. Zobacz Nodes oraz Gateway remote.
Używaj maszyny wirtualnej macOS, gdy konkretnie potrzebujesz funkcji dostępnych tylko w macOS (iMessage/BlueBubbles) albo chcesz ścisłej izolacji od codziennego Maca.
Opcje maszyn wirtualnych macOS¶
Lokalna VM na Macu z Apple Silicon (Lume)¶
Uruchom OpenClaw w sandboxowanej maszynie wirtualnej macOS na istniejącym Macu z Apple Silicon przy użyciu Lume.
Zapewnia to:
- Pełne środowisko macOS w izolacji (host pozostaje „czysty”)
- Obsługę iMessage przez BlueBubbles (niemożliwe na Linuksie/Windows)
- Natychmiastowy reset dzięki klonowaniu VM
- Brak dodatkowego sprzętu lub kosztów chmury
Hostowani dostawcy Maców (chmura)¶
Jeśli chcesz macOS w chmurze, sprawdzą się hostowani dostawcy Maców:
- MacStadium (hostowane Maki)
- Inni dostawcy hostowanych Maców również działają; postępuj zgodnie z ich dokumentacją VM + SSH
Gdy masz dostęp SSH do maszyny wirtualnej macOS, przejdź do kroku 6 poniżej.
Szybka ścieżka (Lume, doświadczeni użytkownicy)¶
- Zainstaluj Lume
lume create openclaw --os macos --ipsw latest- Ukończ Asystenta konfiguracji, włącz Zdalne logowanie (SSH)
lume run openclaw --no-display- Zaloguj się przez SSH, zainstaluj OpenClaw, skonfiguruj kanały
- Gotowe
Czego potrzebujesz (Lume)¶
- Mac z Apple Silicon (M1/M2/M3/M4)
- macOS Sequoia lub nowszy na hoście
- ~60 GB wolnego miejsca na dysku na VM
- ~20 minut
1. Zainstaluj Lume¶
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"
Jeśli ~/.local/bin nie znajduje się w PATH:
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc
Weryfikacja:
lume --version
Dokumentacja: Instalacja Lume
2. Utwórz maszynę wirtualną macOS¶
lume create openclaw --os macos --ipsw latest
To pobierze macOS i utworzy VM. Okno VNC otworzy się automatycznie.
Uwaga: Pobieranie może potrwać w zależności od połączenia.
3. Ukończ Asystenta konfiguracji¶
W oknie VNC:
- Wybierz język i region
- Pomiń Apple ID (lub zaloguj się, jeśli chcesz później iMessage)
- Utwórz konto użytkownika (zapamiętaj nazwę użytkownika i hasło)
- Pomiń wszystkie funkcje opcjonalne
Po zakończeniu konfiguracji włącz SSH:
- Otwórz Ustawienia systemowe → Ogólne → Udostępnianie
- Włącz „Zdalne logowanie”
4. Uzyskaj adres IP VM¶
lume get openclaw
Znajdź adres IP (zwykle 192.168.64.x).
5. Zaloguj się do VM przez SSH¶
ssh youruser@192.168.64.X
Zastąp youruser nazwą konta, które utworzyłeś, oraz IP adresem IP Twojej VM.
6. Zainstaluj OpenClaw¶
Wewnątrz VM:
npm install -g openclaw@latest
openclaw onboard --install-daemon
Postępuj zgodnie z monitami onboardingu, aby skonfigurować dostawcę modelu (Anthropic, OpenAI itd.).
7. Skonfiguruj kanały¶
Edytuj plik konfiguracyjny:
nano ~/.openclaw/openclaw.json
Dodaj swoje kanały:
{
"channels": {
"whatsapp": {
"dmPolicy": "allowlist",
"allowFrom": ["+15551234567"]
},
"telegram": {
"botToken": "YOUR_BOT_TOKEN"
}
}
}
Następnie zaloguj się do WhatsApp (zeskanuj kod QR):
openclaw channels login
8. Uruchom VM bez interfejsu graficznego¶
Zatrzymaj VM i uruchom ponownie bez wyświetlania:
lume stop openclaw
lume run openclaw --no-display
VM działa w tle. Demon OpenClaw utrzymuje gateway w działaniu.
Aby sprawdzić status:
ssh youruser@192.168.64.X "openclaw status"
Bonus: integracja iMessage¶
To kluczowa zaleta uruchamiania na macOS. Użyj BlueBubbles, aby dodać iMessage do OpenClaw.
Wewnątrz VM:
- Pobierz BlueBubbles z bluebubbles.app
- Zaloguj się przy użyciu Apple ID
- Włącz Web API i ustaw hasło
- Skieruj webhooki BlueBubbles do swojego gateway (przykład:
https://your-gateway-host:3000/bluebubbles-webhook?password=<password>)
Dodaj do konfiguracji OpenClaw:
{
"channels": {
"bluebubbles": {
"serverUrl": "http://localhost:1234",
"password": "your-api-password",
"webhookPath": "/bluebubbles-webhook"
}
}
}
Zrestartuj gateway. Teraz agent może wysyłać i odbierać iMessage.
Pełne szczegóły konfiguracji: Kanał BlueBubbles
Zapisz „złoty” obraz¶
Przed dalszą personalizacją wykonaj migawkę czystego stanu:
lume stop openclaw
lume clone openclaw openclaw-golden
Reset w dowolnym momencie:
lume stop openclaw && lume delete openclaw
lume clone openclaw-golden openclaw
lume run openclaw --no-display
Praca 24/7¶
Utrzymuj VM w działaniu poprzez:
- Trwa podłączanie Maca
- Wyłączenie uśpienia w Ustawieniach systemowych → Oszczędzanie energii
- Użycie
caffeinate, jeśli to konieczne
Dla prawdziwego trybu zawsze włączonego rozważ dedykowanego Maca mini lub mały VPS. Zobacz VPS hosting.
Rozwiązywanie problemów¶
| Problem | Rozwiązanie |
|---|---|
| Nie można połączyć się przez SSH | Sprawdź, czy „Zdalne logowanie” jest włączone w Ustawieniach systemowych VM |
| Nie wyświetla się IP VM | Poczekaj, aż VM w pełni się uruchomi, ponownie uruchom lume get openclaw |
| Nie znaleziono polecenia Lume | Dodaj ~/.local/bin do PATH |
| Kod QR WhatsApp nie skanuje | Upewnij się, że jesteś zalogowany do VM (a nie hosta) podczas uruchamiania openclaw channels login |
Powiązana dokumentacja¶
- VPS hosting
- Nodes
- Gateway remote
- Kanał BlueBubbles
- Lume Quickstart
- Lume CLI Reference
- Unattended VM Setup (zaawansowane)
- Docker Sandboxing (alternatywne podejście do izolacji)