Guida Rapida

Installa e configura OpenClaw sul tuo computer in pochi minuti.

Prerequisiti

Requisiti di sistema

  • Node.js 22 o superiore
  • Sistema operativo: macOS, Linux, o Windows con WSL2
  • Chiave API Brave Search (consigliata per funzionalità web)

Nota per utenti Windows

OpenClaw richiede WSL2 (Windows Subsystem for Linux) con Ubuntu. Il supporto nativo Windows è limitato. Segui la guida Microsoft per installare WSL2.

Opzioni di Avvio Rapido

OpenClaw offre due modi veloci per iniziare:

1. Via Browser (senza setup)

Esegui il comando e apri la dashboard nel browser

openclaw dashboard

Oppure visita http://127.0.0.1:18789/

2. Wizard di Onboarding

Consigliato

Configurazione guidata completa

openclaw onboard

Installazione

Metodo 1: Script di installazione (consigliato)

Il modo più veloce per installare OpenClaw:

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

Metodo 2: npm

npm install -g openclaw@latest

Metodo 3: pnpm

pnpm add -g openclaw@latest

Metodo 4: Da sorgente (per sviluppatori)

Per chi vuole modificare o contribuire al codice:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build

Configurazione con l'Onboarding Wizard

Il wizard di onboarding ti guiderà attraverso la configurazione di:

  • 1
    Gateway locale o remoto

    Scegli dove eseguire il gateway di OpenClaw

  • 2
    Autenticazione

    Configura le chiavi API (Anthropic consigliato)

  • 3
    Canali di comunicazione

    WhatsApp, Telegram, Discord, Mattermost

  • 4
    Servizio in background

    Configurazione systemd (Linux) o launchd (macOS)

Avvia il wizard con l'installazione del daemon:

openclaw onboard --install-daemon

Configurazione API Keys

Le credenziali vengono salvate nella directory ~/.openclaw/.

Chiave API Anthropic (Claude)

Ottieni la tua chiave API dal Console Anthropic

export ANTHROPIC_API_KEY=sk-ant-...

Chiave API Brave Search (opzionale)

Per le funzionalità di ricerca web, ottieni una chiave da Brave Search API

export BRAVE_API_KEY=BSA...

Verifica dell'Installazione

Dopo l'installazione, verifica che tutto funzioni correttamente:

openclaw status

Per un controllo più approfondito:

openclaw health

Connessione dei Canali Chat

WhatsApp

openclaw channels login whatsapp

Scansiona il codice QR con l'app WhatsApp per collegare il tuo account.

Telegram

Configura il token del bot nel file di configurazione:

openclaw channels login telegram

Discord

Aggiungi il token del bot Discord:

openclaw channels login discord

Avvio del Gateway

Per avviare il gateway manualmente (per sviluppo):

node openclaw.mjs gateway --port 18789 --verbose

Suggerimento

Per un uso quotidiano, usa openclaw onboard --install-daemon per configurare l'avvio automatico del servizio.

Approvazione Dispositivi

Quando ricevi un messaggio diretto da un dispositivo non conosciuto, OpenClaw richiede l'approvazione tramite un codice breve di pairing.

Questo garantisce che solo i dispositivi autorizzati possano comunicare con il tuo assistente.

Prossimi Passi