> ## 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.

# Ambiente di esecuzione della VM Docker

Passaggi di runtime condivisi per installazioni Docker basate su VM, come GCP, Hetzner e provider VPS simili.

## Integra i binari richiesti nell'immagine

Installare binari dentro un container in esecuzione è una trappola.
Qualsiasi cosa installata a runtime andrà persa al riavvio.

Tutti i binari esterni richiesti dalle skills devono essere installati al momento della build dell'immagine.

Gli esempi sotto mostrano solo tre binari comuni:

* `gog` (da `gogcli`) per l'accesso a Gmail
* `goplaces` per Google Places
* `wacli` per WhatsApp

Questi sono esempi, non un elenco completo.
Puoi installare tutti i binari necessari usando lo stesso pattern.

Se in seguito aggiungi nuove skills che dipendono da binari aggiuntivi, devi:

1. Aggiornare il Dockerfile
2. Ricostruire l'immagine
3. Riavviare i container

**Dockerfile di esempio**

```dockerfile theme={"theme":{"light":"min-light","dark":"min-dark"}}
FROM node:24-bookworm

RUN apt-get update && apt-get install -y socat && rm -rf /var/lib/apt/lists/*

# Example binary 1: Gmail CLI (gogcli — installs as `gog`)
# Copy the current Linux asset URL from https://github.com/steipete/gogcli/releases
RUN curl -L https://github.com/steipete/gogcli/releases/latest/download/gogcli_linux_amd64.tar.gz \
  | tar -xzO gog > /usr/local/bin/gog; \
  chmod +x /usr/local/bin/gog

# Example binary 2: Google Places CLI
# Copy the current Linux asset URL from https://github.com/steipete/goplaces/releases
RUN curl -L https://github.com/steipete/goplaces/releases/latest/download/goplaces_linux_amd64.tar.gz \
  | tar -xzO goplaces > /usr/local/bin/goplaces; \
  chmod +x /usr/local/bin/goplaces

# Example binary 3: WhatsApp CLI
# Copy the current Linux asset URL from https://github.com/steipete/wacli/releases
RUN curl -L https://github.com/steipete/wacli/releases/latest/download/wacli-linux-amd64.tar.gz \
  | tar -xzO wacli > /usr/local/bin/wacli; \
  chmod +x /usr/local/bin/wacli

# Add more binaries below using the same pattern

WORKDIR /app
COPY package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc ./
COPY ui/package.json ./ui/package.json
COPY scripts ./scripts

RUN corepack enable
RUN pnpm install --frozen-lockfile

COPY . .
RUN pnpm build
RUN pnpm ui:install
RUN pnpm ui:build

ENV NODE_ENV=production

CMD ["node","dist/index.js"]
```

<Note>
  Gli URL sopra sono esempi. Per VM basate su ARM, scegli gli asset `arm64`. Per build riproducibili, fissa URL di release con versione.
</Note>

## Build e avvio

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
docker compose build
docker compose up -d openclaw-gateway
```

Se la build fallisce con `Killed` o `exit code 137` durante `pnpm install --frozen-lockfile`, la VM ha esaurito la memoria.
Usa una classe di macchina più grande prima di riprovare.

Verifica i binari:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
docker compose exec openclaw-gateway which gog
docker compose exec openclaw-gateway which goplaces
docker compose exec openclaw-gateway which wacli
```

Output previsto:

```
/usr/local/bin/gog
/usr/local/bin/goplaces
/usr/local/bin/wacli
```

Verifica il Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
docker compose logs -f openclaw-gateway
```

Output previsto:

```
[gateway] listening on ws://0.0.0.0:18789
```

## Cosa persiste e dove

OpenClaw viene eseguito in Docker, ma Docker non è la fonte di verità.
Tutto lo stato a lunga durata deve sopravvivere a riavvii, rebuild e reboot.

| Componente                        | Posizione                                              | Meccanismo di persistenza | Note                                                                                         |
| --------------------------------- | ------------------------------------------------------ | ------------------------- | -------------------------------------------------------------------------------------------- |
| Configurazione Gateway            | `/home/node/.openclaw/`                                | Mount di volume host      | Include `openclaw.json`, `.env`                                                              |
| Profili di autenticazione modello | `/home/node/.openclaw/agents/`                         | Mount di volume host      | `agents/<agentId>/agent/auth-profiles.json` (OAuth, chiavi API)                              |
| Chiave profilo di autenticazione  | `/home/node/.config/openclaw/`                         | Mount di volume host      | Chiave di crittografia locale per il materiale dei token del profilo di autenticazione OAuth |
| Configurazioni Skill              | `/home/node/.openclaw/skills/`                         | Mount di volume host      | Stato a livello di Skill                                                                     |
| Workspace agente                  | `/home/node/.openclaw/workspace/`                      | Mount di volume host      | Codice e artefatti dell'agente                                                               |
| Sessione WhatsApp                 | `/home/node/.openclaw/`                                | Mount di volume host      | Preserva il login QR                                                                         |
| Keyring Gmail                     | `/home/node/.openclaw/`                                | Volume host + password    | Richiede `GOG_KEYRING_PASSWORD`                                                              |
| Pacchetti Plugin                  | `/home/node/.openclaw/npm`, `/home/node/.openclaw/git` | Mount di volume host      | Root dei pacchetti Plugin scaricabili                                                        |
| Binari esterni                    | `/usr/local/bin/`                                      | Immagine Docker           | Devono essere integrati al momento della build                                               |
| Runtime Node                      | Filesystem del container                               | Immagine Docker           | Ricostruito a ogni build dell'immagine                                                       |
| Pacchetti del sistema operativo   | Filesystem del container                               | Immagine Docker           | Non installare a runtime                                                                     |
| Container Docker                  | Effimero                                               | Riavviabile               | Sicuro da eliminare                                                                          |

## Aggiornamenti

Per aggiornare OpenClaw sulla VM:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
git pull
docker compose build
docker compose up -d
```

## Correlati

* [Docker](/it/install/docker)
* [Podman](/it/install/podman)
* [ClawDock](/it/install/clawdock)