🦞
Integración de Canal

Conectar OpenClaw a iMessage

Usa tu asistente de IA directamente a través de Apple Messages en macOS. Compatible con iMessage y SMS.

Solo macOS

La integración de iMessage requiere macOS con la app Mensajes configurada. Usa la herramienta CLI imsg para leer de la base de datos local de Mensajes.

¿Por qué usar iMessage?
  • +Integración Nativa con Apple — Funciona con tu app Mensajes existente
  • +iMessage + SMS — Compatible con ambos protocolos sin problemas
  • +Confirmaciones de Lectura — Sabe cuándo los mensajes son entregados y leídos
  • +Reacciones — Las reacciones de iMessage son compatibles
  • +Chats Grupales — Participa en conversaciones grupales
  • +Gateway Remoto — Puede funcionar vía SSH a una Mac remota
Requisitos
  • 1.
    macOS

    Con la app Mensajes configurada e iniciada sesión con tu Apple ID

  • 2.
    Permiso de Acceso Completo al Disco

    Requerido para que OpenClaw lea ~/Library/Messages/chat.db

  • 3.
    CLI imsg

    Herramienta de línea de comandos para interactuar con Mensajes

Pasos de Configuración

1

Instalar CLI imsg

Instala la herramienta de línea de comandos imsg que OpenClaw usa para interactuar con Mensajes:

brew install imsg

O descarga desde la página de releases de imsg en GitHub

2

Conceder Acceso Completo al Disco

OpenClaw necesita permiso para leer la base de datos de Mensajes:

  • - Abre Configuración del Sistema (o Preferencias del Sistema)
  • - Ve a Privacidad y Seguridad > Acceso Completo al Disco
  • - Haz clic en el botón + y añade Terminal (o iTerm)
  • - También añade el ejecutable de OpenClaw si lo ejecutas como binario
3

Configurar OpenClaw

Añade la configuración de iMessage a tu archivo de configuración openclaw.json:

{
  "channels": {
    "imessage": {
      "enabled": true,
      "cliPath": "imsg",
      "dbPath": "~/Library/Messages/chat.db",
      "allowFrom": ["+15555550123", "user@example.com"]
    }
  }
}
4

Configurar allowFrom

Especifica quién puede interactuar con tu bot:

  • - Números de teléfono con código de país: +15555550123
  • - Apple IDs (direcciones de correo): usuario@ejemplo.com
5

Probar la Conexión

Verifica que el canal de iMessage funcione:

openclaw channels status imessage

Luego envía un mensaje desde un contacto permitido para probar la integración.

Configuración Avanzada

Opciones completas de configuración para el canal de iMessage:

{
  "channels": {
    "imessage": {
      "enabled": true,
      "cliPath": "imsg",
      "dbPath": "~/Library/Messages/chat.db",
      "remoteHost": "user@gateway-host",
      "dmPolicy": "pairing",
      "allowFrom": ["+15555550123", "user@example.com"],
      "historyLimit": 50,
      "includeAttachments": false,
      "mediaMaxMb": 16,
      "service": "auto",
      "region": "US"
    }
  }
}
  • cliPath — Ruta al ejecutable del CLI imsg
  • dbPath — Ruta a la base de datos de Mensajes
  • remoteHost — Host SSH para configuración de gateway remoto
  • dmPolicy — Cómo manejar los mensajes directos
  • allowFrom — Números de teléfono o Apple IDs permitidos para enviar mensajes
  • historyLimit — Número de mensajes a incluir como contexto
  • includeAttachments — Habilitar manejo de archivos adjuntos
  • mediaMaxMb — Tamaño máximo de archivos adjuntos en MB
  • service — Forzar iMessage o SMS, o usar auto
  • region — Región para formato de números de teléfono
Configuración de Gateway Remoto (Opcional)

Si quieres ejecutar OpenClaw en un servidor pero acceder a iMessage desde una Mac en casa, puedes usar SSH:

{
  "channels": {
    "imessage": {
      "enabled": true,
      "remoteHost": "user@your-mac.local",
      "cliPath": "/usr/local/bin/imsg"
    }
  }
}
  • - Asegúrate de que la autenticación por clave SSH esté configurada
  • - La Mac debe estar siempre encendida y conectada
  • - imsg y Acceso Completo al Disco deben estar configurados en la Mac
Características Soportadas
OKConfirmaciones de Lectura
OKReacciones de iMessage
OKChats Grupales
OKSoporte SMS
OPCArchivos Adjuntos (opcional)
OKHistorial de Mensajes
Solución de Problemas

¿Permiso denegado al leer chat.db?

Asegúrate de haber concedido Acceso Completo al Disco a Terminal/iTerm y al ejecutable de OpenClaw. Puede que necesites reiniciar la terminal después de conceder el acceso.

¿El bot no responde a los mensajes?

Verifica que el número de teléfono o Apple ID en allowFrom coincida exactamente. Los números de teléfono necesitan el + y el código de país.

¿No encuentras chat.db?

La ruta por defecto es ~/Library/Messages/chat.db. Asegúrate de que la app Mensajes haya sido abierta al menos una vez y que hayas iniciado sesión.

¿Comando imsg no encontrado?

Asegúrate de que imsg esté instalado y en tu PATH. Puedes especificar la ruta completa en cliPath.

¿El gateway remoto no se conecta?

Verifica que la autenticación por clave SSH funcione con ssh usuario@host y que la Mac remota tenga imsg instalado con Acceso Completo al Disco.

¡iMessage Conectado!

Añade más canales o configura skills para personalizar tu asistente de IA.

Añadir WhatsAppExplorar Skills