Combinar o OpenClaw com n8n para automatizações pessoais poderosas

Duas ferramentas complementares

O OpenClaw e o n8n resolvem problemas diferentes mas funcionam muito bem em conjunto. O OpenClaw oferece-lhe um agente de IA conversacional nas suas aplicações de mensagens — algo com que interage diretamente, que conhece o seu contexto e responde de forma inteligente. O n8n é uma plataforma de automatização de workflows (open source, auto-hospedável) que conecta aplicações, aciona ações e processa dados sem exigir código na maioria dos workflows.

Separadamente: o OpenClaw gere a conversação com IA. O n8n gere a automatização de sistema para sistema. Combinados: obtém automatizações impulsionadas por IA capazes de ler o seu e-mail, processar submissões de formulários, responder a webhooks e tomar ações inteligentes — tudo acionado automaticamente.

A arquitetura de integração

Existem duas formas de conectar o OpenClaw e o n8n:

1. O n8n chama a API do OpenClaw — O n8n aciona um pedido de inferência de IA através do OpenClaw quando determinados eventos ocorrem (novo e-mail, submissão de formulário, hora agendada). O OpenClaw processa a resposta de IA e o n8n usa o resultado nas etapas seguintes do workflow.
2. Os webhooks do OpenClaw acionam o n8n — Quando o seu agente recebe um comando ou mensagem específica, envia um webhook ao n8n, que executa um workflow (criar um evento de calendário, atualizar uma folha de cálculo, enviar um SMS).

Pode executar o n8n no mesmo VPS que o OpenClaw (precisa de aproximadamente 1 GB adicional de RAM) ou num servidor separado se preferir uma separação limpa.

Instalar o n8n no seu VPS

O n8n corre como uma aplicação Node.js. No seu VPS (assumindo que o Node.js 22 já está instalado pelo instalador do k-claw):

npm install -g n8n
n8n start

Para uso em produção, execute-o como um serviço systemd na porta 5678 com um proxy inverso (nginx) à frente. Ative o HTTPS com o Let's Encrypt para que webhooks de serviços externos (Gmail, GitHub, etc.) possam alcançá-lo de forma segura.

Workflow 1: digest de e-mail processado por IA

Este workflow corre todas as manhãs às 7h, obtém a sua caixa de entrada Gmail, envia os assuntos e remetentes à API do OpenClaw para priorização e entrega uma mensagem Telegram com o seu digest ordenado por IA.

Passos do workflow n8n:

1. Trigger Cron: 7:00 de segunda a sexta
2. Nó Gmail: obtém e-mails das últimas 12 horas
3. Nó HTTP Request: envia os dados do e-mail à API do OpenClaw (POST /api/agent/query)
4. Nó Telegram: envia o resumo formatado por IA ao seu chat

A resposta do OpenClaw à consulta contém o resumo priorizado, que o n8n extrai e encaminha para o Telegram.

Workflow 2: respondedor de IA para submissões de formulários

Para freelancers ou pequenas empresas, este workflow processa as submissões do formulário de contacto com IA antes de chegarem à sua caixa de entrada. Quando alguém preenche o formulário:

1. Trigger Webhook: recebe os dados do formulário
2. Chamada à API OpenClaw: "Dado este pedido, é um potencial cliente genuíno ou spam? Se genuíno, categorize e sugira uma resposta."
3. Nó IF: encaminha com base na classificação da IA
4. Potencial cliente genuíno: envia para o seu CRM + notifica via Telegram com resumo da IA e resposta sugerida
5. Spam: regista e descarta silenciosamente

Workflow 3: notas de reunião para itens de ação

Após uma reunião, cole ou carregue as suas notas para um comando específico do Telegram. O OpenClaw processa-as e envia um resumo estruturado ao n8n via webhook, que então:

• Cria tarefas na sua ferramenta de gestão de projetos (Todoist, Linear, Notion)
• Envia um e-mail de resumo a todos os participantes via Gmail
• Cria eventos de calendário para as datas de acompanhamento mencionadas nas notas

Referência de endpoints da API OpenClaw

Para os nós HTTP Request do n8n, o OpenClaw expõe uma API REST simples no seu servidor:

POST http://localhost:3001/api/agent/query
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json

{
  "message": "Summarize these emails and rank by urgency: ...",
  "context": "optional additional context",
  "stream": false
}

A resposta contém o texto gerado por IA que o n8n pode então encaminhar, transformar ou reenviar.

Considerações de segurança

Quando o n8n e o OpenClaw comunicam no mesmo servidor, use endereços localhost em vez de expor a API do OpenClaw publicamente. Se estiverem em servidores separados, use autenticação por token de API e restrinja a API do OpenClaw ao IP do seu servidor n8n através de regras de firewall UFW.

Nunca exponha a API do OpenClaw numa porta pública sem autenticação — ela fornece acesso direto ao seu agente de IA e à sua memória.

Como começar

O melhor primeiro projeto é o digest de e-mail — não requer código personalizado, entrega valor imediato e ensina o padrão de chamar o OpenClaw a partir de um nó HTTP do n8n. Quando isso funcionar, os outros workflows seguem naturalmente.

O curso avançado do k-claw cobre a integração com o n8n em detalhe, incluindo a configuração de autenticação e ficheiros JSON de workflows de exemplo que pode importar diretamente.