Como instalar e configurar manualmente o OpenClaw na VPS

O OpenClaw, também conhecido como ClawdBot ou MoltBot pode ser usado se você tem uma VPS só com sistema operacional AlmaLinux 9 ou Ubuntu 24.04 LTS e tem conhecimento técnico de comandos no terminal. 

Caso contrário, recomendamos instalar a aplicação diretamente pelo Portal do Cliente que automatiza todo o processo – Confira como fazer

A instalação manual envolve preparar o ambiente do servidor, baixar os arquivos necessários e realizar a configuração inicial do modelo de inteligência artificial.

Confira abaixo:

• Etapa 1: Instalar Docker
• Etapa 2: Preparar o ambiente da aplicação
• Etapa 3: Configurar o cliente OpenClaw
• Etapa 4: Configurar o modelo de Inteligência Artificial
• Solução de problemas

Etapa 1: Instalar Docker 

O ClawdBot é executado em containers Docker. Portanto, o primeiro passo é verificar se o Docker já está instalado no servidor.

1No terminal, digite o comando:

docker –version 

Se o Docker estiver instalado, o terminal exibirá a versão disponível.

Caso o Docker não esteja instalado, execute o comando abaixo para instalar:

curl -fsSL https://get.docker.com | sh

2Após a instalação, inicie o Docker, digite o comando:

systemctl start docker

3Após concluir, siga para a Etapa 2

Etapa 2: Preparar o ambiente da aplicação 

1Agora será necessário criar o diretório onde o ClawdBot será instalado, no terminal, digite o comando:

mkdir -p /docker/openclaw && cd /docker/openclaw

2O OpenClawd utiliza um token de autenticação (código de segurança usado para validar o acesso ao sistema) para acesso ao gateway (serviço responsável por permitir a comunicação com o sistema).

Esse token será gerado automaticamente com o comando abaixo:

echo -e "PORT=47716\nCLAWDBOT_GATEWAY_TOKEN=$(openssl rand -hex 32)" > /docker/openclaw/.env && cat /docker/openclaw/.env

3Em seguida, salve o token gerado - ele será utilizado posteriormente para acessar ao painel do OpenClaw

4Agora, baixe os arquivos do projeto diretamente do repositório, para isso digite os dois comandos:

• Arquivo docker-compose.yml:

  • wget https://raw.githubusercontent.com/openclaw/openclaw/main/docker-compose.yml

• Arquivo Dockerfile:

  • wget https://raw.githubusercontent.com/openclaw/openclaw/main/Dockerfile 

5Após baixar os arquivos, crie a imagem gerada no Dockerfile, digite:

docker compose build --no-cache

6Com a imagem criada, inicie o ambiente do ClawdBot:

docker compose up –d

7Agora, siga para a Etapa 3

Etapa 3: Configurar o cliente OpenClaw 

Para facilitar a execução dos comandos do ClawdBot, é necessário criar um cliente local, confira como fazer:

1Crie o arquivo de acesso, digite:

/usr/local/bin/openclaw

2Adicione o seguinte conteúdo no arquivo:

#!/usr/bin/env bash 
set -euo pipefail 
 
CTR="moltbot-clawdbot-1" 
BIN="/app/node_modules/.pnpm/node_modules/.bin/clawdbot" 
 
exec docker exec -it \ 
  -u node \ 
  -e HOME=/home/node \ 
  -e XDG_CONFIG_HOME=/home/node/.clawdbot \ 
  "$CTR" "$BIN" "$@"

3Agora conceda permissão de execução ao arquivo:

chmod +x /usr/local/bin/openclaw

4Para verificar se o cliente foi configurado corretamente, digite:

openclaw status

Se tudo estiver correto, o comando retornará o status do serviço.

Etapa 4: Configurar o modelo de Inteligência Artificial 

Com o ambiente funcionando, o próximo passo é configurar o modelo de IA que será utilizado pelo ClawdBot:

1No terminal execute  o processo de configuração inicial do ClawBot:

clawbot onboard

2Em seguida, selecione a opção QuickStart

3Agora, selecione o provedor de IA – Por exemplo OpenAI, Gemini, etc).

4Escolha o método de autenticação - Por exemplo, se você escolheu OpenAI, selecione OpenAI API Key (chave de acesso ao serviço da OpenAI).

5Em seguida, selecione o modelo desejado

6Opcionalmente, configure os canais de comunicação que poderão interagir com o ClawdBot – Por exemplo Telegram, WhatsApp, Discord etc

7Após selecionar o modelo, será necessário inserir o token de autenticação do provedor de IA, digite:

openclaw models auth paste-token --provider NOME_PROVIDER

Substitua NOME_PROVIDER pelo provedor utilizado.

8Após finalizar, o acesso ao OpenClaw já será possível através da URL com o token gerado na etapa 2

Formato da URL:

http://IP:47716/?token=TOKEN

Para gerar essa URL automaticamente, execute:

echo "http://$(hostname -I | cut -d' ' -f1| tr -d '\n'):47716/?token=$(grep '^CLAWDBOT_GATEWAY_TOKEN=' /docker/openclaw/.env | cut -d= -f2| tr -d '\n')"

Esse comando exibirá diretamente o endereço completo de acesso.

Solução de problemas 

A seguir estão alguns erros comuns e como corrigi-los:

Erro de Gateway: allowInsecureAuth = false

Se ocorrer um erro relacionado ao parâmetro allowInsecureAuth, será necessário alterar a configuração do gateway.

1Primeiro obtenha o valor do parâmetro HASH, digite no terminal:

gateway call config.get --params '{}'

2Em seguida, copie o valor de HASH que aparece

3Após, digite o comando abaixo, substituindo HASH pelo valor obtido:

gateway call config.patch --params '{ 
   "raw": "{\n  \"gateway\": {\n    \"controlUi\": {\n      \"allowInsecureAuth\": true\n    }\n  }\n}", 
   "baseHash": "HASH" 
}'

Erro de Gateway (loop de reinício)

Esse erro ocorre quando o parâmetro gateway.mode não está definido. Nesse cenário, o container do Docker entra em loop de reinicialização.

Para corrigir: 

1Abra o arquivo docker-compose.yml em modo de edição

2Na seção environment, adicione a seguinte linha:

 GATEWAY_MODE=local

Por exemplo:

3Em seguida, basta reiniciar o container, digite:

docker compose down 
docker compose up -d

Pronto! Após concluir essas etapas, o OpenClaw estará instalado e pronto para uso na sua VPS, permitindo automatizar tarefas e integrar agentes de inteligência artificial ao ambiente do seu servidor