Pular para o conteúdo principal
Recursos experimentais no OpenClaw são superfícies de prévia opcionais. Eles ficam atrás de flags explícitas porque ainda precisam de uso no mundo real antes de merecerem um padrão estável ou um contrato público duradouro. Trate-os de forma diferente da configuração normal:
  • Mantenha-os desativados por padrão, a menos que a documentação relacionada diga para você experimentar um.
  • Espere que forma e comportamento mudem mais rapidamente do que na configuração estável.
  • Prefira primeiro o caminho estável quando já houver um.
  • Se você estiver implantando o OpenClaw em larga escala, teste flags experimentais em um ambiente menor antes de incorporá-las a uma base compartilhada.

​
Flags documentadas atualmente

SuperfícieChaveUse quandoMais
Runtime de modelo localagents.defaults.experimental.localModelLean, agents.list[].experimental.localModelLeanUm backend local menor ou mais rigoroso engasga com a superfície completa de ferramentas padrão do OpenClawModelos locais
Busca de memóriaagents.defaults.memorySearch.experimental.sessionMemoryVocê quer que memory_search indexe transcrições de sessões anteriores e aceita o custo extra de armazenamento/indexaçãoReferência de configuração de memória
Harness do Codexplugins.entries.codex.config.appServer.experimental.sandboxExecServerVocê quer que o app-server nativo do Codex 0.132.0 ou mais recente use um exec-server apoiado pelo sandbox do OpenClaw em vez de desativar o Modo de CódigoReferência do harness do Codex
Ferramenta de planejamento estruturadotools.experimental.planToolVocê quer a ferramenta estruturada update_plan exposta para acompanhamento de trabalho em várias etapas em runtimes e UIs compatíveisReferência de configuração do Gateway

​
Modo enxuto de modelo local

agents.defaults.experimental.localModelLean: true é uma válvula de alívio para configurações de modelo local mais fracas. Quando ativado, o OpenClaw remove três ferramentas padrão — browser, cron e message — da superfície de ferramentas do agente em cada turno. Ele também faz esse run usar por padrão controles estruturados de Tool Search quando tools.toolSearch não está configurado explicitamente, para que catálogos maiores de ferramentas de Plugin, MCP ou cliente fiquem atrás de tool_search, tool_describe e tool_call em vez de serem despejados no prompt. Runs que exigem entrega direta por message mantêm essa ferramenta direta em vez de habilitar o padrão de Tool Search do modo enxuto. Use agents.list[].experimental.localModelLean para habilitar ou desabilitar o mesmo comportamento para um agente configurado.

​
Por que estas três ferramentas

Estas três ferramentas têm as maiores descrições e a maior quantidade de formatos de parâmetros no runtime padrão do OpenClaw. Em um backend compatível com OpenAI com contexto pequeno ou mais rigoroso, essa é a diferença entre:
  • Esquemas de ferramentas caberem limpidamente no prompt vs. ocuparem o espaço do histórico da conversa.
  • O modelo escolher a ferramenta certa vs. emitir chamadas de ferramenta malformadas porque há esquemas demais com aparência semelhante.
  • O adaptador de Chat Completions permanecer dentro dos limites de saída estruturada do servidor vs. disparar um 400 por tamanho do payload de chamada de ferramenta.
Removê-las não reconecta o OpenClaw silenciosamente — apenas encurta a lista direta de ferramentas. O modelo ainda tem read, write, edit, exec, apply_patch, busca/busca de conteúdo na web (quando configurada), memória e ferramentas de sessão/agente disponíveis. Catálogos extras continuam chamáveis por meio do Tool Search, a menos que você defina explicitamente tools.toolSearch: false.

​
Quando ativar

Habilite o modo enxuto quando você já tiver comprovado que o modelo consegue falar com o Gateway, mas turnos completos do agente se comportam mal. A cadeia típica de sinais é:
  1. openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong" funciona.
  2. Um turno normal do agente falha com chamadas de ferramenta malformadas, prompts grandes demais ou o modelo ignorando suas ferramentas.
  3. Alternar localModelLean: true elimina a falha.

​
Quando deixar desativado

Se o seu backend lida bem com o runtime padrão completo, deixe isto desativado. O modo enxuto é uma solução alternativa, não um padrão. Ele existe porque algumas pilhas locais precisam de uma superfície de ferramentas menor para se comportar; modelos hospedados e rigs locais bem dimensionados não precisam. O modo enxuto também não substitui tools.profile, tools.allow/tools.deny nem a válvula de escape compat.supportsTools: false do modelo. Se você precisa de uma superfície de ferramentas permanentemente mais estreita para um agente específico, prefira esses controles estáveis em vez da flag experimental. Se você já ajusta o Tool Search globalmente, o OpenClaw deixa essa configuração do operador intacta. Defina tools.toolSearch: false para sair do padrão de Tool Search do modo enxuto.

​
Habilitar

{
  agents: {
    defaults: {
      experimental: {
        localModelLean: true,
      },
    },
  },
}
Apenas para um agente: 
{
  agents: {
    list: [
      {
        id: "local",
        model: "lmstudio/gemma-4-e4b-it",
        experimental: {
          localModelLean: true,
        },
      },
    ],
  },
}
Reinicie o Gateway depois de alterar a flag e confirme a lista reduzida de ferramentas com: 
openclaw status --deep
A saída de status profundo lista as ferramentas ativas do agente; browser, cron e message devem estar ausentes quando o modo enxuto estiver ativado, a menos que o modo de entrega atual force respostas diretas por message.

​
Experimental não significa oculto

Se um recurso é experimental, o OpenClaw deve dizer isso claramente na documentação e no próprio caminho de configuração. O que ele não deve fazer é infiltrar comportamento de prévia em um controle com aparência estável e fingir que isso é normal. É assim que superfícies de configuração ficam bagunçadas.

​
Relacionado