Instale e use o OpenClaw

Do terminal à primeira resposta

Você vai instalar o OpenClaw, conectar um provedor de IA e enviar uma mensagem pelo painel no navegador. Comece no seu computador. Depois que tudo funcionar, a seção opcional sobre servidores explica como mantê-lo rodando em outra máquina.

01Instalar Coloque o OpenClaw no seu computador.02Conectar Escolha a IA que vai responder.03Usar Abra o painel e receba uma resposta.

Antes de começar

Um Mac, PC com Windows ou computador Linux com internet.
Acesso a um provedor de IA. A configuração pode detectar logins compatíveis ou pedir que você conecte um provedor. O uso de API pode ser cobrado separadamente.
Um terminal e tempo para concluir o login. Você não precisa conectar um aplicativo de mensagens nesta aula.

Rodar localmente não significa usar IA offline. O OpenClaw roda na sua máquina; quando você escolhe um modelo na nuvem, as solicitações são enviadas ao provedor. O computador também precisa ficar ligado e fora do modo de suspensão.

Instale no seu sistema operacional

Abra o Terminal no macOS ou seu aplicativo de terminal no Linux. Cole este comando e pressione Enter.

Terminal

curl -fsSL https://openclaw.ai/install.sh | bash

O comando baixa e executa o instalador oficial. Ele instala o OpenClaw, verifica o Node.js e inicia a configuração. Documentação do instalador.

O instalador deve abrir a configuração inicial. Se terminar sem abrir, execute:

Terminal

openclaw onboard

Conecte seu provedor de IA

Escolha Custom setup para revisar as opções de conexão e acesso. Selecione uma conexão detectada ou siga o login do provedor escolhido. Digite credenciais apenas no fluxo de login do provedor ou no terminal de configuração local.

Espere a verificação da conexão terminar. Se falhar, resolva o problema de autenticação ou da conta antes de continuar. Ter o comando instalado não comprova que a conexão com a IA funciona.

Revise as permissões com atenção: Quick start usa acesso completo atualmente. As permissões dependem do modo de acesso, das ferramentas e das integrações que você ativar. Comece com o mínimo necessário e consulte a documentação de configuração e as orientações de segurança das ferramentas antes de ampliar o acesso.

Abra o painel e receba uma resposta

A configuração pode abrir o painel automaticamente. Para abri-lo novamente, execute o comando em um segundo terminal, mantendo o Gateway em execução. O Gateway é o processo que conecta o painel ao seu agente.

Terminal

openclaw dashboard

Use o endereço fornecido pelo comando. O endereço local padrão é http://127.0.0.1:18789, mas o link gerado considera sua configuração. Trate qualquer token nesse link como uma senha.

No chat, envie algo simples: “Responda com uma frase confirmando que você consegue ler esta mensagem.” O resultado esperado é uma resposta real da IA. O painel carregar é apenas a primeira verificação.

Se o navegador não conectar, consulte o serviço:

Terminal

openclaw gateway status

O guia do painel explica autenticação e conexão.

Mantenha o agente em segundo plano

Se o Gateway ficou rodando no terminal após a configuração, Ctrl+C o interrompe sem apagar suas configurações. Pare esse processo e instale o serviço em segundo plano:

Terminal

openclaw gateway install
openclaw gateway status

Confirme que o status indica um Gateway em execução. Abra o painel novamente e envie outra mensagem. O serviço dispensa manter o terminal aberto, mas não mantém um notebook conectado enquanto ele está em suspensão. O guia de primeiros passos explica o serviço usado em cada plataforma.

Opcional: use um servidor Linux

Um servidor permite usar o OpenClaw mesmo com seu notebook desligado. Você precisa de acesso SSH a um servidor Linux, uma conta de usuário comum e considerar o custo da hospedagem. Se ainda não tem um servidor, comece pelo guia oficial de servidores Linux.

Conecte-se ao servidor e siga os passos de instalação Linux, configuração e serviço acima dentro da sessão SSH. As credenciais de provedor do seu notebook não ficam disponíveis automaticamente no servidor.

Mantenha o Gateway restrito à interface local, com autenticação ativada. Em um terminal no seu notebook, abra um túnel. Substitua user e your-server pelos seus dados de SSH:

Terminal · no seu notebook

ssh -N -L 18789:127.0.0.1:18789 user@your-server

Deixe esse terminal aberto. Acesse http://127.0.0.1:18789 no notebook e autentique-se com as credenciais do Gateway do servidor. Se uma instalação local já usa essa porta, escolha outra porta local conforme o guia de acesso remoto. Não é necessário expor a porta 18789 à internet.

Algo deu errado? Comece pelo sintoma

“Command not found”: reabra o terminal após a instalação e execute openclaw --version. Se continuar falhando, leia a saída final do instalador.
O painel não conecta: execute openclaw gateway status. Confira se o endereço corresponde à máquina em que o Gateway está rodando.
O painel abre, mas o chat falha: confira a autenticação, a disponibilidade do modelo e os limites da conta. Revise a conexão com openclaw onboard.

Para um diagnóstico mais amplo, execute o comando abaixo e leia os resultados antes de aplicar mudanças. Consulte também o guia de solução de problemas.

Terminal

openclaw doctor

Você concluiu quando: o Gateway está rodando, o painel conecta e a IA respondeu à sua mensagem. Agora você pode conectar um canal de mensagens na próxima aula.

Instale e use o OpenClaw

Do terminal à primeira resposta

Antes de começar

Instale no seu sistema operacional

Conecte seu provedor de IA

Abra o painel e receba uma resposta

Mantenha o agente em segundo plano

Opcional: use um servidor Linux

Algo deu errado? Comece pelo sintoma

Instale e use o OpenClaw

Comentários