Overview

Panoramica

Usa questa pagina per scegliere la superficie Capabilities corretta. Gli strumenti sono azioni richiamabili, le Skills insegnano agli agenti come lavorare e i Plugin aggiungono capacità di runtime come strumenti, provider, canali, hook e Skills confezionate.

Questa è una pagina di panoramica e indirizzamento. Per criteri esaustivi sugli strumenti, valori predefiniti, appartenenza ai gruppi, restrizioni dei provider e campi di configurazione, usa Strumenti e provider personalizzati.

Inizia da qui

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

Se devi...	Usa prima questo	Poi leggi
Consentire a un agente di agire con capacità esistenti	Strumenti integrati	Categorie di strumenti
Controllare cosa può chiamare un agente	Criteri degli strumenti	Strumenti e provider personalizzati
Insegnare un workflow a un agente	Skills	Skills e Creazione di Skills
Aggiungere una nuova integrazione o superficie di runtime	Plugin	Plugin e Creare Plugin
Eseguire lavoro più tardi o in background	Automazione	Panoramica dell'automazione
Coordinare più agenti o harness	Sotto-agenti	Agenti ACP e Invio agente
Cercare in un ampio catalogo di strumenti PI	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ò chiamare, come exec, browser, web_search, message o image_generate. Usa gli strumenti quando l'agente deve leggere dati, modificare file, inviare messaggi, chiamare un provider o operare un altro sistema. Gli strumenti visibili vengono inviati al modello come definizioni di funzione strutturate.

Il modello vede solo gli strumenti che superano profilo attivo, criteri allow/deny, restrizioni dei provider, stato della sandbox, autorizzazioni del canale e disponibilità dei Plugin.

Usa una Skill quando l'agente ha bisogno di istruzioni

Una Skill è un pacchetto di istruzioni SKILL.md caricato nel prompt dell'agente. Usa una Skill quando l'agente ha già gli strumenti necessari, ma ha bisogno di un workflow ripetibile, una rubric di revisione, una sequenza di comandi o un vincolo operativo.

Le Skills possono trovarsi in un workspace, in una directory di Skills condivisa, nella root di Skills gestita da OpenClaw o in un pacchetto Plugin.

Skills | Creazione di Skills | Configurazione Skills

Usa un Plugin quando OpenClaw ha bisogno di una nuova capacità

Un Plugin può aggiungere strumenti, Skills, canali, provider di modelli, sintesi vocale, voce realtime, generazione multimediale, ricerca web, recupero web, hook e altre capacità di runtime. Usa un Plugin quando la capacità include codice, credenziali, hook del ciclo di vita, metadati del manifest o packaging installabile. I Plugin esistenti possono essere installati da ClawHub, npm, git, directory locali o archivi.

Installa e configura Plugin | Crea Plugin | Plugin SDK

Categorie di strumenti integrate

La tabella elenca strumenti rappresentativi così puoi riconoscere la superficie. Non è il riferimento completo dei criteri. Per gruppi, valori predefiniti e semantica allow/deny esatti, usa Strumenti e provider personalizzati.

Categoria	Usa quando l'agente deve...	Strumenti rappresentativi	Leggi dopo
Runtime	Eseguire comandi, gestire processi o usare analisi Python supportata da provider	`exec`, `process`, `code_execution`	Exec, Esecuzione di codice
File	Leggere e modificare file del workspace	`read`, `write`, `edit`, `apply_patch`	Applica patch
Web	Cercare nel web, cercare post X o recuperare contenuti di pagina leggibili	`web_search`, `x_search`, `web_fetch`	Strumenti web, Recupero web
Browser	Operare una sessione browser	`browser`	Browser
Messaggistica e canali	Inviare risposte o azioni di canale	`message`	Invio agente
Sessioni e agenti	Ispezionare sessioni, delegare lavoro, guidare un'altra esecuzione o riportare lo stato	`sessions_*`, `subagents`, `agents_list`, `session_status`	Sotto-agenti, Strumento sessione
Automazione	Pianificare lavoro o rispondere a eventi in background	`cron`, `heartbeat_respond`	Automazione
Gateway e nodi	Ispezionare lo stato del Gateway o dispositivi target associati	`gateway`, `nodes`	Configurazione Gateway, Nodi
Media	Analizzare, generare o parlare media	`image`, `image_generate`, `music_generate`, `video_generate`, `tts`	Panoramica media
Grandi cataloghi PI	Cercare e chiamare 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 di Plugin cablano gli strumenti tramite api.registerTool(...) e contracts.tools del manifest; usa Plugin SDK e Manifest Plugin per i dettagli dei contratti.

Gli strumenti comuni forniti dai Plugin includono:

Diff per il rendering di diff di file e markdown
Task LLM per passaggi di workflow solo JSON
Lobster per workflow tipizzati con approvazioni riprendibili
Tokenjuice per compattare output rumoroso degli strumenti exec e bash
Ricerca strumenti per scoprire e chiamare grandi cataloghi di strumenti senza mettere ogni schema nel prompt
Canvas per il controllo di Canvas Node e il rendering 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 quello strumento per il turno. Un'esecuzione può perdere strumenti a causa della configurazione globale, della configurazione per agente, dei criteri di canale, delle restrizioni dei provider, delle regole della sandbox, del gating riservato al proprietario o della disponibilità dei Plugin.

Strumenti e provider personalizzati documenta profili degli strumenti, elenchi allow/deny, restrizioni specifiche dei provider, rilevamento dei loop e impostazioni degli strumenti supportati dai provider.
Approvazioni exec documenta i criteri di approvazione dei comandi host.
Exec elevato documenta l'esecuzione controllata fuori dalla sandbox.
Sandbox vs criteri degli strumenti vs elevato spiega quale livello controlla l'accesso a file e processi.
Sandbox per agente e restrizioni degli strumenti documenta le restrizioni specifiche degli agenti per le esecuzioni delegate.

Estendere le capacità

Scegli il percorso di estensione in base al lavoro che OpenClaw deve svolgere:

Installa o gestisci un Plugin esistente con Plugin.
Crea una nuova integrazione, provider, canale, strumento o hook con Crea Plugin.
Aggiungi o regola istruzioni riutilizzabili per agenti con Skills e Creazione di Skills.
Confeziona materiale di workflow riutilizzabile con Laboratorio Skills quando il workflow appartiene a un bundle di Skills distribuito da Plugin.
Usa Plugin SDK e Manifest Plugin quando hai bisogno di contratti di implementazione.

Risolvere problemi di strumenti mancanti

Se il modello non riesce a vedere o chiamare 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 dei provider in Strumenti e provider personalizzati e conferma che il provider del modello selezionato supporti la forma dello strumento.
Controlla autorizzazioni del canale, stato della sandbox e accesso elevato con Sandbox vs criteri degli strumenti vs elevato e Exec elevato.
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 grandi cataloghi PI, conferma se l'esecuzione usa esposizione diretta degli strumenti o Ricerca strumenti.

Correlati

Automazione per cron, task, Heartbeat, commitment, hook, standing order e Task Flow
Agenti per il modello agente, sessioni, memoria e coordinamento multi-agente
Strumenti e provider personalizzati per il riferimento canonico dei criteri degli strumenti
Plugin per installazione e gestione dei Plugin
Plugin SDK per il riferimento degli autori di Plugin
Skills per ordine di caricamento, gating e configurazione delle Skill
Ricerca strumenti per la scoperta compatta di cataloghi di strumenti PI

Was this useful?