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 instradamento. Per criteri completi sugli strumenti, impostazioni predefinite, 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 richiede 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ò richiamare un agente | Criteri degli strumenti | Strumenti e provider personalizzati |
| Insegnare un workflow a un agente | Skills | Skills, Creazione di Skills e Skill Workshop |
| Aggiungere una nuova integrazione o superficie di runtime | Plugin | Plugin e Creare Plugin |
| Eseguire lavoro in seguito o in background | Automazione | Panoramica dell'automazione |
| Coordinare più agenti o harness | Sub-agenti | Agenti ACP e Invio agente |
| Cercare in un grande catalogo di strumenti OpenClaw | Tool Search | Tool Search |
Scegli 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, 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 il profilo attivo, i criteri allow/deny, le restrizioni del provider, lo stato sandbox, i permessi del canale e la 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 richiede un workflow
ripetibile, una rubrica di revisione, una sequenza di comandi o un vincolo operativo.
Le Skills possono risiedere in un workspace, in una directory Skills condivisa, in una root Skills gestita da OpenClaw o in un pacchetto Plugin.
Skills | Skill Workshop | Creazione di Skills | Configurazione Skills
Usa un Plugin quando OpenClaw richiede una nuova capacità
Un Plugin può aggiungere strumenti, Skills, canali, provider di modelli, voce, voce realtime, generazione di media, ricerca web, recupero web, hook e altre capacità di runtime. Usa un Plugin quando la capacità include codice, credenziali, hook di lifecycle, metadati manifest o pacchettizzazione installabile. I Plugin esistenti possono essere installati da ClawHub, npm, git, directory locali o archivi.
Installare e configurare Plugin | Creare Plugin | Plugin SDK
Categorie di strumenti integrate
La tabella elenca strumenti rappresentativi per aiutarti a riconoscere la superficie. Non è il riferimento completo dei criteri. Per gruppi esatti, impostazioni predefinite e semantica allow/deny, 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 del codice |
| File | Leggere e modificare file del workspace | read, write, edit, apply_patch |
Apply patch |
| Web | Cercare sul web, cercare post X o recuperare contenuti leggibili di pagine | web_search, x_search, web_fetch |
Strumenti web, Web fetch |
| 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 segnalare lo stato | sessions_*, subagents, agents_list, session_status, goal |
Goal, Sub-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 pronunciare media | image, image_generate, music_generate, video_generate, tts |
Panoramica media |
| Grandi cataloghi OpenClaw | Cercare e richiamare molti strumenti idonei senza inviare ogni schema al modello | tool_search_code, tool_search, tool_describe |
Tool Search |
Strumenti forniti dai Plugin
I Plugin possono registrare strumenti aggiuntivi. Gli autori di Plugin collegano gli strumenti tramite
api.registerTool(...) e contracts.tools del manifest; usa
Plugin SDK e Manifest Plugin
per i dettagli del contratto.
Gli strumenti comuni forniti dai Plugin includono:
- Diff per renderizzare diff di file e markdown
- LLM Task per passaggi di workflow solo JSON
- Lobster per workflow tipizzati con approvazioni riprendibili
- Tokenjuice per comprimere output rumoroso degli strumenti
execebash - Tool Search per scoprire e richiamare grandi cataloghi di strumenti senza inserire ogni schema nel prompt
- Canvas per il controllo Canvas di Node e il rendering A2UI
Configura 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 sandbox, dei criteri canale/runtime o della disponibilità dei Plugin.
- Strumenti e provider personalizzati documenta profili degli strumenti, elenchi allow/deny, restrizioni specifiche dei provider, rilevamento loop e impostazioni degli strumenti supportati da provider.
- Approvazioni exec documenta i criteri di approvazione dei comandi host.
- Exec elevato documenta l'esecuzione controllata fuori dalla sandbox.
- Sandbox vs criteri strumenti vs elevato spiega quale livello controlla l'accesso a file e processi.
- Sandbox e restrizioni strumenti per agente documenta le restrizioni specifiche degli agenti per le esecuzioni delegate.
Estendi 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 Creare Plugin.
- Aggiungi o perfeziona istruzioni riutilizzabili per agenti con Skills e Creazione di Skills.
- Usa Plugin SDK e Manifest Plugin quando hai bisogno di contratti di implementazione.
Risoluzione dei problemi degli 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.allowetools.denyin Strumenti e provider personalizzati. - Controlla le restrizioni specifiche del provider in Strumenti e provider personalizzati e conferma che il provider del modello selezionato supporti la forma dello strumento.
- Controlla i permessi del canale, lo stato sandbox e l'accesso elevato con Sandbox vs criteri 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 e restrizioni strumenti per agente.
- Per grandi cataloghi OpenClaw, conferma se l'esecuzione usa l'esposizione diretta degli strumenti o Tool Search.
Correlati
- Automazione per cron, attività, heartbeat, impegni, hook, ordini permanenti e Task Flow
- Agenti per il modello agente, sessioni, memoria e coordinamento multi-agente
- Strumenti e provider personalizzati per il riferimento canonico dei criteri 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
- Skill Workshop per creazione di Skills generate e revisionate
- Tool Search per scoperta compatta del catalogo strumenti OpenClaw
