Comandi OpenClaw

Comandi completi di OpenClaw per gestire il tuo agente IA personale attraverso diversi canali di messaggistica e piattaforme.

Installazione

Piattaforma	Comando
macOS/Linux	curl -fsSL https://openclaw.ai/install.sh | bash
npm (globale)	npm install -g openclaw
Aggiornamento	openclaw update
Verifica	openclaw --version

Configurazione e Onboarding

Comando	Descrizione
openclaw onboard	Procedura guidata interattiva per gateway, workspace, canali e competenze
openclaw onboard --install-daemon	Configurazione e installazione del gateway come servizio in background
openclaw onboard --flow quickstart	Configurazione rapida con impostazioni predefinite
openclaw onboard --flow advanced	Configurazione completa con tutte le opzioni
openclaw onboard --non-interactive	Configurazione headless (richiede flag espliciti)
openclaw setup --workspace ~/my-agent	Inizializza configurazione e directory workspace
openclaw configure	Procedura guidata per modelli, canali, competenze e gateway
openclaw doctor	Controlli di salute e correzioni rapide per configurazione e gateway
openclaw doctor --deep	Scansione approfondita inclusi servizi di sistema
openclaw reset --scope config	Reset solo della configurazione
openclaw reset --scope full --yes	Reset completo di configurazione, credenziali e sessioni

Configurazione

Comando	Descrizione
openclaw config get <path>	Mostra un valore di configurazione
openclaw config set <path> <value>	Imposta un valore di configurazione (JSON5 o stringa)
openclaw config unset <path>	Rimuove un valore di configurazione
openclaw configure	Avvia la procedura guidata di configurazione interattiva

Variabili d’Ambiente

Variabile	Scopo
OPENCLAW_HOME	Sovrascrive la directory home predefinita
OPENCLAW_STATE_DIR	Directory di stato personalizzata
OPENCLAW_CONFIG_PATH	Percorso file di configurazione personalizzato

Gestione Gateway

Comando	Descrizione
openclaw gateway run	Esegui il Gateway WebSocket in primo piano
openclaw gateway run --port 18789	Esegui il gateway su una porta specifica
openclaw gateway run --bind lan	Collega all’interfaccia LAN
openclaw gateway run --bind tailnet	Collega tramite Tailscale
openclaw gateway status	Controlla lo stato del gateway tramite RPC
openclaw gateway health	Verifica la salute dal gateway in esecuzione
openclaw gateway install	Installa il gateway come servizio di sistema
openclaw gateway start	Avvia il servizio installato
openclaw gateway stop	Ferma il servizio in esecuzione
openclaw gateway restart	Riavvia il servizio
openclaw gateway uninstall	Rimuovi il servizio
openclaw gateway discover	Scopri i gateway sulla rete
openclaw logs --follow	Segui i log del gateway in tempo reale
openclaw logs --limit 100 --json	Ultime 100 voci di log in formato JSON

Gestione Canali

Comando	Descrizione
openclaw channels list	Mostra tutti i canali configurati e i profili di autenticazione
openclaw channels status	Controlla la raggiungibilità del gateway e la salute dei canali
openclaw channels add --channel telegram	Aggiungi canale Telegram
openclaw channels add --channel whatsapp	Aggiungi canale WhatsApp
openclaw channels add --channel discord	Aggiungi canale Discord
openclaw channels add --channel slack	Aggiungi canale Slack
openclaw channels add --channel signal	Aggiungi canale Signal
openclaw channels add --channel imessage	Aggiungi canale iMessage
openclaw channels add --channel msteams	Aggiungi canale Microsoft Teams
openclaw channels remove --channel telegram	Rimuovi un canale
openclaw channels login --channel discord	Login interattivo del canale
openclaw channels logout --channel telegram	Logout dal canale
openclaw channels logs --channel whatsapp	Mostra i log recenti del canale

Messaggistica

Comando	Descrizione
openclaw message send --text "Hello"	Invia un messaggio
openclaw message send --to user123 --text "Hi"	Invia a una destinazione specifica
openclaw message poll	Recupera nuovi messaggi
openclaw message read	Segna i messaggi come letti
openclaw message edit --text "Updated"	Modifica un messaggio inviato
openclaw message delete	Elimina un messaggio
openclaw message react --emoji "👍"	Reagisci a un messaggio
openclaw message search --text "query"	Cerca messaggi
openclaw message pin	Fissa un messaggio
openclaw message thread create	Crea un thread di messaggi
openclaw message thread list	Elenca i thread
openclaw message thread reply	Rispondi in un thread

Gestione Agenti

Comando	Descrizione
openclaw agent --message "Research this topic"	Esegui un turno singolo dell’agente tramite gateway
openclaw agent --message "Hello" --thinking high	Turno dell’agente con pensiero esteso
openclaw agent --message "task" --local	Esegui l’agente localmente (integrato)
openclaw agent --message "task" --deliver	Consegna la risposta al canale
openclaw agents list	Elenca gli agenti configurati
openclaw agents add myagent --workspace ~/work	Aggiungi agente isolato con workspace
openclaw agents add myagent --model claude-sonnet	Aggiungi agente con modello specifico
openclaw agents delete myagent --force	Elimina un agente

Configurazione Modelli

Comando	Descrizione
openclaw models list	Elenca i modelli disponibili
openclaw models list --all	Elenca tutti i modelli inclusi quelli non disponibili
openclaw models list --local	Elenca solo i modelli locali
openclaw models list --provider anthropic	Filtra per provider
openclaw models status	Mostra stato token e autenticazione
openclaw models set claude-sonnet	Imposta il modello primario
openclaw models scan	Scansiona e scopri modelli disponibili
openclaw models auth add	Helper interattivo di autenticazione
openclaw models fallbacks add gpt-4o	Aggiungi modello di riserva
openclaw models aliases add sonnet claude-sonnet	Crea alias per modello

Controllo Browser

Comando	Descrizione
openclaw browser start	Avvia browser controllato
openclaw browser stop	Chiudi browser
openclaw browser status	Controlla stato del browser
openclaw browser open "https://example.com"	Apri URL nel browser
openclaw browser tabs	Elenca le schede aperte
openclaw browser screenshot	Cattura screenshot del viewport
openclaw browser screenshot --full-page	Screenshot a pagina intera
openclaw browser navigate "https://url"	Naviga verso URL
openclaw browser click <ref>	Clicca su un elemento
openclaw browser type <ref> "text"	Digita testo in un elemento
openclaw browser press Enter	Premi un tasto della tastiera
openclaw browser evaluate --fn "document.title"	Esegui JavaScript

Gestione Nodi

Comando	Descrizione
openclaw node run --host gateway.local --port 18789	Esegui nodo headless
openclaw node install --host gw.local	Installa nodo come servizio
openclaw node status	Controlla stato del nodo
openclaw nodes list	Elenca tutti i nodi
openclaw nodes status --connected	Mostra solo nodi connessi
openclaw nodes approve <requestId>	Approva richiesta del nodo
openclaw nodes run --node mypc "ls -la"	Esegui comando su nodo remoto

Lavori Pianificati (Cron)

Comando	Descrizione
openclaw cron list	Elenca tutti i lavori pianificati
openclaw cron status	Mostra stato del sistema cron
openclaw cron add --name "Daily report" --every 24h --message "Generate daily report"	Aggiungi lavoro ricorrente
openclaw cron add --name "Morning brief" --at "08:00" --message "Brief me"	Aggiungi lavoro basato su orario
openclaw cron enable <id>	Abilita un lavoro
openclaw cron disable <id>	Disabilita un lavoro
openclaw cron run <id>	Esegui immediatamente un lavoro
openclaw cron rm <id>	Elimina un lavoro

Plugin e Competenze

Comando	Descrizione
openclaw plugins list	Scopri plugin disponibili
openclaw plugins install <path>	Installa plugin dal percorso o npm
openclaw plugins enable <id>	Abilita un plugin
openclaw plugins disable <id>	Disabilita un plugin
openclaw plugins doctor	Segnala errori di caricamento plugin
openclaw skills list	Elenca le competenze disponibili
openclaw skills info <name>	Mostra dettagli della competenza

Sicurezza e Approvazioni

Comando	Descrizione
openclaw security audit	Audit configurazione e stato locale
openclaw security audit --deep	Sonda di sicurezza live del gateway
openclaw security audit --fix	Correggi automaticamente i valori predefiniti sicuri
openclaw approvals get	Visualizza impostazioni di approvazione correnti
openclaw approvals set	Configura flussi di approvazione

Memoria e Sessioni

Comando	Descrizione
openclaw memory status	Mostra statistiche dell’indice di memoria
openclaw memory index	Reindicizza i file di memoria
openclaw memory search "query"	Ricerca semantica sulla memoria
openclaw sessions	Elenca le sessioni di conversazione memorizzate
openclaw status	Mostra la salute delle sessioni collegate
openclaw status --all --deep	Diagnosi completa con sonde dei canali

Migliori Pratiche

• Usa --install-daemon durante l’onboarding per eseguire il gateway come servizio in background
• Esegui openclaw doctor regolarmente per individuare problemi di configurazione in anticipo
• Imposta i modelli di riserva per garantire la disponibilità quando il modello primario è limitato
• Usa --thinking high per compiti complessi che richiedono ragionamento profondo
• Crea profili browser per isolare i contesti di navigazione per diversi compiti
• Usa il flag --json quando scrivi script o reindirizzi l’output ad altri strumenti
• Esegui audit di sicurezza con il flag --deep prima di esporre il gateway alla rete

Risoluzione Problemi

Problema	Soluzione
Il gateway non si avvia	Esegui openclaw doctor --deep per diagnosticare
Canale disconnesso	Controlla con openclaw channels status poi rieffettua il login
Autenticazione modello fallita	Esegui openclaw models status --probe per testare i token
Errore caricamento plugin	Esegui openclaw plugins doctor per la diagnostica
Nodo non si connette	Verifica con openclaw nodes pending e approva se necessario
Risposte lente	Controlla openclaw status --usage per i limiti di velocità
Configurazione corrotta	Usa openclaw reset --scope config per resettare in sicurezza