- 관련 문서에서 사용해 보라고 안내하지 않는 한 기본적으로 꺼진 상태로 두세요.
- 안정적인 구성보다 형태와 동작이 더 빠르게 바뀔 수 있음을 예상하세요.
- 이미 안정적인 경로가 있다면 먼저 그 경로를 선호하세요.
- OpenClaw를 광범위하게 배포하는 경우, 실험적 플래그를 공유 기준선에 포함하기 전에 더 작은 환경에서 테스트하세요.
현재 문서화된 플래그
| 기능 영역 | 키 | 사용 시점 | 자세히 |
|---|---|---|---|
| 로컬 모델 런타임 | agents.defaults.experimental.localModelLean, agents.list[].experimental.localModelLean | 더 작거나 더 엄격한 로컬 백엔드가 OpenClaw의 전체 기본 도구 노출 범위를 처리하지 못할 때 | 로컬 모델 |
| 메모리 검색 | agents.defaults.memorySearch.experimental.sessionMemory | memory_search가 이전 세션 전사를 인덱싱하고 추가 저장소/인덱싱 비용을 감수하도록 하려는 경우 | 메모리 구성 참조 |
| Codex 하네스 | plugins.entries.codex.config.appServer.experimental.sandboxExecServer | 네이티브 Codex 앱 서버 0.132.0 이상이 코드 모드를 비활성화하는 대신 OpenClaw 샌드박스 기반 exec-server를 대상으로 하게 하려는 경우 | Codex 하네스 참조 |
| 구조화된 계획 도구 | tools.experimental.planTool | 호환되는 런타임과 UI에서 다단계 작업 추적을 위해 구조화된 update_plan 도구를 노출하려는 경우 | Gateway 구성 참조 |
로컬 모델 린 모드
agents.defaults.experimental.localModelLean: true는 성능이 약한 로컬 모델 설정을 위한 압력 완화 밸브입니다. 이 옵션이 켜져 있으면 OpenClaw는 모든 턴에서 에이전트의 도구 노출 범위에서 기본 도구 세 가지인 browser, cron, message를 제거합니다. 또한 tools.toolSearch가 명시적으로 구성되지 않은 경우 해당 실행은 기본적으로 구조화된 도구 검색 제어를 사용하므로, 더 큰 Plugin, MCP 또는 클라이언트 도구 카탈로그가 프롬프트에 그대로 쏟아지는 대신 tool_search, tool_describe, tool_call 뒤에 유지됩니다. 직접 message 전달이 필요한 실행은 린 모드의 기본 도구 검색을 활성화하는 대신 해당 도구를 직접 유지합니다. 구성된 에이전트 하나에 대해 같은 동작을 활성화하거나 비활성화하려면 agents.list[].experimental.localModelLean을 사용하세요.
이 세 도구인 이유
이 세 도구는 기본 OpenClaw 런타임에서 설명이 가장 길고 매개변수 형태가 가장 많습니다. 작은 컨텍스트 또는 더 엄격한 OpenAI 호환 백엔드에서는 이것이 다음 차이를 만듭니다.- 도구 스키마가 프롬프트에 깔끔하게 들어가는 경우와 대화 기록을 밀어내는 경우.
- 모델이 올바른 도구를 선택하는 경우와 비슷해 보이는 스키마가 너무 많아 잘못된 형식의 도구 호출을 내보내는 경우.
- Chat Completions 어댑터가 서버의 구조화 출력 제한 안에 머무르는 경우와 도구 호출 페이로드 크기 때문에 400 오류가 발생하는 경우.
read, write, edit, exec, apply_patch, 웹 검색/가져오기(구성된 경우), 메모리, 세션/에이전트 도구를 사용할 수 있습니다. tools.toolSearch: false를 명시적으로 설정하지 않는 한 추가 카탈로그는 도구 검색을 통해 계속 호출할 수 있습니다.
켜야 하는 경우
모델이 Gateway와 통신할 수 있음은 이미 증명했지만 전체 에이전트 턴이 오동작할 때 린 모드를 활성화하세요. 일반적인 신호 흐름은 다음과 같습니다.openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong"가 성공합니다.- 일반 에이전트 턴이 잘못된 형식의 도구 호출, 과도하게 큰 프롬프트, 또는 모델이 도구를 무시하는 문제로 실패합니다.
localModelLean: true를 전환하면 실패가 해소됩니다.
꺼둬야 하는 경우
백엔드가 전체 기본 런타임을 깔끔하게 처리한다면 이 옵션을 꺼두세요. 린 모드는 기본값이 아니라 우회 방법입니다. 일부 로컬 스택이 제대로 동작하려면 더 작은 도구 노출 범위가 필요하기 때문에 존재합니다. 호스팅 모델과 충분한 리소스를 갖춘 로컬 장비에는 필요하지 않습니다. 린 모드는tools.profile, tools.allow/tools.deny, 또는 모델 compat.supportsTools: false 탈출구를 대체하지도 않습니다. 특정 에이전트에 대해 영구적으로 더 좁은 도구 노출 범위가 필요하다면 실험적 플래그보다 이러한 안정적인 조정 옵션을 선호하세요.
이미 도구 검색을 전역으로 조정하고 있다면 OpenClaw는 해당 운영자 구성을 그대로 둡니다. 린 모드의 기본 도구 검색을 사용하지 않으려면 tools.toolSearch: false를 설정하세요.
활성화
message 응답을 강제하지 않는 한 browser, cron, message가 없어야 합니다.