Experimental features

기준일: 2026-07-26
공식 기준: Experimental features

Experimental features 문서는 OpenClaw 공식 문서(concepts/experimental-features)를 한국어로 정리한 가이드입니다. What experimental flags mean in OpenClaw and which ones are currently documented 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

What experimental flags mean in OpenClaw and which ones are currently documented

한국어 가이드 범위: concepts/experimental-features 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• Currently documented flags
• Control UI Labs
• Local model lean mode
• Why these tools
• When to turn it on
• When to leave it off
• Enable
• Experimental does not mean hidden
• 관련 문서

상세 내용

본문

Experimental features are preview surfaces behind explicit flags. They need more real-world mileage before they get a stable default or a long-lived contract.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Off by default unless a doc describes a narrow automatic setup rule.
• Shape and behavior can change faster than stable config.
• Prefer a stable path when one already exists.
• Roll out broadly only after testing in a smaller environment first.

Currently documented flags

Surface	Key	Use it when	More
Local model runtime	agents.defaults.experimental.localModelLean, agents.entries.*.experimental.localModelLean	A smaller or stricter local backend chokes on OpenClaw's full default tool surface	Local Models
Codex harness	plugins.entries.codex.config.appServer.experimental.sandboxExecServer	You want native Codex app-server 0.132.0 or newer to target an OpenClaw sandbox-backed exec-server instead of disabling Code Mode	Codex harness reference
Structured planning tool	tools.experimental.planTool	You want the structured update_plan tool exposed for multi-step work tracking in compatible runtimes and UIs	Gateway configuration reference
Code Mode	tools.codeMode.enabled	You want compact code-orchestrated access to a hidden OpenClaw tool catalog	Code Mode
Swarm	tools.swarm.enabled	You want Code Mode scripts to orchestrate bounded groups of sub-agents in parallel	Swarm

Control UI Labs

Open Settings → Agents & Tools → Labs to manage experiments that have a Control UI switch. Enabling or disabling a lab patches the canonical Gateway config immediately; the page shows a restart hint only when a feature requires one.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Local model lean mode

agents.defaults.experimental.localModelLean: true drops heavyweight optional tools from the agent's direct surface every turn: browser, cron, message, image_generate, music_generate, video_generate, tts, and pdf. Explicitly allowed or delivery-required tools remain available, though Tool Search may catalog them instead of exposing them directly. Lean mode also defaults plugin/MCP/client catalogs to structured Tool Search (tool_search, tool_describe, tool_call) when tools.toolSearch is not already set. Use agents.entries.*.experimental.localModelLean to scope this to one agent.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Why these tools

These tools have the largest descriptions, broadest parameter shapes, or highest chance of distracting a small model from the normal coding and conversation path. On a small-context or stricter OpenAI-compatible backend that is the difference between:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Tool schemas fitting the prompt vs. crowding out conversation history.
• The model picking the right tool vs. emitting malformed tool calls from too many similar schemas.
• The Chat Completions adapter staying inside structured-output limits vs. a 400 on tool-call payload size.

When to turn it on

Enable lean mode once you have proved the model can talk to the Gateway but full agent turns misbehave:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

When to leave it off

If your backend handles the full default runtime cleanly, leave this off. It is a workaround for local stacks that need a smaller tool surface, not a default for hosted models or well-resourced local rigs.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Enable

Restart the Gateway after changing the flag. Lean filtering removes browser, cron, message, image_generate, music_generate, video_generate, tts, and pdf unless you explicitly preserve them with tools.allow or tools.alsoAllow; Tool Search may still catalog preserved tools instead of exposing them directly.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

{
  agents: {
    defaults: {
      experimental: {
        localModelLean: true,
      },
    },
  },
}

{
  agents: {
    list: [
      {
        id: "local",
        model: "lmstudio/gemma-4-e4b-it",
        experimental: {
          localModelLean: true,
        },
      },
    ],
  },
}

Experimental does not mean hidden

An experimental feature should say so plainly in docs and in the config path itself, not hide behind a stable-looking default knob.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

관련 문서

주요 항목:

• Features
• Release channels

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/concepts/experimental-features
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

{
  agents: {
    defaults: {
      experimental: {
        localModelLean: true,
      },
    },
  },
}

{
  agents: {
    list: [
      {
        id: "local",
        model: "lmstudio/gemma-4-e4b-it",
        experimental: {
          localModelLean: true,
        },
      },
    ],
  },
}

관련 링크

• 공식 원문: concepts/experimental-features
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.