Overview

Panoramica

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.

Se devi...	Usa prima questo	Quindi consulta
Consentire a un agente di usare le funzionalità esistenti	Strumenti integrati	Categorie di strumenti
Controllare ciò che un agente può richiamare	Criteri degli strumenti	Strumenti e provider personalizzati
Insegnare un flusso di lavoro a un agente	Skills	Skills, Creazione di Skills e Laboratorio delle Skills
Aggiungere una nuova integrazione o superficie di runtime	Plugin	Plugin e Creazione di Plugin
Eseguire attività in seguito o in background	Automazione	Panoramica dell'automazione
Coordinare più agenti o infrastrutture di esecuzione	Sottoagenti	Agenti ACP e Invio dell'agente
Cercare in un ampio catalogo di strumenti OpenClaw	Ricerca strumenti	Ricerca strumenti

Scegliere strumenti, Skills o Plugin

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.

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

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.

Categoria	Da usare quando l'agente deve...	Strumenti rappresentativi	Consulta anche
Runtime	Eseguire comandi, gestire processi o usare analisi Python supportate da un provider	`exec`, `process`, `code_execution`	Exec, Esecuzione del codice
File	Leggere e modificare i file dello spazio di lavoro	`read`, `write`, `edit`, `apply_patch`	Applicazione delle patch
Web	Cercare sul web, cercare post su X o recuperare contenuti leggibili dalle pagine	`web_search`, `x_search`, `web_fetch`	Strumenti web, Recupero web
Browser	Utilizzare una sessione del browser	`browser`	Browser
Messaggistica e canali	Inviare risposte o azioni del canale	`message`	Invio dell'agente
Sessioni e agenti	Esaminare sessioni, delegare attività, dirigere un'altra esecuzione o segnalare lo stato	`sessions_*`, `subagents`, `agents_list`, `session_status`, `get_goal`, `create_goal`, `update_goal`	Obiettivo, Sottoagenti, Strumento di sessione
Automazione	Pianificare attività o rispondere a eventi in background	`cron`, `heartbeat_respond`	Automazione
Gateway e nodi	Esaminare lo stato del Gateway o i dispositivi di destinazione associati	`gateway`, `nodes`	Configurazione del Gateway, Nodi
Contenuti multimediali	Analizzare, generare o riprodurre vocalmente contenuti multimediali	`image`, `image_generate`, `music_generate`, `video_generate`, `tts`	Panoramica dei contenuti multimediali
Ampi cataloghi OpenClaw	Cercare e richiamare molti strumenti idonei senza inviare ogni schema al modello	`tool_search_code`, `tool_search`, `tool_describe`	Ricerca strumenti

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.

Strumenti e provider personalizzati documenta i profili degli strumenti, gli elenchi di autorizzazione/blocco, le restrizioni specifiche dei provider, il rilevamento dei cicli e le impostazioni degli strumenti supportati dai provider.
Approvazioni di Exec documenta i criteri di approvazione dei comandi dell'host.
Exec con privilegi elevati documenta l'esecuzione controllata al di fuori della sandbox.
Sandbox, criteri degli strumenti ed esecuzione con privilegi elevati spiega quale livello controlla l'accesso ai file e ai processi.
Sandbox per agente e restrizioni degli strumenti documenta le restrizioni specifiche dell'agente per le esecuzioni delegate.

Estendere le funzionalità

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

Installa o gestisci un Plugin esistente con Plugin.
Crea una nuova integrazione, un provider, un canale, uno strumento o un hook con Creazione di Plugin.
Aggiungi o perfeziona istruzioni riutilizzabili per gli agenti con Skills e Creazione di Skills.
Usa SDK dei Plugin e Manifesto dei Plugin quando necessiti dei contratti di implementazione.

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:

Controlla il profilo attivo, tools.allow e tools.deny in Strumenti e provider personalizzati.
Controlla le restrizioni specifiche del provider in Strumenti e provider personalizzati e verifica che il provider del modello selezionato supporti la struttura dello strumento.
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.
Controlla se il Plugin proprietario è installato e abilitato in Plugin.
Per le esecuzioni delegate, controlla le restrizioni per agente in Sandbox per agente e restrizioni degli strumenti.
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

Was this useful?