Come gli agenti di IA
strumenti reali
da usare
Esecuzione degli strumenti sul gateway OpenClaw: browser, shell, filesystem, API e posta elettronica, con isolamento delle funzionalità, approvazioni e registrazione prima che si verifichino effetti sul lato produzione.
risposta diretta
Che cosa sono gli strumenti?
All'interno di OpenClaw?
Risposta breve: Gli strumenti sono funzionalità eseguibili che richiamano il Gateway per conto di un agente (azioni del browser, shell, file, HTTP/API, posta elettronica) tramite chiamate strutturate (incluse integrazioni simili a MCP), e non semplicemente testo in chat.
Sfumatura: Il modello sceglie lo strumento e gli argomenti; il Gateway applica le politiche, le approvazioni, il controllo degli accessi basato sui ruoli (RBAC) e la sandbox. Senza governance, "più strumenti" significano solo una maggiore superficie di attacco, senza produttività.
Capacità
Quali strumenti utilizzano gli agenti di intelligenza artificiale?
Nessun marketplace di strumenti: i tipi operativi utilizzano un gateway self-hosted.
Strumenti del browser
Naviga, clicca, digita, invia in Chromium: utilizza cookie reali. Vedi Automazione del browser.
esecuzione terminale
Esecuzione di strumenti shell come utente Gateway: installazione di pacchetti, script, arricciare — raggio d'esplosione più elevato sull'ospite.
Strumenti del filesystem
Lettura/scrittura/elenco sui percorsi che il Gateway è autorizzato a visualizzare — .env Read è una fuga di credenziali.
Strumenti API
Le chiamate HTTP al CRM, ai webhook e ai servizi interni, con la conseguente modifica degli endpoint, sono effetti collaterali.
Strumenti per la casella di posta
Leggere, inviare, inoltrare, eliminare sulla casella di posta collegata: rischio di conformità e di reputazione.
Strumenti di monitoraggio
Stato del gateway, sonda del canale, healthz: rischio basso, essenziale per il debug. Vedi Registri e monitoraggio.
Ricerca/recupero
RAG, documentazione, ricerca ticket: di tipo sola lettura, ma in grado di contestualizzare le informazioni personali; query di registro.
classi di rischio
Strumenti di sola lettura vs. strumenti di mutazione
Insomma: La modalità di sola lettura comporta un rischio inferiore, ma non è priva di rischi; la modifica richiede approvazioni e ambiti di applicazione ristretti.
Sola lettura (relativamente sicura)
Esempi: Registri, <code>stato del gateway</code>, API GET di sola lettura, email letta senza invio, DOM letto senza invio.
NB: Continua a leggere per scoprire i percorsi segreti; un'iniezione che successivamente innesca uno strumento mutante.
Scritture del filesystem
Esempi: Creare, sovrascrivere, eliminare al di fuori della cartella tmp.
NB: Percorso errato = perdita di dati; approvazione + limiti di montaggio.
Il database scrive
Esempi: INSERIMENTO/AGGIORNAMENTO/ELIMINAZIONE tramite strumento o wrapper API.
NB: Quasi mai autonomo in produzione; replica di sola lettura per gli agenti.
Il browser invia
Esempi: Invio del modulo, pagamento, azioni amministrative nella sessione di accesso.
NB: Richiesta di iniezione → azione UI; approvazioni + ambito di dominio.
Comandi del terminale
Esempi: Shell arbitraria tramite runtime dello strumento.
NB: Superficie RCE; negazione predefinita in produzione, approvazione + lista di autorizzazione.
governance
Gestione degli strumenti in produzione
ambiti di approvazione
Le chiamate di strumenti di modifica attendono in coda fino all'approvazione da parte dell'approvatore autorizzato — vedi approvazioni.
RBAC e liste di strumenti consentiti
Quale flusso di lavoro può essere utilizzato con quale strumento? RBAC e autorizzazioni.
minimo privilegio
Set minimo di strumenti per agente; nessun "super-agente" con tutte le funzionalità.
Strumenti isolati
Profilo del browser, contenitore, chiave API separata per contesto dello strumento: isolamento delle funzionalità.
Tracce di controllo
Nome dello strumento, riepilogo del payload, ID dell'approvatore, ID di correlazione nei log.
Registrazione
registri openclaw --follow + conservazione centralizzata — senza registri, nessuna analisi post-mortem in caso di uso improprio.
Fallimenti
Quando l'esecuzione dello strumento non va a buon fine
azioni allucinate
L'agente chiama uno strumento inesistente o utilizza parametri errati: il gateway deve registrare l'errore di chiusura.
Scegliere lo strumento sbagliato
L'agente di smistamento della posta seleziona lo strumento shell: la lista di elementi consentiti è troppo ampia, non si tratta solo di un errore del modello.
Tentativi e fuga
Stesso passaggio di mutazione 20 volte dopo il timeout: limiti di frequenza e numero massimo di tentativi per flusso di lavoro.
Problemi del browser
DOM obsoleto, sessione scaduta, CAPTCHA: sembra un "problema di IA", spesso si tratta di stato della sessione/strumento.
Errori terminali
Comando plausibile, percorso distruttivo: le approvazioni mostrano la riga esatta prima dell'esecuzione.
Debug: Problemi di OpenClaw · Prima accedi, poi cancella i dati.
MCP e chiamata degli strumenti
Esecuzione strutturata,
non automaticamente sicuro
Risposta breve: MCP e la chiamata di strumenti rendono le integrazioni prevedibili: la governance rimane a livello di Gateway (politiche, approvazioni, RBAC).
- → Modello ↔ strumento: LLM seleziona uno strumento e argomenti strutturati; il Gateway esegue e restituisce il risultato, eliminando così il limite del "solo testo".
- → Esecuzione strutturata: MCP e la chiamata di strumenti standardizzano gli schemi, il che è utile per le integrazioni, ma non costituisce di per sé un livello di sicurezza.
- → Perché la governance: Più strumenti = più superficie di chiamata; il protocollo non ha un "punto sicuro" — solo politiche, RBAC e sandbox.
- → Perché le approvazioni: È necessario l'intervento umano prima che lo strumento produca risultati irreversibili, soprattutto tramite l'invio del browser e la shell.
Concentrati sulla produzione: quali strumenti sono esposti, chi li approva e cosa registri. L'aggiunta di server MCP crea una nuova superficie di chiamata, con la stessa procedura di revisione degli strumenti nativi.
produzione
Utensili
lista di controllo
Combinare con Isolamento Docker e flusso di lavoro- ambiti per agente.
Sovraesposizione
Quando gli agenti hanno troppi strumenti
Risposta breve: Le liste di strumenti consentiti troppo ampie aumentano il rischio di selezione errata degli strumenti, di catene di iniezione e di affaticamento da approvazione.
Escalation dei privilegi
L'agente con config-write o strumento di credenziali può ampliare le proprie capacità: negare in produzione.
Uso improprio del browser
Sessione amministrativa + strumento di navigazione avanzata = l'iniezione si trasforma in acquisizione dell'account.
Danni al filesystem
Strumenti di eliminazione/sincronizzazione senza elenco di percorsi consentiti: un'allucinazione = incidente.
Fuga di segreti
Strumento di lettura nella directory home + l'agente incolla l'output nel canale.
rischio di elusione dell'approvazione
Troppe scritture "di piccole dimensioni" con approvazione automatica: l'attaccante concatena piccoli passaggi.
Risposta breve: Funzionalità richiamabili sul gateway OpenClaw — browser, shell, filesystem, API, posta elettronica — che il modello può richiamare tramite tool-calling/MCP con argomenti strutturati.
Sfumatura: eseguire gli strumenti; la risposta in chat non sostituisce la supervisione su tale esecuzione.
Seguito: flussi di lavoro · Centro
Risposta breve: Shell, scrittura/eliminazione su file system, invio tramite browser, invio/eliminazione di email, modifica delle API, scritture su database di produzione, strumenti di configurazione/credenziali.
Causa: effetti collaterali irreversibili o critici per l'aderenza alla terapia.
Seguito: Sicurezza · approvazioni
Risposta breve: Senza un gate, ogni chiamata di strumento è un'esecuzione diretta: il piano di errore o l'iniezione diventano azione.
Sfumatura: Gli strumenti di sola lettura possono essere più leggeri; quelli distruttivi, invece, potrebbero non esserlo.
Seguito: approvazioni
Risposta breve: Strumenti che non hanno un effetto collaterale di modifica: log, stato, GET in sola lettura, lettura del DOM senza invio.
Causa: Sola lettura ≠ sicuro: segreti e dati personali possono comunque essere divulgati.
Consiglio: path-allowlist + audit.
Risposta breve: Sì, se lo strumento shell è nell'ambito di applicazione, ovvero come utente Gateway su un host o in un container.
Causa: Il guscio è la superficie RCE; lo strumento più restrittivo in produzione.
Seguito: approvazione + RBAC + nessuna radice.
Risposta breve: Utilizzano sessioni con accesso effettuato e possono eseguire l'invio/il clic: l'iniezione del prompt diventa un'azione dell'interfaccia utente.
Causa: nessuna sandbox solo testuale.
Seguito: Automazione del browser · Lista di domini consentiti · Approvazioni all'invio.
Utensili
Strumenti sicuri e
architettura agente
Esaminiamo gli elenchi degli strumenti consentiti, l'esposizione a MCP, le politiche di approvazione e i log sul tuo Gateway: si tratta di audit di implementazione per team self-hosted, non di un marketplace di competenze di intelligenza artificiale.