Guia de Introdução ao OpenClaw — Configure seu Assistente IA em Minutos

Para começar com o OpenClaw, instale-o globalmente com npm install -g openclaw@latest e execute openclaw onboard para configurar sua instância. O assistente de integração guia você pela configuração do seu modelo de IA, conexão de canais de mensagens como WhatsApp ou Telegram e configuração do seu espaço de trabalho. Alternativamente, o MyClaw.ai oferece hospedagem gerenciada onde sua instância está pronta imediatamente, sem nenhuma configuração.

O que é o OpenClaw?

O OpenClaw (anteriormente Clawdbot) é um assistente pessoal de IA de código aberto que roda na sua própria máquina. Diferente de ferramentas de IA apenas na nuvem, o OpenClaw dá a você controle total — seus dados ficam locais e você interage com ele através dos aplicativos de mensagens que já usa: WhatsApp, Telegram, Slack, Discord, Signal, iMessage e mais.

Primeiros Passos com o OpenClaw

Existem duas formas de começar:

1. Auto-hospedagem — Instalar na sua própria máquina (este guia)
2. Hospedagem gerenciada — Deixe o MyClaw.ai cuidar de tudo para você

Pré-requisitos para Auto-Hospedagem

Antes de instalar o OpenClaw, certifique-se de ter:

• Node.js — Versão 22 ou posterior (baixar aqui)
• Sistema operacional — macOS, Linux ou Windows (WSL2 fortemente recomendado)

Passo 1: Instalar o OpenClaw

A forma mais rápida de começar é uma instalação global:

npm install -g openclaw@latest

Passo 2: Executar o Assistente de Configuração

O assistente de configuração guia você por toda a instalação:

openclaw onboard --install-daemon

O assistente guia você por:

• Configuração do modelo — Escolha seu modelo de IA (Claude, GPT ou modelos locais) e configure a autenticação da API
• Conexão de canais — Vincule seus aplicativos de mensagens (WhatsApp, Telegram, Slack, Discord, etc.)
• Inicialização do espaço de trabalho — Configure seu espaço de trabalho local em ~/.openclaw/workspace
• Configuração de skills — Navegue e instale skills do ClawHub
• Instalação do daemon — Configura um serviço em segundo plano (launchd no macOS, systemd no Linux) para que o OpenClaw funcione de forma persistente

Passo 3: Verificar sua Configuração

Execute a ferramenta de diagnóstico integrada para garantir que tudo está configurado corretamente:

openclaw doctor

Passo 4: Enviar sua Primeira Mensagem

Uma vez que um canal está conectado, envie uma mensagem para o OpenClaw pelo seu aplicativo de mensagens — como se estivesse mandando uma mensagem para um amigo. Por exemplo, envie pelo WhatsApp ou Telegram:

"Com o que você pode me ajudar?"

Você também pode interagir diretamente pela linha de comando:

openclaw agent --message "Com o que você pode me ajudar?"

O OpenClaw responderá pelo mesmo canal. A partir daqui, você pode pedir para ele gerenciar e-mails, verificar sua agenda, navegar na web, escrever código ou executar qualquer uma das skills instaladas.

Comandos Úteis

Uma vez que o OpenClaw está em execução, estes comandos ajudam no gerenciamento:

Comando	Função
/status	Verificar o status atual da sessão
/new ou /reset	Reiniciar a sessão de conversa
/think <level>	Controlar a profundidade de raciocínio
openclaw doctor	Diagnosticar problemas de configuração
openclaw update --channel stable	Atualizar para a versão mais recente

Problemas Comuns de Configuração

Conflitos de porta

Se você vir um erro de "porta já em uso", especifique uma porta diferente:

openclaw gateway --port 18790

Versão do Node não suportada

O OpenClaw requer Node.js 22 ou posterior. Verifique sua versão:

node --version

Se for mais antiga, atualize pelo nodejs.org ou use o nvm:

nvm install 22
nvm use 22

Erros de permissão no macOS

O OpenClaw pode precisar de permissões de acessibilidade para certas funcionalidades. Vá para:

Ajustes do Sistema > Privacidade e Segurança > Acessibilidade

Adicione seu aplicativo de terminal à lista permitida.

A Alternativa Mais Fácil: Hospedagem Gerenciada

A auto-hospedagem dá controle total, mas também significa gerenciar atualizações, disponibilidade e configuração por conta própria. Se preferir pular tudo isso, o MyClaw.ai roda o OpenClaw para você na nuvem:

• Zero configuração — Sem instalar, sem configurar, sem depurar
• Sempre online — Sua instância funciona 24/7 sem precisar manter seu computador ligado
• Atualizações automáticas — Sempre rodando a versão mais recente do OpenClaw

Seja com auto-hospedagem ou hospedagem gerenciada, o mais importante é começar a usar o OpenClaw e descobrir o que ele pode fazer pelo seu fluxo de trabalho.

Próximos Passos

Uma vez que o OpenClaw está funcionando:

• Explore o marketplace de skills (ClawHub) para integrações criadas pela comunidade
• Tente conectar canais de mensagens adicionais
• Participe da comunidade OpenClaw no Discord para dicas e suporte
• Confira O que é o OpenClaw? para um mergulho mais profundo nas funcionalidades
• Leia o guia completo de instalação se quiser compilar a partir do código-fonte