Installazione di OpenClaw

OpenClaw è distribuito come pacchetto npm. Puoi installarlo globalmente e avere un agente AI funzionante in meno di 5 minuti — oppure salta la configurazione e distribuisci con Clawly.

Non sei tecnico o semplicemente non vuoi la seccatura?

Clawly è una piattaforma hosted che distribuisce e gestisce il tuo agente OpenClaw al posto tuo — niente terminale, niente server, niente Docker. Scegli un piano, collega i tuoi canali e sei online in pochi secondi.

Prova Clawly

> Prerequisiti

Prima di installare OpenClaw, assicurati di avere:

  • ✓ Node.js 22 o successivo. OpenClaw utilizza funzionalità JavaScript moderne che richiedono Node 22+. Controlla la tua versione con node --version.
  • ✓ Una chiave API di un provider AI. Ti servirà una chiave da Anthropic (Claude), OpenAI (GPT), Google (Gemini) o un altro provider supportato.
  • ✓ Un token bot di una piattaforma di messaggistica. Crea un bot Telegram tramite @BotFather o un bot Discord nel Developer Portal.
  • ✓ Un server (per il funzionamento 24/7). Qualsiasi VPS, VM cloud o macchina sempre accesa. Un server da 5$/mese è sufficiente per un singolo agente.

> Installazione

Installa OpenClaw globalmente tramite npm:

npm install -g openclaw

Verifica l'installazione:

openclaw --version

> Configurazione

OpenClaw utilizza un file .env per la configurazione. Crea una directory di lavoro e inizializzala:

mkdir my-agent && cd my-agent
openclaw init

Questo crea un file .env con le variabili necessarie. Come minimo, dovrai impostare:

# AI Provider
ANTHROPIC_API_KEY=sk-ant-...

# Telegram (optional)
TELEGRAM_BOT_TOKEN=123456:ABC-...

# Discord (optional)
DISCORD_BOT_TOKEN=MTIz...

# Agent personality
AGENT_NAME=MyAgent
AGENT_SYSTEM_PROMPT="You are a helpful assistant."

Devi configurare solo i canali che intendi utilizzare. OpenClaw supporta Telegram, Discord, WhatsApp, Signal, Slack, iMessage e altri ancora — basta aggiungere il token corrispondente.

> Avvio dell'agente

Avvia l'agente con il comando gateway:

openclaw gateway

L'agente si connette ai canali configurati e inizia ad ascoltare i messaggi. Vedrai un output simile a:

[OpenClaw] Agent "MyAgent" starting...
[OpenClaw] Telegram connected
[OpenClaw] Discord connected
[OpenClaw] Ready — listening on 2 channels

Per distribuzioni in produzione, usa un process manager come pm2 o Docker per mantenere l'agente in esecuzione:

# With pm2
pm2 start "openclaw gateway" --name my-agent

# With Docker
docker run -d --env-file .env --name my-agent openclaw-agent

> Problemi comuni

"Error: Node.js version too old"

OpenClaw richiede Node.js 22+. Usa nvm install 22 o scaricalo dal sito ufficiale di Node.js.

"Telegram polling conflict"

Questo succede se un altro processo sta già effettuando il polling sullo stesso token bot. Arresta le altre istanze o usa un token bot diverso.

"API rate limit exceeded"

Il tuo provider AI sta limitando le richieste. Controlla i limiti di frequenza del tuo piano e valuta un upgrade o l'aggiunta di una coda per le richieste.

Troppa configurazione?

Clawly gestisce l'installazione, l'hosting, il monitoraggio e gli aggiornamenti al posto tuo. Scegli un piano, collega i tuoi canali e il tuo agente è online in pochi secondi.

Distribuisci senza complicazioni