🦞
Integracao de Canal

Conectar OpenClaw ao iMessage

Use seu assistente de IA diretamente pelo Apple Messages no macOS. Suporta tanto iMessage quanto SMS.

Apenas macOS

A integracao com iMessage requer macOS com o app Mensagens configurado. Usa a ferramenta CLI imsg para ler do banco de dados local de Mensagens.

Por que Usar o iMessage?
  • +Integracao Nativa Apple — Funciona com seu app Mensagens existente
  • +iMessage + SMS — Suporta ambos os protocolos perfeitamente
  • +Confirmacao de Leitura — Saiba quando mensagens sao entregues e lidas
  • +Reacoes — Reacoes do iMessage sao suportadas
  • +Chats em Grupo — Participe de conversas em grupo
  • +Gateway Remoto — Pode funcionar via SSH para um Mac remoto
Requisitos
  • 1.
    macOS

    Com o app Mensagens configurado e conectado ao seu Apple ID

  • 2.
    Permissao de Acesso Total ao Disco

    Necessario para o OpenClaw ler ~/Library/Messages/chat.db

  • 3.
    imsg CLI

    Ferramenta de linha de comando para interagir com o Mensagens

Passos de Configuracao

1

Instalar imsg CLI

Instale a ferramenta de linha de comando imsg que o OpenClaw usa para interagir com o Mensagens:

brew install imsg

Ou baixe da pagina de releases do imsg no GitHub

2

Conceder Acesso Total ao Disco

OpenClaw precisa de permissao para ler o banco de dados do Mensagens:

  • - Abra Ajustes do Sistema (ou Preferencias do Sistema)
  • - Va para Privacidade e Seguranca > Acesso Total ao Disco
  • - Clique no botao + e adicione Terminal (ou iTerm)
  • - Adicione tambem o executavel do OpenClaw se estiver rodando como binario
3

Configurar OpenClaw

Adicione a configuracao do iMessage ao seu arquivo de config openclaw.json:

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

Configurar allowFrom

Especifique quem pode interagir com seu bot:

  • - Numeros de telefone com codigo do pais: +5511999999999
  • - Apple IDs (enderecos de email): usuario@exemplo.com
5

Testar a Conexao

Verifique se o canal iMessage esta funcionando:

openclaw channels status imessage

Depois envie uma mensagem de um contato permitido para testar a integracao.

Configuracao Avancada

Opcoes completas de configuracao para o canal 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 — Caminho para o executavel imsg CLI
  • dbPath — Caminho para o banco de dados do Mensagens
  • remoteHost — Host SSH para configuracao de gateway remoto
  • dmPolicy — Como lidar com mensagens diretas
  • allowFrom — Numeros de telefone ou Apple IDs permitidos a enviar mensagens
  • historyLimit — Numero de mensagens a incluir como contexto
  • includeAttachments — Habilitar manipulacao de anexos
  • mediaMaxMb — Tamanho maximo de anexo em MB
  • service — Forcar iMessage ou SMS, ou usar auto
  • region — Regiao para formatacao de numero de telefone
Configuracao de Gateway Remoto (Opcional)

Se voce quer executar o OpenClaw em um servidor mas acessar o iMessage de um Mac em casa, voce pode usar SSH:

{
  "channels": {
    "imessage": {
      "enabled": true,
      "remoteHost": "user@your-mac.local",
      "cliPath": "/usr/local/bin/imsg"
    }
  }
}
  • - Certifique-se de que a autenticacao por chave SSH esta configurada
  • - O Mac deve estar sempre ligado e conectado
  • - imsg e Acesso Total ao Disco devem estar configurados no Mac
Recursos Suportados
OKConfirmacao de Leitura
OKReacoes do iMessage
OKChats em Grupo
OKSuporte a SMS
OPCAnexos (opcional)
OKHistorico de Mensagens
Solucao de Problemas

Permissao negada ao ler chat.db?

Certifique-se de ter concedido Acesso Total ao Disco para Terminal/iTerm e o executavel do OpenClaw. Voce pode precisar reiniciar o terminal apos conceder acesso.

Bot nao responde a mensagens?

Verifique se o numero de telefone ou Apple ID em allowFrom corresponde exatamente. Numeros de telefone precisam do + e codigo do pais.

Nao encontra chat.db?

O caminho padrao e ~/Library/Messages/chat.db. Certifique-se de que o app Mensagens foi aberto pelo menos uma vez e voce esta conectado.

Comando imsg nao encontrado?

Certifique-se de que imsg esta instalado e no seu PATH. Voce pode especificar o caminho completo em cliPath.

Gateway remoto nao conecta?

Verifique se a autenticacao por chave SSH funciona com ssh usuario@host e que o Mac remoto tem imsg instalado com Acesso Total ao Disco.

iMessage Conectado!

Adicione mais canais ou configure skills para personalizar seu assistente de IA.

Adicionar WhatsAppExplorar Skills