Prima di distribuire, pensa chiaramente a quale strada prendere
Due strade, scegli una:
Distribuzione locale - installato sul proprio computer, massima autorizzazione, può controllare file locali, browser e appunti. Versione completa.
Distribuzione nel cloud - installato su server, online 7×24, accessibile in qualsiasi momento anche dal cellulare. Adatto a chi non vuole tenere acceso il computer.
La distribuzione locale sblocca il 100% delle capacità. Nel cloud è solo circa il 20%.
Se vuoi usarlo seriamente, scegli locale. Se vuoi prima provare, scegli cloud.
Entrambe le strade sotto sono spiegate, scegli in base alla tua situazione.






Strada uno: distribuzione locale (compatibile con Windows / Mac / Linux)
Primo passo: conferma l'ambiente
Apri il terminale (Windows usa PowerShell, Mac usa Terminal), digita:
node -v
Mostra solo il numero di versione, richiede Node.js 18 o superiore.
Non hai installato Node? Vai su nodejs.org per scaricare la versione LTS, dopo aver installato riapri il terminale.
Secondo passaggio: installa OpenClaw
Utenti Windows, esegui nel PowerShell:
iwr -useb https://openclaw.ai/install.ps1 | iex
Utenti Mac / Linux, esegui nel Terminale:
curl -fsSL https://openclaw.ai/install.sh | sh
Connessione lenta in Cina? Prima configura il mirror npm:
npm config set registry https://registry.npmmirror.com
Poi installa manualmente:
npm install -g openclaw@latest
Dopo l'installazione, digita openclaw nel terminale per vedere le informazioni di aiuto, significa che è installato correttamente.
Terzo passaggio: inizializza la configurazione (il passaggio più critico)
Esegui:
openclaw onboard
Entrerai in una guida interattiva, usa i tasti su e giù per selezionare, premi Invio per confermare.
Primo suggerimento: avviso di rischio
I understand this is powerful and inherently risky. Continue?
Seleziona Sì, continua.
Secondo suggerimento: avvia modalità
Seleziona Quick Start (inizio veloce)
Terzo suggerimento: scegli un grande modello
Qui è cruciale. Scegli in base alla tua situazione:
Hai accesso scientifico a Claude / GPT-4
Ambiente puramente nazionale, Alibaba Cloud Bailian / Zhizhu Z.AI / Kimi
Vuoi risparmiare Minimax (ha pacchetti mensili, stabile)
Dopo aver selezionato ti verrà chiesto di inserire la chiave API.
Incolla la tua chiave, premi Invio per confermare.
Come ottenere la chiave? Vai sul sito ufficiale corrispondente per registrarti, cerca "chiave API" o "gestione chiavi", creane una e copiala.
Quarto passaggio: opzioni successive, seleziona tutto per i principianti
Dopo aver installato la configurazione del modello, ti verrà chiesto:
Hai installato il pacchetto di abilità Skills? → No (salta per ora)
Hai integrato Telegram/Discord? → No (salta per ora)
Impostazioni della porta? → Premi Invio per usare la porta 18789 per impostazione predefinita
Tutti questi possono essere regolati successivamente nell'interfaccia grafica, non lasciarti bloccare da questo passaggio.
Quarto passaggio: avvia e verifica
Dopo aver configurato, avvia la console:
openclaw dashboard
Il browser aprirà automaticamente l'interfaccia della console.
Fai un test, digita:
Aiutami a creare una cartella chiamata test
Se sul computer appare davvero questa cartella—
Distribuzione completata.


Rotta due: distribuzione cloud (la versione più semplice per principianti)
Usa Zeabur, a partire da $2
Primo passaggio: vai su un'immagine per trovare l'indirizzo e registrati, supporta Alipay/WeChat.
Secondo passaggio: vai alla console → crea un nuovo progetto → scegli un modello → cerca openclaw → distribuisci direttamente.
Terzo passaggio: attendi che il progetto si attivi (circa 1-2 minuti), clicca nel terminale, digita:
openclaw onboard
Il processo successivo è lo stesso che localmente, segui l'operazione del terzo passaggio della prima rotta.
Usa Alibaba Cloud, l'immagine ufficiale è più rassicurante
Alibaba Cloud ha già l'immagine dedicata di OpenClaw, tutte le dipendenze sono preinstallate.
:aliyun.com/activity/ecs/clawdbot
Seleziona configurazione:
Immagine: OpenClaw (Moltbot)
Area: Virginia, Stati Uniti (la ricerca su server nazionali è limitata)
Configurazione: il livello minimo è sufficiente
Dopo aver completato la distribuzione, tre passaggi per chiudere:
Entra in "dettagli dell'applicazione":
Aprire la porta: sbloccare la porta 18789, operazione con un clic
Configurazione API Key: inserisci la tua chiave Bailian o di un altro modello
Genera Token: esegui il comando, copia il Token di accesso
Apri il link della console, se riesci a dialogare, è completato.
Dopo l'installazione, fai prima questa cosa
Apri la console, trova il file USER.md nella directory Workspace.
Questo è il luogo in cui dici a Xiao Longxia "chi sei".
Scrivi alcune righe: la tua identità, il tuo lavoro, i tipi di compiti che usi frequentemente.
Per esempio:
Sono un creatore di contenuti di criptovalute, ogni giorno devo organizzare i dati on-chain, scrivere report Alpha, analizzare token popolari.
Piattaforme comuni: Binance, Twitter.
Stile di lingua: conciso, senza fronzoli, con punti di vista.
Dopo aver scritto, diventerà sempre più comprensivo di te.
Questo file è il suo "punto di partenza della memoria".




Errori comuni, confrontali e gestiscili
Errore: Nessuna chiave API trovata
Non scrivere direttamente la chiave in openclaw.json, la nuova versione non la riconosce.
Pratica corretta:
openclaw config set zai:default.secret sk-你的Key
Oppure crea manualmente un file:
Percorso: C:\Users\用户名\.openclaw\agents\main\agent\ (Windows)
Contenuto del file:
{ "zai:default": { "secret": "sk-你的Key" } }
Il servizio è stato interrotto improvvisamente, la pagina non si apre
Non ricaricare.
Riapri il terminale, esegui in sequenza:
# Prima ferma
Ctrl + C
# Riavvia il gateway
openclaw gateway
# Riapri la console
openclaw dashboard
Timeout di rete, dipendenza non installabile
Imposta prima il mirror nazionale:
npm config set registry https://registry.npmmirror.com
Se ancora lento, attiva la modalità TUN di accesso scientifico, così anche il traffico del terminale passerà attraverso il proxy.
Xiao Longxia ha privilegi di sistema reali.
Può eliminare file, inviare email, può controllare il tuo browser.
Quindi:
Crea un account secondario dedicato (Gmail dedicata, Bot Feishu dedicato), non usare l'account principale
Imposta limiti sulla directory di lavoro, non lasciarlo vagare
Non dare all'API Key tutti i permessi, attivali secondo necessità
Dopo la distribuzione cloud, chiudi l'accesso pubblico diretto, imposta la verifica del token
Se non ti fidi, puoi andare a vedere quel vecchio che ha trasferito diverse decine di migliaia di u recentemente
Ultimo

Dopo aver installato, il primo compito consigliato è questo:
Aiutami a cercare le principali notizie su BTC di oggi, riassumile in 5 punti
Se funziona, capirai perché 250.000 persone gli hanno dato una stella.
La competizione di Binance termina il 18 marzo, c'è tempo a sufficienza.