Primeiros Passos com OpenClaw

Bem-vindo! Este guia vai te ajudar a criar seu primeiro agente IA em menos de 10 minutos. Não precisa de conhecimento técnico — vamos juntos, passo a passo.

O que é OpenClaw?

OpenClaw é uma plataforma que transforma assistentes de IA (como Claude e GPT) em agentes autônomos que trabalham para você.

A diferença é simples:

• Chatbot comum: Você pergunta, ele responde. Fim.
• Agente OpenClaw: Você dá uma tarefa, ele executa. Envia emails, agenda reuniões, busca informações, cria documentos — tudo sozinho.

Para quem é?

• Empreendedores que querem automatizar tarefas repetitivas
• Profissionais autônomos que precisam de um “assistente” 24 horas
• Pequenas empresas que querem atender clientes no WhatsApp com IA
• Curiosos que querem experimentar IA avançada de forma prática

Requisitos Mínimos

Você vai precisar de:

Não tem servidor? Sem problema! Você pode rodar no seu próprio computador para testar, ou usar a Oracle Cloud gratuita para ter seu agente 24/7.

Instalação Passo a Passo

Passo 1: Instale o Node.js

O OpenClaw roda em Node.js (um programa que executa JavaScript).

Windows/Mac:

1. Acesse nodejs.org
2. Baixe a versão “LTS” (Long Term Support)
3. Execute o instalador e siga as instruções

Linux (Ubuntu/Debian):

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

Verifique a instalação:

node --version
# Deve mostrar v20.x.x ou superior

Passo 2: Instale o OpenClaw

Abra o terminal (Prompt de Comando no Windows) e execute:

npm install -g openclaw

Isso instala o OpenClaw globalmente no seu sistema.

Verifique:

openclaw --version

Passo 3: Crie sua Pasta de Trabalho

O OpenClaw precisa de uma pasta para guardar suas configurações e memórias:

mkdir meu-agente
cd meu-agente

Passo 4: Configure o OpenClaw

Execute o assistente de configuração:

openclaw init

Ele vai te perguntar:

1. Qual provedor de IA? — Recomendamos Anthropic (Claude)
2. Sua chave de API — Pegue em console.anthropic.com
3. Nome do seu agente — Escolha algo que faça sentido para você

Ao final, será criado um arquivo openclaw.yaml com suas configurações.

Seu Primeiro Agente

Passo 5: Inicie o OpenClaw

openclaw start

Seu agente está vivo! Mas ainda não tem como você falar com ele…

Passo 6: Teste no Terminal

Abra outra janela do terminal e execute:

openclaw chat

Agora você pode conversar com seu agente:

Você: Olá! O que você pode fazer?

Agente: Olá! Sou seu assistente IA. Posso ajudar com várias tarefas:
- Responder perguntas e pesquisar informações
- Criar e editar documentos
- Organizar arquivos no seu computador
- E muito mais, dependendo das skills instaladas!

O que gostaria de fazer?

🎉 Parabéns! Você tem um agente IA funcionando!

Conectando ao WhatsApp ou Telegram

Um agente no terminal é legal, mas o poder real vem quando ele está disponível no seu celular.

Opção A: Telegram (Mais Fácil)

1. Abra o Telegram e busque por @BotFather
2. Envie /newbot e siga as instruções
3. Copie o token que ele te dá
4. Edite seu openclaw.yaml:

channels:
  telegram:
    token: "SEU_TOKEN_AQUI"

5. Reinicie o OpenClaw:

openclaw restart

Agora abra o Telegram, busque seu bot e comece a conversar!

Opção B: WhatsApp (Mais Poderoso)

O WhatsApp requer alguns passos extras, mas é onde seus clientes estão:

1. Instale a skill do WhatsApp:

openclaw skill add whatsapp

2. Configure seguindo o guia: Integração WhatsApp

3. Escaneie o QR Code que aparece no terminal

Pronto! Seu agente agora responde no WhatsApp.

Personalizando seu Agente

Dê uma Personalidade

Crie um arquivo SOUL.md na sua pasta:

# Quem Sou Eu

Você é o assistente da Loja ABC, especializado em vendas de eletrônicos.

## Regras
- Sempre cumprimente com "Olá! Bem-vindo à Loja ABC!"
- Mencione que temos frete grátis acima de R$200
- Seja educado mas direto
- Nunca fale mal de concorrentes

## Conhecimento
- Trabalhamos com Samsung, Apple, Xiaomi
- Horário de atendimento: 8h às 22h
- Entregamos em todo o Brasil

O agente vai seguir essas instruções em todas as conversas.

Adicione Conhecimento

Coloque documentos na pasta do agente:

• Catálogo de produtos (PDF ou texto)
• FAQ do seu negócio
• Políticas de troca e devolução

O agente consegue consultar esses arquivos para responder perguntas.

Próximos Passos

Agora que seu agente está funcionando:

1. Adicione Skills — Expanda as capacidades do seu agente
2. Integre com Google Calendar — Agendamentos automáticos
3. Configure Memória — Seu agente lembra de conversas anteriores
4. Veja Casos de Sucesso — Inspiração de outros usuários

Precisa de Ajuda?

• FAQ — Perguntas frequentes
• Discord — Comunidade ativa
• Glossário — Termos técnicos explicados

Resumo Rápido

Tempo total: ~10 minutos

Dúvidas? O Discord da comunidade está sempre pronto para ajudar!