guide beginner tutorial installation

OpenClaw 101: Do Zero ao Seu Primeiro Agente de IA em 15 Minutos

OpenClaws.io Team

OpenClaws.io Team

@openclaws

March 6, 2026

7 min de leitura

OpenClaw 101: Do Zero ao Seu Primeiro Agente de IA em 15 Minutos

O Que É o OpenClaw?

O OpenClaw é um agente de IA open source que roda no seu próprio computador. Diferente do ChatGPT ou Claude.ai, que vivem na nuvem e só conseguem conversar, o OpenClaw vive na sua máquina e pode agir — gerenciando arquivos, enviando mensagens, navegando na web, controlando dispositivos de casa inteligente e executando automações por agendamento.

Você interage com ele através dos apps de chat que já usa: WhatsApp, Telegram, Discord, Slack, iMessage e mais. Ele está sempre ligado, sempre aprendendo e sempre seu.

O Que Você Precisa

  • Um computador: Mac, Windows (com WSL2) ou Linux. Um Raspberry Pi também funciona.
  • Node.js 22 ou superior: O OpenClaw roda em Node.js.
  • Uma chave de API de IA: Da Anthropic (Claude), OpenAI (GPT) ou um modelo local via Ollama.
  • 10 minutos: É genuinamente tudo que leva.

Passo 1: Instalar o Node.js

Se você não tem o Node.js 22+, instale via nvm (Node Version Manager):

bash
# macOS / Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22

# Windows (use nvm-windows from github.com/coreybutler/nvm-windows)
nvm install 22
nvm use 22

Verifique: node --version deve mostrar v22.x.x ou superior.

Passo 2: Instalar o OpenClaw

bash
npm install -g openclaw@latest

Ou com pnpm:

bash
pnpm add -g openclaw@latest

Verifique: openclaw --version deve imprimir a versão instalada.

Passo 3: Executar o Assistente de Onboarding

bash
openclaw onboard --install-daemon

O assistente te guia por:

  1. 1.Configuração da chave de API: Cole sua chave de API da Anthropic ou OpenAI. Se você quiser usar um modelo local, pode configurar o Ollama depois.
  2. 2.Plataforma de chat: Escolha qual app de mensagens conectar primeiro. O WhatsApp é a escolha mais popular — você vai escanear um QR code para vincular sua conta.
  3. 3.Instalação do daemon: O daemon mantém o OpenClaw rodando em segundo plano, mesmo depois que você fechar o terminal.

Passo 4: Diga Olá

Abra seu app de chat conectado (WhatsApp, Telegram, etc.) e envie uma mensagem para seu agente:

> Oi! O que você pode fazer?

Seu agente vai responder com um resumo de suas capacidades. Tente algumas coisas:

  • "Que horas são em Tóquio?"
  • "Resuma este artigo: [cole uma URL]"
  • "Me lembre de ligar para a mamãe às 18h amanhã"
  • "Pesquise na web sobre o último release do OpenClaw"

Passo 5: Personalize Seu Agente

Defina sua personalidade

Edite ~/.openclaw/agents/default/SOUL.md para definir o tom e as regras do seu agente. Por exemplo:

markdown
You are a helpful, concise assistant. Always confirm before deleting files or sending messages.

Instale skills

Skills são plugins que dão novas habilidades ao seu agente:

bash
openclaw skill install web-search
openclaw skill install home-assistant
openclaw skill install github-integration

Navegue pelas skills disponíveis no marketplace do ClawHub.

Acesse a Interface Web

O OpenClaw inclui um painel web local:

bash
openclaw ui

Isso abre uma interface no navegador onde você pode ver o histórico de conversas, gerenciar skills, monitorar a atividade do agente e ajustar configurações.

Entendendo a Arquitetura

Você (celular/laptop)
    |
    v
Plataforma de Chat (WhatsApp, Telegram, Discord...)
    |
    v
Gateway OpenClaw (roda na sua máquina)
    |
    v
Modelo de IA (Claude, GPT, Ollama, etc.)
    |
    v
Skills & Ferramentas (sistema de arquivos, web, APIs, casa inteligente...)

Suas mensagens fluem do seu app de chat para o gateway do OpenClaw na sua máquina. O gateway envia a mensagem para um modelo de IA para raciocínio, e então executa quaisquer ações usando skills instaladas. A resposta flui de volta pelo mesmo caminho.

Tudo roda localmente exceto a inferência do modelo de IA (a menos que você use Ollama para modelos locais).

Perguntas Comuns da Primeira Semana

"Por que meu agente demora para responder?" A primeira resposta após um cold start leva alguns segundos enquanto o modelo de IA carrega o contexto. Mensagens subsequentes na mesma conversa são mais rápidas. Se as respostas estão consistentemente lentas, verifique sua conexão de internet com o provedor de IA.

"Quanto isso vai me custar?" Uso leve (algumas conversas por dia) tipicamente custa $10-30/mês em taxas de API. Você pode reduzir custos significativamente usando Claude Haiku ou modelos locais para tarefas simples.

"Posso usar com múltiplos apps de chat ao mesmo tempo?" Sim. O OpenClaw pode ser conectado ao WhatsApp, Telegram, Discord e outras plataformas simultaneamente. Mensagens de todas as plataformas são tratadas pelo mesmo agente.

"É seguro?" O OpenClaw roda na sua máquina e você controla todos os dados. Mantenha-o atualizado, revise skills antes de instalar e siga o guia de segurança em docs.openclaw.ai/security.

Próximos Passos

Bem-vindo à comunidade OpenClaw. Sua lagosta está pronta.

Fique por dentro

Receba novidades sobre recursos e integrações. Sem spam, cancele quando quiser.