Quando ho configurato per la prima volta OpenClaw, ho commesso ogni errore possibile. Non esagero: ho impiegato tre settimane per una configurazione che avrebbe dovuto richiedere tre giorni, ho speso $400 in strumenti di cui non avevo bisogno e una volta ho messo fuori uso il mio server di produzione eseguendo un aggiornamento dell’agente un venerdì pomeriggio. Alle 16:57. In un lungo weekend.
Ecco i sette errori che mi sono costati di più, classificati in base a quanto vorrei poter tornare indietro nel tempo e schiaffeggiarmi.
1. Eseguire Configurazioni Predefinite in Produzione
OpenClaw è fornito con impostazioni predefinite che vanno bene per test e sviluppo. Non vanno bene per la produzione. L’ho scoperto quando il mio agente ha iniziato a rispondere in 15 secondi anziché in 2, e non riuscivo a capire perché.
Il problema: l’allocazione della memoria predefinita era impostata per lo sviluppo — una frazione di ciò di cui il mio carico di lavoro effettivo aveva bisogno. L’agente stava continuamente scambiando, sbandando e praticamente girando con i lacci delle scarpe legati insieme.
La soluzione è stata imbarazzantemente semplice: aumentare l’allocazione della memoria e regolare le impostazioni di concorrenza per adattarle ai miei schemi di utilizzo effettivi. I tempi di risposta sono scesi da 15 secondi a meno di 2. Avevo vissuto con prestazioni terribili per tre settimane perché assumevo che le impostazioni predefinite fossero ottimizzate. Non lo sono. Sono conservative. Leggi la documentazione della configurazione e adattala al tuo carico di lavoro specifico.
2. Non Configurare il Monitoraggio Fin dal Primo Giorno
Per il primo mese, la mia istanza di OpenClaw era una scatola nera. Funzionava. A volte era veloce. A volte era lenta. Non avevo idea del perché, poiché non avevo impostato alcun monitoraggio.
Poi un giorno ha smesso di rispondere completamente. Nessun avviso. Nessun avviso. Solo silenzio. Me ne sono accorto solo perché un collega mi ha chiesto perché il bot non rispondesse su Slack. L’agente era silenziosamente andato in crash sei ore prima a causa di una perdita di memoria, e nessuno lo sapeva.
Ora ho un monitoraggio su tutto: tempi di risposta, tassi di errore, utilizzo della memoria, consumo di token e uptime. Ci vogliono 30 minuti per impostare un monitoraggio di base, e mi ha salvato da errori silenziosi almeno cinque volte da allora. Se il tuo sistema AI non ha monitoraggio, ha problemi di cui non sei ancora a conoscenza.
3. L’Aggiornamento del Venerdì Pomeriggio
Lo so. Tutti dicono di non distribuire aggiornamenti il venerdì. Pensavo che fosse superstizione per persone di ops paranoiche. Poi ho spinto un aggiornamento dell’agente alle 16:57 di un venerdì prima di un lungo weekend.
L’aggiornamento ha modificato un formato di configurazione che era incompatibile con i dati esistenti. L’agente ha iniziato a restituire errori. Ho provato a tornare indietro, ma mi sono reso conto di non aver preso uno snapshot prima di aggiornare. Tre ore dopo — in quello che doveva essere l’inizio del mio weekend — sono riuscito a riportarlo a uno stato funzionante ricostruendo manualmente la configurazione dalla memoria e dai log delle chat.
Lezioni apprese: fare sempre uno snapshot prima degli aggiornamenti, non aggiornare mai il venerdì (non è superstizione — è gestione del rischio) e tenere la procedura di rollback documentata e testata. Ora ho una checklist pre-aggiornamento attaccata al mio monitor. Sì, attaccata fisicamente. Con del nastro adesivo vero.
4. Dare Troppi Permessi all’Agente
Quando ho configurato per la prima volta il mio agente OpenClaw, gli ho dato accesso da amministratore a tutto perché non volevo affrontare errori di autorizzazione. Email, calendario, file system, database, Slack — accesso completo a tutto.
Puoi probabilmente indovinare cosa è successo. L’agente, seguendo un prompt leggermente ambiguo, ha inviato una bozza di memo interno a tutta la nostra lista clienti. Non una catastrofe — il memo era noioso e inoffensivo — ma le risposte “perché la tua IA mi sta inviando email?” da parte di clienti confusi non sono state divertenti da gestire.
Ora seguo un rigido principio del minimo privilegio. L’agente ha accesso esattamente a ciò di cui ha bisogno e nient’altro. Può pubblicare nel canale Slack interno? Sì. Può inviare email a contatti esterni? Solo tramite una coda che prima rivedo. Può modificare il nostro database? Solo in lettura. Ogni nuova funzionalità richiede un’esplicita autorizzazione, e ci penso attentamente prima di farlo.
5. Ignorare i Costi dei Token Finché Non È Arrivata la Fattura
Avevo un flusso di lavoro in cui l’agente elaborava documenti lunghi alimentandoli a un LLM per la sintesi. Funzionava benissimo. I riassunti erano eccellenti. Poi è arrivata la mia prima fattura mensile: $340 in costi dei token API per un’attività che mi aspettavo costasse circa $30.
Il problema: l’agente stava inviando l’intero documento ogni volta, anche quando l’utente faceva una domanda di follow-up sullo stesso documento. Nessun caching, nessuna suddivisione, nessuna consapevolezza di aver già elaborato quel contenuto. Ogni domanda su un documento di 50 pagine significava rinviare tutte e 50 le pagine.
Aggiungere un semplice cache — “ho già elaborato questo documento? Se sì, utilizza il riepilogo in cache” — ha ridotto i miei costi dell’85%. L’implementazione di una suddivisione intelligente (inviando solo le sezioni rilevanti invece dell’intero documento) ha ulteriormente abbattuto i costi.
Tieni traccia del tuo utilizzo di token fin dal primo giorno. Imposta avvisi di budget. E chiediti sempre: “Sto inviando informazioni che il modello ha già visto?”
6. Costruire Tutto Prima di Parlare con gli Utenti
Ho trascorso due settimane a costruire un elaborato flusso di lavoro per l’agente che avrebbe analizzato i ticket di supporto clienti, li avrebbe classificati, redatto risposte e indirizzati al team giusto. Era architettonicamente bellissimo. Orchestrazione complessa, più passaggi di agente, gestione degli errori per ogni caso limite.
Poi l’ho mostrato al team di supporto. Loro lo hanno guardato e hanno detto: “Ci basta che rediga una risposta. Ci occuperemo noi della classificazione e dell’instradamento — siamo più veloci noi di qualsiasi IA.”
Due settimane di lavoro, e hanno utilizzato circa il 20% di ciò che ho costruito. L’80% su cui ho sprecato tempo non era solo superfluo — ha reso il sistema più complesso e difficile da mantenere.
Ora inizio con delle conversazioni. “Su cosa spendi la maggior parte del tempo?” “Qual è la parte più fastidiosa del tuo flusso di lavoro?” “Se potessi automatizzare una cosa, quale sarebbe?” Costruisci quella cosa. Vedi se la usano. Poi costruisci la cosa successiva.
7. Non Avere un Kill Switch
Questo è quello che mi rende ancora nervoso. Nei primi due mesi, il mio agente non aveva un modo semplice per essere spento in caso di emergenza. Se iniziava a comportarsi male — inviando messaggi sbagliati, facendo chiamate API errate, girando in loop — la mia unica opzione era SSH nel server e terminare manualmente il processo.
Va bene quando sei alla scrivania. Non va bene quando sei a cena e il tuo telefono inizia a squillare con avvisi “perché il bot posta lo stesso messaggio ogni 3 secondi?”.
Ora ogni agente ha un kill switch: un semplicissimo endpoint API o comando Slack che ferma immediatamente tutta l’attività dell’agente. Non è richiesto SSH. Non è richiesto laptop. Basta “/stop-agent” dal mio telefono e tutto si ferma in pochi secondi.
Costruisci il kill switch prima di costruire le funzionalità. Non ne hai bisogno spesso, ma quando ne hai bisogno, ne avrai disperatamente bisogno.
La Meta-Lezione
Tutti e sette questi errori condividono un filo comune: ho trattato l’agente AI come un software, non come un dipendente. Il software lo distribuisci e dimentichi. Un dipendente lo monitori, lo limiti, lo guidi e correggi il tiro.
Gli agenti AI sono più simili a dipendenti che a software. Hanno bisogno di supervisione, vincoli, responsabilità chiare e di qualcuno che controlli per assicurarsi che non stiano accidentalmente inviando email a tutta la tua lista clienti. Trattali di conseguenza, e eviterai la maggior parte del dolore che ho passato.
🕒 Published: