---
title: "Instalou o OpenClaw? 7 Passos Essenciais para Configurar Seu Assistente IA"
url: "https://openclaw.ia.br/guias/pos-instalacao/"
markdown_url: "https://openclaw.ia.br/guias/pos-instalacao.MD"
description: "Guia completo pós-instalação: verificar funcionamento, configurar agente, conectar WhatsApp/Telegram, personalizar SOUL.md, criar skills, heartbeats e backup. Transforme seu OpenClaw num assistente poderoso."
date: "2026-02-01"
author: ""
---

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

Guia completo pós-instalação: verificar funcionamento, configurar agente, conectar WhatsApp/Telegram, personalizar SOUL.md, criar skills, heartbeats e backup. Transforme seu OpenClaw num assistente poderoso.


# Instalou o OpenClaw? Próximos 7 Passos Essenciais

<div class="badges">
⏱ <strong>30-45 minutos</strong> ·  <strong>Iniciante → Intermediário</strong> ·  <strong>Todos os sistemas</strong>
</div>

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

1. [Verificar se a Instalação Está Funcionando](#1-verificar-se-a-instalacao-esta-funcionando)
2. [Configurar Seu Primeiro Agente](#2-configurar-seu-primeiro-agente)
3. [Conectar Canais de Comunicação](#3-conectar-canais-de-comunicacao)
4. [Personalizar o SOUL.md](#4-personalizar-o-soulmd)
5. [Criar Sua Primeira Skill](#5-criar-sua-primeira-skill)
6. [Configurar Heartbeats](#6-configurar-heartbeats)
7. [Backup e Segurança](#7-backup-e-seguranca)

---

## 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)

```bash
# 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?**
```bash
# 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?**
```bash
# Reconfigura credenciais
openclaw config set anthropic.apiKey "sua-nova-key"
openclaw gateway restart
```

[→ Troubleshooting completo](/troubleshooting/)

---

## 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:

```markdown
# 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`:

```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](/guias/modelos/)

### Passo 2.3: Testar a Configuração

Reinicie e teste:

```bash
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)

```bash
openclaw channel add whatsapp
```

1. QR code aparece no terminal
2. Abra WhatsApp no celular → Configurações → Dispositivos conectados
3. Escaneie o código
4. 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)

```bash
openclaw channel add telegram
```

1. Fale com [@BotFather](https://t.me/BotFather) no Telegram
2. Use `/newbot` e siga as instruções
3. Copie o token fornecido
4. 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)

```bash
openclaw channel add discord
```

Requer configuração no [Discord Developer Portal](https://discord.com/developers/applications):

1. Criar Application
2. Adicionar Bot
3. Copiar Token
4. Configurar Intents (Message Content Intent = ON)

[→ Tutorial Discord completo](/tutoriais/discord/)

### Slack (Para Empresas)

```bash
openclaw channel add slack
```

Precisa criar Slack App com Socket Mode. [→ Tutorial Slack](/tutoriais/slack/)

### Múltiplos Canais

Você pode ter todos ao mesmo tempo:

```yaml
# 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`:

```markdown
# 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:**
```markdown
## 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:**
```markdown
## 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:**
```markdown
## 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](/tutoriais/personalizar-soul/)

---

## 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:

```bash
# 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`:

```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:

1. Crie a pasta:
```bash
mkdir -p ~/clawd/skills/meu-sistema
```

2. Crie `SKILL.md`:
```markdown
# 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"
```

3. Habilite:
```yaml
skills:
  - ./skills/meu-sistema
```

[→ Tutorial criar skills](/tutoriais/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`:

```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`:

```markdown
# 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:

```markdown
## 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:

```bash
#!/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:
```bash
# 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:

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

Use variáveis de ambiente:
```bash
export ANTHROPIC_API_KEY="sua-key"
export OPENAI_API_KEY="sua-key"
```

### Proteção de Dados

O OpenClaw processa suas mensagens. Considere:

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

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

[→ Guia completo de segurança](/guias/seguranca/)

---

## 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

- [Configurar memória persistente](/tutoriais/configurar-memoria/)
- [Integrar com calendário](/integracoes/google-calendar/)
- [Automação de tarefas](/guias/automacao-avancada/)

### Para Negócios

- [Atendimento WhatsApp 24/7](/blog/automacao-whatsapp-ia-guia-completo/)
- [Integrar com CRM](/integracoes/crm/)
- [Múltiplos agentes para equipe](/guias/equipe/)

### Para Desenvolvedores

- [API e webhooks](/api/)
- [Criar skills avançadas](/tutoriais/criar-skills/)
- [Contribuir com código](/contribuir/)

---

## Precisa de Ajuda?

- **Comunidade Discord:** [discord.gg/clawd](https://discord.gg/clawd)
- **GitHub Issues:** [Reportar problemas](https://github.com/openclaw/openclaw/issues)
- **Troubleshooting:** [Soluções comuns](/troubleshooting/)

---

> ** 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ê.