OpenClaw sur VM macOS (Sandboxing)

Choix recommande par defaut (la plupart des utilisateurs)

  • Petit VPS Linux pour une passerelle toujours active a faible cout. Consultez Hebergement VPS.
  • Materiel dedie (Mac mini ou machine Linux) si vous voulez un controle total et une IP residentielle pour l’automatisation navigateur. Beaucoup de sites bloquent les IP de data center, donc la navigation locale fonctionne souvent mieux.
  • Hybride : gardez la passerelle sur un VPS economique et connectez votre Mac en tant que noeud quand vous avez besoin d’automatisation navigateur/UI. Consultez Noeuds et Passerelle distante.

Utilisez une VM macOS quand vous avez specifiquement besoin de fonctionnalites exclusives a macOS (iMessage/BlueBubbles) ou souhaitez une isolation stricte de votre Mac quotidien.

Options de VM macOS

VM locale sur votre Mac Apple Silicon (Lume)

Executez OpenClaw dans une VM macOS sandboxee sur votre Mac Apple Silicon existant avec Lume.

Cela vous offre :

  • Environnement macOS complet en isolation (votre hote reste propre)
  • Support iMessage via BlueBubbles (impossible sous Linux/Windows)
  • Reinitialisation instantanee par clonage de VM
  • Pas de materiel supplementaire ni de couts cloud

Fournisseurs Mac heberges (cloud)

Si vous voulez macOS dans le cloud, les fournisseurs Mac heberges fonctionnent aussi :

  • MacStadium (Macs heberges)
  • D’autres fournisseurs de Mac heberges fonctionnent aussi ; suivez leur documentation VM + SSH

Une fois que vous avez un acces SSH a une VM macOS, continuez a l’etape 6 ci-dessous.


Chemin rapide (Lume, utilisateurs experimentes)

  1. Installer Lume
  2. lume create openclaw --os macos --ipsw latest
  3. Completer l’assistant de configuration, activer la connexion a distance (SSH)
  4. lume run openclaw --no-display
  5. Se connecter en SSH, installer OpenClaw, configurer les canaux
  6. Termine

Ce dont vous avez besoin (Lume)

  • Mac Apple Silicon (M1/M2/M3/M4)
  • macOS Sequoia ou ulterieur sur l’hote
  • ~60 Go d’espace disque libre par VM
  • ~20 minutes

1) Installer Lume

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"

Si ~/.local/bin n’est pas dans votre PATH :

echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc

Verifiez :

lume --version

Docs : Installation de Lume


2) Creer la VM macOS

lume create openclaw --os macos --ipsw latest

Cela telecharge macOS et cree la VM. Une fenetre VNC s’ouvre automatiquement.

A noter : le telechargement peut prendre un certain temps selon votre connexion.


3) Completer l’assistant de configuration

Dans la fenetre VNC :

  1. Selectionnez la langue et la region
  2. Ignorez l’identifiant Apple (ou connectez-vous si vous voulez iMessage plus tard)
  3. Creez un compte utilisateur (retenez le nom d’utilisateur et le mot de passe)
  4. Ignorez toutes les fonctionnalites optionnelles

Une fois la configuration terminee, activez SSH :

  1. Ouvrez Reglages systeme → General → Partage
  2. Activez “Connexion a distance”

4) Obtenir l’adresse IP de la VM

lume get openclaw

Cherchez l’adresse IP (generalement 192.168.64.x).


5) Se connecter en SSH a la VM

ssh [email protected]

Remplacez youruser par le compte que vous avez cree, et l’IP par celle de votre VM.


6) Installer OpenClaw

Dans la VM :

npm install -g openclaw@latest
openclaw onboard --install-daemon

Suivez les invites d’accueil pour configurer votre fournisseur de modeles (Anthropic, OpenAI, etc.).


7) Configurer les canaux

Editez le fichier de configuration :

nano ~/.openclaw/openclaw.json

Ajoutez vos canaux :

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    },
    "telegram": {
      "botToken": "YOUR_BOT_TOKEN"
    }
  }
}

Puis connectez-vous a WhatsApp (scan QR) :

openclaw channels login

8) Executer la VM en mode headless

Arretez la VM et redemarrez sans affichage :

lume stop openclaw
lume run openclaw --no-display

La VM tourne en arriere-plan. Le daemon OpenClaw maintient la passerelle en fonctionnement.

Pour verifier l’etat :

ssh [email protected] "openclaw status"

Bonus : integration iMessage

C’est la fonctionnalite phare de l’execution sur macOS. Utilisez BlueBubbles pour ajouter iMessage a OpenClaw.

Dans la VM :

  1. Telechargez BlueBubbles depuis bluebubbles.app
  2. Connectez-vous avec votre identifiant Apple
  3. Activez l’API Web et definissez un mot de passe
  4. Pointez les webhooks BlueBubbles vers votre passerelle (exemple : https://your-gateway-host:3000/bluebubbles-webhook?password=<password>)

Ajoutez a votre configuration OpenClaw :

{
  "channels": {
    "bluebubbles": {
      "serverUrl": "http://localhost:1234",
      "password": "your-api-password",
      "webhookPath": "/bluebubbles-webhook"
    }
  }
}

Redemarrez la passerelle. Votre agent peut desormais envoyer et recevoir des iMessages.

Details complets : Canal BlueBubbles


Sauvegarder une image de reference

Avant de personnaliser davantage, faites un instantane de votre etat propre :

lume stop openclaw
lume clone openclaw openclaw-golden

Reinitialisation a tout moment :

lume stop openclaw && lume delete openclaw
lume clone openclaw-golden openclaw
lume run openclaw --no-display

Fonctionnement 24/7

Maintenez la VM en fonctionnement en :

  • Gardant votre Mac branche
  • Desactivant la mise en veille dans Reglages systeme → Economiseur d’energie
  • Utilisant caffeinate si necessaire

Pour un fonctionnement veritablement permanent, envisagez un Mac mini dedie ou un petit VPS. Consultez Hebergement VPS.


Depannage

ProblemeSolution
Impossible de SSH dans la VMVerifiez que “Connexion a distance” est active dans les Reglages systeme de la VM
IP de la VM non afficheeAttendez que la VM soit completement demarree, relancez lume get openclaw
Commande lume introuvableAjoutez ~/.local/bin a votre PATH
QR WhatsApp ne scanne pasAssurez-vous d’etre connecte a la VM (pas l’hote) quand vous executez openclaw channels login

Documentation associee