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.

​
Aanbevolen standaardkeuze (meeste gebruikers)

  • Kleine Linux-VPS voor een altijd actieve Gateway en lage kosten. Zie VPS-hosting.
  • Eigen hardware (Mac mini of Linux-machine) als je volledige controle en een residentieel IP-adres wilt voor browserautomatisering. Veel sites blokkeren datacenter-IP’s, 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 sandboxed 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)
  • Directe reset 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 bij 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 in (SSH)
  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 later op de host
  • ~60 GB vrije schijfruimte per VM
  • ~20 minuten

​
1) Installeer Lume

/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
Controleer: 
lume --version
Documentatie: Lume-installatie

​
2) Maak de macOS-VM

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) Voltooi de configuratie-assistent

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

​
4) Haal het IP-adres van de VM op

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

​
5) Log via SSH in 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) Installeer OpenClaw

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

​
7) Configureer kanalen

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 op WhatsApp (QR scannen): 
openclaw channels login

​
8) Voer de VM headless uit

Stop de VM en herstart zonder scherm: 
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 killer feature van draaien op macOS. Gebruik BlueBubbles om iMessage aan OpenClaw toe te voegen. 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

​
Sla een gouden image op

Maak een snapshot van je schone staat voordat je verder aanpast: 
lume stop openclaw
lume clone openclaw openclaw-golden
Altijd 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 op stroom te houden
  • Sluimerstand uit te schakelen in Systeeminstellingen → Energiestand
  • caffeinate te gebruiken indien nodig
Voor echt altijd actief gebruik kun je een eigen Mac mini of een kleine VPS overwegen. Zie VPS-hosting.

​
Probleemoplossing

ProbleemOplossing
Kan niet via SSH inloggen op de VMControleer of “Extern inloggen” is ingeschakeld in de Systeeminstellingen van de VM
VM-IP wordt niet getoondWacht tot de VM volledig is opgestart, 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