OpenClaw, 코어 및 플러그인에 경량 의사결정 모델(Decision Model) 전용 지원 도입

오픈소스 AI 에이전트 프레임워크 OpenClaw가 코어 엔진 및 플러그인 생태계 전반에 구조화된 경량 판단을 전담하는 '결정 모델(Decision Model)' 전용 역할을 공식 도입했습니다. 2026년 9월 공개된 이번 변경은 무거운 대화형 LLM 대신 초경량 의사결정 모델을 워크플로우 분기에 연동할 수 있도록 지원합니다.

이미지 출처: @openclaw on X

에이전트가 복잡한 다단계 작업을 수행할 때 모든 조건 분기, 적합도 평가, 도구 선택 확률 계산을 대규모 텍스트 생성 모델에 위임하면 상당한 지연 시간과 불필요한 토큰 비용이 발생합니다. OpenClaw는 TypeSafe 번들 프로바이더를 추가한 PR #152298과 공용 코어 도구(decision_evaluate)를 도입한 PR #155134를 병합하며, 일반 대화 모델과 물리적으로 분리된 전용 결정 모델 런타임 인터페이스를 구축했습니다.

대화 모델과 엄격히 분리된 전용 Decision Picker와 평가 도구

OpenClaw의 이번 아키텍처 개편에서 가장 두드러진 특징은 결정 모델을 일반 대화형(Chat) 모델과 철저하게 분리했다는 점입니다.

Control UI 내부에 별도의 'Decision picker'가 신설되었으며, 이 카탈로그에 등록된 모델은 일반 채팅, 프라이머리 모델, 폴백 모델, 유틸리티 모델 목록에는 일절 노출되지 않습니다. 대화 생성과 구조적 판단의 역할을 UI와 내부 라우팅 단계에서부터 명확히 격리한 설계입니다.

• 타입화된 의사결정 특화: 결정 모델은 장문 텍스트 생성이 아닌 선택(choice), 점수(score), 불리언 확률(boolean probability) 계산에 특화되어 동작합니다.
• narrow 평가 도구 제공: 함께 추가된 decision_evaluate 도구는 에이전트 워크플로우가 전달한 상태값을 검증하고, 허용된 규격과 범위 내에서 점수와 확률만을 반환합니다.
• 호스트 주도 라우팅 통제: 네이티브 평가 작업은 개별 플러그인이 임의로 모델을 호출하는 대신, 시스템 호스트가 사전에 지정한 결정 모델을 일관되게 사용하도록 강제합니다.
• 단독 자율 실행 방지: 결정 모델은 단독 설정만으로 대화 모델을 대체하거나 백그라운드 작업을 실행하지 않으며, 지원 플러그인의 명시적 런타임 호출을 통해서만 활성화됩니다.

공식 TypeSafe 플러그인 연동과 Jev 모델 설정 구조

결정 모델 역할을 실무에 적용하기 위해 OpenClaw는 공식 외부 플러그인인 typesafe(extensions/typesafe)를 번들 형태로 지원합니다.

운영자는 TypeSafe AI가 제공하는 클라우드 호스팅 모델인 Jev(typesafe/jev-latest, 고정 버전 typesafe/jev-1.13.0)를 연결하거나, 로컬 환경에서 직접 구동하는 System One 서버(Kev 등)를 decisionModel로 지정할 수 있습니다. 호스팅 Jev 모델을 사용할 경우 Control UI의 Settings → Secrets 메뉴에서 TYPESAFE_API_KEY 인증 정보를 사전에 등록해야 합니다.

설정 파일(JSON5)에서는 다음과 같이 플러그인 활성화와 에이전트별 모델 할당을 정의합니다.

{
  plugins: {
    allow: ["typesafe"],
    entries: {
      typesafe: {
        enabled: true,
        config: {
          apiKey: { source: "store", provider: "default", id: "TYPESAFE_API_KEY" },
        },
      },
    },
  },
  agents: {
    ownership: "explicit",
    defaults: { decisionModel: "typesafe/jev-latest" },
    entries: {
      research: { decisionModel: "typesafe/jev-1.13.0" },
    },
  },
}

이 설정을 통해 전체 에이전트의 기본 결정 모델을 typesafe/jev-latest로 지정하면서도, 엄격한 재현성이 요구되는 리서치 에이전트에는 특정 고정 버전인 typesafe/jev-1.13.0을 독립적으로 바인딩하는 등 유연한 구성이 가능합니다.

호환성 요건과 실무 운영 시 주의사항

OpenClaw 환경에 결정 모델 파이프라인을 도입하기 전 확인해야 할 버전 호환성과 운영 규칙이 있습니다.

어댑터 및 결정 모델 역할은 공식 릴리즈된 OpenClaw 2026.9.5 이후에 코어에 추가되었습니다. 따라서 정식 패키지 설치 시 호스트 및 플러그인 API 버전이 최소 2026.9.6 이상이어야 하며, 패키지 설치 프로그램은 2026.9.5 이하의 구버전 호스트를 감지하면 플러그인 로딩을 즉시 거부합니다.

• 소스 체크아웃 빌드 필요: TypeSafe AI 플러그인의 npm 및 ClawHub 정식 배포 전까지는 결정 제공자 API와 extensions/typesafe가 포함된 소스 체크아웃 환경에서 pnpm install --frozen-lockfile && pnpm build를 직접 수행해야 합니다.
• 기본 비활성화(Opt-in) 설계: agents.defaults.decisionModel 설정이 비어 있거나 지정되지 않은 기본 상태에서는 결정 모델 기능이 비활성화되므로, 기존 설치 환경의 동작 흐름이 예기치 않게 변경되지 않습니다.
• 비용 및 라이프사이클 관리: 호스팅 Jev 모델을 호출할 경우 TypeSafe의 정규 API 과금이 적용되며, 플러그인 수명 주기와 프로바이더 상태는 호스트와 동기화되어 에이전트별 안정적인 모니터링을 지원합니다.

출처

• OpenClaw 공식 블로그: Decision Models in OpenClaw
• OpenClaw 플러그인 문서: TypeSafe AI Plugin Documentation
• OpenClaw 공식 X 발표: 2026-09-23 X 포스트 (@openclaw)