> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Upstash Box

Esegui un Gateway OpenClaw persistente su Upstash Box, un ambiente Linux gestito
con supporto del ciclo di vita keep-alive.

Usa un tunnel SSH per l'accesso al dashboard. Non esporre direttamente la porta del Gateway
a Internet pubblico.

## Prerequisiti

* Account Upstash
* Upstash Box keep-alive
* Client SSH sulla tua macchina locale

## Creare un Box

Crea un Box keep-alive nella Console Upstash. Prendi nota dell'ID del Box, ad esempio
`right-flamingo-14486`, e della chiave API del tuo Box.

Upstash mantiene la procedura dettagliata corrente per OpenClaw Box in
[Configurazione di OpenClaw](https://upstash.com/docs/box/guides/openclaw-setup).

## Connettersi con un tunnel SSH

Inoltra la porta del dashboard OpenClaw alla tua macchina locale. Usa la chiave API del tuo Box
come password SSH quando richiesto:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
ssh -o ServerAliveInterval=15 -o ServerAliveCountMax=3 -L 18789:127.0.0.1:18789 <box-id>@us-east-1.box.upstash.com
```

Le opzioni keepalive riducono le interruzioni del tunnel inattivo durante l'onboarding.

## Installare OpenClaw

All'interno del Box:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
sudo npm install -g openclaw
```

## Eseguire l'onboarding

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --install-daemon
```

Segui le istruzioni. Copia l'URL del dashboard e il token al termine dell'onboarding.

## Avviare il Gateway

Configura il Gateway per la rete del Box e avvialo in background:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw config set gateway.bind lan
nohup openclaw gateway > gateway.log 2>&1 &
```

Con il tunnel SSH attivo, apri localmente l'URL del dashboard:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
http://127.0.0.1:18789/#token=<your-token>
```

## Riavvio automatico

Imposta questo comando come script di inizializzazione del Box, in modo che il Gateway si riavvii quando il Box
si avvia:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
nohup openclaw gateway > gateway.log 2>&1 &
```

## Risoluzione dei problemi

Se SSH si blocca durante l'onboarding, riconnettiti con una configurazione SSH pulita e
keepalive:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
ssh -F /dev/null -o ControlMaster=no -o ServerAliveInterval=15 -o ServerAliveCountMax=3 -L 18789:127.0.0.1:18789 <box-id>@us-east-1.box.upstash.com
```

Questo evita impostazioni locali `~/.ssh/config` obsolete e mantiene attivo il tunnel
durante periodi di inattività della rete.

## Correlati

* [Accesso remoto](/it/gateway/remote)
* [Sicurezza del Gateway](/it/gateway/security)
* [Aggiornare OpenClaw](/it/install/updating)