exe.dev

Objetivo: Gateway do OpenClaw em execução em uma VM da exe.dev, acessível em https://<vm-name>.exe.xyz. Este guia pressupõe a imagem padrão exeuntu da exe.dev. Adapte os pacotes conforme necessário em outras distribuições.

O que você precisa

Conta da exe.dev
Acesso via ssh exe.dev às VMs da exe.dev (opcional, para configuração manual)

Caminho rápido para iniciantes

Abra https://exe.new/openclaw
Preencha sua chave/token de autenticação conforme necessário
Clique em “Agent” ao lado da sua VM e aguarde Shelley concluir o provisionamento
Abra https://<vm-name>.exe.xyz/ e autentique-se com o segredo compartilhado configurado (autenticação por token por padrão; a autenticação por senha também funciona se você alterar gateway.auth.mode)
Aprove as solicitações pendentes de pareamento de dispositivos com openclaw devices approve <requestId>

Instalação automatizada com Shelley

Shelley, o agente da exe.dev, pode instalar o OpenClaw a partir de um prompt:

Configure o OpenClaw (https://docs.openclaw.ai/install) nesta VM. Use os sinalizadores de modo não interativo e de aceitação de risco no processo de integração do OpenClaw. Adicione a autenticação ou o token fornecido conforme necessário. Configure o nginx para encaminhar da porta padrão 18789 para o local raiz na configuração padrão de site habilitada, certificando-se de habilitar o suporte a WebSocket. O pareamento é feito com "openclaw devices list" e "openclaw devices approve <request id>". Certifique-se de que o painel mostre que a integridade do OpenClaw está OK. A exe.dev gerencia para nós o encaminhamento da porta 8000 para as portas 80/443 e o HTTPS, portanto o endereço "acessível" final deve ser <vm-name>.exe.xyz, sem especificação de porta.

Instalação manual

Criar a VM

No seu dispositivo:

ssh exe.dev new

Em seguida, conecte-se:

ssh <vm-name>.exe.xyz

Mantenha esta VM com estado persistente. O OpenClaw armazena openclaw.json, arquivos auth-profiles.json por agente, sessões e o estado de canais/provedores em ~/.openclaw/, além do espaço de trabalho em ~/.openclaw/workspace/.

Instalar os pré-requisitos (na VM)

sudo apt-get update
sudo apt-get install -y git curl jq ca-certificates openssl

Instalar o OpenClaw

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

Configurar o nginx como proxy para a porta 8000

Edite /etc/nginx/sites-enabled/default:

server {
    listen 80 default_server;
    listen [::]:80 default_server;
    listen 8000;
    listen [::]:8000;

    server_name _;

    location / {
        proxy_pass http://127.0.0.1:18789;
        proxy_http_version 1.1;

        # Suporte a WebSocket
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        # Cabeçalhos padrão do proxy
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;

        # Configurações de tempo limite para conexões de longa duração
        proxy_read_timeout 86400s;
        proxy_send_timeout 86400s;
    }
}

Sobrescreva os cabeçalhos de encaminhamento em vez de preservar cadeias fornecidas pelo cliente. O OpenClaw confia nos metadados de IP encaminhados somente quando provenientes de proxies configurados explicitamente, e cadeias X-Forwarded-For com anexação são tratadas como um risco de proteção.

Acessar o OpenClaw e aprovar dispositivos

Abra https://<vm-name>.exe.xyz/ (consulte a saída da interface de controle durante a integração). Se uma autenticação for solicitada, cole o segredo compartilhado configurado na VM.Este guia usa autenticação por token por padrão; portanto, obtenha gateway.auth.token com openclaw config get gateway.auth.token ou gere um novo com openclaw doctor --n. Se você alterou o Gateway para autenticação por senha, use gateway.auth.password / OPENCLAW_GATEWAY_PASSWORD.Aprove dispositivos com openclaw devices list e openclaw devices approve <requestId>. Em caso de dúvida, use Shelley no navegador.

Configuração remota de canais

Para hosts remotos, prefira uma única chamada config patch em vez de várias chamadas SSH para config set. Mantenha os tokens reais no ambiente da VM ou em ~/.openclaw/.env e coloque somente SecretRefs em openclaw.json. Consulte Gerenciamento de segredos para ver o contrato completo de SecretRef. Na VM, faça com que o ambiente do serviço contenha os segredos necessários:

cat >> ~/.openclaw/.env <<'EOF'
SLACK_BOT_TOKEN=xoxb-...
SLACK_APP_TOKEN=xapp-...
DISCORD_BOT_TOKEN=...
OPENAI_API_KEY=sk-...
EOF

Na sua máquina local, crie um arquivo de patch e envie-o por pipe para a VM:

// openclaw.remote.patch.json5
{
  secrets: {
    providers: {
      default: { source: "env" },
    },
  },
  channels: {
    slack: {
      enabled: true,
      mode: "socket",
      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
      appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },
      groupPolicy: "open",
      requireMention: false,
    },
    discord: {
      enabled: true,
      token: { source: "env", provider: "default", id: "DISCORD_BOT_TOKEN" },
      dmPolicy: "disabled",
      dm: { enabled: false },
      groupPolicy: "allowlist",
    },
  },
  agents: {
    defaults: {
      model: { primary: "openai/gpt-5.6-sol" },
      models: {
        "openai/gpt-5.6-sol": { params: { fastMode: true } },
      },
    },
  },
}

ssh <vm-name>.exe.xyz 'openclaw config patch --stdin --dry-run' < ./openclaw.remote.patch.json5
ssh <vm-name>.exe.xyz 'openclaw config patch --stdin' < ./openclaw.remote.patch.json5
ssh <vm-name>.exe.xyz 'openclaw gateway restart && openclaw health'

Use --replace-path quando uma lista de permissões aninhada precisar se tornar exatamente o valor do patch, por exemplo, ao substituir a lista de permissões de um canal do Discord:

ssh <vm-name>.exe.xyz 'openclaw config patch --stdin --replace-path "channels.discord.guilds[\"123\"].channels"' < ./discord.patch.json5

Consulte Discord e Slack para ver a referência completa de configuração dos canais.

Acesso remoto

A exe.dev gerencia a autenticação do acesso remoto. Por padrão, o tráfego HTTP da porta 8000 é encaminhado para https://<vm-name>.exe.xyz com autenticação por e-mail.

Atualização

openclaw update

Consulte Atualização para ver como alternar canais e realizar a recuperação manual.

Install overview

Maintenance

Containers

Hosting

Advanced setup

O que você precisa

Caminho rápido para iniciantes

Instalação automatizada com Shelley

Instalação manual

Configuração remota de canais

Acesso remoto

Atualização

Relacionados

​O que você precisa

​Caminho rápido para iniciantes

​Instalação automatizada com Shelley

​Instalação manual

​Configuração remota de canais

​Acesso remoto

​Atualização

​Relacionados

O que você precisa

Caminho rápido para iniciantes

Instalação automatizada com Shelley

Instalação manual

Configuração remota de canais

Acesso remoto

Atualização

Relacionados