Back to blog

Instalar e usar OpenClaw sem nenhuma experiência em programação

Um guia tranquilizador para utilizadores não técnicos. Não precisa de saber programar nem conhecer Linux para ter o seu próprio agente de IA. Aqui está exatamente como é o processo k-claw e o que pode esperar.

K-Claw Team·05 de outubro de 2025·4 min read

A verdade honesta sobre "sem programação necessária"

Quando um software diz "sem programação necessária", muitas vezes ainda requer conhecimentos técnicos significativos. Sejamos diretos sobre o que é realmente necessário para executar OpenClaw via k-claw, para que você possa tomar uma decisão informada.

Você precisará:

  • Criar uma conta num fornecedor de VPS (como criar qualquer conta web)
  • Abrir um terminal e digitar um comando (mostramos exatamente como)
  • Responder a algumas perguntas do instalador

Não precisará:

  • Escrever nenhum código
  • Entender Linux em profundidade
  • Configurar servidores manualmente
  • Gerir software do sistema

Se consegue instalar uma app no seu telefone e criar uma conta de e-mail, consegue fazer isto. O sistema de cursos k-claw é especificamente concebido para preencher esta lacuna para utilizadores não técnicos.

Passo 1: criar uma conta VPS

Um VPS (Servidor Privado Virtual) é um computador num centro de dados que aluga mensalmente. Não o vê nem toca — apenas interage com ele através do seu browser e ocasionalmente através de um terminal.

Recomendamos Hetzner para novos utilizadores. Visite hetzner.com/cloud e crie uma conta. É como registar-se em qualquer website: e-mail, palavra-passe, dados de pagamento.

Após verificar a sua conta, crie um novo servidor:

  1. Clique em "Add Server"
  2. Selecione "Ubuntu 22.04" como sistema operativo
  3. Escolha o plano CX22 (EUR 4,35/mês)
  4. Em "SSH Keys" — se não tiver uma, Hetzner criará uma palavra-passe root para si
  5. Clique em "Create & Buy Now"

Hetzner configura o seu servidor em menos de um minuto e mostra-lhe um endereço IP. Copie-o — vai precisar dele a seguir.

Passo 2: abrir um terminal

Esta é a parte que a maioria dos guias não técnicos ignora. Um terminal é apenas uma interface de texto para o seu computador — não há nada a temer.

No Mac: Prima Comando + Espaço, escreva "Terminal", prima Enter. Verá uma janela com um cursor a piscar.

No Windows: Prima a tecla Windows, escreva "PowerShell", prima Enter. Ou instale Windows Terminal na Microsoft Store para uma melhor experiência.

No terminal, escreva isto para se ligar ao seu servidor (substitua pelo seu IP real):

ssh root@123.456.789.0

Na primeira vez que se ligar, pergunta "Tem a certeza que quer continuar a ligar?" — escreva yes e prima Enter. Depois introduza a palavra-passe do seu servidor se for pedida.

Agora está "dentro" do seu servidor. Verá um prompt como root@ubuntu:~#.

Passo 3: executar o instalador k-claw

Este é o único comando que faz tudo:

curl -fsSL https://claw.krokanti.com/install | bash

Escreva isto exatamente e prima Enter. O instalador irá:

  • Pedir a sua chave de licença k-claw (obtém-na no seu painel k-claw após subscrever)
  • Perguntar qual aplicação de mensagens quer ligar (escolha Telegram — é a mais fácil)
  • Pedir o seu token de bot do Telegram (o instalador explica como criar um)
  • Pedir uma chave de API de IA (terá de criar uma conta gratuita em openrouter.ai)

Cada pergunta aparece no ecrã com instruções. Escreve a sua resposta e prime Enter. O instalador trata de tudo o resto — transferir software, configurá-lo, configurar segurança, iniciar serviços.

Passo 4: obter a sua chave de API

O seu agente de IA precisa de se ligar a um modelo de IA para gerar respostas. OpenRouter é a opção mais simples para iniciantes:

  1. Vá a openrouter.ai
  2. Crie uma conta e adicione um pequeno crédito (USD 5 dura meses para uso pessoal)
  3. Vá a Definições > Chaves API e crie uma chave
  4. Copie a chave — parece-se com sk-or-v1-abc123...

Cole isto no instalador quando pedir a sua chave de API.

Passo 5: a sua primeira conversa

Assim que o instalador terminar (mostra "Installation complete!"), abra Telegram no seu telemóvel, encontre o seu bot pelo nome de utilizador e envie-lhe uma mensagem. O seu agente de IA pessoal responde diretamente no Telegram.

É tudo. Sem separadores de browser, sem iniciar sessão, sem mudar de aplicações — apenas Telegram, que já tem.

E quando algo corre mal?

Se o instalador encontrar um problema, para e mostra uma mensagem de erro clara. O painel k-claw (no website) mostra o estado da sua instalação em tempo real. Problemas comuns:

  • Chave de licença não aceite: Verifique erros de digitação, ou copie-cole diretamente do seu painel
  • Erro de chave API: Verifique se tem créditos no OpenRouter e se a chave está correta
  • Bot não responde: Certifique-se de que enviou o seu ID de utilizador Telegram corretamente durante a configuração

Para qualquer outra coisa, o sistema de cursos k-claw inclui um módulo de resolução de problemas com soluções passo a passo para cada problema comum. Não está sozinho.

Manutenção mensal

Após a configuração inicial, OpenClaw funciona automaticamente. O instalador k-claw configura atualizações de segurança automáticas e reinícios automáticos se o serviço alguma vez falhar. A sua "manutenção" mensal é aproximadamente zero minutos de trabalho real.

Uma vez por mês, pode querer verificar que tudo está a correr enviando ao seu bot /status. Isso é genuinamente todo o trabalho técnico necessário.

Ready to follow along? Install OpenClaw now.

k-claw's guided courses walk you through every step. The automated installer does the heavy lifting.

Get started