> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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. Voir [Hébergement VPS](/fr/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 bon marché et connectez votre Mac comme **nœud** lorsque vous avez besoin d’automatisation navigateur/UI. Voir [Nœuds](/fr/nodes) et [Gateway distant](/fr/gateway/remote).

Utilisez une VM macOS lorsque vous avez spécifiquement besoin de capacités réservées à macOS, comme iMessage, ou lorsque 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](https://cua.ai/docs/lume).

Cela vous offre :

* Environnement macOS complet isolé (votre hôte reste propre)
* Prise en charge d’iMessage via `imsg` (le chemin local par défaut est impossible sous Linux/Windows)
* Réinitialisation instantanée en clonant les 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](https://www.macstadium.com/) (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, continuez à 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 la Connexion à 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
* \~60 Go d’espace disque libre par VM
* \~20 minutes

***

## 1) Installer Lume

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
/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 :

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc
```

Vérifiez :

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
lume --version
```

Documentation : [Installation de Lume](https://cua.ai/docs/lume/guide/getting-started/installation)

***

## 2) Créer la VM macOS

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
lume create openclaw --os macos --ipsw latest
```

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

<Note>
  Le téléchargement peut prendre un certain temps selon votre connexion.
</Note>

***

## 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 (retenez le nom d’utilisateur et le mot de passe)
4. Ignorez toutes les fonctionnalités facultatives

Une fois la configuration terminée :

1. Activez SSH : ouvrez Réglages Système -> Général -> Partage et activez « Connexion à distance ».
2. Pour utiliser la VM sans interface graphique, activez la connexion automatique : ouvrez Réglages Système -> Utilisateurs et groupes, sélectionnez « Se connecter automatiquement en tant que : », puis choisissez l’utilisateur de la VM.

***

## 4) Obtenir l’adresse IP de la VM

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
lume get openclaw
```

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

***

## 5) Se connecter à la VM en SSH

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
ssh youruser@192.168.64.X
```

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

***

## 6) Installer OpenClaw

Dans la VM :

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
npm install -g openclaw@latest
openclaw onboard --install-daemon
```

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

***

## 7) Configurer les canaux

Modifiez le fichier de configuration :

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
nano ~/.openclaw/openclaw.json
```

Ajoutez vos canaux :

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+15551234567"],
    },
    telegram: {
      botToken: "YOUR_BOT_TOKEN",
    },
  },
}
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw channels login
```

***

## 8) Exécuter la VM sans interface graphique

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
lume stop openclaw
lume run openclaw --no-display
```

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

Pour vérifier l’état :

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
ssh youruser@192.168.64.X "openclaw status"
```

***

## Bonus : intégration iMessage

C’est la fonction phare de l’exécution sur macOS. Utilisez [iMessage](/fr/channels/imessage) avec `imsg` pour ajouter Messages à OpenClaw.

Dans la VM :

1. Connectez-vous à Messages.
2. Installez `imsg`.
3. Accordez les autorisations Accès complet au disque et Automatisation au processus qui exécute OpenClaw/`imsg`.
4. Vérifiez la prise en charge RPC avec `imsg rpc --help`.

Ajoutez ceci à votre configuration OpenClaw :

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "imsg",
      dbPath: "~/Library/Messages/chat.db",
    },
  },
}
```

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

Détails complets de configuration : [canal iMessage](/fr/channels/imessage)

***

## Enregistrer une image de référence

Avant de personnaliser davantage, prenez un instantané de votre état propre :

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
lume stop openclaw
lume clone openclaw openclaw-golden
```

Réinitialisez à tout moment :

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
lume stop openclaw && lume delete openclaw
lume clone openclaw-golden openclaw
lume run openclaw --no-display
```

***

## Exécution 24/7

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

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

Pour un fonctionnement réellement toujours actif, envisagez un Mac mini dédié ou un petit VPS. Voir [Hébergement VPS](/fr/vps).

***

## Dépannage

| Problème                                  | Solution                                                                                            |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------- |
| Impossible de se connecter à la VM en SSH | Vérifiez que « Connexion à distance » est activé dans les Réglages Système de la VM                 |
| L’IP de la VM ne s’affiche pas            | Attendez que la VM ait complètement démarré, puis exécutez à nouveau `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 (pas à l’hôte) lorsque vous exécutez `openclaw channels login` |

***

## Documentation associée

* [Hébergement VPS](/fr/vps)
* [Nœuds](/fr/nodes)
* [Gateway distant](/fr/gateway/remote)
* [Canal iMessage](/fr/channels/imessage)
* [Démarrage rapide Lume](https://cua.ai/docs/lume/guide/getting-started/quickstart)
* [Référence CLI Lume](https://cua.ai/docs/lume/reference/cli-reference)
* [Configuration de VM sans surveillance](https://cua.ai/docs/lume/guide/fundamentals/unattended-setup) (avancé)
* [Isolation avec Docker](/fr/install/docker) (approche d’isolation alternative)