- 문서에서 활성화하라고 안내하지 않는 한 기본적으로 꺼져 있습니다.
- 구조와 동작은 안정적인 구성보다 더 빠르게 변경될 수 있습니다.
- 이미 안정적인 경로가 있다면 해당 경로를 우선 사용하세요.
- 먼저 소규모 환경에서 테스트한 후에만 광범위하게 배포하세요.
현재 문서화된 플래그
로컬 모델 린 모드
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와 통신할 수 있지만 전체 에이전트 턴이 제대로 작동하지 않는다는 사실을 확인한 후 린 모드를 활성화하세요.openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong"가 성공합니다.- 일반적인 에이전트 턴이 잘못된 도구 호출, 지나치게 큰 프롬프트 또는 모델의 도구 무시로 인해 실패합니다.
localModelLean: true로 전환하면 실패가 해결됩니다.
비활성화 상태를 유지해야 하는 경우
백엔드가 전체 기본 런타임을 문제없이 처리한다면 이 기능을 비활성화 상태로 유지하세요. 이는 더 작은 도구 구성이 필요한 로컬 스택을 위한 우회 방법이지, 호스팅 모델이나 리소스가 충분한 로컬 시스템을 위한 기본값이 아닙니다. 린 모드는tools.profile, tools.allow/tools.deny 또는 모델의 compat.supportsTools: false 우회 옵션을 대체하지 않습니다. 특정 에이전트의 도구 구성을 영구적으로 축소하려면 이러한 안정적인 설정을 우선 사용하세요.
활성화
tools.allow 또는 tools.alsoAllow를 사용하여 명시적으로 유지하지 않는 한 린 필터링은 browser, cron, message, image_generate, music_generate, video_generate, tts, pdf를 제거합니다. Tool Search는 유지된 도구를 직접 노출하는 대신 계속 카탈로그에 등록할 수 있습니다.