Vai al contenuto principale
Le funzionalità sperimentali in OpenClaw sono superfici di anteprima opt-in. Sono dietro flag espliciti perché hanno ancora bisogno di essere provate nel mondo reale prima di meritare un valore predefinito stabile o un contratto pubblico duraturo. Trattale in modo diverso dalla configurazione normale:
  • Tienile disattivate per impostazione predefinita, a meno che la documentazione correlata non ti dica di provarne una.
  • Aspettati che forma e comportamento cambino più rapidamente rispetto alla configurazione stabile.
  • Preferisci prima il percorso stabile quando ne esiste già uno.
  • Se stai distribuendo OpenClaw su larga scala, prova i flag sperimentali in un ambiente più piccolo prima di integrarli in una baseline condivisa.

Flag attualmente documentati

SuperficieChiaveUsalo quandoAltro
Runtime del modello localeagents.defaults.experimental.localModelLean, agents.list[].experimental.localModelLeanUn backend locale più piccolo o più rigoroso va in difficoltà con la superficie completa degli strumenti predefiniti di OpenClawModelli locali
Ricerca in memoriaagents.defaults.memorySearch.experimental.sessionMemoryVuoi che memory_search indicizzi le trascrizioni delle sessioni precedenti e accetti il costo extra di archiviazione/indicizzazioneRiferimento configurazione memoria
Harness Codexplugins.entries.codex.config.appServer.experimental.sandboxExecServerVuoi che l’app-server nativo Codex 0.132.0 o più recente usi come target un exec-server basato su sandbox OpenClaw invece di disabilitare la Modalità CodiceRiferimento harness Codex
Strumento di pianificazione strutturatatools.experimental.planToolVuoi esporre lo strumento strutturato update_plan per tracciare lavori in più passaggi in runtime e UI compatibiliRiferimento configurazione Gateway

Modalità snella per modello locale

agents.defaults.experimental.localModelLean: true è una valvola di sfogo per configurazioni di modelli locali più deboli. Quando è attiva, OpenClaw rimuove tre strumenti predefiniti — browser, cron e message — dalla superficie degli strumenti dell’agente per ogni turno. Inoltre, per quell’esecuzione usa per impostazione predefinita controlli strutturati di Ricerca strumenti quando tools.toolSearch non è configurato esplicitamente, così cataloghi di strumenti più grandi di Plugin, MCP o client restano dietro tool_search, tool_describe e tool_call invece di essere scaricati nel prompt. Le esecuzioni che richiedono la consegna diretta di message mantengono quello strumento diretto invece di abilitare il valore predefinito di Ricerca strumenti della modalità snella. Usa agents.list[].experimental.localModelLean per abilitare o disabilitare lo stesso comportamento per un singolo agente configurato.

Perché questi tre strumenti

Questi tre strumenti hanno le descrizioni più grandi e il maggior numero di forme di parametri nel runtime OpenClaw predefinito. Su un backend con contesto ridotto o compatibile con OpenAI ma più rigoroso, questa è la differenza tra:
  • Schemi degli strumenti che entrano pulitamente nel prompt invece di comprimere la cronologia della conversazione.
  • Il modello che sceglie lo strumento giusto invece di emettere chiamate agli strumenti malformate perché ci sono troppi schemi dall’aspetto simile.
  • L’adapter Chat Completions che resta entro i limiti di output strutturato del server invece di incorrere in un 400 per la dimensione del payload delle chiamate agli strumenti.
Rimuoverli non riconnette silenziosamente OpenClaw in modo diverso: rende solo più breve l’elenco degli strumenti diretti. Il modello ha ancora a disposizione read, write, edit, exec, apply_patch, ricerca/recupero web (quando configurati), memoria e strumenti di sessione/agente. I cataloghi extra restano richiamabili tramite Ricerca strumenti, a meno che tu non imposti esplicitamente tools.toolSearch: false.

Quando attivarla

Abilita la modalità snella quando hai già dimostrato che il modello può comunicare con il Gateway ma i turni completi dell’agente si comportano male. La catena di segnali tipica è:
  1. openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong" riesce.
  2. Un turno normale dell’agente fallisce con chiamate agli strumenti malformate, prompt troppo grandi o il modello che ignora i suoi strumenti.
  3. Attivare localModelLean: true risolve l’errore.

Quando lasciarla disattivata

Se il tuo backend gestisce pulitamente il runtime predefinito completo, lasciala disattivata. La modalità snella è un workaround, non un valore predefinito. Esiste perché alcuni stack locali hanno bisogno di una superficie degli strumenti più piccola per comportarsi correttamente; i modelli ospitati e le configurazioni locali ben dimensionate no. La modalità snella inoltre non sostituisce tools.profile, tools.allow/tools.deny o la via di fuga compat.supportsTools: false del modello. Se hai bisogno di una superficie degli strumenti permanentemente più stretta per un agente specifico, preferisci queste manopole stabili al flag sperimentale. Se configuri già Ricerca strumenti a livello globale, OpenClaw lascia invariata quella configurazione dell’operatore. Imposta tools.toolSearch: false per disattivare il valore predefinito di Ricerca strumenti della modalità snella.

Abilitazione

{
  agents: {
    defaults: {
      experimental: {
        localModelLean: true,
      },
    },
  },
}
Solo per un agente:
{
  agents: {
    list: [
      {
        id: "local",
        model: "lmstudio/gemma-4-e4b-it",
        experimental: {
          localModelLean: true,
        },
      },
    ],
  },
}
Riavvia il Gateway dopo aver modificato il flag, poi conferma l’elenco ridotto degli strumenti con:
openclaw status --deep
L’output di stato approfondito elenca gli strumenti attivi dell’agente; browser, cron e message dovrebbero essere assenti quando la modalità snella è attiva, a meno che la modalità di consegna corrente non forzi risposte dirette tramite message.

Sperimentale non significa nascosto

Se una funzionalità è sperimentale, OpenClaw dovrebbe dirlo chiaramente nella documentazione e nello stesso percorso di configurazione. Ciò che non dovrebbe fare è infilare di nascosto un comportamento di anteprima in una manopola predefinita dall’aspetto stabile e fingere che sia normale. È così che le superfici di configurazione diventano disordinate.

Correlati