Skip to main content
Usa questa pagina per scegliere la superficie di funzionalità corretta. Gli strumenti sono azioni richiamabili, le Skills insegnano agli agenti come operare e i Plugin aggiungono funzionalità di runtime quali strumenti, provider, canali, hook e Skills distribuite come pacchetti. Questa è una pagina introduttiva e di orientamento. Per informazioni complete su criteri degli strumenti, impostazioni predefinite, appartenenza ai gruppi, restrizioni dei provider e campi di configurazione, consulta Strumenti e provider personalizzati.

​
Da qui

Per la maggior parte degli agenti, inizia con le categorie di strumenti integrate, quindi modifica i criteri solo quando l’agente deve visualizzare meno strumenti o necessita di accesso esplicito all’host.

​
Scegliere strumenti, Skills o Plugin

1

Usa uno strumento quando l'agente deve agire

Uno strumento è una funzione tipizzata che l’agente può richiamare, come exec, browser, web_search, message o image_generate. Usa gli strumenti quando l’agente deve leggere dati, modificare file, inviare messaggi, richiamare un provider o utilizzare un altro sistema. Gli strumenti visibili vengono inviati al modello come definizioni di funzione strutturate.Il modello vede solo gli strumenti che superano il profilo attivo, i criteri di autorizzazione/blocco, le restrizioni del provider, lo stato della sandbox, le autorizzazioni del canale e la disponibilità dei Plugin.
2

Usa una Skill quando l'agente necessita di istruzioni

Una Skill è un pacchetto di istruzioni SKILL.md caricato nel prompt dell’agente. Usa una Skill quando l’agente dispone già degli strumenti necessari, ma necessita di un flusso di lavoro ripetibile, criteri di revisione, una sequenza di comandi o un vincolo operativo.Le Skills possono trovarsi in uno spazio di lavoro, in una directory condivisa delle Skills, nella radice gestita delle Skills di OpenClaw o nel pacchetto di un Plugin.Skills | Laboratorio delle Skills | Creazione di Skills | Configurazione delle Skills
3

Usa un Plugin quando OpenClaw necessita di una nuova funzionalità

Un Plugin può aggiungere strumenti, Skills, canali, provider di modelli, sintesi vocale, voce in tempo reale, generazione di contenuti multimediali, ricerca web, recupero web, hook e altre funzionalità di runtime. Usa un Plugin quando la funzionalità include codice, credenziali, hook del ciclo di vita, metadati del manifesto o un pacchetto installabile. I Plugin esistenti possono essere installati da ClawHub, npm, git, directory locali o archivi.Installare e configurare i Plugin | Creare Plugin | SDK dei Plugin

​
Categorie di strumenti integrate

La tabella elenca strumenti rappresentativi per consentirti di riconoscere la superficie. Non è il riferimento completo dei criteri. Per gruppi esatti, impostazioni predefinite e semantica di autorizzazione/blocco, consulta Strumenti e provider personalizzati.
La Ricerca strumenti è una superficie sperimentale per gli agenti OpenClaw. Le esecuzioni dell’infrastruttura Codex usano la modalità codice nativa di Codex, la ricerca strumenti nativa, gli strumenti dinamici differiti e le chiamate di strumenti annidate invece di tools.toolSearch.

​
Strumenti forniti dai Plugin

I Plugin possono registrare strumenti aggiuntivi. Gli autori dei Plugin collegano gli strumenti tramite api.registerTool(...) e contracts.tools del manifesto; consulta SDK dei Plugin e Manifesto dei Plugin per i dettagli dei contratti. Gli strumenti comunemente forniti dai Plugin includono:
  • Differenze per rappresentare le differenze tra file e Markdown
  • Visualizzazione widget per SVG e HTML autonomi incorporati nella chat web
  • Attività LLM per passaggi del flusso di lavoro esclusivamente JSON
  • Lobster per flussi di lavoro tipizzati con approvazioni ripristinabili
  • Tokenjuice per compattare l’output prolisso degli strumenti exec e bash
  • Ricerca strumenti per individuare e richiamare ampi cataloghi di strumenti senza inserire ogni schema nel prompt
  • Canvas per il controllo di Canvas sui nodi e la rappresentazione A2UI

​
Configurare accesso e approvazioni

I criteri degli strumenti vengono applicati prima della chiamata al modello. Se i criteri rimuovono uno strumento, il modello non riceve lo schema di tale strumento per il turno. Un’esecuzione può perdere strumenti a causa della configurazione globale, della configurazione per agente, dei criteri del canale, delle restrizioni del provider, delle regole della sandbox, dei criteri del canale/runtime o della disponibilità dei Plugin.

​
Estendere le funzionalità

Scegli il percorso di estensione in base all’attività che OpenClaw deve svolgere:

​
Risolvere i problemi relativi agli strumenti mancanti

Se il modello non può vedere o richiamare uno strumento, inizia dai criteri effettivi per il turno corrente:
  1. Controlla il profilo attivo, tools.allow e tools.deny in Strumenti e provider personalizzati.
  2. Controlla le restrizioni specifiche del provider in Strumenti e provider personalizzati e verifica che il provider del modello selezionato supporti la struttura dello strumento.
  3. Controlla le autorizzazioni del canale, lo stato della sandbox e l’accesso con privilegi elevati tramite Sandbox, criteri degli strumenti ed esecuzione con privilegi elevati ed Exec con privilegi elevati.
  4. Controlla se il Plugin proprietario è installato e abilitato in Plugin.
  5. Per le esecuzioni delegate, controlla le restrizioni per agente in Sandbox per agente e restrizioni degli strumenti.
  6. Per gli ampi cataloghi OpenClaw, verifica se l’esecuzione usa l’esposizione diretta degli strumenti o la Ricerca strumenti.

​
Contenuti correlati

  • Automazione per Cron, attività, Heartbeat, impegni, hook, ordini permanenti e TaskFlow
  • Agenti per il modello di agente, le sessioni, la memoria e il coordinamento multi-agente
  • Strumenti e provider personalizzati per il riferimento canonico ai criteri degli strumenti
  • Plugin per l’installazione e la gestione dei Plugin
  • SDK dei Plugin come riferimento per gli autori di Plugin
  • Skills per l’ordine di caricamento, le condizioni di attivazione e la configurazione delle Skills
  • Laboratorio delle Skills per la creazione di Skills generate e sottoposte a revisione
  • Ricerca degli strumenti per esplorare il catalogo compatto degli strumenti di OpenClaw