OpenClaw no iPhone: Guia para iOS em 2026

Para usar OpenClaw no iPhone, você mantém o Gateway rodando em um computador, mini-PC ou VPS e acessa o assistente pelo app iOS, WhatsApp, Telegram ou navegador. O iPhone funciona como interface e, no app oficial, também como um nó com câmera, localização, voz e outros recursos autorizados. Ele não substitui o servidor: o trabalho continua sendo coordenado pelo Gateway em macOS, Linux ou Windows via WSL2.

A opção mais simples para começar é conversar pelo Telegram, sem instalar um app adicional do OpenClaw. Para integrar recursos nativos do aparelho, use uma compilação oficial distribuída pelos canais da Apple quando disponível para a versão atual, ou uma build de desenvolvimento feita a partir do código-fonte. A disponibilidade pública do app pode variar entre lançamentos; por isso, confirme sempre na documentação oficial do OpenClaw para iOS em vez de confiar em links antigos ou aplicativos com nome parecido.

Resposta rápida: qual opção escolher no iPhone?

Recomendação direta: se é seu primeiro contato com o produto, instale o Gateway em uma máquina compatível, valide o modelo pelo terminal e conecte o Telegram. Depois, escolha entre WhatsApp e app iOS conforme o trabalho que precisa executar. Não tente ativar todos os canais, câmera, localização, voz e ferramentas no primeiro dia.

Como o OpenClaw funciona no iPhone

OpenClaw separa a interface do usuário da máquina que coordena o agente. Essa arquitetura permite conversar pelo celular sem obrigar o iPhone a manter processos de servidor ativos em segundo plano.

iPhone com app, WhatsApp, Telegram ou navegador
                         ↓
                conexão autenticada
                         ↓
       Gateway OpenClaw em outra máquina
                         ↓
      modelo + memória + skills + ferramentas
                         ↓
              resultado volta ao iPhone

O Gateway recebe a mensagem, aplica as regras do agente, consulta as ferramentas permitidas e devolve o resultado. Se houver uma tarefa programada, ele pode trabalhar sem que o telefone esteja com a tela ligada e enviar um resumo quando terminar.

Esse desenho explica duas dúvidas comuns:

1. O OpenClaw não precisa rodar integralmente no iPhone. O celular pode ser apenas a superfície de conversa e aprovação.
2. O Gateway precisa continuar disponível. Se o computador dormir ou a VPS cair, os canais deixam de executar o trabalho, mesmo que os aplicativos do iPhone continuem abrindo normalmente.

Se você ainda está escolhendo a máquina principal, compare PC, VPS, Proxmox e Raspberry Pi no guia de onde hospedar o OpenClaw. Para entender a arquitetura antes da instalação, veja também o que é OpenClaw e como funciona.

Existe app oficial do OpenClaw para iPhone?

O projeto mantém um app iOS do tipo node, documentado oficialmente e capaz de se conectar a um Gateway. Segundo a documentação atual, builds para iPhone são distribuídas pelos canais da Apple quando habilitadas para uma versão; desenvolvedores também podem executar uma build local a partir do código-fonte.

Isso não significa que haverá sempre uma página pública e estável na App Store para qualquer visitante. A distribuição pode mudar conforme o estágio do lançamento, testes e versão. Antes de instalar:

• parta da documentação oficial;
• confira quem é o desenvolvedor e a origem do link;
• não entregue token, senha ou setup code a um app não verificado;
• desconfie de aplicativos que usam “OpenClaw” no nome, mas não são vinculados ao projeto oficial;
• evite arquivos IPA oferecidos por sites desconhecidos.

Quando o app oficial não estiver disponível para a sua versão ou conta, você ainda pode usar OpenClaw normalmente pelo WhatsApp, Telegram ou navegador. Esses caminhos não são “versões menores”: para conversar, receber alertas e aprovar rotinas, frequentemente são tudo o que o usuário precisa.

O que o app iOS adiciona

O app oficial não é apenas uma janela de chat. Quando pareado como nó e autorizado, ele pode expor capacidades do iPhone ao Gateway. A documentação atual lista recursos como:

• captura de câmera;
• snapshot de tela;
• localização;
• Talk Mode e recursos de voz;
• Voice Wake, conforme suporte da versão;
• resumos de saúde opcionais e somente leitura, com consentimento específico;
• leitura de arquivos do workspace pelo app;
• acesso a sessões e histórico recente;
• revisão de pedidos de aprovação;
• envio de imagens pelo seletor de fotos, câmera, Arquivos, colagem ou folha de compartilhamento.

Cada capacidade deve ser tratada separadamente. Parear o aparelho não é motivo para conceder todas as permissões. Se o caso de uso é apenas receber um briefing, por exemplo, câmera, localização e dados de saúde não são necessários.

O princípio correto é menor privilégio: habilite um recurso quando existir uma tarefa clara, teste, registre o resultado e revogue o que não for usado. O guia de boas práticas do OpenClaw em produção detalha essa progressão.

Opção 1: usar OpenClaw pelo Telegram no iPhone

Telegram é o caminho mais previsível para um primeiro teste. Você cria um bot, configura o token no Gateway, restringe o acesso ao seu usuário e conversa pelo aplicativo que já existe no iPhone.

O fluxo básico é:

1. concluir a instalação do OpenClaw em outra máquina;
2. confirmar que o Gateway e o modelo respondem localmente;
3. criar um bot pelo BotFather;
4. armazenar o token na configuração segura, nunca em uma mensagem ou repositório;
5. configurar o canal Telegram;
6. adicionar seu identificador à allowlist;
7. abrir o bot no iPhone e enviar uma mensagem de teste;
8. acompanhar os logs durante as primeiras interações.

Use primeiro um teste sem ferramentas:

Responda apenas com: conexão do iPhone confirmada.

Depois valide uma entrega estruturada:

Crie uma checklist de cinco itens para amanhã. Não acesse arquivos nem envie mensagens para terceiros.

A restrição no segundo pedido é deliberada: ela ajuda a separar conversa de execução. Somente depois de verificar identidade, logs e comportamento você deve permitir agenda, e-mail, navegador ou arquivos.

O passo a passo completo está no guia de integração do Telegram com OpenClaw.

Quando escolher Telegram

Telegram costuma ser a melhor opção se você:

• quer validar a instalação rapidamente;
• prefere um bot separado da conta principal do WhatsApp;
• precisa receber relatórios e alertas programados;
• quer experimentar botões, comandos e aprovações;
• ainda não precisa de câmera ou localização como ferramenta do agente.

Para uma pessoa aprendendo, menos componentes significam diagnóstico mais fácil. Se a mensagem não chega, você verifica canal, token, allowlist e Gateway — sem misturar pareamento de nó e permissões do iOS.

Opção 2: usar OpenClaw pelo WhatsApp no iPhone

WhatsApp é o canal mais natural para muitos usuários brasileiros. Ele permite pedir resumos, enviar áudio, receber alertas e acompanhar tarefas no mesmo aplicativo usado durante o dia.

O processo geral é:

1. instalar e testar o Gateway em um computador ou servidor;
2. iniciar a vinculação do canal WhatsApp;
3. no iPhone, abrir WhatsApp → Configurações → Aparelhos conectados;
4. escanear o QR code mostrado pelo processo de configuração;
5. confirmar que a sessão ficou conectada;
6. restringir os números que podem acionar o agente;
7. testar texto antes de áudio, imagem e documento;
8. observar reconexão e logs antes de colocar a rotina em produção.

Consulte como conectar WhatsApp ao OpenClaw para o procedimento completo e o hub de OpenClaw no WhatsApp para limites do canal.

O que dá para fazer pelo WhatsApp no iPhone

Com permissões bem definidas, você pode:

• pedir um resumo de agenda e tarefas;
• enviar áudio para transcrição e classificação;
• receber um briefing matinal;
• consultar uma base de conhecimento autorizada;
• pedir um rascunho de e-mail ou resposta comercial;
• aprovar ou rejeitar uma ação sensível;
• receber aviso quando uma automação falha;
• acompanhar uma tarefa executada no servidor.

Não transforme a conversa em terminal irrestrito. Para ações como enviar e-mail externo, publicar, excluir arquivo, fazer pagamento ou alterar produção, use o padrão de aprovação humana para agentes de IA: o agente prepara, mostra o impacto e espera uma confirmação identificável.

Opção 3: parear o app iOS com o Gateway

O app iOS é indicado quando você precisa que o aparelho participe como nó, não apenas como canal de mensagens. O pareamento atual usa um setup code criado pelo Gateway.

Pré-requisitos

Você precisa de:

• Gateway atualizado e autenticado em macOS, Linux ou Windows via WSL2;
• uma rota de rede que o iPhone consiga alcançar;
• app iOS oficial ou build de desenvolvimento confiável;
• permissão para criar e aprovar o dispositivo;
• conexão protegida, especialmente fora da rede local.

O Gateway usa a porta 18789 no fluxo atual. O bind padrão em loopback não fica acessível pelo telefone. Para acesso remoto, a documentação recomenda uma rota protegida, como Tailscale Serve, em vez de simplesmente abrir a porta administrativa para toda a internet.

Exemplo documentado para iniciar o Gateway com Tailscale Serve:

openclaw gateway --port 18789 --tailscale serve

Passo a passo do pareamento

1. Inicie o Gateway autenticado em uma rota alcançável pelo iPhone.
2. Abra a Control UI e acesse a área de nós e dispositivos.
3. Selecione Pair device e crie um setup code.
4. No app iOS, abra Settings → Gateway.
5. Escaneie o QR code ou cole o setup code.
6. Revise o nível de acesso solicitado antes de aprovar.
7. Se aparecer um pedido pendente, confirme no Gateway somente depois de verificar o dispositivo.
8. Teste o chat e uma capacidade de baixo risco antes de liberar outros recursos.

Como alternativa pelo terminal, a documentação atual usa comandos como:

openclaw devices list
openclaw devices approve <requestId>
openclaw nodes status

Não aprove um requestId antigo sem listar novamente os pedidos. Uma nova tentativa com credenciais, escopos ou chave diferentes pode substituir a solicitação anterior.

Como acessar com segurança fora de casa

O erro mais perigoso em uma instalação mobile é expor o Gateway diretamente à internet sem autenticação e sem controle de rede. A conveniência de abrir uma porta não compensa o risco de oferecer uma superfície administrativa pública.

Prefira uma destas opções:

• Tailscale: cria uma rede privada entre iPhone e servidor;
• Tailscale Serve: fornece uma rota protegida recomendada na documentação do app;
• VPN própria bem configurada: adequada para quem já opera essa infraestrutura;
• proxy reverso com HTTPS e autenticação: exige mais conhecimento e manutenção;
• Telegram ou WhatsApp: quando você só precisa de conversa e alertas, sem acesso ao painel.

Evite:

• encaminhar a porta 18789 no roteador para qualquer origem;
• usar ws:// em rede não confiável;
• compartilhar token por chat, print ou e-mail;
• reutilizar a senha principal de outro serviço;
• aprovar automaticamente qualquer aparelho que apareça;
• deixar o painel aberto em computador compartilhado.

Depois do primeiro pareamento, revise dispositivos ativos e remova os que não são mais usados. Segurança mobile precisa incluir o cenário de perda ou troca do iPhone.

App iOS, Telegram, WhatsApp ou navegador?

A escolha não precisa ser exclusiva. Um arranjo comum é usar Telegram para alertas, WhatsApp para pedidos cotidianos e app iOS somente quando câmera, localização ou aprovação nativa forem úteis. O importante é não duplicar notificações e permissões sem necessidade.

E o iMessage?

É possível usar iMessage como canal quando há um Mac compatível e sempre disponível. Nesse desenho, o iPhone envia e recebe mensagens pelo ecossistema Apple, mas a integração depende do macOS e das permissões do aplicativo Mensagens.

O caminho é adequado para quem já mantém um Mac ligado como host e quer uma experiência integrada. Não é a melhor primeira opção para quem pretende rodar o Gateway somente em Linux ou VPS.

Veja o guia de OpenClaw no iMessage antes de escolher essa arquitetura. Considere também que mudanças de permissões e automações do macOS podem exigir manutenção depois de atualizações do sistema.

Limitações importantes no iPhone

O app não substitui o Gateway

O nó iOS conecta-se a um Gateway em outro dispositivo. Se a máquina principal estiver desligada, as rotinas não continuarão sendo executadas apenas porque o app está instalado.

O iOS pode suspender conexões em segundo plano

O sistema controla bateria e execução em background. A documentação alerta que o iOS pode suspender conexões do app quando ele entra em segundo plano. Portanto, não trate o telefone como servidor 24 horas nem dependa de uma sessão permanentemente ativa para tarefas críticas.

Nem toda permissão é necessária

Câmera, tela, localização, voz e saúde são categorias diferentes. Autorize apenas o que o workflow usa e confira o texto do pedido do sistema antes de tocar em Permitir.

A disponibilidade do app pode variar

Uma referência a “app iOS” na documentação não garante que uma listagem pública estará disponível em todo país, conta ou momento. Use os canais de mensagens como alternativa funcional e consulte a página oficial para o estado atual da distribuição.

Modelos locais continuam rodando em outra máquina

Se você quer usar Ollama e evitar uma API de modelo, a inferência deve rodar em um computador com recursos adequados. O iPhone conversa com o Gateway, mas não vira automaticamente o host de um modelo grande. Compare opções no guia de modelos locais com Ollama.

Configuração recomendada para começar

Uma arquitetura simples e segura para uso pessoal é:

iPhone
  └── Telegram ou WhatsApp
          └── Gateway em computador pessoal
                  ├── modelo por API ou Ollama
                  ├── memória básica
                  └── uma rotina de leitura

Siga esta ordem:

1. Instale o Gateway. Não conecte o celular antes de o diagnóstico local passar.
2. Valide o modelo. Faça perguntas simples no terminal.
3. Conecte um canal. Telegram costuma reduzir variáveis.
4. Configure allowlist. Somente seu usuário ou número no começo.
5. Teste uma rotina de leitura. Agenda, checklist ou resumo.
6. Adicione aprovação. Antes de qualquer ação externa.
7. Configure backup. Registre configuração, memória e procedimento de restauração.
8. Só então avalie o app iOS. Habilite uma capacidade por vez.

Para uma primeira entrega útil, configure um briefing matinal com OpenClaw e receba no iPhone antes do expediente. Depois, use o agendamento de tarefas para criar rotinas recorrentes.

Checklist de segurança para iPhone

Antes de considerar a configuração pronta, confirme:

• o Gateway exige autenticação;
• a porta administrativa não está aberta para toda a internet;
• o acesso remoto usa Tailscale, VPN ou HTTPS protegido;
• Telegram ou WhatsApp aceitam somente usuários autorizados;
• setup code, token e senha não aparecem em chats ou prints;
• o app foi obtido de uma origem oficial verificável;
• permissões de câmera, localização, microfone e saúde foram concedidas individualmente;
• ações externas exigem aprovação;
• dispositivos antigos podem ser revogados;
• existe backup testado da configuração;
• você sabe pausar o agente se o iPhone for perdido;
• logs não armazenam dados pessoais além do necessário.

O hub de segurança do OpenClaw reúne controles adicionais. Para dados pessoais e retenção, leia também a página de privacidade.

Troubleshooting: OpenClaw não funciona no iPhone

O iPhone não encontra o Gateway

Confirme se o Gateway está rodando e se a rota é alcançável pelo aparelho. Um serviço preso em 127.0.0.1 aceita somente conexões da própria máquina. Para acesso pela LAN, use a configuração autenticada recomendada; para acesso remoto, prefira Tailscale Serve.

Verifique também se iPhone e servidor estão na mesma rede quando o teste depende de descoberta local. Redes de convidados costumam isolar dispositivos.

O pedido de pareamento não aparece

Gere um novo setup code, tente novamente e execute:

openclaw devices list

Não presuma que o identificador anterior continua válido. Se a solicitação foi substituída, aprove o novo requestId após revisar papel e escopos.

O app conecta, mas câmera ou localização não funciona

Abra os Ajustes do iOS e confira a permissão específica do OpenClaw. Depois, verifique se a capacidade aparece no status do nó. Conexão do chat e autorização de sensor são etapas independentes.

O assistente para de responder quando o app vai para segundo plano

Isso pode ser uma limitação normal do gerenciamento de background do iOS. Tarefas contínuas devem rodar no Gateway. Use Telegram, WhatsApp ou notificações para receber o resultado, em vez de depender da sessão do app permanentemente ativa.

Telegram ou WhatsApp recebe mensagem, mas não responde

Separe o diagnóstico em camadas:

1. o Gateway está ativo?
2. o modelo responde localmente?
3. o canal está conectado?
4. o usuário está na allowlist?
5. houve erro de credencial ou limite do provedor?
6. a ferramenta solicitada tem permissão?

Essa sequência evita reinstalar o canal quando o problema real está no modelo ou no Gateway.

Encontrei vários apps com o nome OpenClaw

Não use apenas nome e ícone como prova. Volte à documentação oficial, siga os links publicados pelo projeto e confira desenvolvedor, domínio e instruções de pareamento. Nunca cole um token do Gateway em um aplicativo cuja origem você não verificou.

Próximo passo

Para começar hoje, instale o Gateway em uma máquina compatível e conecte o Telegram no iPhone. Faça uma conversa simples, restrinja o acesso e programe um briefing de baixo risco. Quando essa base estiver estável, escolha conscientemente entre WhatsApp, navegador e app iOS.

Se você usa Android, consulte o guia específico de OpenClaw no Android. A arquitetura é parecida, mas disponibilidade do app, execução em segundo plano e opções experimentais diferem entre os sistemas.

Perguntas frequentes

Dá para instalar OpenClaw diretamente no iPhone?

O uso recomendado não instala o Gateway completo no iPhone. Você executa o Gateway em macOS, Linux ou Windows via WSL2 e acessa pelo app iOS, Telegram, WhatsApp ou navegador. O telefone funciona como interface e, no app, como nó autorizado.

Existe app oficial do OpenClaw para iOS?

O projeto mantém um app iOS documentado oficialmente. Builds são distribuídas pelos canais da Apple quando habilitadas para uma versão, e também podem ser executadas a partir do código-fonte para desenvolvimento. Como a disponibilidade pública pode variar, confirme sempre na documentação oficial antes de procurar na App Store.

Preciso deixar o computador ligado?

Sim, se o Gateway estiver no seu computador. Para funcionar 24 horas sem depender do notebook, use um mini-PC, servidor doméstico ou VPS com backup, atualização e acesso remoto protegido.

Qual é melhor no iPhone: Telegram ou WhatsApp?

Telegram costuma ser mais fácil para o primeiro teste e para um bot dedicado. WhatsApp é mais natural para a rotina de muitos brasileiros, mas exige atenção à sessão vinculada, allowlist e comportamento do canal. Ambos dependem do Gateway.

O app iOS funciona sem internet?

O app pode manter cache recente e enfileirar algumas mensagens conforme a implementação atual, mas precisa se reconectar ao Gateway para sincronizar e executar o trabalho. Não trate o modo offline como substituto de um servidor disponível.

É seguro liberar câmera e localização?

Pode ser seguro quando existe um caso de uso específico, conexão autenticada e controle de acesso. Não libere permissões “para testar tudo”. Ative uma capacidade por vez, observe logs, limite quem pode invocá-la e revogue o que não gera valor.

Posso usar modelo local no OpenClaw pelo iPhone?

Sim. O iPhone envia o pedido ao Gateway, e uma máquina com Ollama ou outro runtime local executa a inferência. O modelo não precisa estar no celular. O desempenho dependerá do hardware que hospeda o modelo.

Como usar OpenClaw pelo iMessage?

Você precisa de um Mac com iMessage configurado e disponível para operar o canal. O iPhone conversa pelo aplicativo Mensagens, enquanto a integração e o Gateway dependem da máquina macOS. É uma opção para usuários Apple, mas não é necessária para usar OpenClaw no iPhone.