Seu Primeiro Dia com OpenClaw — Guia Iniciante

Seu Primeiro Dia com OpenClaw

Introdução

Você instalou o OpenClaw. Agora o que fazer? Esse é o momento em que muitos usuários ficam um pouco perdidos — o assistente está funcionando, mas aproveitar o potencial real requer um passo a passo que vai além de “perguntar coisas aleatórias e ver o que acontece”.

Este guia vai te acompanhar pelo seu primeiro dia completo com o OpenClaw, desde os primeiros testes de funcionamento até a configuração das automações que vão transformar o assistente em uma ferramenta realmente útil. A sequência é importante: cada etapa prepara o terreno para a próxima, e completar todas elas no primeiro dia cria uma base sólida para o uso contínuo.

A experiência com usuários do OpenClaw mostra um padrão claro: quem completa o checklist do primeiro dia — especialmente as partes de personalização e memória — usa o assistente diariamente. Quem para na instalação básica geralmente abandona a ferramenta em uma semana. A diferença não é tecnologia, é tempo dedicado para fazer o assistente trabalhar para você especificamente.

Pré-requisitos

Para este guia, você precisará de:

  • OpenClaw instalado (se não instalou ainda, veja guia de instalação)
  • Pelo menos 1 hora disponível (pode ser distribuída ao longo do dia)
  • Pelo menos um canal configurado (WhatsApp, Telegram, ou outro)
  • Acesso ao terminal para editar arquivos de configuração

Primeiros 30 Minutos — Verificação e Orientação

Passo 1: Teste Básico de Comunicação

O primeiro contato deve ser simples, para confirmar que tudo está funcionando:

"Oi! Você está funcionando?"
→ Deve responder confirmando que está ativo

"Que horas são agora?"
→ Deve responder com a hora atual (confirma acesso ao horário do servidor)

"Qual a previsão do tempo para [sua cidade] hoje?"
→ Se tiver skill de clima: responde com previsão
→ Se não tiver: diz que não tem acesso ainda (normal)

"Me conte uma curiosidade sobre a Amazônia"
→ Deve responder com uma curiosidade interessante
→ Confirma que o modelo de IA está respondendo bem

Se qualquer um desses não funcionar, consulte o guia de debugging antes de continuar.

Passo 2: Apresente-se ao Assistente

O OpenClaw aprende sobre você através do que você diz. Comece se apresentando:

"Me chamo [Seu Nome] e moro em [cidade].
Trabalho como [profissão] e meu principal interesse profissional agora é [tema].
Pode me chamar de [apelido se tiver] e usar linguagem [formal/informal].
Meu fuso horário é America/Sao_Paulo."

O assistente vai registrar essas informações e usá-las para personalizar as respostas.

Passo 3: Configure Sua Identidade no USER.md

Para que o assistente “lembre” suas informações em qualquer sessão futura, edite o arquivo USER.md:

# No terminal do servidor
nano ~/clawd/USER.md

Template inicial recomendado:

# USER.md — Quem Sou Eu

## Dados Básicos
- Nome: [Seu Nome]
- Apelido: [Como prefere ser chamado]
- Cidade: [Sua cidade]
- Timezone: America/Sao_Paulo
- Idioma: Português brasileiro

## Contexto Profissional
- Profissão: [O que você faz]
- Área: [Setor ou especialidade]
- Empresa/Projeto atual: [Nome]
- Principais responsabilidades: [3-4 bullet points]

## Como Prefiro Trabalhar
- Comunicação: [direta/detalhada/com exemplos]
- Respostas: [curtas/longas/dependendo do contexto]
- Durante trabalho: mensagens focadas
- Tarde da noite: pode ser mais casual

## Contexto Pessoal (opcional)
- Família: [informação que seja útil para o assistente]
- Hobbies relevantes: [se relevante para o uso]

Salve e reinicie o gateway para carregar:

openclaw gateway restart

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

Primeira Hora — Explorando Capacidades

Passo 4: Explore as Capacidades com Exemplos Reais

Teste cada categoria com algo relevante para você, não com exemplos genéricos:

Produtividade (use sua situação real):

"Tenho reunião importante às 15h. Me ajude a preparar 3 perguntas para fazer"
"Preciso responder um email difícil para [tipo de situação]. Me ajude a redigir"
"Liste as tarefas que ainda não fiz hoje" (se você já listou tarefas antes)

Análise e pesquisa:

"Resuma as vantagens e desvantagens de [tecnologia/ferramenta que estou avaliando]"
"Quais são as 5 melhores práticas para [algo relevante na minha área]?"
"Compare [opção A] vs [opção B] para o meu contexto de [descreva]"

Escrita e comunicação:

"Escreva um email profissional pedindo [algo que você realmente precisa pedir]"
"Reescreva este trecho de forma mais clara: [cole texto real]"
"Crie uma descrição de [produto/projeto] para publicar no LinkedIn"

Código (se você programa):

"Explique este código: [cole trecho]"
"Qual a diferença entre [conceito A] e [conceito B] em [linguagem]?"
"Como implemento [funcionalidade] em [linguagem]?"

Observe a qualidade das respostas. Se estiverem muito genéricas, é sinal de que o USER.md e SOUL.md precisam de mais contexto.

Passo 5: Personalize o SOUL.md

O SOUL.md é onde você define a personalidade do seu assistente. Quanto mais específico, melhor:

nano ~/clawd/SOUL.md

Template funcional:

# SOUL.md — Assistente de [Seu Nome]

## Identidade
Nome: [escolha um nome para o assistente, ou deixe sem nome]
Papel: Assistente pessoal e profissional de [Seu Nome]

## Tom e Comunicação
- [Formal/Informal] — [Seu Nome] prefere linguagem [descreva]
- Use bullet points quando listar múltiplos itens
- Seja conciso nas respostas durante horário de trabalho
- Pode ser mais detalhado quando não há urgência
- [Adicione outras preferências específicas suas]

## Prioridades
Quando receber uma mensagem:
1. Se é uma tarefa: confirme o entendimento antes de executar
2. Se é uma pergunta: responda diretamente, sem rodeios
3. Se há ambiguidade: pergunte para esclarecer antes de responder
4. Se precisa de mais informação: peça especificamente o que falta

## Contexto de Trabalho
[Descreva brevemente o que você faz e como o assistente pode ajudar melhor]
Exemplo: "[Seu Nome] é desenvolvedor. Prioridade para código, debug e documentação."

## O Que Sempre Fazer
- Responder em português brasileiro
- Confirmar tarefas completadas
- Perguntar antes de executar ações externas (enviar emails, mensagens)

## O Que Nunca Fazer
- Inventar informações (prefira dizer "não sei" a inventar)
- Ignorar contexto disponível no MEMORY.md
- Fazer suposições sobre preferências não declaradas

Reinicie para aplicar:

openclaw gateway restart

Passo 6: Configure a Memória Básica

Adicione informações que o assistente deve lembrar sempre:

"Anota na memória: Meu café preferido é expresso sem açúcar"
"Guarda para lembrar depois: meu projeto mais importante agora é [nome do projeto]"
"Salve que minha reunião semanal com a equipe é toda segunda às 10h"
"Anote que uso [ferramentas específicas do seu trabalho]"

Ou adicione diretamente ao MEMORY.md:

nano ~/clawd/MEMORY.md

Exemplo de entradas úteis:

# MEMORY.md

## Projetos Ativos (atualizado em [data])
- [Projeto 1]: [descrição curta e status]
- [Projeto 2]: [descrição curta e status]

## Preferências de Trabalho
- Horário de foco: 9h-12h (não interromper para coisas não urgentes)
- Pausa para almoço: normalmente 12h30
- Disponível para reuniões: tardes

## Informações Técnicas
- Stack principal: [suas tecnologias]
- Editor: [VS Code, Vim, etc.]
- OS: [MacOS, Linux, Windows]

## Contexto Atual
- Foco do mês: [o que você está priorizando]
- Deadline próximo: [prazo importante se houver]

Fim do Primeiro Dia — Automações e Integração

Passo 7: Configure Sua Primeira Automação

A automação mais valiosa para a maioria das pessoas é o briefing matinal. Configure:

"Quero que todo dia de semana às 7h30 você me mande uma mensagem com:
1. Uma citação motivacional curta
2. Previsão do tempo para [sua cidade]
3. Lembrança dos meus compromissos do dia (se tiver acesso ao calendário)
4. Uma tarefa sugerida baseada nas minhas prioridades atuais"

O assistente vai configurar o heartbeat automaticamente. Para verificar:

cat ~/clawd/HEARTBEAT.md
# Deve mostrar a automação configurada

Ajuste conforme necessário:

nano ~/clawd/HEARTBEAT.md
# Edite o horário ou o que deve ser incluído

Passo 8: Conecte Ferramentas Relevantes

Baseado no que você faz, conecte as integrações que farão diferença real:

Para todos:

openclaw integration add google-calendar  # Agenda
# Siga os passos de autenticação OAuth

Para profissionais de tecnologia:

openclaw integration add github    # Repositórios e PRs
openclaw integration add jira      # Gestão de tarefas (se usa Jira)

Para negócios e vendas:

openclaw integration add gmail     # Email
openclaw integration add hubspot   # CRM (se usa HubSpot)

Para gestão e produtividade:

openclaw integration add notion    # Base de conhecimento
openclaw integration add trello    # Boards de tarefa

Depois de conectar, teste:

"Quais compromissos tenho amanhã?"
"Quais emails importantes recebi hoje?"
"Qual o status das minhas tarefas abertas no [ferramenta]?"

Passo 9: Revise e Ajuste

No fim do dia, faça uma revisão reflexiva:

"O que você aprendeu sobre mim hoje?"
"Mostre o que está no meu MEMORY.md"
"O que eu poderia fazer diferente na nossa comunicação para que você me ajude melhor?"
"Quais configurações do SOUL.md você acha que deveríamos ajustar baseado no que viu hoje?"

As respostas podem surpreender. Use o feedback para refinar o SOUL.md e USER.md.

Configuração Avançada — Se Tiver Tempo Sobrando

Skills Essenciais

Habilite skills que adicionam capacidade real:

# Ver skills disponíveis
openclaw skills list --available

# Instalar skills úteis (verifique as que fazem sentido para você)
openclaw skills install web-search     # Pesquisa na web
openclaw skills install summarize      # Resumir URLs, documentos
openclaw skills install weather        # Previsão do tempo

# Após instalar, teste cada uma

Configuração de Segurança Básica

# Limitar acesso ao seu número no WhatsApp
openclaw config set channels.whatsapp.allowlist "+55SEU_NUMERO"

# Habilitar auditoria
openclaw config set audit.enabled true

# Aplicar
openclaw gateway restart

Checklist do Primeiro Dia

Use esta lista para acompanhar seu progresso:

Funcionamento Básico:

  • Testei comandos básicos e todos responderam
  • Confirmei que hora e data são retornadas corretamente
  • Recebi pelo menos 5 respostas de qualidade sobre assuntos reais

Personalização:

  • Criei e preenchi o USER.md com minha informação real
  • Personalizei o SOUL.md com meu tom e preferências
  • Adicionei pelo menos 5 itens relevantes ao MEMORY.md
  • Testei “Quem sou eu?” e recebeu resposta com meu contexto

Automações:

  • Configurei pelo menos uma automação (briefing matinal ou outra)
  • Testei o heartbeat manualmente

Integrações:

  • Conectei pelo menos uma integração relevante para mim
  • Testei a integração com uma pergunta real

Segurança:

  • Sei onde ficam os arquivos de configuração
  • Entendo o que vai para APIs externas (leia o guia de privacidade)

Erros Comuns e Soluções

SituaçãoO Que AconteceSolução
Assistente muito genéricoUSER.md e SOUL.md muito vagosSeja mais específico sobre seu contexto e preferências
Esquece coisas entre sessõesInformação não está no MEMORY.mdPeça para salvar explicitamente ou adicione ao MEMORY.md
Respostas muito longasSem instrução de formatoAdicione ao SOUL.md: “prefiro respostas concisas, máximo [N] parágrafos”
Automação não dispara no horárioCrontab mal configuradoVerifique HEARTBEAT.md e openclaw heartbeat status
Integração não funcionaToken OAuth expirado ou permissõesReconecte a integração com openclaw integration reconnect nome

Boas Práticas para os Primeiros Dias

  • Seja específico desde o início: O investimento de 30 minutos no USER.md e SOUL.md retorna em semanas de respostas muito mais relevantes. Não deixe “para depois” — faça no primeiro dia.

  • Itere sem medo: Se a resposta não foi o que você queria, diga “Isso não foi o que eu precisava porque [razão]. Tente de novo com foco em [aspecto].” O assistente aprende com o feedback.

  • Peça para salvar na memória: Sempre que você compartilhar algo importante sobre seu trabalho ou preferências, peça: “Salve isso no MEMORY.md.” Com o tempo, o assistente vai ter um contexto rico sobre você.

  • Use para coisas reais: Não teste com perguntas genéricas de “demonstração”. Use para resolver problemas reais do seu trabalho desde o primeiro dia. Isso acelera muito o aprendizado sobre o que funciona para você.

  • Anote o que funcionou bem: No fim do primeiro dia, anote 3 coisas que funcionaram melhor que você esperava. Isso ajuda a identificar onde focar energia no uso futuro.

Perguntas Frequentes

Quanto tempo até o assistente “entender” meu contexto bem? Com USER.md e MEMORY.md bem preenchidos, a partir do segundo dia as respostas já são notavelmente melhores. Com 2-4 semanas de uso regular e adições constantes ao MEMORY.md, o assistente tem um contexto rico que torna o uso muito mais fluido.

O assistente aprende sozinho com o uso? O assistente não modifica o modelo de IA subjacente (isso seria fine-tuning). O que melhora é o contexto — a quantidade de informação sobre você disponível nos arquivos SOUL.md, USER.md, MEMORY.md e nos logs diários. Você precisa ativamente adicionar informação ou pedir que o assistente salve coisas importantes.

É normal cometer erros e a IA dar respostas erradas? Sim, especialmente no início. Corrija explicitamente: “Isso está errado. O correto é [X]. Por favor, salve a correção no MEMORY.md.” A IA não fica “magoada” com correções — quanto mais feedback, melhor.

Qual a diferença entre falar pela conversa vs. editar os arquivos diretamente? Conversar é mais rápido para informações simples e contextuais. Editar diretamente os arquivos (SOUL.md, MEMORY.md) é melhor para informações estruturadas e permanentes. Para o primeiro dia, uma combinação das duas abordagens funciona melhor.

Como sei se configurei bem? Faça o teste: após configurar tudo, pergunte algo específico do seu contexto que um assistente genérico não saberia responder, como “Quais são minhas prioridades atuais no trabalho?” ou “Como prefiro receber resumos de documentos?”. Se a resposta refletir o que você configurou, está bem feito.

Próximos Passos

Com o primeiro dia completo, os próximos passos naturais são:


Dica final: Ao fim de cada dia de trabalho, passe 2 minutos pedindo um resumo: “O que foi mais importante no que discutimos hoje? Salve no MEMORY.md o que achar relevante para futuras sessões.” Esse hábito simples vai criar uma memória organizacional rica ao longo das semanas.