Download da Imagem do Sistema

Acesse o repositório oficial de releases do Ubuntu (https://releases.ubuntu.com/22.04/) e obtenha a imagem ISO do servidor. Neste guia, utilizaremos a versão ubuntu-22.04.5-live-server-amd64.iso como referência.

Provisionamento da Máquina Virtual no Hyper-V

Siga as etapas abaixo para configurar o ambiente virtualizado que hospedará o Ubuntu Server.

Inicialização do Assistente

• Abra o Gerenciador do Hyper-V a partir do menu Iniciar.
• No painel de ações à direita, selecione Novo e clique em Máquina Virtual.

Parâmetros de Configuração

Armazenamento e Mídia de Instalação

• Aloque 80 GB para o disco virtual rígido (VHDX), garantindo espaço suficiente para o sistema e futuras aplicações.
• Na etapa de instalação, marque a opção para instalar o sistema operacional a partir de um arquivo de imagem bootável.
• Selecione o arquivo ISO baixado anteriormente.

Nota: Caso a máquina virtual não inicie a partir da ISO, acesse as configurações da VM, vá em Segurança e desmarque a opção Habilitar Inicialização Segura. Verifique também se a virtualização (Intel VT-x ou AMD-V) está ativa no BIOS do host.

Instalação do Ubuntu Server

Durante o processo de instalação, navegue pelas telas com as seguintes seleções:

• Idioma: English
• Atualização: Continue without updating
• Teclado: English US → Done
• Tipo de Instalação: Ubuntu Server (padrão) → Done
• Rede: DHCP (padrão) → Done
• Proxy: Deixar vazio → Done
• Mirror: Manter padrão → Done
• Disco: Use an entire disk → Mover para Done
• Confirmação de Disco: Done → Confirm destructive action → Continue
• Perfil: Defina credenciais locais (ex: usuário sysadmin e senha sysadmin) → Done
• Ubuntu Pro: Skip for now → Continue
• SSH: Marque com a barra de espaço Install OpenSSH server → Done
• Snaps: Não selecione nenhum pacote adicional → Done

Pós-Instalação e Primeiro Acesso

1. Aguarde a conclusão do processo. Quando os logs pararem de rolar e exibirem subiquity/late/run:, a instalação terminou.
2. Selecione Reboot Now.
3. Atenção: Antes de pressionar Enter, acesse as configurações da VM no Hyper-V, vá na unidade de DVD e remova a ISO de instalação.
4. Após remover a mídia, confrime e pressione Enter para reiniciar.
5. Quando o terminal exibir DatesourceNone. Up X.XX seconds, pressione Enter e faça login com o usuário sysadmin.

Atualização e Configuração Inicial

Execute os comandos abaixo para atualizar os pacotes do sistema:

sudo apt update && sudo apt upgrade -y

Caso um prompt de configuração de pacote apareça perguntando quais serviços devem ser reiniciados, pressione a tecla Tab para selecionar OK e confirme com Enter.

Para definir a senha do usuário root (opcional):

sudo passwd root
# Insira a nova senha para o root

Reinicie o sistema para aplicar todas as atualizações de kernel:

sudo reboot

Instalação de Dependências

Utilize o comando ip a para descobrir o IP da máquina e conecte-se via um cliente SSH (como PuTTY ou MobaXterm) para facilitar a cópia de comandos.

Node.js

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v && npm -v

Git

sudo apt install git -y

Docker

sudo apt install docker.io -y
sudo systemctl enable --now docker

Playwright

sudo npm install -g playwright
sudo npx playwright install

Implantação do OpenClaw

Instale e configure a ferramenta com os seguintes passos:

sudo npm install -g openclaw
sudo openclaw onboard --install-daemon
OPENCLAW_INSECURE_CONTROL_UI=true openclaw gateway -p 18789
openclaw tui

Se a interface web exibir o erro unauthorized: gateway token missing, copie o valor de gateway.auth.token do arquivo de configuração openclaw.json e cole-o na aba de configurações da interface (Overview → Gateway Token → Connect).

Habilitando Acesso Externo à Interface Web

Por padrão, o gateway bloqueia conexões externas (bind em loopback). Para acessar a interface a partir da máquina host ou de outras estações, edite o arquivo openclaw.json.

Altere a seção de gateway da seguinte forma:

"gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "controlUi": {
      "allowedOrigins": ["*"]
    }
}

A mudança de loopback para lan permite o tráfego de rede local. Manter o allowedOrigins com o curinga "*" resolve problemas de status "Offline" ou falhas de comunicação causadas por restrições de origem cruzada (CORS) entre a interface web e o gateway.