Machines virtuelles macOS

# Valeur par défaut recommandée (la plupart des utilisateurs)

• Petit VPS Linux pour un Gateway toujours actif et à faible coût. Consultez Hébergement VPS.
• Matériel dédié (Mac mini ou machine Linux) si vous voulez un contrôle total et une IP résidentielle pour l’automatisation du navigateur. De nombreux sites bloquent les IP de centres de données, donc la navigation locale fonctionne souvent mieux.
• Hybride : gardez le Gateway sur un VPS peu coûteux, et connectez votre Mac comme Node lorsque vous avez besoin d’automatisation de navigateur ou d’interface utilisateur. Consultez Nodes et Gateway distant.

Utilisez une VM macOS lorsque vous avez spécifiquement besoin de fonctionnalités réservées à macOS (iMessage/BlueBubbles) ou que vous voulez une isolation stricte par rapport à votre Mac quotidien.

# Options de VM macOS

# VM locale sur votre Mac Apple Silicon (Lume)

Exécutez OpenClaw dans une VM macOS isolée sur votre Mac Apple Silicon existant avec Lume.

Cela vous donne :

• Un environnement macOS complet isolé (votre hôte reste propre)
• La prise en charge d’iMessage via BlueBubbles (impossible sous Linux/Windows)
• Une réinitialisation instantanée par clonage de VM
• Aucun matériel supplémentaire ni coût cloud

# Fournisseurs Mac hébergés (cloud)

Si vous voulez macOS dans le cloud, les fournisseurs Mac hébergés fonctionnent aussi :

• MacStadium (Mac hébergés)
• D’autres fournisseurs Mac hébergés fonctionnent également ; suivez leur documentation VM + SSH

Une fois que vous avez un accès SSH à une VM macOS, passez à l’étape 6 ci-dessous.

---

# Chemin rapide (Lume, utilisateurs expérimentés)

1. Installez Lume
2. lume create openclaw --os macos --ipsw latest
3. Terminez l’assistant de configuration, activez l’ouverture de session à distance (SSH)
4. lume run openclaw --no-display
5. Connectez-vous en SSH, installez OpenClaw, configurez les canaux
6. Terminé

---

# Ce dont vous avez besoin (Lume)

• Mac Apple Silicon (M1/M2/M3/M4)
• macOS Sequoia ou version ultérieure sur l’hôte
• Environ 60 Go d’espace disque libre par VM
• Environ 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

Vérifiez :

lume --version

Documentation : Installation de Lume

---

# 2) Créer la VM macOS

lume create openclaw --os macos --ipsw latest

Cela télécharge macOS et crée la VM. Une fenêtre VNC s’ouvre automatiquement.

---

# 3) Terminer l’assistant de configuration

Dans la fenêtre VNC :

1. Sélectionnez la langue et la région
2. Ignorez l’identifiant Apple (ou connectez-vous si vous voulez utiliser iMessage plus tard)
3. Créez un compte utilisateur (mémorisez le nom d’utilisateur et le mot de passe)
4. Ignorez toutes les fonctionnalités optionnelles

Une fois la configuration terminée, activez SSH :

1. Ouvrez Réglages Système → Général → Partage
2. Activez « Ouverture de session à distance »

---

# 4) Obtenir l’adresse IP de la VM

lume get openclaw

Recherchez l’adresse IP (généralement 192.168.64.x).

---

# 5) Se connecter à la VM en SSH

ssh [email protected]

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

---

# 6) Installer OpenClaw

Dans la VM :

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

Suivez les invites d’intégration pour configurer votre fournisseur de modèle (Anthropic, OpenAI, etc.).

---

# 7) Configurer les canaux

Modifiez le fichier de configuration :

nano ~/.openclaw/openclaw.json

Ajoutez vos canaux :

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

Connectez-vous ensuite à WhatsApp (scannez le QR) :

openclaw channels login

---

# 8) Exécuter la VM sans interface graphique

Arrêtez la VM et redémarrez sans affichage :

lume stop openclaw
lume run openclaw --no-display

La VM s’exécute en arrière-plan. Le daemon d’OpenClaw maintient le Gateway en cours d’exécution.

Pour vérifier l’état :

ssh [email protected] "openclaw status"

---

# Bonus : intégration iMessage

C’est la fonctionnalité phare de l’exécution sur macOS. Utilisez BlueBubbles pour ajouter iMessage à OpenClaw.

Dans la VM :

1. Téléchargez BlueBubbles depuis bluebubbles.app
2. Connectez-vous avec votre identifiant Apple
3. Activez l’API Web et définissez un mot de passe
4. Faites pointer les Webhook BlueBubbles vers votre Gateway (exemple : https://your-gateway-host:3000/bluebubbles-webhook?password=<password>)

Ajoutez ceci à votre configuration OpenClaw :

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

Redémarrez le Gateway. Votre agent peut maintenant envoyer et recevoir des iMessages.

Détails complets de configuration : canal BlueBubbles

---

# Enregistrer une image de référence

Avant de poursuivre la personnalisation, prenez un instantané de votre état propre :

lume stop openclaw
lume clone openclaw openclaw-golden

Réinitialisez à tout moment :

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

---

# Exécution 24 h/24, 7 j/7

Gardez la VM en cours d’exécution en :

• Gardant votre Mac branché
• Désactivant la veille dans Réglages Système → Économiseur d’énergie
• Utilisant caffeinate si nécessaire

Pour un vrai fonctionnement toujours actif, envisagez un Mac mini dédié ou un petit VPS. Consultez Hébergement VPS.

---

# Dépannage

Problème	Solution
Impossible de se connecter à la VM en SSH	Vérifiez que « Ouverture de session à distance » est activée dans les Réglages Système de la VM
L’IP de la VM ne s’affiche pas	Attendez que la VM démarre complètement, puis relancez lume get openclaw
Commande Lume introuvable	Ajoutez ~/.local/bin à votre PATH
Le QR WhatsApp ne se scanne pas	Assurez-vous d’être connecté à la VM (et non à l’hôte) lorsque vous exécutez openclaw channels login

---

# Documentation associée

• Hébergement VPS
• Nodes
• Gateway distant
• canal BlueBubbles
• Démarrage rapide de Lume
• Référence CLI de Lume
• Configuration de VM sans surveillance (avancé)
• Isolation Docker (approche d’isolation alternative)