Guia do ConectaClaw

Os três nomes que aparecem o tempo todo

• Instância: o seu servidor dedicado. O painel mostra o status (Online, Sincronizando ou Offline), o plano, a configuração da máquina e há quanto tempo está no ar.
• Claw (ou assistente): o agente que conversa e executa tarefas. Cada Claw tem nome, personalidade, memória e habilidades próprias. Toda conta começa com um Claw principal.
• Pontos ConectaClaw: a moeda de consumo de IA quando você usa a inteligência gerenciada por nós. Cada pergunta e cada resposta consomem pontos. Se você prefere usar a sua própria chave de API, não gasta pontos.

Do pagamento ao primeiro uso

1. 1Escolha um plano na página de planos e conclua o pagamento. A criação do servidor começa automaticamente logo depois.
2. 2Aguarde na tela de configuração inicial. Ela acompanha o provisionamento em tempo real; no OpenClaw costuma levar alguns minutos, e no Hermes Agent a instalação do zero leva de 9 a 15 minutos.
3. 3Passo 1 da configuração: escolha por qual canal você quer falar com o assistente (WhatsApp, Telegram, Discord, Slack ou o app OpenClaw).
4. 4Passo 2: escolha como a inteligência vai funcionar — pontos ConectaClaw, sua própria chave de API ou sua conta OpenAI.
5. 5Passo 3: conecte o canal escolhido seguindo as instruções da tela.
6. 6Passo 4: com o canal conectado, clique em “Ir para o painel”. A partir daí tudo acontece em /dashboard.

O que só existe no OpenClaw

• Reuniões com resumo automático.
• App nativo do OpenClaw pareado por QR code.
• Pendências, auditoria detalhada de tarefas e fluxos avançados de automação.
• Gatilhos (hooks) no formato do painel.

O que o Hermes Agent traz de diferente

• Loop de aprendizado: ele cria e melhora habilidades sozinho a partir do que você pede.
• Profiles isolados para memória, sessões e skills — os canais continuam da instância inteira.
• Memória persistente com perfil de quem conversa.
• Automações agendadas, integrações MCP e apps conectados (Gmail, Drive, Notion e afins).
• Entende os áudios que chegam pelos canais e responde falando, sem custo extra: a transcrição roda na sua própria instância e a voz padrão é gratuita.
• Dashboard web nativo do Hermes para conversar e administrar o agente, além do painel ConectaClaw.

O que o Hermes Agent não faz (em relação ao OpenClaw)

• O Chat Conecta usa a API oficial do Hermes; aprovações de ferramentas sempre exigem sua escolha e anexos ficam desativados neste chat.
• Login pela assinatura do ChatGPT usa o código de dispositivo oficial do Hermes; a credencial fica somente na sua VPS.
• Profiles isolam memória, sessões e skills. Os canais continuam no nível da instância e não são roteados por Profile.
• Sem Gatilhos (hooks) no painel — o que o Hermes chama de hooks é outro recurso, de linha de comando.
• Imagem e voz não entram nos pontos ConectaClaw: os pontos cobrem o texto (conversas, automações e ferramentas). A voz sai de graça e a imagem precisa de uma chave sua da FAL (fal.ai) — quem quiser voz premium também usa chave própria (ElevenLabs, OpenAI, MiniMax, Gemini ou xAI).

Como escolher e como conferir depois

1. 1Na página de planos, clique em Começar. Se os dois motores estiverem no checkout, o seletor “Motor do agente” aparece; senão a instância nasce no OpenClaw.
2. 2Leia os destaques e as limitações do motor escolhido antes de pagar: a lista é a mesma que usamos internamente para ligar e desligar recursos.
3. 3Conclua o pagamento. A instância é criada já com o motor escolhido.
4. 4No painel, o motor ativo aparece na barra superior e em Plano & cobrança (/dashboard/assinatura), com link para a documentação oficial dele.
5. 5No Hermes, converse direto na aba Conversar (/dashboard/chat); se preferir, ela também mostra o link do painel web nativo do motor.

WhatsApp — 1. Vincular o aparelho (QR)

1. 1Em Canais, clique em Conectar no cartão do WhatsApp.
2. 2Escolha o modo: “Número dedicado” (recomendado — um chip só para o assistente) ou “Meu número pessoal” (você conversa consigo mesmo e a IA responde).
3. 3Informe o número com código do país. No modo pessoal ele é obrigatório; no modo dedicado é recomendado, porque o seu número entra na allowlist.
4. 4Salve. O painel mostra o QR de Dispositivos conectados — o mesmo fluxo do WhatsApp Web. Isso só liga a conta ao assistente.
5. 5No celular, abra o WhatsApp do número que vai atender, vá em Aparelhos conectados e escaneie o QR. O código expira em cerca de 30 segundos e é gerado outro sozinho.
6. 6Quando o cartão virar “Conectado”, o aparelho está vinculado. Mandar mensagem ainda pode exigir o passo 2 (pairing), se o número não estiver na allowlist.

Telegram

1. 1No Telegram, procure por @BotFather.
2. 2Envie /newbot e escolha o nome e o nome de usuário do seu bot.
3. 3Copie o token completo que o BotFather devolve.
4. 4No painel, em Canais, clique em Conectar no cartão do Telegram e cole o token. Salve.
5. 5Abra a conversa com o seu bot e envie /start. No OpenClaw é normal ele responder “access not configured” no primeiro contato. No Hermes Agent o bot manda um código de pairing de 8 caracteres, se o DM pairing estiver ligado.
6. 6Volte ao painel: o pedido de acesso aparece com um código. Clique em Aprovar (ou cole o código manualmente) e mande uma nova mensagem para confirmar.

Discord

1. 1Crie uma application no Discord Developer Portal e adicione um bot a ela.
2. 2Em Privileged Gateway Intents, ative Message Content Intent e Server Members Intent.
3. 3Convide o bot para o seu servidor com os escopos bot e applications.commands e as permissões View Channels, Send Messages, Read Message History, Embed Links e Attach Files.
4. 4No Discord, ative o Developer Mode (User Settings → Advanced) e copie o ID do servidor clicando com o botão direito nele.
5. 5No painel, em Canais, clique em Conectar no cartão do Discord, cole o bot token e o Server ID e salve. O motor reinicia para ativar o Gateway.
6. 6Mande uma mensagem direta (DM) para o bot. No OpenClaw, aprove o código de pairing que aparece no painel. No Hermes Agent, aguarde o runtime reiniciar e fale com o bot; se ele mandar um código de pairing, aprove no mesmo painel.

Slack

1. 1Crie um app em api.slack.com/apps.
2. 2Em Bot Token Scopes, adicione chat:write, im:history, im:read e im:write.
3. 3Instale o app no workspace e copie o Bot User OAuth Token (começa com xoxb-).
4. 4Opcional, mas recomendado: gere um App-Level Token (xapp-) com a permissão connections:write para usar o Socket Mode.
5. 5No painel, em Canais, clique em Conectar no cartão do Slack, cole o bot token (e o app token, se tiver) e salve.
6. 6Mande uma DM para o bot. No OpenClaw, aprove o código de pairing no painel. No Hermes Agent, aguarde o restart e fale no workspace; se aparecer um código de pairing, aprove em Canais.

App OpenClaw (celular)

1. 1Baixe o app oficial OpenClaw na App Store ou no Google Play — os dois links estão no painel, em Canais, no bloco “App nativo OpenClaw”.
2. 2No painel, clique em “Gerar QR do app”. Aparecem um QR code e um setup code (que dá para copiar).
3. 3No app, vá em Onboarding → Scan QR e escaneie o código.
4. 4O pedido do aparelho aparece no painel, na lista de aparelhos. Clique em Aprovar.
5. 5Pronto: o aparelho passa a constar como pareado. Se quiser conectar outro celular, gere um novo QR.

Sua primeira conversa

1. 1Abra Conversar no menu inferior.
2. 2Se não souber por onde começar, clique em uma das sugestões que aparecem na tela vazia — elas já mandam um pedido pronto.
3. 3Ou escreva na caixa de mensagem e envie. No OpenClaw você também pode anexar arquivos e imagens. No Hermes Agent os anexos ficam desativados neste chat — use um canal ou o painel nativo do Hermes para arquivos.
4. 4Enquanto o assistente responde, o botão de parar fica disponível caso você queira interromper.

Conversas e histórico

• O seletor no topo lista as suas conversas do painel. “Chat do painel” é a conversa padrão; as demais aparecem como “Conversa HH:MM”.
• O botão “Nova” (ou o ícone +) abre uma conversa em branco, sem o contexto da anterior. Útil para separar assuntos.
• O ícone de atualizar recarrega o histórico da conversa aberta.
• “Limpar conversa” apaga o que está na tela do seu navegador; o histórico no servidor não é apagado por esse botão.
• Cada Claw tem as suas próprias conversas. Ao trocar de assistente no seletor do topo do painel, a lista muda junto.

As categorias que aparecem

• Memória durável: fatos e preferências que o agente sempre lembra. É o índice principal.
• Notas diárias: registros do dia a dia, organizados por data.
• Sonhos: consolidação que o próprio agente faz durante a madrugada.
• Wiki de conhecimento: um espaço navegável que o agente compila e que você também pode editar.
• Outros: demais arquivos do espaço de trabalho do assistente.

Adicionar uma anotação

1. 1Abra Memória no menu inferior.
2. 2Clique em “Nova nota”.
3. 3Dê um nome à nota (ex.: Política de reembolso) e escolha entre “Wiki de conhecimento” e “Nota avulsa”.
4. 4Clique em Criar: a nota é criada e abre na tela.
5. 5Use o botão de editar, escreva o conteúdo e salve.

Revisar e corrigir

1. 1Clique em um arquivo da lista para ler o conteúdo já formatado.
2. 2Use o botão de editar para alterar o texto e salvar.
3. 3Use “Buscar na memória” para procurar por um trecho — a partir de duas letras ela mostra as linhas que casaram.
4. 4Se alguma anotação estiver errada, apague o arquivo pelo botão de excluir. O índice de memória durável é protegido e não pode ser excluído.

Instalar uma skill

1. 1Abra Habilidades no menu inferior.
2. 2Use a busca ou os filtros por categoria para achar o que precisa. O filtro “Instaladas” mostra só o que já está no seu servidor.
3. 3Clique no cartão para ver a descrição, os arquivos, as versões e o resultado da verificação de segurança.
4. 4Clique em Instalar. A instalação leva alguns segundos e reinicia o motor para ativar a habilidade.
5. 5Quando terminar, o cartão passa a exibir a etiqueta “Instalada”.

Manutenção

• “Atualizar instaladas” busca novas versões de tudo que já está instalado. Pode levar alguns minutos.
• Para remover, abra a skill instalada e clique em Desinstalar; o painel pede confirmação antes.
• Se o painel avisar que o motor não voltou a rodar depois de instalar, confira a tela Status antes de continuar usando.

Criar a primeira automação

1. 1Abra Automações no menu inferior.
2. 2Em “Nova automação”, dê um nome (por exemplo: “Resumo diário”).
3. 3Escreva em linguagem natural o que o assistente deve fazer (por exemplo: “resuma meus e-mails de hoje em tópicos curtos”).
4. 4Escolha a entrega: Canal (o assistente manda a resposta por um canal conectado) ou Sem entrega (a tarefa roda e o resultado fica só no histórico).
5. 5Se escolher Canal, selecione qual canal e preencha o destino. Sem destino a automação é criada, mas nunca chega a ninguém.
6. 6Escolha quando rodar: Cron (expressão como 0 8 * * * para todo dia às 8h), Intervalo (30m, 1h, 1d) ou Uma vez (data e hora).
7. 7Clique em Criar. Ela aparece na lista abaixo com a etiqueta “Ativa”.

Saber se entregou

1. 1Na lista, clique no ícone de histórico da automação.
2. 2As últimas execuções aparecem com hora e resultado. Bolinha verde é execução concluída; vermelha traz a mensagem de erro.
3. 3Se ainda não houver nenhuma execução, use “Rodar agora” (ícone de play) para testar sem esperar o horário.

Outros controles da lista

• O botão de energia pausa e reativa a automação; pausada, ela fica com a etiqueta “Pausada”.
• O lápis abre a automação para edição. Se você não mexer no agendamento, o horário original é preservado.
• A lixeira exclui a automação (com confirmação, porque não dá para desfazer).
• Entrega por Webhook e memória persistente entre execuções só ficam disponíveis em versões mais novas do OpenClaw; quando a sua instância ainda não tem esse suporte, o painel avisa na própria tela.

Apps conectados (Gmail, Drive, Notion e outros)

1. 1Abra Apps conectados (/dashboard/conexoes).
2. 2Procure o aplicativo pela busca ou pelos filtros de categoria.
3. 3Clique em conectar: você é levado à tela de autorização do próprio serviço.
4. 4Autorize e volte para o painel — o app aparece marcado como conectado.
5. 5Para remover o acesso, use o botão de desconectar no cartão do app.

Integrações personalizadas (MCP)

1. 1Abra Integrações (/dashboard/mcp). Esta tela é para usuários avançados.
2. 2Clique em “Novo MCP” e dê um nome ao servidor.
3. 3Informe a URL do servidor MCP (precisa ser HTTPS) e escolha o transporte: Streamable HTTP ou SSE.
4. 4Se o servidor exigir autenticação, preencha o token ou os cabeçalhos. Valores sensíveis aparecem redigidos depois de salvos.
5. 5Clique em “Salvar” e depois em “Testar” para confirmar que o servidor responde.
6. 6Se precisar, use Reload para o motor recarregar a configuração e enxergar as novas ferramentas.

Os três modos

• Pontos ConectaClaw: nós cuidamos do acesso aos modelos e você paga em pontos, que aparecem com saldo e consumo na própria tela.
• Chave de API: você traz a sua chave de um provedor (o painel lista os provedores suportados e ajuda a escolher o modelo). O consumo é cobrado direto pelo provedor, não em pontos.
• OpenAI: você conecta a sua conta ou chave da OpenAI e escolhe entre os modelos disponíveis nessa opção.

Trocar de modelo

1. 1Abra Inteligência no menu inferior.
2. 2No bloco “Modelos em uso” você vê o modelo de Texto, o de Imagem e o de Voz.
3. 3Clique em Trocar (ou no modo desejado, no seletor do topo) para abrir a janela de configuração.
4. 4Escolha o modelo. No modo de pontos, o painel mostra uma estimativa de quantos pontos aquele modelo consome.
5. 5Salve. O motor reinicia para aplicar a mudança — leva de dez a trinta segundos, e o chat volta sozinho.

Criar um novo Claw

1. 1Abra Assistentes no menu inferior.
2. 2Clique em “Criar nova Claw”.
3. 3Dê um nome (ex.: Lia) e, se quiser, uma função (ex.: Vendas) e um emoji para identificá-la.
4. 4Modelo é opcional: deixando em branco, o Claw herda o modelo padrão da conta.
5. 5Escreva as instruções de comportamento: como ela deve responder, o tom de voz e o que faz.
6. 6Se quiser, restrinja os canais em que ela atende e as skills que ela usa.
7. 7Salve. O novo Claw aparece na lista e no seletor do topo do painel.

Detalhes importantes

• A quantidade de Claws depende do seu plano. Ao atingir o limite, o painel mostra um cartão bloqueado com a opção de upgrade.
• Um dos Claws é o principal e não pode ser arquivado.
• Arquivar um Claw faz ele parar de responder, mas mantém configuração e histórico. Restaurar respeita o limite do plano.
• O consumo de pontos por assistente aparece no cartão de cada Claw.

Assinatura

• O cartão do topo mostra o plano ativo, o valor e a configuração do servidor.
• “Abrir portal de cobrança” leva ao portal seguro da Stripe, onde você atualiza o cartão, vê o histórico de faturas e resolve pendências.
• “Fazer upgrade” muda para um plano maior. O servidor é redimensionado e fica indisponível por cerca de dois minutos.

Comprar mais pontos

1. 1Abra Inteligência no menu inferior (com o modo de pontos ativo).
2. 2Confira o saldo e o consumo do ciclo no cartão “Seus pontos”.
3. 3Clique em “Recarregar pontos”.
4. 4Escolha um pacote — o painel mostra o preço e o custo por mil pontos.
5. 5Conclua o pagamento na Stripe. Os pontos entram na conta automaticamente.

Cancelar o plano

1. 1Abra Plano & cobrança.
2. 2Clique em “Cancelar plano”, no rodapé do cartão do plano.
3. 3Leia o aviso: ao cancelar, a instância é desligada e o servidor é apagado. Um snapshot operacional fica guardado por até 30 dias para eventual restauração.
4. 4Digite CANCELAR no campo de confirmação e clique em “Confirmar cancelamento”.
5. 5O cancelamento vale para o fim do período já pago — até lá o assistente continua no ar.

O assistente está offline

1. 1Abra Status (/dashboard/saude) e confira o indicador do motor.
2. 2Clique em “Corrigir problemas”: essa ação executa a rotina automática de recuperação do ConectaClaw.
3. 3Se continuar parado, use “Reiniciar assistente”. Ele fica fora do ar por poucos segundos.
4. 4Se mesmo assim não voltar, abra “Diagnóstico” e depois acione o suporte pelo chat de ajuda do painel.

Um canal aparece desconectado

1. 1Abra Canais e veja o estado do cartão.
2. 2“Quase pronto” significa que as credenciais foram salvas mas o acesso não foi liberado: procure o pedido de pairing na mesma tela e aprove.
3. 3No WhatsApp, “Continuar conexão” gera um novo QR — o anterior expira em cerca de 30 segundos.
4. 4No Telegram, Discord e Slack, confira se o token continua válido; se você o regenerou na plataforma de origem, salve o novo token.
5. 5Se o cartão continuar instável, desconecte o canal e refaça a conexão do zero.

Acabaram os pontos

1. 1No chat, a mensagem falha com o aviso de saldo insuficiente e aparece o botão “Recarregar pontos”.
2. 2Você também pode ir direto a Inteligência e clicar em “Recarregar pontos”.
3. 3Escolha um pacote e conclua o pagamento; o saldo é creditado automaticamente.
4. 4Se preferir não usar pontos, troque o modo para “Chave de API” e informe a chave do seu provedor.

A automação não entregou

• Abra o histórico da automação em Automações e veja o erro da última execução.
• Confira se a entrega está configurada com canal e destino. Sem destino, a tarefa roda mas não envia nada.
• Confirme que o canal escolhido continua conectado em Canais.
• Use “Rodar agora” para testar a correção sem esperar o próximo horário.