Vai al contenuto principale

​
Strumenti e plugin

Tutto ciò che l’agent fa oltre a generare testo avviene tramite gli strumenti. Gli strumenti sono il modo in cui l’agent legge file, esegue comandi, naviga sul web, invia messaggi e interagisce con i dispositivi.

​
Strumenti, Skills e plugin

OpenClaw ha tre livelli che lavorano insieme:
1

Gli strumenti sono ciò che l'agent richiama

Uno strumento è una funzione tipizzata che l’agent può invocare (ad esempio exec, browser, web_search, message). OpenClaw include un insieme di strumenti integrati e i plugin possono registrarne altri.L’agent vede gli strumenti come definizioni strutturate di funzione inviate all’API del modello.
2

Le Skills insegnano all'agent quando e come

Una Skill è un file markdown (SKILL.md) iniettato nel prompt di sistema. Le Skills forniscono all’agent contesto, vincoli e indicazioni passo passo per usare gli strumenti in modo efficace. Le Skills si trovano nel tuo workspace, in cartelle condivise, oppure vengono distribuite all’interno dei plugin.Riferimento Skills | Creare Skills
3

I plugin impacchettano tutto insieme

Un plugin è un pacchetto che può registrare qualsiasi combinazione di capability: canali, provider di modelli, strumenti, Skills, speech, realtime transcription, realtime voice, media understanding, image generation, video generation, web fetch, web search e altro. Alcuni plugin sono core (distribuiti con OpenClaw), altri sono esterni (pubblicati su npm dalla community).Installare e configurare plugin | Crea il tuo

​
Strumenti integrati

Questi strumenti sono inclusi in OpenClaw e sono disponibili senza installare alcun plugin:
StrumentoCosa faPagina
exec / processEsegue comandi shell, gestisce processi in backgroundExec
code_executionEsegue analisi Python remote in sandboxCode Execution
browserControlla un browser Chromium (naviga, clicca, screenshot)Browser
web_search / x_search / web_fetchCerca nel web, cerca post su X, recupera contenuto di pagineWeb
read / write / editI/O di file nel workspace
apply_patchPatch di file multi-hunkApply Patch
messageInvia messaggi su tutti i canaliAgent Send
canvasGuida il Canvas a nodi (present, eval, snapshot)
nodesRileva e seleziona dispositivi associati
cron / gatewayGestisce job pianificati; ispeziona, modifica, riavvia o aggiorna il gateway
image / image_generateAnalizza o genera immaginiGenerazione di immagini
music_generateGenera tracce musicaliGenerazione di musica
video_generateGenera videoGenerazione di video
ttsConversione text-to-speech singolaTTS
sessions_* / subagents / agents_listGestione sessioni, stato e orchestrazione di sub-agentSub-agent
session_statusLettura leggera in stile /status e override del modello di sessioneStrumenti di sessione
Per il lavoro sulle immagini, usa image per l’analisi e image_generate per la generazione o la modifica. Se scegli come target openai/*, google/*, fal/* o un altro provider image non predefinito, configura prima l’autenticazione/la chiave API di quel provider. Per il lavoro sulla musica, usa music_generate. Se scegli come target google/*, minimax/* o un altro provider music non predefinito, configura prima l’autenticazione/la chiave API di quel provider. Per il lavoro sui video, usa video_generate. Se scegli come target qwen/* o un altro provider video non predefinito, configura prima l’autenticazione/la chiave API di quel provider. Per la generazione audio guidata da workflow, usa music_generate quando un plugin come ComfyUI lo registra. Questo è separato da tts, che è text-to-speech. session_status è lo strumento leggero di stato/lettura nel gruppo sessions. Risponde a domande in stile /status sulla sessione corrente e può facoltativamente impostare un override del modello per sessione; model=default cancella tale override. Come /status, può completare in retrospettiva contatori sparsi di token/cache e l’etichetta del modello runtime attivo dall’ultima voce di utilizzo nella trascrizione. gateway è lo strumento runtime riservato al proprietario per le operazioni del gateway:
  • config.schema.lookup per un sottoalbero della configurazione limitato a un percorso prima delle modifiche
  • config.get per lo snapshot + hash della configurazione corrente
  • config.patch per aggiornamenti parziali della configurazione con riavvio
  • config.apply solo per la sostituzione completa della configurazione
  • update.run per auto-aggiornamento esplicito + riavvio
Per le modifiche parziali, preferisci config.schema.lookup e poi config.patch. Usa config.apply solo quando intendi sostituire l’intera configurazione. Lo strumento rifiuta anche di modificare tools.exec.ask o tools.exec.security; gli alias legacy tools.bash.* vengono normalizzati agli stessi percorsi exec protetti.

​
Strumenti forniti dai plugin

I plugin possono registrare strumenti aggiuntivi. Alcuni esempi:
  • Lobster — runtime di workflow tipizzato con approvazioni riprendibili
  • LLM Task — passaggio LLM solo JSON per output strutturato
  • Generazione di musica — strumento condiviso music_generate con provider supportati da workflow
  • Diffs — visualizzatore e renderer di diff
  • OpenProse — orchestrazione di workflow markdown-first

​
Configurazione degli strumenti

​
Liste di autorizzazione e negazione

Controlla quali strumenti l’agent può richiamare tramite tools.allow / tools.deny nella configurazione. La negazione ha sempre la precedenza sull’autorizzazione. 
{
  tools: {
    allow: ["group:fs", "browser", "web_search"],
    deny: ["exec"],
  },
}

​
Profili degli strumenti

tools.profile imposta una allowlist di base prima che vengano applicati allow/deny. Override per-agent: agents.list[].tools.profile.
ProfiloCosa include
fullNessuna restrizione (uguale a non impostato)
codinggroup:fs, group:runtime, group:web, group:sessions, group:memory, cron, image, image_generate, music_generate, video_generate
messaginggroup:messaging, sessions_list, sessions_history, sessions_send, session_status
minimalSolo session_status

​
Gruppi di strumenti

Usa le abbreviazioni group:* nelle liste allow/deny:
GruppoStrumenti
group:runtimeexec, process, code_execution (bash è accettato come alias di exec)
group:fsread, write, edit, apply_patch
group:sessionssessions_list, sessions_history, sessions_send, sessions_spawn, sessions_yield, subagents, session_status
group:memorymemory_search, memory_get
group:webweb_search, x_search, web_fetch
group:uibrowser, canvas
group:automationcron, gateway
group:messagingmessage
group:nodesnodes
group:agentsagents_list
group:mediaimage, image_generate, music_generate, video_generate, tts
group:openclawTutti gli strumenti integrati di OpenClaw (esclude gli strumenti dei plugin)
sessions_history restituisce una vista di richiamo limitata e filtrata per sicurezza. Rimuove tag di thinking, scaffolding <relevant-memories>, payload XML in testo semplice delle chiamate agli strumenti (inclusi <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls> e blocchi di chiamata agli strumenti troncati), scaffolding degradato delle chiamate agli strumenti, token di controllo del modello ASCII/full-width trapelati e XML malformato delle chiamate agli strumenti MiniMax dal testo dell’assistente, quindi applica redazione/troncamento e possibili placeholder per righe troppo grandi invece di comportarsi come dump grezzo della trascrizione.

​
Restrizioni specifiche del provider

Usa tools.byProvider per limitare gli strumenti per provider specifici senza modificare i valori predefiniti globali: 
{
  tools: {
    profile: "coding",
    byProvider: {
      "google-antigravity": { profile: "minimal" },
    },
  },
}