OpenClaw en macOS VMs (Sandboxing)

Configurar entornos de desarrollo aislados puede ser frustrante. Quieres que todo funcione, pero no quieres comprometer la estabilidad de tu máquina principal o perder horas configurando dependencias que luego son difíciles de eliminar.

Mantener el sistema limpio mientras experimentas con automatizaciones requiere una solución que te permita fallar y reiniciar en segundos. Usar una VM te da esa libertad sin riesgos.

Recomendaciones (Elige tu opción)

• VPS Linux pequeño: Ideal para un Gateway siempre activo a bajo costo.
• Hardware dedicado: Un Mac mini o PC con Linux si buscas control total y una IP residencial para evitar bloqueos en automatización de navegadores.
• Híbrido: Mantén el Gateway en un VPS barato y conecta tu Mac como un node cuando necesites automatizar la UI.
• macOS VM: Usa esta opción si necesitas capacidades exclusivas de macOS (iMessage/BlueBubbles) o un aislamiento estricto.

What You’ll Need (Lume)

• Mac con Apple Silicon (M1/M2/M3/M4)
• macOS Sequoia o posterior en el host
• ~60 GB de espacio libre en disco por VM
• ~20 minutos

Quick Start

1. Instala Lume en tu terminal.
2. Crea la VM: lume create openclaw --os macos --ipsw latest.
3. Completa el Setup Assistant y activa Remote Login (SSH).
4. Inicia en modo headless: lume run openclaw --no-display.
5. Accede por SSH, instala OpenClaw y configura tus canales.

---

1) Instalar Lume

Ejecuta este comando para instalar Lume:

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

Si ~/.local/bin no está en tu PATH, añádelo:

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

Verifica la instalación:

lume --version

---

2) Crear la macOS VM

lume create openclaw --os macos --ipsw latest

Este comando descarga macOS y crea la VM. Se abrirá una ventana de VNC automáticamente. Ten paciencia, la descarga puede tardar según tu conexión.

---

3) Completar el Setup Assistant

En la ventana de VNC:

1. Selecciona idioma y región.
2. Omite el Apple ID (o inicia sesión si planeas usar iMessage).
3. Crea tu cuenta de usuario (no olvides el usuario y contraseña).
4. Omite todas las funciones opcionales.

Cuando termines, activa SSH:

1. Ve a System Settings → General → Sharing.
2. Activa “Remote Login”.

---

4) Obtener la IP de la VM

lume get openclaw

Busca la dirección IP (normalmente es algo como 192.168.64.x).

---

5) SSH hacia la VM

ssh tu_usuario@192.168.64.X

Reemplaza tu_usuario y la IP con los datos de tu VM.

---

6) Instalar OpenClaw

Dentro de la VM:

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

Sigue las instrucciones para configurar tu proveedor de modelos (Anthropic, OpenAI, etc.).

---

7) Configurar canales

Edita el archivo de configuración:

nano ~/.openclaw/openclaw.json

Añade tus canales:

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

Inicia sesión en WhatsApp escaneando el QR:

openclaw channels login

---

8) Ejecutar la VM en modo headless

Detén la VM y reiníciala sin interfaz gráfica:

lume stop openclaw
lume run openclaw --no-display

La VM correrá en segundo plano y el daemon de OpenClaw mantendrá el Gateway activo. Para revisar el estado:

ssh tu_usuario@192.168.64.X "openclaw status"

---

Bonus: Integración con iMessage

Esta es la ventaja principal de usar macOS. Utiliza BlueBubbles para conectar iMessage a OpenClaw.

Dentro de la VM:

1. Descarga BlueBubbles desde bluebubbles.app.
2. Inicia sesión con tu Apple ID.
3. Activa la Web API y define una contraseña.
4. Apunta los webhooks de BlueBubbles a tu Gateway (ejemplo: https://tu-host:3000/bluebubbles-webhook?password=tu_password).

Configuración en openclaw.json:

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

Reinicia el Gateway y tu agente podrá gestionar iMessages.

---

Guardar una imagen base (Golden Image)

Antes de hacer cambios profundos, guarda el estado limpio de tu VM:

lume stop openclaw
lume clone openclaw openclaw-golden

Si necesitas resetear todo:

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

---

Ejecución 24/7

Para que la VM no se detenga:

• Mantén tu Mac conectado a la corriente.
• Desactiva el reposo en System Settings → Energy Saver.

Si necesitas disponibilidad total, considera un Mac mini dedicado o un VPS.

---

Troubleshooting

Problema	Solución
No puedo entrar por SSH	Verifica que “Remote Login” esté activo en la VM.
La IP no aparece	Espera a que la VM inicie y ejecuta lume get openclaw de nuevo.
Comando lume no encontrado	Añade ~/.local/bin a tu PATH.
El QR de WhatsApp no funciona	Asegúrate de ejecutar openclaw channels login dentro de la VM.

---

What’s Next

• VPS hosting
• Nodes
• Gateway remote
• BlueBubbles channel
• Lume Quickstart
• Lume CLI Reference

¿Necesitas ayuda personalizada? Prueba nuestro AI Setup Assistant.