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.Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
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 SkillsUsa 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 |
Ricerca strumenti è una superficie sperimentale per agenti PI. Le esecuzioni con harness Codex usano
la modalità codice nativa di Codex, la ricerca strumenti nativa, strumenti dinamici differiti e chiamate
di strumenti annidate invece di
tools.toolSearch.Strumenti forniti dai Plugin
I Plugin possono registrare strumenti aggiuntivi. Gli autori di Plugin cablano gli strumenti tramiteapi.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
execebash - 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.allowetools.denyin 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