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.

✓ Chiamata utensile / MCP
✓ Sola lettura vs. mutazione
✓ Approvazione soggetta a restrizioni
✓ Tracce di controllo

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à.

RBAC · approvazioni · Sicurezza

Chiamata
strutturato
Esecutivo
Gateway
Cancello
Approvazione
Tronco d'albero
audit

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.

Leggere

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.

Scrivere

Scritture del filesystem

Esempi: Creare, sovrascrivere, eliminare al di fuori della cartella tmp.

NB: Percorso errato = perdita di dati; approvazione + limiti di montaggio.

DB

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.

Sito web

Il browser invia

Esempi: Invio del modulo, pagamento, azioni amministrative nella sessione di accesso.

NB: Richiesta di iniezione → azione UI; approvazioni + ambito di dominio.

Conchiglia

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

Piano

azioni allucinate

L'agente chiama uno strumento inesistente o utilizza parametri errati: il gateway deve registrare l'errore di chiusura.

Selezionare

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.

Riprova

Tentativi e fuga

Stesso passaggio di mutazione 20 volte dopo il timeout: limiti di frequenza e numero massimo di tentativi per flusso di lavoro.

Sito web

Problemi del browser

DOM obsoleto, sessione scaduta, CAPTCHA: sembra un "problema di IA", spesso si tratta di stato della sessione/strumento.

Conchiglia

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.
⚠️ Nessun protocollo, approfondimento

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.

📋 produzione di strumenti per agenti

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.

FAQ

Strumenti per gli agenti —
risposta diretta

Esecuzione degli strumenti, rischi e governance: prima una breve panoramica.

Domanda di architettura →

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: Lista minima di elementi consentiti, approvazioni sulle modifiche, RBAC, sessioni isolate, registrazione, limiti di tentativi, negazione della scrittura della configurazione.

Causa: Uso improprio = strumenti troppo generici + nessuna verifica.

Seguito: registri incidente Problemi

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.

✓ Governance degli strumenti
✓ Audit di implementazione
✓ limiti di capacità