Publicar no Telegram a partir do OpenClaw

Hermoso é um servidor MCP de marketing: 922+ ferramentas em um endpoint único com OAuth, que permitem a um agente pesquisar os anúncios que já rodam em um mercado, gerar anúncios finalizados em imagem e vídeo, publicá-los e montar as campanhas pagas por trás deles. O OpenClaw acessa tudo isso por uma única conexão. Esta página cobre uma fatia disso: o que o OpenClaw consegue fazer de fato no Telegram, e o que o Telegram não deixa que ele faça.

Conectar o Hermoso ao OpenClaw

1. Instale e entre.

   npm install -g hermoso && hermoso auth login

   O seu navegador abre uma vez. Não há nada para criar nem para colar: a credencial fica guardada, só com acesso do dono, em ~/.hermoso/config.json. Em uma máquina sem navegador, hermoso auth login --token hmk_… usa uma chave de MCP & CLI → Terminal e chaves de API.
2. Adicione em ~/.openclaw/openclaw.json. Nenhuma chave vai no arquivo, porque hermoso mcp lê o login feito acima:

   { "mcp": { "servers": { "hermoso": { "command": "npx", "args": ["-y", "hermoso", "mcp"] } } } }

3. Peça algo ao seu agente. “Puxe os anúncios mais duradouros dos meus três concorrentes mais próximos e refaça o melhor gancho em um vídeo 9:16”, ou “poste este render no canal”. O agente escolhe as ferramentas; você aprova o gasto.

A Hermoso não tem nenhuma relação especial com o OpenClaw e não alega ter. O bloco acima é citado da própria referência de MCP do OpenClaw em docs.openclaw.ai/cli/mcp, lida em 2026-08-23; ele está documentado e não foi executado aqui, e por isso é o formato de arquivo publicado, e não um comando de instalação específico.

Depois conecte o próprio Telegram, uma vez, em Configurações → Conectores na Hermoso, colando um token de bot do @BotFather, e adicione esse bot ao seu canal como administrador. Não há tela de consentimento: o token é a credencial, e o bot é quem publica.

As ferramentas do Telegram que o OpenClaw recebe

• post_to_telegram: envia uma mensagem como o seu bot para o chat que você indicar: texto de até 4.096 caracteres, ou uma foto, um vídeo, ou um álbum de 2 a 10 com fotos e vídeos misturados.
• schedule_post: coloca na fila com o seu chatId, no mesmo calendário de todos os outros canais.
• list_telegram_chats: os chats que enviaram mensagem ao bot nas últimas 24 horas. Ajuda a encontrar um ID, e não é uma lista de todos os chats em que o bot está.
• edit_telegram_message / pin_telegram_message: corrige o texto ou a legenda de uma mensagem sem perder as visualizações, e fixa ou desafixa a chamada para ação.
• create_telegram_invite_link: um link de convite nomeado por campanha, com validade, limite de membros ou aprovação de entrada opcionais, para você ver quem entrou e por onde.
• telegram_account: a contagem de assinantes ou membros do chat, o título, a descrição e o link de convite.
• list_telegram_dms: o que as pessoas enviaram ao bot nas últimas 24 horas, da mais recente para a mais antiga, para responder com post_to_telegram.
• delete_telegram_message: remove uma mensagem que o bot enviou, dentro da janela de 48 horas do Telegram, depois de uma etapa de confirmação.

O Telegram conecta com um token de bot, e não com uma tela de login. Crie um bot com o @BotFather no Telegram, cole o token em Configurações → Conectores e depois adicione o bot ao seu canal como administrador com a permissão Publicar mensagens, ou a um grupo como membro que pode publicar. A Hermoso publica como esse bot, nunca como você. Dois limites são do próprio Telegram e vale planejar em torno deles: um bot não recebe visualizações por publicação nem histórico de publicações, então a contagem de assinantes e os links de convite nomeados são os números que você tem; e as mensagens enviadas ao bot são guardadas por 24 horas e depois somem. Publicar não consome créditos.

Limites do Telegram que vale conhecer antes de automatizar qualquer coisa

Experimente no OpenClaw

Peça em linguagem comum. São frases simples, não uma DSL:

“Duas vezes por dia: leia as mensagens enviadas ao nosso bot do Telegram, responda às perguntas simples e me passe a lista das demais.”

Isso percorre render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link. Quantas vezes uma execução pede a sua confirmação é uma configuração do OpenClaw, não nossa.

OpenClaw no Telegram: a parte que pega

Faça a leitura pelo menos uma vez por dia. O Telegram guarda atualizações não entregues por 24 horas e não tem método de histórico. Então list_telegram_dms é uma janela contínua, não uma caixa de entrada, e um resultado vazio significa que não há nada nas últimas 24 horas, não que não há mensagens. Um bot com webhook de saída configurado não vê nada por ele. E um bot não pode mandar mensagem primeiro; as pessoas precisam escrever para ele.

Em um loop autônomo longo, a CLI hermoso é o caminho barato em tokens, porque o agente chama o comando a cada vez, em vez de carregar um manifesto de mais de 922+ ferramentas em cada turno.

Pesquise o Telegram antes de publicar

Não existe biblioteca de anúncios do Telegram nem busca de canais na Hermoso, então ela não afirma fazer pesquisa de concorrentes no Telegram. Pesquise o criativo onde ele é público (as bibliotecas de anúncios da Meta, do Google e do LinkedIn, além do TikTok, Instagram, YouTube, Reddit e Threads orgânicos) e publique o anúncio pronto aqui.

A metade paga

Não há anúncios do Telegram na Hermoso, e não damos a entender que haja. Aqui o Telegram é um canal que você possui e administra pelo seu bot: publicar, fixar, editar, contar assinantes e acompanhar convites. As ferramentas pagas cobrem Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads e AppLovin Ads.

O que o OpenClaw não consegue fazer sozinho

Um agente com orçamento só é útil se o raio de impacto for limitado, então a cerca fica no servidor, e não em um prompt. Toda campanha, conjunto de anúncios, grupo de anúncios e anúncio é criado pausado, e as trocas de status que ativam dinheiro real se recusam a rodar sem uma flag de confirmação explícita. Cada render é cotado antes (hermoso_capabilities publica o custo exato em créditos de cada modelo antes de qualquer gasto). Os créditos são reservados antes da primeira chamada ao provedor e acertados pelo custo exato depois, então uma falha no envio devolve o valor em vez de deixar você cobrado por nada. As exclusões também exigem confirmação, e cada árvore de campanha é relida da plataforma de anúncios antes que o seu agente diga o que construiu.

Um passo fica propositalmente com você: criar o bot com o @BotFather e adicioná-lo ao seu canal. Tudo depois disso é uma chamada de ferramenta.

O resto da matriz

A partir do OpenClaw, publique em: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky. Ou veja tudo o que o OpenClaw pode publicar.

Publique no Telegram a partir de: Claude · ChatGPT · Claude Code · Cursor · Codex · Cline · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip

Perguntas frequentes

O OpenClaw consegue publicar no Telegram?

Sim, pelo servidor MCP da Hermoso. Rode npm install -g hermoso && hermoso auth login, depois adicione hermoso em mcp.servers em ~/.openclaw/openclaw.json, com command npx e args -y hermoso mcp. O login no navegador guarda a credencial, então nenhuma chave vai no arquivo. O OpenClaw passa a ter mais de 922+ ferramentas, incluindo as que publicam no Telegram e as que pesquisam os anúncios que já estão rodando no seu mercado e criam o criativo do zero.

Como conecto o Telegram ao OpenClaw?

Duas etapas, uma vez cada. Execute npm install -g hermoso && hermoso auth login e depois adicione o hermoso em mcp.servers em ~/.openclaw/openclaw.json, com o comando npx e os argumentos -y hermoso mcp. O login pelo navegador guarda a credencial, então nenhuma chave vai no arquivo. Depois crie um bot com o @BotFather no Telegram, cole o token em Configurações → Conectores no Hermoso e adicione o bot ao seu canal como administrador com a permissão Publicar mensagens. A partir daí, o OpenClaw publica no Telegram como uma chamada de ferramenta comum, indicando o chat a cada vez.

O OpenClaw precisa da minha senha do Telegram?

Não. O Telegram conecta por meio de um bot que você cria com o @BotFather, e a Hermoso guarda apenas o token desse bot. Assim, o OpenClaw publica como o bot, nunca como a sua conta pessoal do Telegram. O token pode ser revogado no @BotFather a qualquer momento, e nunca é entregue ao modelo.

O OpenClaw consegue agendar um post no Telegram para depois?

Sim. O schedule_post coloca o post na fila de uma agenda única compartilhada com todos os outros canais, com uma legenda por canal se o texto precisar ser diferente, e o list_scheduled e o cancel_scheduled leem e retiram o post. O Telegram é um dos onze canais que entram na fila.

O OpenClaw consegue publicar um carrossel no Telegram?

Sim, como um álbum de 2 a 10 itens, com fotos e vídeos misturados, que é a regra do próprio Telegram para sendMediaGroup. O álbum leva uma só legenda, no primeiro item. O OpenClaw chama a mesma ferramenta de publicação de qualquer forma, e um canal que não comporta carrossel é recusado com o motivo real indicado.

Quanto custa publicar no Telegram a partir do OpenClaw?

Publicar no Telegram não consome créditos; o Telegram não cobra nada por chamada. Os créditos são gastos na geração do criativo. Os planos são $29, $69 e $149 por mês, para 1.200, 3.000 e 7.000 créditos, e todos os recursos estão em todos os planos, incluindo o Grátis. A única exceção é o SSO empresarial.