실험적 기능

실험적 기능은 명시적 플래그 뒤에 있는 선택형 미리보기 기능입니다. 안정적인 기본값이나 장기적으로 유지되는 계약을 갖추기 전에 실제 환경에서 더 많은 검증이 필요합니다.

• 문서에서 활성화하라고 안내하지 않는 한 기본적으로 꺼져 있습니다.
• 구조와 동작은 안정적인 구성보다 더 빠르게 변경될 수 있습니다.
• 이미 안정적인 경로가 있다면 해당 경로를 우선 사용하세요.
• 먼저 소규모 환경에서 테스트한 후에만 광범위하게 배포하세요.

현재 문서화된 플래그

로컬 모델 린 모드

agents.defaults.experimental.localModelLean: true는 매 턴 에이전트의 직접 도구 구성에서 용량이 큰 선택적 도구인 browser, cron, message, image_generate, music_generate, video_generate, tts, pdf를 제외합니다. 명시적으로 허용되었거나 전달에 필요한 도구는 계속 사용할 수 있지만, Tool Search가 이를 직접 노출하는 대신 카탈로그에 등록할 수 있습니다. 또한 tools.toolSearch가 아직 설정되지 않은 경우 린 모드는 Plugin/MCP/클라이언트 카탈로그의 기본값을 구조화된 Tool Search(tool_search, tool_describe, tool_call)로 설정합니다. 이를 하나의 에이전트에만 적용하려면 agents.list[].experimental.localModelLean을 사용하세요.

이미 Tool Search를 전역으로 조정하고 있다면 OpenClaw는 해당 구성을 변경하지 않습니다. 린 모드의 Tool Search 기본값을 사용하지 않으려면 tools.toolSearch: false를 설정하세요.

구조화된 tools 모드에서 린 실행은 Tool Search 제어 기능 옆에 exec를 직접 표시하므로, 코딩에 맞춰 조정된 로컬 모델이 익숙한 셸 경로를 계속 선택할 수 있습니다. 이는 스키마의 표시 여부만 변경합니다. 일반적인 도구 정책, 샌드박싱, exec 승인은 계속 적용됩니다. 명시적인 code 및 directory 모드는 일반적인 Compaction 동작을 유지합니다.

이러한 도구를 선택한 이유

이러한 도구는 설명이 가장 길거나, 매개변수 구조가 가장 광범위하거나, 작은 모델이 일반적인 코딩 및 대화 경로에서 벗어나게 할 가능성이 가장 높습니다. 컨텍스트가 작거나 더 엄격한 OpenAI 호환 백엔드에서는 다음과 같은 차이를 만듭니다.

• 도구 스키마가 프롬프트에 맞게 들어가는 경우와 대화 기록을 밀어내는 경우.
• 모델이 올바른 도구를 선택하는 경우와 유사한 스키마가 너무 많아 잘못된 도구 호출을 생성하는 경우.
• Chat Completions 어댑터가 구조화된 출력 제한 내에서 작동하는 경우와 도구 호출 페이로드 크기로 인해 400 오류가 발생하는 경우.

이러한 도구를 제거해도 직접 도구 목록만 짧아집니다. 모델은 계속 read, write, edit, exec, apply_patch, 이미지 이해, 웹 검색/가져오기(구성된 경우), 메모리, 세션/에이전트 도구를 사용할 수 있습니다. tools.toolSearch: false를 설정하지 않는 한 추가 카탈로그에는 Tool Search를 통해 계속 접근할 수 있으며, 명시적인 도구 허용을 사용하면 린 에이전트에 간소화된 워크플로를 다시 추가할 수 있습니다.

활성화해야 하는 경우

모델이 Gateway와 통신할 수 있지만 전체 에이전트 턴이 제대로 작동하지 않는다는 사실을 확인한 후 린 모드를 활성화하세요.

1. openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong"가 성공합니다.
2. 일반적인 에이전트 턴이 잘못된 도구 호출, 지나치게 큰 프롬프트 또는 모델의 도구 무시로 인해 실패합니다.
3. localModelLean: true로 전환하면 실패가 해결됩니다.

비활성화 상태를 유지해야 하는 경우

백엔드가 전체 기본 런타임을 문제없이 처리한다면 이 기능을 비활성화 상태로 유지하세요. 이는 더 작은 도구 구성이 필요한 로컬 스택을 위한 우회 방법이지, 호스팅 모델이나 리소스가 충분한 로컬 시스템을 위한 기본값이 아닙니다.

린 모드는 tools.profile, tools.allow/tools.deny 또는 모델의 compat.supportsTools: false 우회 옵션을 대체하지 않습니다. 특정 에이전트의 도구 구성을 영구적으로 축소하려면 이러한 안정적인 설정을 우선 사용하세요.

활성화

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

하나의 에이전트에만 적용하려면 다음과 같이 설정합니다.

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

플래그를 변경한 후 Gateway를 다시 시작하세요. tools.allow 또는 tools.alsoAllow를 사용하여 명시적으로 유지하지 않는 한 린 필터링은 browser, cron, message, image_generate, music_generate, video_generate, tts, pdf를 제거합니다. Tool Search는 유지된 도구를 직접 노출하는 대신 계속 카탈로그에 등록할 수 있습니다.

실험적이라는 말이 숨겨져 있다는 뜻은 아닙니다

실험적 기능은 안정적인 기능처럼 보이는 기본 설정 뒤에 숨기지 말고, 문서와 구성 경로 자체에서 실험적임을 명확히 밝혀야 합니다.

관련 문서

• 기능
• 릴리스 채널