--- title: "Primeiros Passos com OpenClaw — Seu Agente IA em 10 Minutos" url: "https://openclaw.ia.br/docs/primeiros-passos/" markdown_url: "https://openclaw.ia.br/docs/primeiros-passos.MD" description: "Guia completo para iniciantes. Instale o OpenClaw, configure seu primeiro agente IA e conecte ao WhatsApp ou Telegram. Sem conhecimento técnico necessário." date: "2026-02-01" author: "" --- # Primeiros Passos com OpenClaw — Seu Agente IA em 10 Minutos Guia completo para iniciantes. Instale o OpenClaw, configure seu primeiro agente IA e conecte ao WhatsApp ou Telegram. Sem conhecimento técnico necessário. # 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: | Requisito | Mínimo | Recomendado | |-----------|--------|-------------| | Computador | Qualquer um com 4GB RAM | 8GB RAM ou mais | | Sistema | Windows 10+, macOS, ou Linux | Ubuntu/Debian Linux | | Internet | Conexão estável | Banda larga | | Conta IA | Uma chave de API | Claude (Anthropic) ou GPT (OpenAI) | **Não tem servidor?** Sem problema! Você pode rodar no seu próprio computador para testar, ou usar a [Oracle Cloud gratuita](/blog/instalar-openclaw-gratis-oracle-cloud/) 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](https://nodejs.org) 2. Baixe a versão "LTS" (Long Term Support) 3. Execute o instalador e siga as instruções **Linux (Ubuntu/Debian):** ```bash curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs ``` **Verifique a instalação:** ```bash node --version # Deve mostrar v20.x.x ou superior ``` ### Passo 2: Instale o OpenClaw Abra o terminal (Prompt de Comando no Windows) e execute: ```bash npm install -g openclaw ``` Isso instala o OpenClaw globalmente no seu sistema. **Verifique:** ```bash openclaw --version ``` ### Passo 3: Crie sua Pasta de Trabalho O OpenClaw precisa de uma pasta para guardar suas configurações e memórias: ```bash mkdir meu-agente cd meu-agente ``` ### Passo 4: Configure o OpenClaw Execute o assistente de configuração: ```bash openclaw init ``` Ele vai te perguntar: 1. **Qual provedor de IA?** — Recomendamos Anthropic (Claude) 2. **Sua chave de API** — Pegue em [console.anthropic.com](https://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 ```bash 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: ```bash 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`: ```yaml channels: telegram: token: "SEU_TOKEN_AQUI" ``` 5. Reinicie o OpenClaw: ```bash 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: ```bash openclaw skill add whatsapp ``` 2. Configure seguindo o guia: [Integração WhatsApp](/integracoes/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: ```markdown # 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](/skills/)** — Expanda as capacidades do seu agente 2. **[Integre com Google Calendar](/integracoes/google-calendar/)** — Agendamentos automáticos 3. **[Configure Memória](/tutoriais/memoria/)** — Seu agente lembra de conversas anteriores 4. **[Veja Casos de Sucesso](/blog/casos-sucesso-ia-brasil/)** — Inspiração de outros usuários --- ## Precisa de Ajuda? - **[FAQ](/docs/faq/)** — Perguntas frequentes - **[Discord](https://discord.gg/clawd)** — Comunidade ativa - **[Glossário](/docs/glossario-ia/)** — Termos técnicos explicados --- ## Resumo Rápido | Passo | Comando | |-------|---------| | 1. Instalar | `npm install -g openclaw` | | 2. Criar pasta | `mkdir meu-agente && cd meu-agente` | | 3. Configurar | `openclaw init` | | 4. Iniciar | `openclaw start` | | 5. Testar | `openclaw chat` | **Tempo total:** ~10 minutos --- *Dúvidas? O [Discord da comunidade](https://discord.gg/clawd) está sempre pronto para ajudar!*