--- read_when: - Plugin 가져오기에 적합한 plugin-sdk 하위 경로 선택 - 번들 Plugin 하위 경로 및 헬퍼 표면 감사 summary: 'Plugin SDK 하위 경로 카탈로그: 어떤 import가 어디에 있는지, 영역별로 그룹화' title: Plugin SDK 하위 경로 x-i18n: generated_at: "2026-05-11T20:34:25Z" model: gpt-5.5 provider: openai source_hash: c2ef3c37e00ca59a567e55b3b47962803e43514d6791d8fda75c7bfeffb1e142 source_path: plugins/sdk-subpaths.md workflow: 16 --- 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 개요](/ko/plugins/sdk-overview)를 참조하세요. ## 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`를 사용하세요. | 하위 경로 | 주요 내보내기 | | --- | --- | | `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](/ko/plugins/sdk-channel-ingress)를 참조하세요. | | `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](/ko/plugins/sdk-channel-message)를 참조하세요. 레거시 답장 디스패치 파사드는 호환성 전용으로 더 이상 사용되지 않습니다. | | `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/discord@2026.3.13` 및 추적 중인 소유자 호환성을 위한 더 이상 사용되지 않는 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` | 의미론적 메시지 표현, 전달, 레거시 대화형 답장 헬퍼입니다. [메시지 표현](/ko/plugins/message-presentation)을 참조하세요 | | `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 하위 경로를 사용합니다. ## 관련 항목 - [Plugin SDK 개요](/ko/plugins/sdk-overview) - [Plugin SDK 설정](/ko/plugins/sdk-setup) - [Plugin 빌드](/ko/plugins/building-plugins)