Plugin SDK reference

Plugin SDK 하위 경로

Plugin SDK는 openclaw/plugin-sdk/ 아래의 좁은 공개 하위 경로 집합으로 노출됩니다. 이 페이지는 일반적으로 사용되는 하위 경로를 목적별로 묶어 정리합니다. 생성된 컴파일러 엔트리포인트 인벤터리는 scripts/lib/plugin-sdk-entrypoints.json에 있습니다. 패키지 exports는 scripts/lib/plugin-sdk-private-local-only-subpaths.json에 나열된 저장소 로컬 테스트/내부 하위 경로를 제외한 공개 부분입니다. Maintainer는 pnpm plugin-sdk:surface로 공개 export 수를 감사하고, pnpm plugins:boundary-report:summary로 활성 예약 helper 하위 경로를 감사할 수 있습니다. 사용되지 않는 예약 helper exports는 휴면 호환성 부채로 공개 SDK에 남아 있는 대신 CI 보고서에서 실패합니다.

Plugin 작성 가이드는 Plugin SDK 개요를 참조하세요.

Plugin 엔트리

하위 경로	주요 exports
`plugin-sdk/plugin-entry`	`definePluginEntry`
`plugin-sdk/core`	`defineChannelPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase`, `defineSetupPluginEntry`, `buildChannelConfigSchema`, `buildJsonChannelConfigSchema`
`plugin-sdk/config-schema`	`OpenClawSchema`
`plugin-sdk/provider-entry`	`defineSingleProviderPluginEntry`
`plugin-sdk/migration`	`createMigrationItem` 같은 마이그레이션 provider 항목 helper, reason 상수, 항목 상태 marker, redaction helper, `summarizeMigrationItems`
`plugin-sdk/migration-runtime`	`copyMigrationFileItem`, `withCachedMigrationConfigRuntime`, `writeMigrationReport` 같은 런타임 마이그레이션 helper

Deprecated 호환성 및 테스트 helper

이 하위 경로들은 오래된 plugins와 OpenClaw 테스트 스위트를 위해 패키지 exports로 남아 있지만, 새 코드는 여기에서 import를 추가하면 안 됩니다: agent-runtime-test-contracts, channel-contract-testing, channel-target-testing, channel-test-helpers, plugin-test-api, plugin-test-contracts, provider-http-test-mocks, provider-test-contracts, test-env, test-fixtures, test-node-mocks, testing, channel-runtime, compat, config-types, infra-runtime, text-runtime, zod. 새 plugin 코드에서는 zod를 zod에서 직접 import하세요. plugin-test-runtime은 여전히 활성화된 집중 테스트 helper 하위 경로입니다.

Deprecated 미사용 공개 하위 경로

이 공개 하위 경로들은 최소 한 달 동안 존재했으며 현재 번들 extension 프로덕션 imports가 없습니다. 호환성을 위해 계속 import할 수 있지만, 새 plugin 코드는 대신 집중되어 있고 실제로 소비되는 SDK 하위 경로를 사용해야 합니다: agent-config-primitives, channel-config-schema-legacy, channel-reply-pipeline, channel-runtime, channel-secret-runtime, command-auth, compat, config-runtime, config-schema, discord, group-access, infra-runtime, matrix, mattermost, media-generation-runtime-shared, memory-core-engine-runtime, memory-core-host-multimodal, memory-core-host-query, music-generation-core, self-hosted-provider-setup, telegram-account, telegram-command-config, zalouser.

Deprecated 드물게 사용되는 공개 하위 경로

현재 한두 개의 번들 plugin owner만 사용하는 공개 하위 경로도 새 plugin 코드에서는 deprecated입니다. 호환성을 위해 패키지 exports로 남아 있지만, 새 코드는 활발히 공유되는 SDK seam이나 plugin 소유 패키지 API를 선호해야 합니다. Maintainer는 scripts/lib/plugin-sdk-deprecated-public-subpaths.json에서 정확한 집합을 추적하고 pnpm plugin-sdk:surface로 현재 budget을 추적합니다.

Deprecated 광범위 barrel

이 광범위한 re-export barrel은 OpenClaw 소스와 호환성 검사에서 계속 빌드할 수 있지만, 새 코드는 집중된 SDK 하위 경로를 선호해야 합니다: agent-runtime, channel-lifecycle, channel-runtime, cli-runtime, compat, config-types, conversation-runtime, hook-runtime, infra-runtime, media-runtime, plugin-runtime, security-runtime, text-runtime. channel-runtime, compat, config-types, infra-runtime, text-runtime은 이전 버전과의 호환성을 위해서만 패키지 exports로 남아 있습니다. 대신 집중된 channel/runtime 하위 경로, config-contracts, string-coerce-runtime, text-chunking, text-utility-runtime, logging-core를 사용하세요.

Channel subpaths

하위 경로	주요 내보내기
`plugin-sdk/channel-core`	`defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase`
`plugin-sdk/config-schema`	루트 `openclaw.json` Zod 스키마 내보내기(`OpenClawSchema`)
`plugin-sdk/json-schema-runtime`	Plugin 소유 스키마를 위한 캐시된 JSON Schema 검증 헬퍼
`plugin-sdk/channel-setup`	`createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, 그리고 `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries`
`plugin-sdk/setup`	공유 설정 마법사 헬퍼, 허용 목록 프롬프트, 설정 상태 빌더
`plugin-sdk/setup-runtime`	`createPatchedAccountSetupAdapter`, `createEnvPatchedAccountSetupAdapter`, `createSetupInputPresenceValidator`, `noteChannelLookupFailure`, `noteChannelLookupSummary`, `promptResolvedAllowFrom`, `splitSetupEntries`, `createAllowlistSetupWizardProxy`, `createDelegatedSetupWizardProxy`
`plugin-sdk/setup-adapter-runtime`	더 이상 사용되지 않는 호환성 별칭입니다. `plugin-sdk/setup-runtime`을 사용하세요
`plugin-sdk/setup-tools`	`formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR`
`plugin-sdk/account-core`	다중 계정 구성/작업 게이트 헬퍼, 기본 계정 폴백 헬퍼
`plugin-sdk/account-id`	`DEFAULT_ACCOUNT_ID`, 계정 ID 정규화 헬퍼
`plugin-sdk/account-resolution`	계정 조회 및 기본 폴백 헬퍼
`plugin-sdk/account-helpers`	좁은 범위의 계정 목록/계정 작업 헬퍼
`plugin-sdk/access-groups`	액세스 그룹 허용 목록 파싱 및 수정된 그룹 진단 헬퍼
`plugin-sdk/channel-pairing`	`createChannelPairingController`
`plugin-sdk/channel-reply-pipeline`	레거시 답장 파이프라인 헬퍼입니다. 새 채널 답장 파이프라인 코드는 `plugin-sdk/channel-message`의 `createChannelMessageReplyPipeline` 및 `resolveChannelMessageSourceReplyDeliveryMode`를 사용해야 합니다.
`plugin-sdk/channel-config-helpers`	`createHybridChannelConfigAdapter`, `resolveChannelDmAccess`, `resolveChannelDmAllowFrom`, `resolveChannelDmPolicy`, `normalizeChannelDmPolicy`, `normalizeLegacyDmAliases`
`plugin-sdk/channel-config-schema`	공유 채널 구성 스키마 기본 요소와 Zod 및 직접 JSON/TypeBox 빌더
`plugin-sdk/bundled-channel-config-schema`	유지 관리되는 번들 Plugin 전용 번들 OpenClaw 채널 구성 스키마
`plugin-sdk/channel-config-schema-legacy`	번들 채널 구성 스키마를 위한 더 이상 사용되지 않는 호환성 별칭
`plugin-sdk/telegram-command-config`	번들 계약 폴백이 있는 Telegram 사용자 지정 명령 정규화/검증 헬퍼
`plugin-sdk/command-gating`	좁은 범위의 명령 권한 부여 게이트 헬퍼
`plugin-sdk/channel-policy`	`resolveChannelGroupRequireMention`
`plugin-sdk/channel-ingress`	더 이상 사용되지 않는 저수준 채널 인그레스 호환성 파사드입니다. 새 수신 경로는 `plugin-sdk/channel-ingress-runtime`을 사용해야 합니다.
`plugin-sdk/channel-ingress-runtime`	마이그레이션된 채널 수신 경로를 위한 실험적 고수준 채널 인그레스 런타임 해석기 및 라우트 사실 빌더입니다. 각 Plugin에서 유효 허용 목록, 명령 허용 목록, 레거시 프로젝션을 조립하는 대신 이를 선호하세요. 채널 인그레스 API를 참조하세요.
`plugin-sdk/channel-lifecycle`	`createAccountStatusSink`, `createChannelRunQueue`, 레거시 초안 스트림 수명 주기 헬퍼입니다. 새 미리 보기 확정 코드는 `plugin-sdk/channel-message`를 사용해야 합니다.
`plugin-sdk/channel-message`	`defineChannelMessageAdapter`, `createChannelMessageAdapterFromOutbound`, `createChannelMessageReplyPipeline`, `createReplyPrefixContext`, `resolveChannelMessageSourceReplyDeliveryMode`, 지속 최종 기능 파생, 전송/수신/부작용 기능을 위한 기능 증명 헬퍼, `MessageReceiveContext`, 수신 확인 정책 증명, `defineFinalizableLivePreviewAdapter`, `deliverWithFinalizableLivePreviewAdapter`, 실시간 미리 보기 및 실시간 확정기 기능 증명, 지속 복구 상태, `RenderedMessageBatch`, 메시지 수신 타입, 수신 ID 헬퍼 같은 저비용 메시지 수명 주기 계약 헬퍼입니다. 채널 메시지 API를 참조하세요. 레거시 답장 디스패치 파사드는 호환성 전용으로 더 이상 사용되지 않습니다.
`plugin-sdk/channel-message-runtime`	`deliverInboundReplyWithMessageSendContext`, `sendDurableMessageBatch`, `withDurableMessageSendContext`를 포함해 아웃바운드 전달을 로드할 수 있는 런타임 전달 헬퍼입니다. 더 이상 사용되지 않는 답장 디스패치 브리지는 호환성 디스패처 전용으로 계속 가져올 수 있습니다. 핫 Plugin 부트스트랩 파일이 아니라 모니터/전송 런타임 모듈에서 사용하세요.
`plugin-sdk/inbound-envelope`	공유 인바운드 라우트 및 엔벨로프 빌더 헬퍼
`plugin-sdk/inbound-reply-dispatch`	레거시 공유 인바운드 기록 및 디스패치 헬퍼, 표시/최종 디스패치 조건자, 준비된 채널 디스패처를 위한 더 이상 사용되지 않는 `deliverDurableInboundReplyPayload` 호환성입니다. 새 채널 수신/디스패치 코드는 `plugin-sdk/channel-message-runtime`에서 런타임 수명 주기 헬퍼를 가져와야 합니다.
`plugin-sdk/messaging-targets`	대상 파싱/매칭 헬퍼
`plugin-sdk/outbound-media`	공유 아웃바운드 미디어 로딩 헬퍼
`plugin-sdk/outbound-send-deps`	채널 어댑터를 위한 경량 아웃바운드 전송 의존성 조회
`plugin-sdk/outbound-runtime`	아웃바운드 ID, 전송 위임, 세션, 서식 지정, 페이로드 계획 헬퍼입니다. `deliverOutboundPayloads` 같은 직접 전달 헬퍼는 더 이상 사용되지 않는 호환성 기반입니다. 새 전송 경로에는 `plugin-sdk/channel-message-runtime`을 사용하세요.
`plugin-sdk/poll-runtime`	좁은 범위의 폴 정규화 헬퍼
`plugin-sdk/thread-bindings-runtime`	스레드 바인딩 수명 주기 및 어댑터 헬퍼
`plugin-sdk/agent-media-payload`	레거시 에이전트 미디어 페이로드 빌더
`plugin-sdk/conversation-runtime`	대화/스레드 바인딩, 페어링, 구성된 바인딩 헬퍼
`plugin-sdk/runtime-config-snapshot`	런타임 구성 스냅샷 헬퍼
`plugin-sdk/runtime-group-policy`	런타임 그룹 정책 해석 헬퍼
`plugin-sdk/channel-status`	공유 채널 상태 스냅샷/요약 헬퍼
`plugin-sdk/channel-config-primitives`	좁은 범위의 채널 구성 스키마 기본 요소
`plugin-sdk/channel-config-writes`	채널 구성 쓰기 권한 부여 헬퍼
`plugin-sdk/channel-plugin-common`	공유 채널 Plugin 프렐류드 내보내기
`plugin-sdk/allowlist-config-edit`	허용 목록 구성 편집/읽기 헬퍼
`plugin-sdk/group-access`	공유 그룹 액세스 결정 헬퍼
`plugin-sdk/direct-dm`	공유 직접 DM 인증/가드 헬퍼
`plugin-sdk/discord`	게시된 `@openclaw/[email protected]` 및 추적 중인 소유자 호환성을 위한 더 이상 사용되지 않는 Discord 호환성 파사드입니다. 새 Plugin은 일반 채널 SDK 하위 경로를 사용해야 합니다
`plugin-sdk/telegram-account`	추적 중인 소유자 호환성을 위한 더 이상 사용되지 않는 Telegram 계정 해석 호환성 파사드입니다. 새 Plugin은 주입된 런타임 헬퍼 또는 일반 채널 SDK 하위 경로를 사용해야 합니다
`plugin-sdk/zalouser`	발신자 명령 권한 부여를 여전히 가져오는 게시된 Lark/Zalo 패키지를 위한 더 이상 사용되지 않는 Zalo Personal 호환성 파사드입니다. 새 Plugin은 `plugin-sdk/command-auth`를 사용해야 합니다
`plugin-sdk/interactive-runtime`	의미론적 메시지 표현, 전달, 레거시 대화형 답장 헬퍼입니다. 메시지 표현을 참조하세요
`plugin-sdk/channel-inbound`	인바운드 디바운스, 멘션 매칭, 멘션 정책 헬퍼, 엔벨로프 헬퍼를 위한 호환성 배럴
`plugin-sdk/channel-inbound-debounce`	좁은 범위의 인바운드 디바운스 헬퍼
`plugin-sdk/channel-mention-gating`	더 넓은 인바운드 런타임 표면 없이 제공되는 좁은 범위의 멘션 정책, 멘션 마커, 멘션 텍스트 헬퍼
`plugin-sdk/channel-envelope`	좁은 범위의 인바운드 엔벨로프 서식 지정 헬퍼
`plugin-sdk/channel-location`	채널 위치 컨텍스트 및 서식 지정 헬퍼
`plugin-sdk/channel-logging`	인바운드 드롭 및 입력/확인 실패를 위한 채널 로깅 헬퍼
`plugin-sdk/channel-send-result`	답장 결과 타입
`plugin-sdk/channel-actions`	채널 메시지 작업 헬퍼와 Plugin 호환성을 위해 유지되는 더 이상 사용되지 않는 네이티브 스키마 헬퍼
`plugin-sdk/channel-route`	공유 라우트 정규화, 파서 기반 대상 해석, 스레드 ID 문자열화, 라우트 키 중복 제거/압축, 파싱된 대상 타입, 라우트/대상 비교 헬퍼
`plugin-sdk/channel-targets`	대상 파싱 헬퍼입니다. 라우트 비교 호출자는 `plugin-sdk/channel-route`를 사용해야 합니다
`plugin-sdk/channel-contract`	채널 계약 타입
`plugin-sdk/channel-feedback`	피드백/반응 연결
`plugin-sdk/channel-secret-runtime`	`collectSimpleChannelFieldAssignments`, `getChannelSurface`, `pushAssignment`, 비밀 대상 타입 같은 좁은 범위의 비밀 계약 헬퍼

제공자 하위 경로

하위 경로	주요 내보내기
`plugin-sdk/provider-entry`	`defineSingleProviderPluginEntry`
`plugin-sdk/lmstudio`	설정, 카탈로그 검색, 런타임 모델 준비를 위한 지원되는 LM Studio 제공자 퍼사드
`plugin-sdk/lmstudio-runtime`	로컬 서버 기본값, 모델 검색, 요청 헤더, 로드된 모델 헬퍼를 위한 지원되는 LM Studio 런타임 퍼사드
`plugin-sdk/provider-setup`	선별된 로컬/자체 호스팅 제공자 설정 헬퍼
`plugin-sdk/self-hosted-provider-setup`	OpenAI 호환 자체 호스팅 제공자 설정에 특화된 헬퍼
`plugin-sdk/cli-backend`	CLI 백엔드 기본값 + 워치독 상수
`plugin-sdk/provider-auth-runtime`	제공자 Plugin을 위한 런타임 API 키 확인 헬퍼
`plugin-sdk/provider-auth-api-key`	`upsertApiKeyProfile` 같은 API 키 온보딩/프로필 쓰기 헬퍼
`plugin-sdk/provider-auth-result`	표준 OAuth 인증 결과 빌더
`plugin-sdk/provider-env-vars`	제공자 인증 환경 변수 조회 헬퍼
`plugin-sdk/provider-auth`	`createProviderApiKeyAuthMethod`, `ensureApiKeyFromOptionEnvOrPrompt`, `upsertAuthProfile`, `upsertApiKeyProfile`, `writeOAuthCredentials`, 더 이상 사용되지 않는 `resolveOpenClawAgentDir` 호환성 내보내기
`plugin-sdk/provider-model-shared`	`ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, 공유 리플레이 정책 빌더, 제공자 엔드포인트 헬퍼, 공유 모델 ID 정규화 헬퍼
`plugin-sdk/provider-catalog-runtime`	계약 테스트를 위한 제공자 카탈로그 보강 런타임 훅과 Plugin 제공자 레지스트리 이음부
`plugin-sdk/provider-catalog-shared`	`findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `buildManifestModelProviderConfig`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat`
`plugin-sdk/provider-http`	범용 제공자 HTTP/엔드포인트 기능 헬퍼, 제공자 HTTP 오류, 오디오 전사 multipart form 헬퍼
`plugin-sdk/provider-web-fetch-contract`	`enablePluginInConfig` 및 `WebFetchProviderPlugin` 같은 좁은 웹 가져오기 구성/선택 계약 헬퍼
`plugin-sdk/provider-web-fetch`	웹 가져오기 제공자 등록/캐시 헬퍼
`plugin-sdk/provider-web-search-config-contract`	Plugin 활성화 연결이 필요 없는 제공자를 위한 좁은 웹 검색 구성/자격 증명 헬퍼
`plugin-sdk/provider-web-search-contract`	`createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig`, 범위 지정 자격 증명 setter/getter 같은 좁은 웹 검색 구성/자격 증명 계약 헬퍼
`plugin-sdk/provider-web-search`	웹 검색 제공자 등록/캐시/런타임 헬퍼
`plugin-sdk/provider-tools`	`ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, Gemini 스키마 정리 + 진단
`plugin-sdk/provider-usage`	`fetchClaudeUsage` 등
`plugin-sdk/provider-stream`	`ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, 스트림 래퍼 타입, 공유 Anthropic/Bedrock/DeepSeek V4/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot 래퍼 헬퍼
`plugin-sdk/provider-transport-runtime`	보호된 fetch, 전송 메시지 변환, 쓰기 가능한 전송 이벤트 스트림 같은 네이티브 제공자 전송 헬퍼
`plugin-sdk/provider-onboard`	온보딩 구성 패치 헬퍼
`plugin-sdk/global-singleton`	프로세스 로컬 singleton/map/cache 헬퍼
`plugin-sdk/group-activation`	좁은 그룹 활성화 모드 및 명령 파싱 헬퍼

인증 및 보안 하위 경로

하위 경로	주요 내보내기
`plugin-sdk/command-auth`	`resolveControlCommandGate`, 동적 인수 메뉴 형식을 포함한 명령 레지스트리 헬퍼, 발신자 권한 부여 헬퍼
`plugin-sdk/command-status`	`buildCommandsMessagePaginated` 및 `buildHelpMessage` 같은 명령/도움말 메시지 빌더
`plugin-sdk/approval-auth-runtime`	승인자 확인 및 동일 채팅 작업 인증 헬퍼
`plugin-sdk/approval-client-runtime`	네이티브 exec 승인 프로필/필터 헬퍼
`plugin-sdk/approval-delivery-runtime`	네이티브 승인 기능/전달 어댑터
`plugin-sdk/approval-gateway-runtime`	공유 승인 Gateway 확인 헬퍼
`plugin-sdk/approval-handler-adapter-runtime`	핫 채널 진입점을 위한 경량 네이티브 승인 어댑터 로딩 헬퍼
`plugin-sdk/approval-handler-runtime`	더 넓은 승인 핸들러 런타임 헬퍼. 충분하다면 더 좁은 어댑터/Gateway 이음부를 선호하세요
`plugin-sdk/approval-native-runtime`	네이티브 승인 대상 + 계정 바인딩 헬퍼
`plugin-sdk/approval-reply-runtime`	Exec/Plugin 승인 응답 페이로드 헬퍼
`plugin-sdk/approval-runtime`	Exec/Plugin 승인 페이로드 헬퍼, 네이티브 승인 라우팅/런타임 헬퍼, `formatApprovalDisplayPath` 같은 구조화된 승인 표시 헬퍼
`plugin-sdk/reply-dedupe`	좁은 인바운드 응답 중복 제거 재설정 헬퍼
`plugin-sdk/channel-contract-testing`	넓은 테스트 배럴 없이 제공되는 좁은 채널 계약 테스트 헬퍼
`plugin-sdk/command-auth-native`	네이티브 명령 인증, 동적 인수 메뉴 형식, 네이티브 세션 대상 헬퍼
`plugin-sdk/command-detection`	공유 명령 감지 헬퍼
`plugin-sdk/command-primitives-runtime`	핫 채널 경로를 위한 경량 명령 텍스트 조건자
`plugin-sdk/command-surface`	명령 본문 정규화 및 명령 표면 헬퍼
`plugin-sdk/allow-from`	`formatAllowFromLowercase`
`plugin-sdk/channel-secret-runtime`	채널/Plugin 시크릿 표면을 위한 좁은 시크릿 계약 수집 헬퍼
`plugin-sdk/secret-ref-runtime`	시크릿 계약/구성 파싱을 위한 좁은 `coerceSecretRef` 및 SecretRef 타입 지정 헬퍼
`plugin-sdk/security-runtime`	create-only 쓰기, 동기/비동기 원자적 파일 교체, 형제 임시 쓰기, 장치 간 이동 폴백, 비공개 파일 저장소 헬퍼, symlink 부모 가드, 외부 콘텐츠, 민감한 텍스트 수정, 상수 시간 시크릿 비교, 시크릿 수집 헬퍼를 포함한 공유 신뢰, DM 게이팅, 루트 경계 파일/경로 헬퍼
`plugin-sdk/ssrf-policy`	호스트 허용 목록 및 비공개 네트워크 SSRF 정책 헬퍼
`plugin-sdk/ssrf-dispatcher`	넓은 인프라 런타임 표면 없이 제공되는 좁은 고정 dispatcher 헬퍼
`plugin-sdk/ssrf-runtime`	고정 dispatcher, SSRF 보호 fetch, SSRF 오류, SSRF 정책 헬퍼
`plugin-sdk/secret-input`	시크릿 입력 파싱 헬퍼
`plugin-sdk/webhook-ingress`	Webhook 요청/대상 헬퍼 및 원시 웹소켓/본문 강제 변환
`plugin-sdk/webhook-request-guards`	요청 본문 크기/타임아웃 헬퍼

런타임 및 스토리지 하위 경로

하위 경로	주요 내보내기
`plugin-sdk/runtime`	광범위한 런타임/로깅/백업/Plugin 설치 헬퍼
`plugin-sdk/runtime-env`	좁은 범위의 런타임 환경, 로거, 제한 시간, 재시도, 백오프 헬퍼
`plugin-sdk/browser-config`	정규화된 프로필/기본값, CDP URL 파싱, 브라우저 제어 인증 헬퍼를 위한 지원되는 브라우저 구성 파사드
`plugin-sdk/channel-runtime-context`	일반 채널 런타임 컨텍스트 등록 및 조회 헬퍼
`plugin-sdk/matrix`	이전 타사 채널 패키지를 위한 더 이상 사용되지 않는 Matrix 호환성 파사드. 새 Plugin은 `plugin-sdk/run-command`를 직접 가져와야 합니다
`plugin-sdk/mattermost`	이전 타사 채널 패키지를 위한 더 이상 사용되지 않는 Mattermost 호환성 파사드. 새 Plugin은 일반 SDK 하위 경로를 직접 가져와야 합니다
`plugin-sdk/runtime-store`	`createPluginRuntimeStore`
`plugin-sdk/plugin-runtime`	공유 Plugin 명령/훅/http/인터랙티브 헬퍼
`plugin-sdk/hook-runtime`	공유 Webhook/내부 훅 파이프라인 헬퍼
`plugin-sdk/lazy-runtime`	`createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeSurface` 같은 지연 런타임 가져오기/바인딩 헬퍼
`plugin-sdk/process-runtime`	프로세스 실행 헬퍼
`plugin-sdk/cli-runtime`	CLI 형식 지정, 대기, 버전, 인수 호출, 지연 명령 그룹 헬퍼
`plugin-sdk/gateway-runtime`	Gateway 클라이언트, 이벤트 루프 준비 클라이언트 시작 헬퍼, Gateway CLI RPC, Gateway 프로토콜 오류, 채널 상태 패치 헬퍼
`plugin-sdk/config-contracts`	`OpenClawConfig` 및 채널/프로바이더 구성 타입 같은 Plugin 구성 형태를 위한 집중된 타입 전용 구성 표면
`plugin-sdk/plugin-config-runtime`	`requireRuntimeConfig`, `resolvePluginConfigObject`, `resolveLivePluginConfigObject` 같은 런타임 Plugin 구성 조회 헬퍼
`plugin-sdk/config-mutation`	`mutateConfigFile`, `replaceConfigFile`, `logConfigUpdated` 같은 트랜잭션 구성 변경 헬퍼
`plugin-sdk/runtime-config-snapshot`	`getRuntimeConfig`, `getRuntimeConfigSnapshot`, 테스트 스냅샷 설정자 같은 현재 프로세스 구성 스냅샷 헬퍼
`plugin-sdk/telegram-command-config`	번들된 Telegram 계약 표면을 사용할 수 없는 경우에도 Telegram 명령 이름/설명 정규화 및 중복/충돌 검사
`plugin-sdk/text-autolink-runtime`	광범위한 텍스트 배럴 없이 파일 참조 자동 링크 감지
`plugin-sdk/approval-runtime`	실행/Plugin 승인 헬퍼, 승인 기능 빌더, 인증/프로필 헬퍼, 네이티브 라우팅/런타임 헬퍼, 구조화된 승인 표시 경로 형식 지정
`plugin-sdk/reply-runtime`	공유 인바운드/답장 런타임 헬퍼, 청킹, 디스패치, Heartbeat, 답장 플래너
`plugin-sdk/reply-dispatch-runtime`	좁은 범위의 답장 디스패치/완료 및 대화 레이블 헬퍼
`plugin-sdk/reply-history`	`buildHistoryContext`, `HISTORY_CONTEXT_MARKER`, `recordPendingHistoryEntry`, `clearHistoryEntriesIfEnabled` 같은 공유 짧은 기간 답장 기록 헬퍼와 마커
`plugin-sdk/reply-reference`	`createReplyReferencePlanner`
`plugin-sdk/reply-chunking`	좁은 범위의 텍스트/Markdown 청킹 헬퍼
`plugin-sdk/session-store-runtime`	세션 스토어 경로, 세션 키, 업데이트 시간, 스토어 변경 헬퍼
`plugin-sdk/cron-store-runtime`	Cron 스토어 경로/로드/저장 헬퍼
`plugin-sdk/state-paths`	상태/OAuth 디렉터리 경로 헬퍼
`plugin-sdk/routing`	`resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId` 같은 라우트/세션 키/계정 바인딩 헬퍼
`plugin-sdk/status-helpers`	공유 채널/계정 상태 요약 헬퍼, 런타임 상태 기본값, 이슈 메타데이터 헬퍼
`plugin-sdk/target-resolver-runtime`	공유 대상 확인자 헬퍼
`plugin-sdk/string-normalization-runtime`	슬러그/문자열 정규화 헬퍼
`plugin-sdk/request-url`	fetch/request 유사 입력에서 문자열 URL 추출
`plugin-sdk/run-command`	정규화된 stdout/stderr 결과를 제공하는 시간 제한 명령 실행기
`plugin-sdk/param-readers`	공통 도구/CLI 매개변수 리더
`plugin-sdk/tool-payload`	도구 결과 객체에서 정규화된 페이로드 추출
`plugin-sdk/tool-send`	도구 인수에서 표준 전송 대상 필드 추출
`plugin-sdk/temp-path`	공유 임시 다운로드 경로 헬퍼와 비공개 보안 임시 작업 공간
`plugin-sdk/logging-core`	하위 시스템 로거 및 수정 헬퍼
`plugin-sdk/markdown-table-runtime`	Markdown 표 모드 및 변환 헬퍼
`plugin-sdk/model-session-runtime`	`applyModelOverrideToSessionEntry`, `resolveAgentMaxConcurrent` 같은 모델/세션 재정의 헬퍼
`plugin-sdk/talk-config-runtime`	Talk 프로바이더 구성 확인 헬퍼
`plugin-sdk/json-store`	작은 JSON 상태 읽기/쓰기 헬퍼
`plugin-sdk/file-lock`	재진입 파일 잠금 헬퍼
`plugin-sdk/persistent-dedupe`	디스크 기반 중복 제거 캐시 헬퍼
`plugin-sdk/acp-runtime`	ACP 런타임/세션 및 답장 디스패치 헬퍼
`plugin-sdk/acp-runtime-backend`	시작 시 로드된 Plugin을 위한 경량 ACP 백엔드 등록 및 답장 디스패치 헬퍼
`plugin-sdk/acp-binding-resolve-runtime`	수명 주기 시작 가져오기 없는 읽기 전용 ACP 바인딩 확인
`plugin-sdk/agent-config-primitives`	좁은 범위의 에이전트 런타임 구성 스키마 프리미티브
`plugin-sdk/boolean-param`	느슨한 불리언 매개변수 리더
`plugin-sdk/dangerous-name-runtime`	위험한 이름 일치 확인 헬퍼
`plugin-sdk/device-bootstrap`	디바이스 부트스트랩 및 페어링 토큰 헬퍼
`plugin-sdk/extension-shared`	공유 수동 채널, 상태, 앰비언트 프록시 헬퍼 프리미티브
`plugin-sdk/models-provider-runtime`	`/models` 명령/프로바이더 답장 헬퍼
`plugin-sdk/skill-commands-runtime`	Skill 명령 목록 헬퍼
`plugin-sdk/native-command-registry`	네이티브 명령 레지스트리/빌드/직렬화 헬퍼
`plugin-sdk/agent-harness`	저수준 에이전트 하네스를 위한 실험적 신뢰 Plugin 표면: 하네스 타입, 활성 실행 조정/중단 헬퍼, OpenClaw 도구 브리지 헬퍼, 런타임 계획 도구 정책 헬퍼, 터미널 결과 분류, 도구 진행률 형식 지정/세부 정보 헬퍼, 시도 결과 유틸리티
`plugin-sdk/provider-zai-endpoint`	더 이상 사용되지 않는 Z.AI 프로바이더 소유 엔드포인트 감지 파사드. Z.AI Plugin 공개 API를 사용하세요
`plugin-sdk/async-lock-runtime`	작은 런타임 상태 파일을 위한 프로세스 로컬 비동기 잠금 헬퍼
`plugin-sdk/channel-activity-runtime`	채널 활동 텔레메트리 헬퍼
`plugin-sdk/concurrency-runtime`	제한된 비동기 작업 동시성 헬퍼
`plugin-sdk/dedupe-runtime`	인메모리 중복 제거 캐시 헬퍼
`plugin-sdk/delivery-queue-runtime`	아웃바운드 보류 중 전송 드레인 헬퍼
`plugin-sdk/file-access-runtime`	안전한 로컬 파일 및 미디어 소스 경로 헬퍼
`plugin-sdk/heartbeat-runtime`	Heartbeat 깨우기, 이벤트, 표시 여부 헬퍼
`plugin-sdk/number-runtime`	숫자 강제 변환 헬퍼
`plugin-sdk/secure-random-runtime`	보안 토큰/UUID 헬퍼
`plugin-sdk/system-event-runtime`	시스템 이벤트 큐 헬퍼
`plugin-sdk/transport-ready-runtime`	전송 준비 상태 대기 헬퍼
`plugin-sdk/infra-runtime`	더 이상 사용되지 않는 호환성 심. 위의 집중된 런타임 하위 경로를 사용하세요
`plugin-sdk/collection-runtime`	작은 제한 캐시 헬퍼
`plugin-sdk/diagnostic-runtime`	진단 플래그, 이벤트, 추적 컨텍스트 헬퍼
`plugin-sdk/error-runtime`	오류 그래프, 형식 지정, 공유 오류 분류 헬퍼, `isApprovalNotFoundError`
`plugin-sdk/fetch-runtime`	래핑된 fetch, 프록시, EnvHttpProxyAgent 옵션, 고정 조회 헬퍼
`plugin-sdk/runtime-fetch`	프록시/보호된 fetch 가져오기 없는 디스패처 인식 런타임 fetch
`plugin-sdk/response-limit-runtime`	광범위한 미디어 런타임 표면 없는 제한된 응답 본문 리더
`plugin-sdk/session-binding-runtime`	구성된 바인딩 라우팅 또는 페어링 스토어 없는 현재 대화 바인딩 상태
`plugin-sdk/session-store-runtime`	광범위한 구성 쓰기/유지 관리 가져오기 없는 세션 스토어 헬퍼
`plugin-sdk/context-visibility-runtime`	광범위한 구성/보안 가져오기 없는 컨텍스트 표시 여부 확인 및 보조 컨텍스트 필터링
`plugin-sdk/string-coerce-runtime`	Markdown/로깅 가져오기 없는 좁은 범위의 프리미티브 레코드/문자열 강제 변환 및 정규화 헬퍼
`plugin-sdk/host-runtime`	호스트 이름 및 SCP 호스트 정규화 헬퍼
`plugin-sdk/retry-runtime`	재시도 구성 및 재시도 실행기 헬퍼
`plugin-sdk/agent-runtime`	`resolveAgentDir`, `resolveDefaultAgentDir`, 더 이상 사용되지 않는 `resolveOpenClawAgentDir` 호환성 내보내기를 포함한 에이전트 디렉터리/ID/작업 공간 헬퍼
`plugin-sdk/directory-runtime`	구성 기반 디렉터리 조회/중복 제거
`plugin-sdk/keyed-async-queue`	`KeyedAsyncQueue`

기능 및 테스트 하위 경로

하위 경로	주요 내보내기
`plugin-sdk/media-runtime`	공유 미디어 가져오기/변환/저장 헬퍼, ffprobe 기반 비디오 크기 탐색, 미디어 페이로드 빌더
`plugin-sdk/media-mime`	좁은 범위의 MIME 정규화, 파일 확장자 매핑, MIME 감지, 미디어 종류 헬퍼
`plugin-sdk/media-store`	`saveMediaBuffer` 같은 좁은 범위의 미디어 저장소 헬퍼
`plugin-sdk/media-generation-runtime`	공유 미디어 생성 장애 조치 헬퍼, 후보 선택, 누락된 모델 메시지
`plugin-sdk/media-understanding`	미디어 이해 제공자 타입과 제공자용 이미지/오디오/구조화 추출 헬퍼 내보내기
`plugin-sdk/text-chunking`	텍스트 및 markdown 청킹/렌더링 헬퍼, markdown 표 변환, 지시문 태그 제거, 안전한 텍스트 유틸리티
`plugin-sdk/text-chunking`	아웃바운드 텍스트 청킹 헬퍼
`plugin-sdk/speech`	음성 제공자 타입과 제공자용 지시문, 레지스트리, 검증, OpenAI 호환 TTS 빌더, 음성 헬퍼 내보내기
`plugin-sdk/speech-core`	공유 음성 제공자 타입, 레지스트리, 지시문, 정규화, 음성 헬퍼 내보내기
`plugin-sdk/realtime-transcription`	실시간 전사 제공자 타입, 레지스트리 헬퍼, 공유 WebSocket 세션 헬퍼
`plugin-sdk/realtime-voice`	실시간 음성 제공자 타입 및 레지스트리 헬퍼
`plugin-sdk/image-generation`	이미지 생성 제공자 타입과 이미지 애셋/데이터 URL 헬퍼 및 OpenAI 호환 이미지 제공자 빌더
`plugin-sdk/image-generation-core`	공유 이미지 생성 타입, 장애 조치, 인증, 레지스트리 헬퍼
`plugin-sdk/music-generation`	음악 생성 제공자/요청/결과 타입
`plugin-sdk/music-generation-core`	공유 음악 생성 타입, 장애 조치 헬퍼, 제공자 조회, 모델 참조 파싱
`plugin-sdk/video-generation`	비디오 생성 제공자/요청/결과 타입
`plugin-sdk/video-generation-core`	공유 비디오 생성 타입, 장애 조치 헬퍼, 제공자 조회, 모델 참조 파싱
`plugin-sdk/webhook-targets`	Webhook 대상 레지스트리 및 라우트 설치 헬퍼
`plugin-sdk/webhook-path`	사용 중단된 호환성 별칭입니다. `plugin-sdk/webhook-ingress`를 사용하세요
`plugin-sdk/web-media`	공유 원격/로컬 미디어 로딩 헬퍼
`plugin-sdk/zod`	사용 중단된 호환성 재내보내기입니다. `zod`에서 `zod`를 직접 가져오세요
`plugin-sdk/testing`	레거시 OpenClaw 테스트를 위한 repo-local 사용 중단 호환성 배럴입니다. 새 repo 테스트는 대신 `plugin-sdk/agent-runtime-test-contracts`, `plugin-sdk/plugin-test-runtime`, `plugin-sdk/channel-test-helpers`, `plugin-sdk/test-env` 또는 `plugin-sdk/test-fixtures` 같은 집중된 로컬 테스트 하위 경로를 가져와야 합니다
`plugin-sdk/plugin-test-api`	repo 테스트 헬퍼 브리지를 가져오지 않고 직접 Plugin 등록 단위 테스트를 수행하기 위한 repo-local 최소 `createTestPluginApi` 헬퍼
`plugin-sdk/agent-runtime-test-contracts`	인증, 전달, 폴백, 도구 훅, 프롬프트 오버레이, 스키마, 전사 프로젝션 테스트를 위한 repo-local 네이티브 에이전트 런타임 어댑터 계약 fixture
`plugin-sdk/channel-test-helpers`	일반 작업/설정/상태 계약, 디렉터리 어설션, 계정 시작 수명 주기, 전송 구성 스레딩, 런타임 mock, 상태 이슈, 아웃바운드 전달, 훅 등록을 위한 repo-local 채널 지향 테스트 헬퍼
`plugin-sdk/channel-target-testing`	채널 테스트를 위한 repo-local 공유 대상 해석 오류 사례 스위트
`plugin-sdk/plugin-test-contracts`	repo-local Plugin 패키지, 등록, 공개 아티팩트, 직접 가져오기, 런타임 API, 가져오기 부작용 계약 헬퍼
`plugin-sdk/provider-test-contracts`	repo-local 제공자 런타임, 인증, 검색, 온보딩, 카탈로그, 마법사, 미디어 기능, 재생 정책, 실시간 STT 라이브 오디오, 웹 검색/가져오기, 스트림 계약 헬퍼
`plugin-sdk/provider-http-test-mocks`	`plugin-sdk/provider-http`를 실행하는 제공자 테스트용 repo-local 옵트인 Vitest HTTP/인증 mock
`plugin-sdk/test-fixtures`	repo-local 일반 CLI 런타임 캡처, 샌드박스 컨텍스트, Skills 작성기, 에이전트 메시지, 시스템 이벤트, 모듈 재로드, 번들 Plugin 경로, 터미널 텍스트, 청킹, 인증 토큰, 타입 지정 사례 fixture
`plugin-sdk/test-node-mocks`	Vitest `vi.mock("node:*")` 팩토리 내부에서 사용하기 위한 repo-local 집중 Node 내장 mock 헬퍼

메모리 하위 경로

하위 경로	주요 내보내기
`plugin-sdk/memory-core`	관리자/구성/파일/CLI 헬퍼를 위한 번들 memory-core 헬퍼 표면
`plugin-sdk/memory-core-engine-runtime`	메모리 인덱스/검색 런타임 파사드
`plugin-sdk/memory-core-host-engine-foundation`	메모리 호스트 기반 엔진 내보내기
`plugin-sdk/memory-core-host-engine-embeddings`	메모리 호스트 임베딩 계약, 레지스트리 접근, 로컬 제공자, 일반 배치/원격 헬퍼
`plugin-sdk/memory-core-host-engine-qmd`	메모리 호스트 QMD 엔진 내보내기
`plugin-sdk/memory-core-host-engine-storage`	메모리 호스트 저장소 엔진 내보내기
`plugin-sdk/memory-core-host-multimodal`	메모리 호스트 멀티모달 헬퍼
`plugin-sdk/memory-core-host-query`	메모리 호스트 쿼리 헬퍼
`plugin-sdk/memory-core-host-secret`	메모리 호스트 보안 정보 헬퍼
`plugin-sdk/memory-core-host-events`	사용 중단된 호환성 별칭입니다. `plugin-sdk/memory-host-events`를 사용하세요
`plugin-sdk/memory-core-host-status`	메모리 호스트 상태 헬퍼
`plugin-sdk/memory-core-host-runtime-cli`	메모리 호스트 CLI 런타임 헬퍼
`plugin-sdk/memory-core-host-runtime-core`	메모리 호스트 코어 런타임 헬퍼
`plugin-sdk/memory-core-host-runtime-files`	메모리 호스트 파일/런타임 헬퍼
`plugin-sdk/memory-host-core`	메모리 호스트 코어 런타임 헬퍼를 위한 벤더 중립 별칭
`plugin-sdk/memory-host-events`	메모리 호스트 이벤트 저널 헬퍼를 위한 벤더 중립 별칭
`plugin-sdk/memory-host-files`	사용 중단된 호환성 별칭입니다. `plugin-sdk/memory-core-host-runtime-files`를 사용하세요
`plugin-sdk/memory-host-markdown`	메모리 인접 Plugin을 위한 공유 관리형 markdown 헬퍼
`plugin-sdk/memory-host-search`	검색 관리자 접근을 위한 Active Memory 런타임 파사드
`plugin-sdk/memory-host-status`	사용 중단된 호환성 별칭입니다. `plugin-sdk/memory-core-host-status`를 사용하세요

예약된 번들 헬퍼 하위 경로

현재 예약된 번들 헬퍼 SDK 하위 경로는 없습니다. 소유자별 헬퍼는 소유 Plugin 패키지 내부에 있으며, 재사용 가능한 호스트 계약은 plugin-sdk/gateway-runtime, plugin-sdk/security-runtime, plugin-sdk/plugin-config-runtime 같은 일반 SDK 하위 경로를 사용합니다.