FAQ Integrações

Tudo sobre conectar o OpenClaw com mensageiros, calendário e e-mail.

WhatsApp

Como Conecto o WhatsApp?

1. Configure o canal WhatsApp no config.yaml:

whatsapp:
  enabled: true

2. Inicie o gateway:

openclaw gateway start

3. Escaneie o QR code com seu WhatsApp

Preciso de WhatsApp Business?

Não! Funciona com WhatsApp pessoal normal. Usamos a biblioteca Baileys que simula o WhatsApp Web.

Posso Usar em Grupos?

Sim! Configure quais grupos responder:

whatsapp:
  groups:
    allowlist:
      - "Grupo Trabalho"
      - "Família"

Minha Conta Pode Ser Banida?

Risco baixo se usar responsavelmente:

• Evite spam/mensagens em massa
• Não envie para contatos que não te conhecem
• Use respostas naturais, não robóticas

Posso Enviar Imagens/Arquivos?

Sim! O agente pode enviar e receber:

• Imagens
• Documentos (PDF, DOC, etc.)
• Áudios
• Vídeos curtos

Veja mais: FAQ WhatsApp Completo

Telegram

Como Conecto o Telegram?

1. Crie um bot no @BotFather:

   • Envie /newbot
   • Escolha nome e username
   • Copie o token

2. Configure no config.yaml:

telegram:
  enabled: true
  token: "123456:ABC-DEF..."

3. Reinicie o gateway

Vantagens vs WhatsApp

Posso Usar Bot Existente?

Sim! Basta configurar o token do seu bot atual.

Funciona em Grupos/Canais?

Sim! Adicione o bot ao grupo e configure:

telegram:
  groups:
    enabled: true
    mention_only: true  # Só responde se mencionado

Discord

Como Conecto o Discord?

1. Crie um app no Discord Developer Portal
2. Vá em “Bot” → “Add Bot”
3. Copie o token
4. Configure:

discord:
  enabled: true
  token: "seu-token-aqui"

5. Convide o bot para seu servidor:
   • OAuth2 → URL Generator
   • Scopes: bot, applications.commands
   • Permissions: Read/Send Messages, etc.

Posso Usar em Múltiplos Servidores?

Sim! Um bot pode estar em vários servidores. Configure regras por servidor:

discord:
  servers:
    "123456789": # ID do servidor
      channels:
        - "bot-commands"
        - "general"

Funciona com Slash Commands?

Em desenvolvimento! Atualmente responde a mensagens normais. Slash commands planejados para versões futuras.

Posso Responder DMs?

Sim! Ativado por padrão. Para desativar:

discord:
  dm:
    enabled: false

Google Calendar

Como Conecto o Calendário?

1. Crie projeto no Google Cloud Console
2. Ative a Calendar API
3. Crie credenciais OAuth 2.0
4. Configure:

google:
  calendar:
    enabled: true
    credentials_file: "credentials.json"

5. Autorize na primeira execução

O Que o Agente Pode Fazer?

• ✅ Ver próximos eventos
• ✅ Criar novos eventos
• ✅ Atualizar eventos existentes
• ✅ Cancelar eventos
• ✅ Verificar disponibilidade
• ✅ Sugerir horários

Exemplos de Uso

"Quais são meus compromissos amanhã?"
"Agenda reunião com João para sexta às 15h"
"Remarque a reunião de ontem para próxima semana"
"Estou livre às 14h na terça?"

Funciona com Outlook/iCal?

Parcialmente. Suporte nativo apenas para Google Calendar. Para outros:

• Exporte/importe via .ics
• Use integrações de terceiros (Zapier, n8n)

E-mail

Como Conecto o E-mail?

Opção 1: IMAP/SMTP (Gmail, Outlook, etc.)

email:
  imap:
    host: "imap.gmail.com"
    port: 993
    user: "seu@gmail.com"
    password: "senha-de-app"
  smtp:
    host: "smtp.gmail.com"
    port: 587
    user: "seu@gmail.com"
    password: "senha-de-app"

Nota: Para Gmail, use Senhas de App, não sua senha normal.

Opção 2: API (Gmail API)

google:
  gmail:
    enabled: true
    credentials_file: "credentials.json"

O Que o Agente Pode Fazer?

• ✅ Ler e-mails não lidos
• ✅ Buscar e-mails por assunto/remetente
• ✅ Resumir e-mails longos
• ✅ Redigir rascunhos
• ✅ Enviar e-mails (com sua aprovação)
• ✅ Marcar como lido/importante
• ✅ Arquivar mensagens

Exemplos de Uso

"Tenho e-mails importantes não lidos?"
"Resuma os e-mails do João desta semana"
"Redigir resposta para o último e-mail do cliente"
"Envie e-mail para diego@email.com sobre a reunião"

É Seguro Dar Acesso ao E-mail?

Com ressalvas:

• Use conta separada para testes iniciais
• Configure human-in-the-loop para envios
• O agente não envia sem sua aprovação (padrão)
• Revise rascunhos antes de enviar

Outras Integrações

Slack

slack:
  enabled: true
  bot_token: "xoxb-..."
  app_token: "xapp-..."

Funciona similar ao Discord, com suporte a canais e DMs.

Notion

notion:
  enabled: true
  api_key: "secret_..."

Lê e escreve páginas, bancos de dados e blocos.

GitHub

github:
  enabled: true
  token: "ghp_..."

Cria issues, PRs, comenta, busca em repos.

APIs Customizadas

Qualquer API pode ser integrada via Skills:

// skills/minha-api/SKILL.md
// Define como usar sua API

Solução de Problemas

WhatsApp: QR Code Não Aparece

# Limpe sessão anterior
rm -rf ~/.openclaw/whatsapp/
openclaw gateway restart

Telegram: Bot Não Responde

1. Verifique se o token está correto
2. Confirme que o bot está ativo no BotFather
3. Verifique logs: openclaw logs

Calendar: Erro de Autorização

1. Delete token.json
2. Reautorize na próxima execução
3. Verifique escopos da API

E-mail: Falha de Login

Para Gmail:

1. Ative autenticação em 2 etapas
2. Gere senha de app
3. Use a senha de app, não a normal

Próximas Perguntas

• FAQ WhatsApp (detalhado)
• FAQ Configuração
• FAQ Técnico
• FAQ Privacidade