Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
OpenClaw op macOS-VM’s (sandboxing)

​
Aanbevolen standaardkeuze (meeste gebruikers)

  • Kleine Linux-VPS voor een altijd actieve Gateway en lage kosten. Zie VPS-hosting.
  • Toegewijde hardware (Mac mini of Linux-machine) als je volledige controle en een residentieel IP-adres wilt voor browserautomatisering. Veel sites blokkeren IP-adressen van datacenters, dus lokaal browsen werkt vaak beter.
  • Hybride: houd de Gateway op een goedkope VPS en verbind je Mac als een Node wanneer je browser-/UI-automatisering nodig hebt. Zie Nodes en Gateway op afstand.
Gebruik een macOS-VM wanneer je specifiek macOS-only mogelijkheden nodig hebt (iMessage/BlueBubbles) of strikte isolatie van je dagelijkse Mac wilt.

​
macOS-VM-opties

​
Lokale VM op je Apple Silicon Mac (Lume)

Voer OpenClaw uit in een gesandboxte macOS-VM op je bestaande Apple Silicon Mac met Lume. Dit geeft je:
  • Volledige macOS-omgeving in isolatie (je host blijft schoon)
  • iMessage-ondersteuning via BlueBubbles (onmogelijk op Linux/Windows)
  • Direct resetten door VM’s te klonen
  • Geen extra hardware- of cloudkosten

​
Gehoste Mac-aanbieders (cloud)

Als je macOS in de cloud wilt, werken gehoste Mac-aanbieders ook:
  • MacStadium (gehoste Macs)
  • Andere gehoste Mac-leveranciers werken ook; volg hun VM- en SSH-documentatie
Zodra je SSH-toegang hebt tot een macOS-VM, ga je verder met stap 6 hieronder.

​
Snel pad (Lume, ervaren gebruikers)

  1. Installeer Lume
  2. lume create openclaw --os macos --ipsw latest
  3. Voltooi de Configuratie-assistent, schakel Extern inloggen (SSH) in
  4. lume run openclaw --no-display
  5. Log in via SSH, installeer OpenClaw, configureer kanalen
  6. Klaar

​
Wat je nodig hebt (Lume)

  • Apple Silicon Mac (M1/M2/M3/M4)
  • macOS Sequoia of nieuwer op de host
  • ~60 GB vrije schijfruimte per VM
  • ~20 minuten

​
1) Lume installeren

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"
Als ~/.local/bin niet in je PATH staat: 
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc
Verifieer: 
lume --version
Documentatie: Lume-installatie

​
2) De macOS-VM maken

lume create openclaw --os macos --ipsw latest
Dit downloadt macOS en maakt de VM. Er wordt automatisch een VNC-venster geopend.
De download kan even duren, afhankelijk van je verbinding.

​
3) Configuratie-assistent voltooien

In het VNC-venster:
  1. Selecteer taal en regio
  2. Sla Apple ID over (of log in als je later iMessage wilt gebruiken)
  3. Maak een gebruikersaccount aan (onthoud de gebruikersnaam en het wachtwoord)
  4. Sla alle optionele functies over
Nadat de configuratie is voltooid, schakel je SSH in:
  1. Open Systeeminstellingen → Algemeen → Delen
  2. Schakel “Extern inloggen” in

​
4) Het IP-adres van de VM ophalen

lume get openclaw
Zoek het IP-adres (meestal 192.168.64.x).

​
5) Via SSH inloggen op de VM

ssh youruser@192.168.64.X
Vervang youruser door het account dat je hebt aangemaakt, en het IP-adres door het IP-adres van je VM.

​
6) OpenClaw installeren

Binnen de VM: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
Volg de onboarding-prompts om je modelprovider (Anthropic, OpenAI, enz.) in te stellen.

​
7) Kanalen configureren

Bewerk het configuratiebestand: 
nano ~/.openclaw/openclaw.json
Voeg je kanalen toe: 
{
  channels: {
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+15551234567"],
    },
    telegram: {
      botToken: "YOUR_BOT_TOKEN",
    },
  },
}
Log daarna in bij WhatsApp (QR-code scannen): 
openclaw channels login

​
8) De VM zonder scherm uitvoeren

Stop de VM en start opnieuw zonder display: 
lume stop openclaw
lume run openclaw --no-display
De VM draait op de achtergrond. De daemon van OpenClaw houdt de Gateway actief. Status controleren: 
ssh youruser@192.168.64.X "openclaw status"

​
Bonus: iMessage-integratie

Dit is de belangrijkste functie van draaien op macOS. Gebruik BlueBubbles om iMessage toe te voegen aan OpenClaw. Binnen de VM:
  1. Download BlueBubbles van bluebubbles.app
  2. Log in met je Apple ID
  3. Schakel de Web API in en stel een wachtwoord in
  4. Richt BlueBubbles-Webhooks op je Gateway (voorbeeld: https://your-gateway-host:3000/bluebubbles-webhook?password=<password>)
Voeg dit toe aan je OpenClaw-configuratie: 
{
  channels: {
    bluebubbles: {
      serverUrl: "http://localhost:1234",
      password: "your-api-password",
      webhookPath: "/bluebubbles-webhook",
    },
  },
}
Herstart de Gateway. Je agent kan nu iMessages verzenden en ontvangen. Volledige installatiedetails: BlueBubbles-kanaal

​
Een golden image opslaan

Maak een snapshot van je schone staat voordat je verder aanpast: 
lume stop openclaw
lume clone openclaw openclaw-golden
Op elk moment resetten: 
lume stop openclaw && lume delete openclaw
lume clone openclaw-golden openclaw
lume run openclaw --no-display

​
24/7 draaien

Houd de VM actief door:
  • Je Mac aangesloten te houden op stroom
  • Slaapstand uit te schakelen in Systeeminstellingen → Energiestand
  • Indien nodig caffeinate te gebruiken
Voor echt altijd actief gebruik kun je een toegewijde Mac mini of een kleine VPS overwegen. Zie VPS-hosting.

​
Problemen oplossen

ProbleemOplossing
Kan niet via SSH inloggen op VMControleer of “Extern inloggen” is ingeschakeld in de Systeeminstellingen van de VM
VM-IP wordt niet weergegevenWacht tot de VM volledig is opgestart en voer lume get openclaw opnieuw uit
Lume-opdracht niet gevondenVoeg ~/.local/bin toe aan je PATH
WhatsApp-QR scant nietZorg dat je bent ingelogd op de VM (niet op de host) wanneer je openclaw channels login uitvoert

​
Gerelateerde documentatie