Inizia a usare OpenClaw su Lightsail - Amazon Lightsail

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Inizia a usare OpenClaw su Lightsail

OpenClaw è un gateway di chat basato sull'intelligenza artificiale che funziona su Amazon Lightsail, che ti offre un assistente AI privato e ospitato autonomamente accessibile dal tuo browser, Telegram e altro ancora. WhatsApp Questo tutorial illustra come avviare un'istanza OpenClaw Amazon Lightsail, associare il browser, abilitare le funzionalità di intelligenza artificiale e, facoltativamente, connettere i canali di messaggistica.

Lo sapevi?

La tua istanza OpenClaw Lightsail è preconfigurata con Amazon Bedrock come provider di modelli AI predefinito. Una volta completata la configurazione, puoi iniziare subito a chattare con il tuo assistente AI, senza bisogno di configurazioni aggiuntive.

Passaggio 1: crea un'istanza OpenClaw

In questo passaggio, crei un'istanza Lightsail in esecuzione. OpenClaw

Per creare un'istanza Lightsail con OpenClaw
  1. Accedi alla console Lightsail.

  2. Nella sezione Istanze della home page di Lightsail, scegli Crea istanza.

  3. Scegli la AWS regione e la zona di disponibilità per la tua istanza.

  4. Scegli l'immagine per la tua istanza come segue:

    • In Seleziona una piattaforma, scegli Linux/Unix.

    • In Seleziona un progetto, scegli. OpenClaw

    Seleziona il OpenClaw blueprint.
  5. In Scegli il tuo piano di istanza, seleziona un piano di istanza (si consiglia un piano di memoria da 4 GB per prestazioni ottimali).

  6. Inserisci un nome per l'istanza o usa il nome predefinito fornito.

    Nota

    I nomi delle istanze devono essere unici all'interno del tuo account Lightsail, da 2 a 255 caratteri, iniziare e terminare con un carattere alfanumerico e contenere solo caratteri alfanumerici, punti, trattini o caratteri di sottolineatura.

  7. Seleziona Crea istanza.

L'istanza rimarrà in uno stato iniziale per alcuni minuti durante l'avvio. Attendi che lo stato mostri Running (In esecuzione) prima di procedere al passaggio successivo.

Passo 2: Associa il tuo browser a OpenClaw

Prima di poter utilizzare la OpenClaw dashboard, devi associare il browser a OpenClaw. Questo crea una connessione sicura tra la sessione del browser e OpenClaw.

Suggerimento

Tieni il browser pronto sullo stesso dispositivo che utilizzerai per accedere alla OpenClaw dashboard. Copierai un token da Lightsail e lo incollerai nella dashboard durante questo OpenClaw passaggio.

L'indirizzo IP pubblico predefinito per l' OpenClaw istanza cambia se l'istanza viene interrotta e avviata. Quando colleghi un indirizzo IP statico alla tua istanza, questo rimane invariato anche se interrompi e avvii l'istanza. Per ulteriori informazioni, consulta Visualizzare e gestire gli indirizzi IP per le risorse Lightsail.

Per associare il browser a OpenClaw
  1. Nella sezione Istanze della console Lightsail, scegli il nome dell'istanza per aprire la pagina di OpenClaw gestione dell'istanza.

  2. Nella scheda Guida introduttiva, in Associa il tuo browser a OpenClaw, scegli Connect using SSH. Si apre un terminale SSH basato su browser.

    La scheda OpenClaw Guida introduttiva.
  3. Nel terminale SSH, individua l'URL della dashboard visualizzato nel messaggio di benvenuto. Copia questo URL e aprilo in una nuova scheda del browser.

    Associazione di un dispositivo con OpenClaw
  4. Nella OpenClaw dashboard che si apre, individua il campo Gateway Token.

  5. Tornando al terminale SSH, copia il token di accesso visualizzato.

  6. Incolla il token di accesso copiato nel campo Gateway Token della OpenClaw dashboard, quindi fai clic su Connect.

    Inserimento di un token per il OpenClaw Gateway.
  7. Ritorna al terminale SSH. Quando richiesto, premi y per continuare con l'associazione del dispositivo.

  8. Premi a per approvare la richiesta di associazione del dispositivo.

Una volta completata l'associazione, lo stato nella OpenClaw dashboard mostrerà OK. Il tuo browser è ora connesso alla tua OpenClaw istanza.

Il browser è connesso correttamente al OpenClaw Gateway.
Suggerimento

Se hai bisogno di associare un altro browser in un secondo momento, inserisci nuovamente l'istanza tramite SSH e ripeti i passaggi di associazione precedenti.

Fase 3: abilitare le funzionalità di intelligenza artificiale con Amazon Bedrock

La tua istanza OpenClaw Lightsail è configurata per utilizzare Amazon Bedrock per alimentare il suo assistente AI. In questo passaggio, concederai all'istanza le autorizzazioni necessarie per chiamare l'API Bedrock.

Per abilitare l'accesso all'API Bedrock
  1. Nella pagina di gestione dell' OpenClaw istanza, scegli la scheda Guida introduttiva.

  2. In Abilita Amazon Bedrock come fornitore di modelli, fai clic sul pulsante Copia lo script. Quindi fai clic sul CloudShell pulsante Avvia per CloudShell aprirlo.

    Copia lo script Bedrock per la creazione di ruoli IAM.
  3. Incolla lo script copiato nel CloudShell terminale e premi. Enter

  4. Attendi il completamento dello script. Quando vedi Fine nell'output, le autorizzazioni sono state applicate correttamente.

Suggerimento

Lo script crea un ruolo IAM e allega una policy che concede all' OpenClaw istanza l'accesso all'API Amazon Bedrock. Puoi visualizzare e personalizzare questa policy IAM in qualsiasi momento nella console IAM.

Una volta completato questo passaggio, vai a Chat nella OpenClaw dashboard per iniziare a utilizzare il tuo assistente AI.

Nota: l'istanza OpenClaw Lightsail utilizza Anthropic Claude Sonnet 4.6 per impostazione predefinita. Se è la prima volta che utilizzi modelli Anthropic in Amazon Bedrock, dovrai completare il modulo First Time Use (FTU) per accedere. Scopri di più su come accedere ai modelli Anthropic.

Fase 4: Connect a un canale di messaggistica (opzionale)

Puoi continuare OpenClaw a lavorare con app di messaggistica come Telegram e WhatsApp interagire con il tuo assistente AI direttamente dal telefono o dal client di messaggistica. Prima di poterti connettere OpenClaw a un canale di messaggistica, devi associare il browser a OpenClaw (vedi Passaggio 2).

Connect Telegram

Per aggiungere un canale Telegram
  1. Apri Telegram e cerca. @BotFather

  2. Invia il comando /newbot e segui le istruzioni per creare un nuovo bot. BotFather fornirà un token bot e un deep link per il tuo bot.

    BotFather su Telegram.
  3. Connect alla propria OpenClaw istanza tramite SSH. Si apre un terminale SSH basato su browser.

  4. Nel terminale SSH collegato alla tua istanza, esegui OpenClaw :

    openclaw channels add
  5. Seleziona Telegram dall'elenco dei canali disponibili.

    Seleziona Telegram dal menu di selezione dei canali.
  6. Quando richiesto, inserisci il token bot che hai ricevuto BotFather nel passaggio 2.

  7. Nella OpenClaw dashboard, vai alla sezione Canali e aggiungi il tuo ID utente di Telegram all'elenco degli utenti consentiti.

    Consenti al bot di ricevere messaggi dal tuo ID Telegram.
  8. Testa l'integrazione inviando un messaggio al tuo bot in Telegram nel passaggio 2.

  9. Vedrai un messaggio in Telegram per approvare l'associazione. OpenClaw Nel terminale SSH, esegui:

    openclaw pairing approve telegram [pairing code]
    Telegram non è associato alla tua istanza OpenClaw
  10. Prova nuovamente l'integrazione inviando un messaggio al bot che hai creato in Telegram nel passaggio 2

    Telegram è associato alla tua istanza OpenClaw

Connect WhatsApp

Per aggiungere un WhatsApp canale
  1. Connect alla propria OpenClaw istanza tramite SSH. Si apre un terminale SSH basato su browser.

  2. Nel terminale SSH collegato alla tua istanza, esegui OpenClaw :

    openclaw channels add
  3. Seleziona WhatsAppdall'elenco dei canali disponibili.

  4. Seguire le istruzioni su schermo. Nel terminale verrà visualizzato un codice QR.

  5. Sul telefono WhatsApp, apri e usa la funzione Dispositivi collegati per scansionare il codice QR.

  6. Completa l'associazione sul telefono.

  7. Testa l'integrazione inviando un messaggio al tuo OpenClaw assistente direttamente WhatsApp inviando un messaggio al numero di contatto associato nei passaggi precedenti.

    WhatsApp è abbinato alla tua istanza OpenClaw

Passaggio 5: crea un'istantanea dell'istanza (opzionale)

Dopo aver completato la configurazione, ti consigliamo di creare un'istantanea dell'istanza. OpenClaw Le istantanee sono point-in-time backup che consentono di ripristinare l'istanza da uno stato ben noto, fornendo un meccanismo di ripristino affidabile. È inoltre possibile creare nuove istanze del piano desiderato partendo dalle istantanee.

Creazione di uno snapshot manuale
  1. Nella sezione Istanze della console Lightsail, scegli il nome dell'istanza. OpenClaw

  2. Selezionare la scheda Snapshots (Snapshot).

  3. In Istantanee manuali, scegli Crea istantanea.

  4. Inserisci un nome per l'istantanea e scegli Crea.

Lo sapevi?

Lightsail archivia sette istantanee giornaliere e sostituisce automaticamente le più vecchie con le più recenti quando abiliti le istantanee automatiche per la tua istanza. Per ulteriori informazioni, consulta Configurare le istantanee automatiche per le istanze e i dischi Lightsail.

Domande frequenti (FAQ)

Come faccio ad associare un browser aggiuntivo alla mia OpenClaw istanza?

Puoi associare tutti i browser di cui hai bisogno. Per associare nuovamente un nuovo browser, SSH all' OpenClaw istanza (dalla pagina di gestione delle istanze nella console Lightsail, scegli Connect using SSH). Segui gli stessi passaggi di associazione del Passaggio 2: accedi all'URL della dashboard, copia il token di accesso dal terminale, incollalo nel campo Gateway Token della OpenClaw dashboard del nuovo browser e approva la richiesta di associazione.

Posso personalizzare le autorizzazioni IAM concesse alla mia istanza? OpenClaw

Sì. Lo script di configurazione nella fase 3 crea un ruolo IAM con una policy che concede l'accesso ad Amazon Bedrock. Puoi visualizzare, modificare o limitare questa politica in qualsiasi momento:

  • Apri la console IAM e vai a Ruoli.

  • Trova il ruolo creato per la tua OpenClaw istanza, ad LightsailRoleFor-i-0d15d5483571b95bb es.

  • Scegli il ruolo per visualizzare le politiche allegate.

  • Scegli il nome della politica per modificarne le autorizzazioni.

Fai attenzione quando modifichi le autorizzazioni: la rimozione delle autorizzazioni Bedrock richieste OpenClaw impedirà la generazione di risposte AI. Per ulteriori informazioni, consulta le politiche IAM nella documentazione AWS.

Posso fare OpenClaw domande su se stesso, ad esempio cosa può fare o come usarlo?

Sì, OpenClaw l'assistente di chat integrato può rispondere a domande su OpenClaw se stesso. Se non sei sicuro di cosa OpenClaw puoi fare, chiedilo direttamente nell'interfaccia di chat. Ad esempio, puoi digitare:

  • «In cosa puoi aiutarmi?»

  • «A quali canali posso connettermi OpenClaw?»

  • «Come faccio ad aggiungere un nuovo canale di messaggistica?»

OpenClaw risponderà con indicazioni basate sulle sue capacità. Questo è un ottimo modo per esplorare le funzionalità senza uscire dalla OpenClaw dashboard.

Nota: dovrai completare il passaggio Abilita le funzionalità AI con Amazon Bedrock (Passaggio 3 della guida introduttiva) o configurare il tuo provider di modelli per far funzionare la chat. La configurazione di Bedrock prevede l'esecuzione di uno script con un clic dalla scheda Guida introduttiva dell'istanza per concedere le autorizzazioni necessarie e, se è la prima volta che utilizzi i modelli Anthropic, l'invio di un breve modulo First Time Use nella console Amazon Bedrock. Senza questo passaggio, l'interfaccia di chat non disporrà di un modello di intelligenza artificiale a cui connettersi.

Quanto costa utilizzare OpenClaw Lightsail?

Ecco una ripartizione dei costi:

  • Istanza Lightsail: paghi in base al piano di istanza selezionato (ad esempio il piano da 4 GB). I piani Lightsail vengono fatturati in base a una tariffa oraria su richiesta, quindi paghi solo per ciò che utilizzi. Per ogni piano Lightsail che utilizzi, ti addebitiamo il prezzo orario fisso, fino al costo massimo mensile del piano.

  • Utilizzo del modello di intelligenza artificiale (token): ogni messaggio inviato e ricevuto dall' OpenClaw assistente viene elaborato tramite Amazon Bedrock utilizzando un modello di prezzo basato su token. I costi variano in base al modello: alcuni modelli sono più costosi per token rispetto ad altri.

  • Abbonamenti a modelli di terze parti: se selezioni un modello di terze parti distribuito tramite AWS Marketplace (come Anthropic Claude o Cohere), potrebbero essere previsti costi software aggiuntivi oltre al costo per token. Questi vengono visualizzati come voci separate in AWS Marketplace nella fattura.

  • Eccedenze per il trasferimento dei dati: ogni piano Lightsail include un'indennità mensile per il trasferimento dei dati. Se l' OpenClaw istanza invia o riceve più dati di quelli inclusi nel piano, verranno addebitati costi aggiuntivi per il trasferimento dei dati in uscita.

  • Istantanee: le istantanee manuali e automatiche dell'istanza Lightsail vengono fatturate in base alla quantità di storage utilizzata.

Voglio usare un modello antropico. C'è qualcosa in più che devo fare?

Anthropic ha un requisito aggiuntivo oltre alle autorizzazioni standard: è necessario completare un modulo First Time Use (FTU) prima di richiamare un modello Anthropic per la prima volta. Si tratta di un requisito antropico e si applica una volta per account AWS o una volta a livello di account di gestione dell'organizzazione AWS, che viene poi ereditato da tutti gli account membri dell'organizzazione. La tua OpenClaw istanza utilizza Anthropic Claude-Sonnet 4.6 per impostazione predefinita.

Lightsail si occupa delle autorizzazioni IAM e Marketplace sottostanti per te come parte della configurazione nella Fase 3. Lo CloudShell script crea un ruolo IAM che include le tre autorizzazioni AWS Marketplace richieste (aws-marketplace:Subscribeaws-marketplace:Unsubscribe, eaws-marketplace:ViewSubscriptions). Questi sono necessari per consentire ad Amazon Bedrock di abilitare automaticamente i modelli di terze parti la prima volta che vengono richiamati. Una volta che un modello è stato abilitato nel tuo account, tutti gli utenti dell'account possono richiamarlo senza bisogno delle autorizzazioni del Marketplace: l'abbonamento deve avvenire solo una volta.

Per completare il requisito FTU specifico di Anthropic:

  • Apri la console Amazon Bedrock.

  • Vai al catalogo dei modelli e seleziona un modello antropico (come Claude).

  • Ti verrà richiesto di inviare i dettagli del caso d'uso. Compilare e inviare il modulo.

L'accesso ai modelli Anthropic viene concesso immediatamente dopo l'invio corretto del modulo. Una volta terminato, puoi selezionare qualsiasi modello Anthropic nella OpenClaw dashboard e iniziare a usarlo subito.

Nota

I modelli di Amazon, Meta, Mistral AI e Qwen non vengono venduti tramite AWS Marketplace e non richiedono questo passaggio. DeepSeek

Per ulteriori informazioni, consulta Accedere ai modelli Amazon Bedrock Foundation nella Amazon Bedrock User Guide.

Come funziona HTTPS?

La tua OpenClaw istanza è dotata di un endpoint HTTPS integrato protetto da un certificato Let's Encrypt. Quando viene creata l'istanza, viene emesso automaticamente un certificato Let's Encrypt per l' IPv4 indirizzo dell'istanza; non è richiesta alcuna configurazione manuale.

Cosa succede al mio certificato SSL se l'indirizzo IP della mia istanza cambia?

La tua OpenClaw istanza include un daemon di gestione dei certificati integrato (lightsail-manage-certd) che monitora l'indirizzo IP dell'istanza. Se l'indirizzo IP cambia, ad esempio quando colleghi o scolleghi un IP statico, il demone rileva automaticamente la modifica ed emette un nuovo certificato Let's Encrypt per il nuovo indirizzo IP. Non è richiesta alcuna azione manuale.

Con che frequenza viene rinnovato il mio certificato SSL?

I certificati Let's Encrypt emessi per la tua OpenClaw istanza sono validi per 7 giorni. Il daemon di gestione dei certificati rinnova automaticamente il certificato 2 giorni prima della scadenza, in modo che l'istanza rimanga protetta senza interruzioni o interventi manuali.

OpenClawPosso installare plugin su?

Sì. OpenClaw supporta l'installazione dei plug-in e alcuni plug-in o modifiche alla configurazione potrebbero richiedere il riavvio manuale del servizio OpenClaw gateway per rendere effettive le modifiche.

Per gestire il gateway dopo l'installazione di un plug-in o l'aggiornamento di una configurazione, accedi tramite SSH alla tua OpenClaw istanza e usa i seguenti comandi:

  • Arresta il servizio OpenClaw gateway: sudo systemctl stop openclaw-gateway

  • Avvia il servizio OpenClaw gateway: sudo systemctl start openclaw-gateway

  • Verifica lo stato attuale del servizio: sudo systemctl status openclaw-gateway

Il mio token gateway può essere compromesso e come posso ruotarlo?

Sì. Il token gateway viene generato una volta al primo avvio dell' OpenClaw istanza e non ruota automaticamente. Se il token viene mai esposto, ad esempio se viene divulgato nei log, condiviso accidentalmente o esposto a seguito di un attacco di pronta iniezione, chiunque lo possieda può accedere al OpenClaw gateway fino a quando non viene rigenerato manualmente.

Per ruotare il token del gateway:

  • Accedi tramite SSH alla tua OpenClaw istanza dalla console Lightsail.

  • Esegui il seguente comando per rigenerare il token:

    openclaw token rotate
  • Il vecchio token viene immediatamente invalidato. Tutti i browser o client attualmente associati al vecchio token verranno disconnessi.

  • Riassocia i browser utilizzando il nuovo token seguendo la procedura descritta nel Passaggio 2: Associa il browser a. OpenClaw

Suggerimento

Dopo aver ruotato il token, verifica che tutti i dispositivi attendibili siano stati riassociati prima di riprenderne l'uso.

Come faccio a ruotare le credenziali del mio canale di messaggistica (Telegram, Slack)? WhatsApp

Se un token o una credenziale della piattaforma di messaggistica archiviata sull' OpenClaw istanza sono compromessi, ad esempio il token bot di Telegram, le credenziali di WhatsApp sessione o il token Slack, devi ruotarlo immediatamente per impedire l'accesso non autorizzato ai tuoi canali di messaggistica.

Le credenziali per i canali collegati sono archiviate nell'istanza. ~/.openclaw/credentials/ Per ruotare una credenziale:

  • Revoca il token compromesso alla fonte:

    • Telegram: apri Telegram@BotFather, invia un messaggio e utilizzalo /revoke per invalidare il token bot esistente e generarne uno nuovo.

    • WhatsApp: Esci dalla sessione del dispositivo collegato dal WhatsApp telefono (Settings→ seleziona la sessione Linked Devices →). OpenClaw Log out Quindi ricollega utilizzando il flusso di associazione del codice QR.

  • Aggiorna la credenziale sulla tua OpenClaw istanza: SSH nella tua istanza ed esegui:

    openclaw channels update

    Seleziona il canale che desideri aggiornare e inserisci il nuovo token o credenziale quando richiesto.

  • Verifica che il canale funzioni inviando un messaggio di prova tramite il canale aggiornato.

Nota

La rotazione di una credenziale di messaggistica non influisce sul token del gateway o su altri canali connessi: ogni credenziale viene gestita in modo indipendente.