OpenClaw da terminale: i comandi essenziali che tutti dovrebbero conoscere
# OpenClaw da terminale: i comandi essenziali che tutti dovrebbero conoscere
Apri un terminale? Non spaventarti! Non è magia, è semplicemente una finestra nera dove scrivi testo per dare ordini al computer. E con OpenClaw, quel terminale diventa la tua finestra di controllo directe sul tuo agente AI.
Immagina il terminale come un "telecomando" per il tuo OpenClaw. Puoi usare comandi semplici come `openclaw status` per chiedere "come stai?" o `openclaw logs` per vedere "cosa è successo ultimamente". Niente di complicato.
## Cos'è l'interfaccia a comando (CLI)?
CLI significa Command Line Interface. È un modo per interagire con il programma scrivendo testo invece di cliccare pulsanti. Appena come usi WhatsApp scrivendo messaggi, qui scrivi comandi che OpenClaw esegue. È più veloce per le persone esperte, ma soprattutto dà un controllo totale sul tuo agent.
Prima di iniziare: assicurati che OpenClaw sia già installato e funzionante. Se non sei sicuro di averlo fatto, leggi l'articolo "Come installare OpenClaw dal zero" prima di procedere. Comincia sempre dalla base!
## Il comando più importante: `openclaw`
Tutti i comici OpenClaw partono da `openclaw`. Scrivi simplementemente `openclaw` nel tuo terminale e vedi cosa succede. Di solito vedrai un elenco dei comandi disponibili o entrerai in una modalità di chat interattiva. Prova!
Se vedi una schermata piena di opzioni, non preoccuparti. Non devi imparare tutto subito. Concentrati sui comandi fondamentali.
## 1. Controlla lo stato: `openclaw status`
Questo comando è il tuo primo amico. Ti dice se il tuo agent è vivo, quale modello stai usando, e se ci sono errori. È come controllare se l'auto ha carburante prima di partire.
Esempio:
```bash
openclaw status
```
Leggerai qualcosa come "Gateway è in esecuzione", "Modello: gpt-4o", e "Utenti connessi: 1". Se tutto è verde, sei a posto. Se vedi rosso, qualcosa va sbagliato e puoi chiedere aiuto all'agent o cercare nei log.
## 2. Guarda gli errori: `openclaw logs`
A volte le cose vanno storte. Quando succede, i log sono la tua mappa del tesoro. Ti mostrano cosa è successo negli ultimi minuti o ore. Usa `openclaw logs` per vedere tutta l'attività recentede tuo agent.
Comandi utili:
```bash
openclaw logs # Mostra gli ultimi log
openclaw logs -f # Mostra i log in tempo reale (premi CTRL+C per uscire)
```
Il comando `-f` segue i log while li vedi arrivare, come guardare un film in diretta. Utile quando debughi un problema.
## 3. Apre il pannello grafico: `openclaw dashboard`
Non ti senti a tuo agio con il terminale? Nessun problema! OpenClaw ha un interfaccia grafica che puoi aprire nel browser. Scrivi semplicemente:
```bash
openclaw dashboard
```
Il terminale ti darà un indirizzo (solitamente http://127.0.0.1:18789/) che puoi aprire nel browser. Là potrai vedere chattate, impostazioni, e tutto in forma visiva.È la stessa interfaccia che usi quando apri il browser e vai in quel URL.
Se sei remoto (su un server a cui accedi via SSH), il comando ti insegna come creare un tunnel SSH per accedere in sicurezza al dashboard. La sicurezza prima di tutto, remember?
## 4. Verifica la configurazione: `openclaw config get`
Vuoi sapere com'è configurato il tuo OpenClaw? Usa `openclaw config get` per leggere le impostazioni. Per esempio:
```bash
openclaw config get gateway.port
```
Ti dirà su quale porta il Gateway sta ascoltando di solito è 18789. Oppure:
```bash
openclaw config get model.selected
```
Ti dirai quale modello AI stai usando.
Per modificare un'impostazione, usi `openclaw config set`:
```bash
openclaw config set model.selected claude-3-5-sonnet
```
Cambiamento il modello del tuo agent. Attenzione: modifcare le impostazioni può cambiare il comportamento del tuo agent, fallo solo se sai cosa fai.
## 5. Controlla gli agenti connessi: `openclaw agents list`
Se hai più agent (sotto-agenti) che works in parallelo, puoi vederli tutti con:
```bash
openclaw agents list
```
Ti mostrerà una lista di agent con i loro stati: in corso, fermi, in errore, etc. Utile se hai attivati alcuni task automatici o cron jobs.
## 6. Guarda le sessioni in corso: `openclaw sessions list`
Le sessioni sono le conversazioni che hai avuto con il tuo agent. Ogni volta che parli con OpenClaw, crea una sessione. Per vedere le tue conversazioni recenti:
```bash
openclaw sessions list
```
Potresti vedere liste come "oggi alle 10:00", "yalle 15:30", etc. Puoi usare queste sessioni per continuare conversazioni precedenti o ripunti da dove eravamo rimasti.
## 7. Comandi per principianti: `openclaw doctor`
Qualcosa non funziona? Il terminale ti dà errori strani? Prova `openclaw doctor`. È come portare il tuo agent dal medico: analizza tutto il sistema e ti dice cosa potrebbe essere sbagliato, con suggerimenti per risolvere il problema.
Esempio:
```bash
openclaw doctor
```
Farà una serie di controlli e ti indicherà eventuali problemi: porte occupate, autorizzazioni mancanti, configurazioni errate, etc. Molto utile per i principianti.
## 8. Uscire e ricominciare: `openclaw stop` e `openclaw start`
Se OpenClaw si blocca o non risponde, puoi provare a restartarlo. Prima ferma:
```bash
openclaw stop
```
Poi riavvia:
```bash
openclaw start
```
È come spegnere e riaccendere il computer — funziona strano quanto spesso!.
## Comandi avanzati (quando sarai più esperto)
Una volta che ti senti più consono, puoi esplorare altri comandi:
- **`openclaw cron`** — gestisci gli appuntamenti automatici del tuo agent (impostare promemori, richiami等工作)
- **`openclaw health`** — controlla se tutto è ok con il tuo sistema OpenClaw
- **`openclaw backup`** — fai una copia di sicurezza dei tuoi dati e configurazioni
- **`openclaw models list`** — vedi quali modelli AI sono disponibili
- **`openclaw message`** — invia messaggi dal terminale (utile per scripting)
Questi comandi saranno oggetto di articoli futuri...
## Atttenzione alla sicurezza
Ricorda quello che abbiamo detto nell'ultimo articolo: **non installare OpenClaw sul computer che usi ogni giorno**. Usa una macchina virtuale o un container. Se devi eseguire comidi da terminale, fallo dall'ambiente isolato dove hai installato OpenClaw, NON dal tuo computer principale.
Alcuni comidi come `openclaw config set` possono modificare impostazioni importanti. Se non sai cosa fa un comando, cerca prima su Google o chiedi al tuo agent: "openclaw cosfa il comando X?". Meglio un secondo prima che un遗憾 dopo.
## Inizia lentamente
Non provare a imparare tutti questi comidi in un giorno. Scegli uno o due ogni volta. Prova `openclaw status` oggi. Domani prova `openclaw logs`. Tra una settimana avrai imparato abbastanza per gestire la maggior parte delle situazioni normali.
E ricorda: il tuo agent è lì per aiutarti. Se non ricordi un comando, digli simplesmente: "come faccio a visualizzare i log con OpenClaw?" E lui ti darà la risposta (magari con l'esatto comando da scrivere).
---
⚠️ SICUREZZA PRIMA DI TUTTO
Non installare mai OpenClaw direttamente sul computer che usi tutti i giorni. Usa sempre una macchina virtuale o un container per isolare l'ambiente.
Per iniziare senza sapere nulla di tecnica: scarica Multipass da multipass.run. Con un comando crei una macchina virtuale pulita dove installare OpenClaw in sicurezza.
Se gia' sai usare Docker: crea un container e lavora li'. Se non sai cos'e' Docker: usa Multipass, e' piu' semplice.
La regola e' una: OpenClaw su un computer isolato. Mai in chiaro sul PC di tutti i giorni. La sicurezza informatica e' paranoia, e' buon senso.
Apri un terminale? Non spaventarti! Non è magia, è semplicemente una finestra nera dove scrivi testo per dare ordini al computer. E con OpenClaw, quel terminale diventa la tua finestra di controllo directe sul tuo agente AI.
Immagina il terminale come un "telecomando" per il tuo OpenClaw. Puoi usare comandi semplici come `openclaw status` per chiedere "come stai?" o `openclaw logs` per vedere "cosa è successo ultimamente". Niente di complicato.
## Cos'è l'interfaccia a comando (CLI)?
CLI significa Command Line Interface. È un modo per interagire con il programma scrivendo testo invece di cliccare pulsanti. Appena come usi WhatsApp scrivendo messaggi, qui scrivi comandi che OpenClaw esegue. È più veloce per le persone esperte, ma soprattutto dà un controllo totale sul tuo agent.
Prima di iniziare: assicurati che OpenClaw sia già installato e funzionante. Se non sei sicuro di averlo fatto, leggi l'articolo "Come installare OpenClaw dal zero" prima di procedere. Comincia sempre dalla base!
## Il comando più importante: `openclaw`
Tutti i comici OpenClaw partono da `openclaw`. Scrivi simplementemente `openclaw` nel tuo terminale e vedi cosa succede. Di solito vedrai un elenco dei comandi disponibili o entrerai in una modalità di chat interattiva. Prova!
Se vedi una schermata piena di opzioni, non preoccuparti. Non devi imparare tutto subito. Concentrati sui comandi fondamentali.
## 1. Controlla lo stato: `openclaw status`
Questo comando è il tuo primo amico. Ti dice se il tuo agent è vivo, quale modello stai usando, e se ci sono errori. È come controllare se l'auto ha carburante prima di partire.
Esempio:
```bash
openclaw status
```
Leggerai qualcosa come "Gateway è in esecuzione", "Modello: gpt-4o", e "Utenti connessi: 1". Se tutto è verde, sei a posto. Se vedi rosso, qualcosa va sbagliato e puoi chiedere aiuto all'agent o cercare nei log.
## 2. Guarda gli errori: `openclaw logs`
A volte le cose vanno storte. Quando succede, i log sono la tua mappa del tesoro. Ti mostrano cosa è successo negli ultimi minuti o ore. Usa `openclaw logs` per vedere tutta l'attività recentede tuo agent.
Comandi utili:
```bash
openclaw logs # Mostra gli ultimi log
openclaw logs -f # Mostra i log in tempo reale (premi CTRL+C per uscire)
```
Il comando `-f` segue i log while li vedi arrivare, come guardare un film in diretta. Utile quando debughi un problema.
## 3. Apre il pannello grafico: `openclaw dashboard`
Non ti senti a tuo agio con il terminale? Nessun problema! OpenClaw ha un interfaccia grafica che puoi aprire nel browser. Scrivi semplicemente:
```bash
openclaw dashboard
```
Il terminale ti darà un indirizzo (solitamente http://127.0.0.1:18789/) che puoi aprire nel browser. Là potrai vedere chattate, impostazioni, e tutto in forma visiva.È la stessa interfaccia che usi quando apri il browser e vai in quel URL.
Se sei remoto (su un server a cui accedi via SSH), il comando ti insegna come creare un tunnel SSH per accedere in sicurezza al dashboard. La sicurezza prima di tutto, remember?
## 4. Verifica la configurazione: `openclaw config get`
Vuoi sapere com'è configurato il tuo OpenClaw? Usa `openclaw config get` per leggere le impostazioni. Per esempio:
```bash
openclaw config get gateway.port
```
Ti dirà su quale porta il Gateway sta ascoltando di solito è 18789. Oppure:
```bash
openclaw config get model.selected
```
Ti dirai quale modello AI stai usando.
Per modificare un'impostazione, usi `openclaw config set`:
```bash
openclaw config set model.selected claude-3-5-sonnet
```
Cambiamento il modello del tuo agent. Attenzione: modifcare le impostazioni può cambiare il comportamento del tuo agent, fallo solo se sai cosa fai.
## 5. Controlla gli agenti connessi: `openclaw agents list`
Se hai più agent (sotto-agenti) che works in parallelo, puoi vederli tutti con:
```bash
openclaw agents list
```
Ti mostrerà una lista di agent con i loro stati: in corso, fermi, in errore, etc. Utile se hai attivati alcuni task automatici o cron jobs.
## 6. Guarda le sessioni in corso: `openclaw sessions list`
Le sessioni sono le conversazioni che hai avuto con il tuo agent. Ogni volta che parli con OpenClaw, crea una sessione. Per vedere le tue conversazioni recenti:
```bash
openclaw sessions list
```
Potresti vedere liste come "oggi alle 10:00", "yalle 15:30", etc. Puoi usare queste sessioni per continuare conversazioni precedenti o ripunti da dove eravamo rimasti.
## 7. Comandi per principianti: `openclaw doctor`
Qualcosa non funziona? Il terminale ti dà errori strani? Prova `openclaw doctor`. È come portare il tuo agent dal medico: analizza tutto il sistema e ti dice cosa potrebbe essere sbagliato, con suggerimenti per risolvere il problema.
Esempio:
```bash
openclaw doctor
```
Farà una serie di controlli e ti indicherà eventuali problemi: porte occupate, autorizzazioni mancanti, configurazioni errate, etc. Molto utile per i principianti.
## 8. Uscire e ricominciare: `openclaw stop` e `openclaw start`
Se OpenClaw si blocca o non risponde, puoi provare a restartarlo. Prima ferma:
```bash
openclaw stop
```
Poi riavvia:
```bash
openclaw start
```
È come spegnere e riaccendere il computer — funziona strano quanto spesso!.
## Comandi avanzati (quando sarai più esperto)
Una volta che ti senti più consono, puoi esplorare altri comandi:
- **`openclaw cron`** — gestisci gli appuntamenti automatici del tuo agent (impostare promemori, richiami等工作)
- **`openclaw health`** — controlla se tutto è ok con il tuo sistema OpenClaw
- **`openclaw backup`** — fai una copia di sicurezza dei tuoi dati e configurazioni
- **`openclaw models list`** — vedi quali modelli AI sono disponibili
- **`openclaw message`** — invia messaggi dal terminale (utile per scripting)
Questi comandi saranno oggetto di articoli futuri...
## Atttenzione alla sicurezza
Ricorda quello che abbiamo detto nell'ultimo articolo: **non installare OpenClaw sul computer che usi ogni giorno**. Usa una macchina virtuale o un container. Se devi eseguire comidi da terminale, fallo dall'ambiente isolato dove hai installato OpenClaw, NON dal tuo computer principale.
Alcuni comidi come `openclaw config set` possono modificare impostazioni importanti. Se non sai cosa fa un comando, cerca prima su Google o chiedi al tuo agent: "openclaw cosfa il comando X?". Meglio un secondo prima che un遗憾 dopo.
## Inizia lentamente
Non provare a imparare tutti questi comidi in un giorno. Scegli uno o due ogni volta. Prova `openclaw status` oggi. Domani prova `openclaw logs`. Tra una settimana avrai imparato abbastanza per gestire la maggior parte delle situazioni normali.
E ricorda: il tuo agent è lì per aiutarti. Se non ricordi un comando, digli simplesmente: "come faccio a visualizzare i log con OpenClaw?" E lui ti darà la risposta (magari con l'esatto comando da scrivere).
---
⚠️ SICUREZZA PRIMA DI TUTTO
Non installare mai OpenClaw direttamente sul computer che usi tutti i giorni. Usa sempre una macchina virtuale o un container per isolare l'ambiente.
Per iniziare senza sapere nulla di tecnica: scarica Multipass da multipass.run. Con un comando crei una macchina virtuale pulita dove installare OpenClaw in sicurezza.
Se gia' sai usare Docker: crea un container e lavora li'. Se non sai cos'e' Docker: usa Multipass, e' piu' semplice.
La regola e' una: OpenClaw su un computer isolato. Mai in chiaro sul PC di tutti i giorni. La sicurezza informatica e' paranoia, e' buon senso.
Sent via AgentMail
Commenti
Posta un commento