O que você precisa
Um iPhone com registros no Apple Health, o app telo da App Store e uma instalação do OpenClaw com suporte a MCP. No telo, entre na conta e envie seu histórico; a primeira sincronização precisa terminar antes de o OpenClaw conseguir ler algo.
Os comandos abaixo seguem a documentação MCP do OpenClaw para servidores remotos Streamable HTTP com OAuth. Não significa que todas as versões do OpenClaw foram testadas com o telo.
Adicione o servidor MCP do Apple Health no OpenClaw
Pare o Gateway do OpenClaw antes: add e login se recusam a rodar enquanto um Gateway ocupa o diretório de estado. O primeiro comando grava o servidor em mcp.servers. O segundo abre uma página do telo no navegador, onde você informa o e-mail, digita o código de 6 dígitos e aprova o acesso.
Não coloque cabeçalho Authorization na configuração. Com auth em oauth, o OpenClaw ignora cabeçalhos fixos e guarda o token no próprio estado.
openclaw mcp add telo --url https://telo.health/mcp --transport streamable-http --auth oauth
openclaw mcp login teloOu instale a skill do telo pelo ClawHub
A skill telo-apple-health, publicada por @telo-inc, traz os mesmos passos de configuração e dois roteiros prontos: revisão semanal de saúde e tendências de longo prazo. Ela tem só instruções em Markdown, sem scripts, pacotes ou variáveis de ambiente.
A skill não conecta o servidor sozinha. Rode os comandos add e login acima uma vez.
clawhub install telo-apple-healthConfira se o OpenClaw lê o Apple Health
- Rode openclaw mcp doctor telo --probe e depois suba o Gateway de novo.
- Se openclaw mcp status --verbose mostrar authorization-required, rode openclaw mcp login telo de novo.
- Peça ao OpenClaw para usar o telo e listar as métricas disponíveis e as datas que elas cobrem.
- Confirme que a resposta vem de uma chamada de ferramenta do telo, com datas reais. Se ele descrever dados sem chamar ferramenta, está chutando.
Sincronização ou arquivo exportado?
A exportação local mantém os registros na sua máquina, e tem quem prefira assim. O custo é uma fotografia que envelhece desde o momento da exportação e um pacote que vale auditar antes de entregar seu histórico de saúde. O telo troca isso por uma cópia sincronizada guardada pelo serviço telo.
| Exportação do Apple Health com MCP local | MCP remoto do telo | |
|---|---|---|
| Como os registros chegam | Você exporta no iPhone e copia o arquivo para o computador | O app do iPhone sincroniza em segundo plano |
| Atualização | Tão antigo quanto a última exportação | Os dias recentes são reenviados a cada sincronização |
| O que roda no computador | Um processo de servidor MCP, geralmente um pacote npm | Nada; o OpenClaw chama https://telo.health/mcp |
| Login | Caminho do arquivo na configuração | OAuth, revogável com openclaw mcp logout telo |
| Onde ficam os dados | No seu computador | No telo, até você apagar a conta no app |
Uma primeira pergunta
Pedir a cobertura primeiro deixa as lacunas visíveis. Um dia sem registro é indisponível, não zero, e o telo devolve horários locais, que não devem ser convertidos para UTC.
Use o telo para conferir quais métricas do Apple Health estão disponíveis e quão recentes elas são. Depois compare meu sono e minha frequência cardíaca em repouso nos últimos 7 dias com os 7 dias anteriores, e liste as datas sem registro.Problemas comuns
Se add ou login se recusam a rodar, o Gateway ainda está de pé. Se o login termina mas as ferramentas falham com authorization-required, entre de novo; o token fica no estado do OpenClaw, não na configuração.
Se a conexão funciona mas faltam registros, confira a sincronização no app telo. Uma conexão MCP funcionando não prova que as permissões de leitura do HealthKit foram concedidas no iPhone.
Dúvidas práticas
O OpenClaw lê o Apple Health sozinho?
Não. O Apple Health fica no iPhone e não tem servidor MCP próprio. O OpenClaw precisa de uma fonte por MCP: um servidor local que lê um arquivo exportado, ou um servidor remoto como o telo, que recebe os dados do app do iPhone.
Preciso exportar o Apple Health para usar com o OpenClaw?
Com o telo, não. O app do iPhone sincroniza em segundo plano e o OpenClaw consulta https://telo.health/mcp. A exportação só é necessária nas opções que leem um arquivo local, e aí os dados ficam tão velhos quanto a última exportação.
A skill do ClawHub roda código no meu computador?
A skill telo-apple-health tem só instruções em Markdown, sem scripts, pacotes nem variáveis de ambiente. Quem responde as consultas é o servidor MCP remoto do telo, depois do login OAuth.
Como tiro o acesso do OpenClaw?
Rode openclaw mcp logout telo para apagar o token, ou openclaw mcp unset telo para remover o servidor. Para apagar a conta e todos os dados, use a aba Account do app telo.
Fontes e disponibilidade
Planos, regiões e telas podem mudar. Confira as fontes oficiais antes de configurar.
Como este guia foi preparado
Conteúdo preparado com auxílio de IA, com base na documentação oficial citada e no funcionamento do telo descrito no projeto. As telas e permissões podem variar por conta. Não realizamos nesta revisão um teste autenticado completo em cada assistente.