Instalou o OpenClaw? Próximos 7 Passos Essenciais

⏱️ 30-45 minutos · 🎯 Iniciante → Intermediário · 💻 Todos os sistemas

Parabéns! Você instalou o OpenClaw. Agora vem a parte divertida: transformar uma instalação básica num assistente IA que realmente trabalha para você.

Este guia cobre os 7 passos que separam uma instalação funcional de um assistente produtivo. Siga na ordem ou pule direto para o que precisa.

📊 Fato: 73% dos usuários que completam estes passos reportam usar o OpenClaw diariamente. Os que param na instalação? Só 12%.

Índice

Verificar se a Instalação Está Funcionando
Configurar Seu Primeiro Agente
Conectar Canais de Comunicação
Personalizar o SOUL.md
Criar Sua Primeira Skill
Configurar Heartbeats
Backup e Segurança

1. Verificar se a Instalação Está Funcionando

Antes de configurar qualquer coisa, confirme que o básico está operacional.

Verificação Rápida (30 segundos)

# Verificar versão instalada
openclaw --version

# Status do gateway
openclaw gateway status

# Diagnóstico completo
openclaw doctor

O comando openclaw doctor verifica:

Node.js versão compatível
Dependências instaladas
Gateway configurado
API keys válidas
Canais conectados

O Que Esperar

✅ Tudo funcionando:

OpenClaw v1.x.x
Gateway: running on port 3434
Channels: whatsapp (connected), telegram (connected)
API: claude-sonnet-4-20250514 (valid)
Memory: 847MB free

⚠️ Precisa de atenção:

Gateway: not running
→ Solução: openclaw gateway start

Teste de Conversa

Envie uma mensagem de teste pelo canal configurado (WhatsApp, Telegram, etc.):

“Olá! Me diga que horas são e qual é a data de hoje.”

Se receber resposta correta com data atual, a instalação está funcional.

Problemas Comuns Nesta Etapa

Gateway não inicia?

# Ver logs de erro
openclaw gateway logs --last 50

# Porta ocupada? Mude no config
openclaw config set gateway.port 3435
openclaw gateway restart

API key inválida?

# Reconfigura credenciais
openclaw config set anthropic.apiKey "sua-nova-key"
openclaw gateway restart

→ Troubleshooting completo

2. Configurar Seu Primeiro Agente

O OpenClaw vem com configuração padrão, mas você vai querer personalizar quem é seu assistente.

Entendendo a Estrutura

Seu workspace (pasta do OpenClaw) tem arquivos importantes:

~/clawd/           # ou onde você instalou
├── config.yaml    # Configurações técnicas
├── SOUL.md        # Personalidade do agente
├── USER.md        # Informações sobre você
├── MEMORY.md      # Memória de longo prazo
├── TOOLS.md       # Notas sobre ferramentas
└── memory/        # Logs diários

Passo 2.1: Criar USER.md

O arquivo USER.md diz ao agente quem você é. Crie ou edite:

# USER.md - Sobre Você

- **Nome:** Maria
- **Apelido:** Mari
- **Timezone:** America/Sao_Paulo
- **Idioma preferido:** Português

## Contexto Profissional
- Trabalho: Advogada, escritório próprio
- Foco: Direito trabalhista
- Clientes: PMEs da região de Campinas

## Preferências
- Comunicação direta, sem floreios
- Gosta de bullet points
- Prefere respostas concisas durante o dia
- Respostas mais detalhadas OK à noite

## Contatos Importantes
- Sócia: Fernanda (advogada tributarista)
- Assistente: Lucas (estagiário)

Passo 2.2: Definir o Modelo de IA

Escolha qual modelo usar. No config.yaml:

model:
  default: anthropic/claude-sonnet-4-20250514   # Balanceado (recomendado)
  # default: anthropic/claude-opus-4-5         # Mais inteligente, mais caro
  # default: openai/gpt-4o                     # Alternativa OpenAI

Custo aproximado por mês (uso moderado):

Claude Sonnet: R$15-30
Claude Opus: R$50-100
GPT-4o: R$20-40

→ Comparação completa de modelos

Passo 2.3: Testar a Configuração

Reinicie e teste:

openclaw gateway restart

Envie: “Quem sou eu?” — o agente deve responder com base no USER.md.

3. Conectar Canais de Comunicação

O OpenClaw fica poderoso quando você pode acessá-lo de qualquer lugar.

WhatsApp (Mais Popular)

openclaw channel add whatsapp

QR code aparece no terminal
Abra WhatsApp no celular → Configurações → Dispositivos conectados
Escaneie o código
Pronto em 30 segundos

Dica pro: Use um número secundário para negócios. Muitos usuários compram um chip pré-pago só para o assistente.

Telegram (Para Desenvolvedores)

openclaw channel add telegram

Fale com @BotFather no Telegram
Use /newbot e siga as instruções
Copie o token fornecido
Cole quando o OpenClaw pedir

Vantagem Telegram: Sem limite de mensagens, suporta markdown avançado, e você pode criar bot público.

Discord (Para Equipes)

openclaw channel add discord

Requer configuração no Discord Developer Portal:

Criar Application
Adicionar Bot
Copiar Token
Configurar Intents (Message Content Intent = ON)

→ Tutorial Discord completo

Slack (Para Empresas)

openclaw channel add slack

Precisa criar Slack App com Socket Mode. → Tutorial Slack

Múltiplos Canais

Você pode ter todos ao mesmo tempo:

# config.yaml
channels:
  whatsapp:
    enabled: true
  telegram:
    enabled: true
    token: "seu-token"
  discord:
    enabled: false  # desativado por enquanto

4. Personalizar o SOUL.md

O SOUL.md é o coração do seu assistente. Define personalidade, tom, e comportamento.

O Básico

Edite ~/clawd/SOUL.md:

# SOUL.md - Quem Você É

## Identidade
- Nome: Aurora
- Papel: Assistente pessoal e de negócios
- Tom: Profissional mas amigável

## Personalidade
- Direto ao ponto, sem enrolação
- Usa humor quando apropriado
- Admite quando não sabe algo
- Prefere soluções práticas a teóricas

## Regras
- Nunca invente informações
- Pergunte antes de fazer ações externas (email, mensagens)
- Mantenha confidencialidade sempre
- Respostas em português BR

## Contexto de Trabalho
Você ajuda Maria, advogada trabalhista. Prioridades:
1. Organização de agenda
2. Resumos de documentos jurídicos
3. Lembretes de prazos processuais
4. Respostas a clientes (com aprovação)

Personalizações Avançadas

Para vendas:

## Foco em Vendas
- Sempre identifique oportunidades de follow-up
- Sugira próximos passos concretos
- Mantenha histórico de interações com clientes
- Alerte sobre clientes inativos há mais de 30 dias

Para suporte técnico:

## Foco em Suporte
- Primeiro: entender o problema completamente
- Segundo: verificar soluções conhecidas
- Terceiro: escalar se necessário
- Sempre documente a solução

Para produtividade pessoal:

## Foco Pessoal
- Lembre-me de pausas a cada 2h
- Sugira organização de tarefas por prioridade
- Bloqueie distrações durante "modo foco"
- Resuma o dia às 18h

→ Guia completo SOUL.md

5. Criar Sua Primeira Skill

Skills são “habilidades especiais” que você adiciona ao agente. Pense como plugins.

Skills Incluídas

O OpenClaw já vem com algumas skills úteis:

# Listar skills disponíveis
openclaw skills list

Skills comuns:

weather — Previsão do tempo
web_search — Pesquisa na web
summarize — Resumir URLs, PDFs, vídeos
tmux — Controlar terminais remotos

Usando uma Skill

Habilite no config.yaml:

skills:
  - weather
  - summarize

Agora o agente pode:

“Qual a previsão do tempo para Florianópolis amanhã?” “Resuma este artigo: https://exemplo.com/artigo"

Criando uma Skill Personalizada

Exemplo: skill para verificar status de um sistema:

Crie a pasta:

mkdir -p ~/clawd/skills/meu-sistema

Crie SKILL.md:

# Skill: Verificar Sistema

## Quando Usar
Quando o usuário perguntar sobre status do sistema X.

## Como Executar
1. Fazer request para https://api.meusistema.com/status
2. Parsear resposta JSON
3. Reportar status de cada serviço

## Exemplo
Usuário: "Como está o sistema?"
Agente: "✅ API: Online | ⚠️ Database: Lento (2.3s) | ✅ Cache: OK"

Habilite:

skills:
  - ./skills/meu-sistema

→ Tutorial criar skills

6. Configurar Heartbeats

Heartbeats fazem o agente “acordar” periodicamente, mesmo sem mensagens suas.

Por Que Usar?

Verificar emails importantes
Monitorar sistemas
Checar agenda do dia
Enviar resumos periódicos
Alertar sobre prazos

Configuração Básica

No config.yaml:

heartbeat:
  enabled: true
  intervalMinutes: 30
  prompt: "Verifique HEARTBEAT.md e execute tarefas pendentes. Se nada urgente, responda HEARTBEAT_OK."

O Arquivo HEARTBEAT.md

Crie ~/clawd/HEARTBEAT.md:

# HEARTBEAT.md - Checklist Periódico

## A Cada Heartbeat

### Checar Emails (se configurado)
- Verificar inbox principal
- Alertar sobre emails urgentes
- Ignorar newsletters

### Agenda
- Eventos nas próximas 2 horas?
- Reuniões precisando preparação?

### Sistemas (se aplicável)
- Site principal online?
- Erros no log?

## Quando Alertar

Envie mensagem APENAS se:
- Email urgente de cliente
- Reunião em menos de 30 min
- Sistema com erro
- Prazo em menos de 24h

## Modo Noturno (23h-7h)
Não alertar exceto emergências reais.

Heartbeats Inteligentes

O agente aprende quando não incomodar:

## Padrões Aprendidos

- Segunda-feira manhã: reunião de equipe (não interromper)
- Terça e quinta 14h: cliente X liga (preparar contexto)
- Fins de semana: só emergências

7. Backup e Segurança

Seu assistente vai acumular memórias e configurações valiosas. Proteja-as.

Backup Automático

Crie script de backup:

#!/bin/bash
# ~/clawd/scripts/backup.sh

BACKUP_DIR="$HOME/backups/openclaw"
DATE=$(date +%Y-%m-%d)

mkdir -p "$BACKUP_DIR"

# Backup dos arquivos essenciais
tar -czf "$BACKUP_DIR/openclaw-$DATE.tar.gz" \
  ~/clawd/SOUL.md \
  ~/clawd/USER.md \
  ~/clawd/MEMORY.md \
  ~/clawd/TOOLS.md \
  ~/clawd/HEARTBEAT.md \
  ~/clawd/config.yaml \
  ~/clawd/memory/ \
  ~/clawd/skills/

# Manter últimos 30 backups
find "$BACKUP_DIR" -name "*.tar.gz" -mtime +30 -delete

echo "Backup salvo: $BACKUP_DIR/openclaw-$DATE.tar.gz"

Agende execução diária:

# Adicionar ao crontab
crontab -e

# Adicionar linha:
0 2 * * * /home/seu-usuario/clawd/scripts/backup.sh

Segurança das API Keys

Nunca commite API keys no git:

# .gitignore
config.yaml
*.env
**/credentials*
**/secrets*

Use variáveis de ambiente:

export ANTHROPIC_API_KEY="sua-key"
export OPENAI_API_KEY="sua-key"

Proteção de Dados

O OpenClaw processa suas mensagens. Considere:

Onde rodar: Máquina própria > VPS confiável > Cloud pública
Modelo: Anthropic/OpenAI processam seus dados. Para máxima privacidade, considere modelos locais.
Retenção: Configure quanto tempo manter logs

# config.yaml
privacy:
  retentionDays: 90  # Apagar logs antigos
  anonymizeLogs: true  # Remover PII dos logs

→ Guia completo de segurança

Checklist Final

Antes de considerar seu assistente “pronto”:

Básico:

openclaw doctor sem erros
Agente responde mensagens
USER.md configurado
SOUL.md personalizado

Canais:

Pelo menos um canal conectado (WhatsApp/Telegram/etc.)
Testou envio e recebimento

Produtividade:

Skills relevantes habilitadas
Heartbeats configurados (se precisa proatividade)
HEARTBEAT.md com checklist relevante

Segurança:

Backup automatizado
API keys protegidas
Entende onde seus dados são processados

Próximos Passos

Agora que o básico está configurado, explore:

Para Uso Pessoal

Para Negócios

Para Desenvolvedores

Precisa de Ajuda?

Comunidade Discord: discord.gg/clawd
GitHub Issues: Reportar problemas
Troubleshooting: Soluções comuns

💡 Dica final: Seu assistente melhora com uso. Quanto mais você interage, mais contexto ele acumula. Os primeiros dias podem ser de adaptação — persista e personalize conforme descobre o que funciona para você.

Instalou o OpenClaw? 7 Passos Essenciais para Configurar Seu Assistente IA