호환성 레지스트리
Plugin 호환성 계약은 코어 레지스트리src/plugins/compat/registry.ts에서 추적됩니다.
각 레코드에는 다음이 포함됩니다:
- 안정적인 호환성 코드
- 상태:
active,deprecated,removal-pending, 또는removed - 소유자: SDK, config, setup, channel, provider, plugin execution, agent runtime, 또는 core
- 해당되는 경우 도입 및 지원 중단 날짜
- 대체 안내
- 이전 및 새 동작을 다루는 문서, 진단 및 테스트
Plugin inspector 패키지
Plugin inspector는 버전이 지정된 호환성 및 manifest 계약을 기반으로 하는 별도의 패키지/리포지토리로, 코어 OpenClaw 리포지토리 외부에 있어야 합니다. 첫 번째 날의 CLI는 다음이어야 합니다:- manifest/schema 유효성 검사
- 검사 중인 계약 호환성 버전
- 설치/소스 메타데이터 검사
- 콜드 경로 import 검사
- 지원 중단 및 호환성 경고
--json을 사용하세요. OpenClaw
코어는 inspector가 사용할 수 있는 계약과 fixture를 노출해야 하지만,
메인 openclaw 패키지에서 inspector 바이너리를 게시해서는 안 됩니다.
지원 중단 정책
OpenClaw는 대체 계약을 도입한 동일한 릴리스에서 문서화된 Plugin 계약을 제거해서는 안 됩니다. 마이그레이션 순서는 다음과 같습니다:- 새 계약을 추가합니다.
- 이전 동작을 이름이 지정된 호환성 어댑터를 통해 계속 연결해 둡니다.
- Plugin 작성자가 조치를 취할 수 있을 때 진단 또는 경고를 출력합니다.
- 대체 항목과 일정을 문서화합니다.
- 이전 경로와 새 경로를 모두 테스트합니다.
- 공지된 마이그레이션 기간 동안 기다립니다.
- 명시적인 브레이킹 릴리스 승인 없이 제거하지 않습니다.
현재 호환성 영역
현재 호환성 레코드에는 다음이 포함됩니다:openclaw/plugin-sdk/compat와 같은 레거시 광범위 SDK import- 레거시 hook 전용 Plugin 형태 및
before_agent_start - 번들 Plugin 허용 목록 및 활성화 동작
- 레거시 provider/channel env-var manifest 메타데이터
- manifest contribution ownership으로 대체되고 있는 activation 힌트
- 공개 명명이
agentRuntime으로 이동하는 동안의embeddedHarness및agent-harness명명 별칭 - 레지스트리 우선
channelConfigs메타데이터가 도입되는 동안의 생성된 번들 채널 구성 메타데이터 fallback - repair 흐름이 운영자를
openclaw plugins registry --refresh및openclaw doctor --fix로 마이그레이션하는 동안의 persisted Plugin 레지스트리 비활성화 env
릴리스 노트
릴리스 노트에는 대상 날짜와 마이그레이션 문서 링크가 포함된 예정된 Plugin 지원 중단이 포함되어야 합니다. 이 경고는 호환성 경로가removal-pending 또는 removed로 이동하기 전에 발생해야 합니다.