openclaw/plugin-sdk/ 아래의 좁은 하위 경로 집합으로 노출됩니다.이 페이지는 자주 사용되는 하위 경로를 목적별로 그룹화해 정리합니다. 생성된 전체 200개 이상의 하위 경로 목록은
scripts/lib/plugin-sdk-entrypoints.json에 있습니다. 예약된 번들 Plugin helper 하위 경로도 여기에 나타나지만, 문서 페이지에서 명시적으로 승격하지 않는 한 구현 세부사항입니다.
Plugin 작성 가이드는 Plugin SDK 개요를 참고하세요.
Plugin 엔트리
| Subpath | 주요 export |
|---|---|
plugin-sdk/plugin-entry | definePluginEntry |
plugin-sdk/core | defineChannelPluginEntry, createChatChannelPlugin, createChannelPluginBase, defineSetupPluginEntry, buildChannelConfigSchema |
plugin-sdk/config-schema | OpenClawSchema |
plugin-sdk/provider-entry | defineSingleProviderPluginEntry |
채널 하위 경로
채널 하위 경로
| Subpath | 주요 export |
|---|---|
plugin-sdk/channel-core | defineChannelPluginEntry, defineSetupPluginEntry, createChatChannelPlugin, createChannelPluginBase |
plugin-sdk/config-schema | 루트 openclaw.json Zod 스키마 export (OpenClawSchema) |
plugin-sdk/channel-setup | createOptionalChannelSetupSurface, createOptionalChannelSetupAdapter, createOptionalChannelSetupWizard, 그리고 DEFAULT_ACCOUNT_ID, createTopLevelChannelDmPolicy, setSetupChannelEnabled, splitSetupEntries |
plugin-sdk/setup | 공용 setup wizard helper, allowlist 프롬프트, setup 상태 빌더 |
plugin-sdk/setup-runtime | createPatchedAccountSetupAdapter, createEnvPatchedAccountSetupAdapter, createSetupInputPresenceValidator, noteChannelLookupFailure, noteChannelLookupSummary, promptResolvedAllowFrom, splitSetupEntries, createAllowlistSetupWizardProxy, createDelegatedSetupWizardProxy |
plugin-sdk/setup-adapter-runtime | createEnvPatchedAccountSetupAdapter |
plugin-sdk/setup-tools | formatCliCommand, detectBinary, extractArchive, resolveBrewExecutable, formatDocsLink, CONFIG_DIR |
plugin-sdk/account-core | 다중 계정 config/action-gate helper, 기본 계정 fallback helper |
plugin-sdk/account-id | DEFAULT_ACCOUNT_ID, account-id 정규화 helper |
plugin-sdk/account-resolution | 계정 조회 + 기본 fallback helper |
plugin-sdk/account-helpers | 좁은 범위의 account-list/account-action helper |
plugin-sdk/channel-pairing | createChannelPairingController |
plugin-sdk/channel-reply-pipeline | createChannelReplyPipeline |
plugin-sdk/channel-config-helpers | createHybridChannelConfigAdapter |
plugin-sdk/channel-config-schema | 채널 config 스키마 타입 |
plugin-sdk/telegram-command-config | 번들 contract fallback이 포함된 Telegram 사용자 정의 명령 정규화/검증 helper |
plugin-sdk/command-gating | 좁은 범위의 명령 권한 게이트 helper |
plugin-sdk/channel-policy | resolveChannelGroupRequireMention |
plugin-sdk/channel-lifecycle | createAccountStatusSink, draft 스트림 라이프사이클/완료 helper |
plugin-sdk/inbound-envelope | 공용 inbound route + envelope 빌더 helper |
plugin-sdk/inbound-reply-dispatch | 공용 inbound 기록 및 디스패치 helper |
plugin-sdk/messaging-targets | 대상 파싱/매칭 helper |
plugin-sdk/outbound-media | 공용 outbound 미디어 로딩 helper |
plugin-sdk/outbound-runtime | outbound identity, send delegate, payload 계획 helper |
plugin-sdk/poll-runtime | 좁은 범위의 poll 정규화 helper |
plugin-sdk/thread-bindings-runtime | thread-binding 라이프사이클 및 adapter helper |
plugin-sdk/agent-media-payload | 레거시 agent media payload 빌더 |
plugin-sdk/conversation-runtime | 대화/thread binding, pairing, configured-binding helper |
plugin-sdk/runtime-config-snapshot | 런타임 config 스냅샷 helper |
plugin-sdk/runtime-group-policy | 런타임 group-policy 해석 helper |
plugin-sdk/channel-status | 공용 채널 상태 스냅샷/요약 helper |
plugin-sdk/channel-config-primitives | 좁은 범위의 채널 config 스키마 primitive |
plugin-sdk/channel-config-writes | 채널 config 쓰기 권한 helper |
plugin-sdk/channel-plugin-common | 공용 채널 Plugin prelude export |
plugin-sdk/allowlist-config-edit | allowlist config 편집/읽기 helper |
plugin-sdk/group-access | 공용 group-access 결정 helper |
plugin-sdk/direct-dm | 공용 direct-DM 인증/가드 helper |
plugin-sdk/interactive-runtime | 의미 기반 메시지 표시, 전달, 레거시 interactive reply helper. 메시지 표시 참고 |
plugin-sdk/channel-inbound | inbound debounce, mention matching, mention-policy helper, envelope helper를 위한 호환성 barrel |
plugin-sdk/channel-inbound-debounce | 좁은 범위의 inbound debounce helper |
plugin-sdk/channel-mention-gating | 더 넓은 inbound 런타임 표면 없이 사용하는 좁은 범위의 mention-policy 및 mention 텍스트 helper |
plugin-sdk/channel-envelope | 좁은 범위의 inbound envelope 형식 helper |
plugin-sdk/channel-location | 채널 위치 컨텍스트 및 형식 helper |
plugin-sdk/channel-logging | inbound drop 및 typing/ack 실패를 위한 채널 로깅 helper |
plugin-sdk/channel-send-result | reply 결과 타입 |
plugin-sdk/channel-actions | 채널 메시지 액션 helper와, Plugin 호환성을 위해 유지되는 사용 중단된 네이티브 스키마 helper |
plugin-sdk/channel-targets | 대상 파싱/매칭 helper |
plugin-sdk/channel-contract | 채널 contract 타입 |
plugin-sdk/channel-feedback | feedback/reaction wiring |
plugin-sdk/channel-secret-runtime | collectSimpleChannelFieldAssignments, getChannelSurface, pushAssignment 같은 좁은 범위의 secret-contract helper와 secret 대상 타입 |
Provider 하위 경로
Provider 하위 경로
| Subpath | 주요 export |
|---|---|
plugin-sdk/provider-entry | defineSingleProviderPluginEntry |
plugin-sdk/provider-setup | 선별된 로컬/자체 호스팅 provider setup helper |
plugin-sdk/self-hosted-provider-setup | 집중된 OpenAI 호환 자체 호스팅 provider setup helper |
plugin-sdk/cli-backend | CLI 백엔드 기본값 + watchdog 상수 |
plugin-sdk/provider-auth-runtime | provider Plugin용 런타임 API 키 해석 helper |
plugin-sdk/provider-auth-api-key | upsertApiKeyProfile 같은 API 키 온보딩/profile-write helper |
plugin-sdk/provider-auth-result | 표준 OAuth auth-result 빌더 |
plugin-sdk/provider-auth-login | provider Plugin용 공용 interactive login helper |
plugin-sdk/provider-env-vars | provider auth env-var 조회 helper |
plugin-sdk/provider-auth | createProviderApiKeyAuthMethod, ensureApiKeyFromOptionEnvOrPrompt, upsertAuthProfile, upsertApiKeyProfile, writeOAuthCredentials |
plugin-sdk/provider-model-shared | ProviderReplayFamily, buildProviderReplayFamilyHooks, normalizeModelCompat, 공용 replay-policy 빌더, provider-endpoint helper, normalizeNativeXaiModelId 같은 model-id 정규화 helper |
plugin-sdk/provider-catalog-shared | findCatalogTemplate, buildSingleProviderApiKeyCatalog, supportsNativeStreamingUsageCompat, applyProviderNativeStreamingUsageCompat |
plugin-sdk/provider-http | 오디오 전사 multipart form helper를 포함한 일반 provider HTTP/endpoint capability helper |
plugin-sdk/provider-web-fetch-contract | enablePluginInConfig, WebFetchProviderPlugin 같은 좁은 범위의 web-fetch config/선택 contract helper |
plugin-sdk/provider-web-fetch | web-fetch provider 등록/캐시 helper |
plugin-sdk/provider-web-search-config-contract | Plugin 활성화 wiring이 필요 없는 provider를 위한 좁은 범위의 web-search config/credential helper |
plugin-sdk/provider-web-search-contract | createWebSearchProviderContractFields, enablePluginInConfig, resolveProviderWebSearchPluginConfig, 범위 지정 credential setter/getter 같은 좁은 범위의 web-search config/credential contract helper |
plugin-sdk/provider-web-search | web-search provider 등록/캐시/런타임 helper |
plugin-sdk/provider-tools | ProviderToolCompatFamily, buildProviderToolCompatFamilyHooks, Gemini 스키마 정리 + 진단, resolveXaiModelCompatPatch / applyXaiModelCompat 같은 xAI compat helper |
plugin-sdk/provider-usage | fetchClaudeUsage 등 |
plugin-sdk/provider-stream | ProviderStreamFamily, buildProviderStreamFamilyHooks, composeProviderStreamWrappers, 스트림 wrapper 타입, 공용 Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot wrapper helper |
plugin-sdk/provider-transport-runtime | guarded fetch, transport 메시지 변환, 쓰기 가능한 transport 이벤트 스트림 같은 네이티브 provider transport helper |
plugin-sdk/provider-onboard | 온보딩 config patch helper |
plugin-sdk/global-singleton | 프로세스 로컬 singleton/map/cache helper |
plugin-sdk/group-activation | 좁은 범위의 그룹 활성화 모드 및 명령 파싱 helper |
인증 및 보안 하위 경로
인증 및 보안 하위 경로
| Subpath | 주요 export |
|---|---|
plugin-sdk/command-auth | resolveControlCommandGate, 명령 레지스트리 helper, 발신자 권한 helper |
plugin-sdk/command-status | buildCommandsMessagePaginated, buildHelpMessage 같은 명령/도움말 메시지 빌더 |
plugin-sdk/approval-auth-runtime | 승인자 해석 및 동일 채팅 action-auth helper |
plugin-sdk/approval-client-runtime | 네이티브 exec 승인 profile/filter helper |
plugin-sdk/approval-delivery-runtime | 네이티브 승인 capability/delivery adapter |
plugin-sdk/approval-gateway-runtime | 공용 승인 gateway 해석 helper |
plugin-sdk/approval-handler-adapter-runtime | 빠른 채널 엔트리포인트를 위한 경량 네이티브 승인 adapter 로딩 helper |
plugin-sdk/approval-handler-runtime | 더 넓은 승인 handler 런타임 helper. 더 좁은 adapter/gateway seam으로 충분하다면 그것을 우선 사용 |
plugin-sdk/approval-native-runtime | 네이티브 승인 대상 + account-binding helper |
plugin-sdk/approval-reply-runtime | exec/Plugin 승인 reply payload helper |
plugin-sdk/reply-dedupe | 좁은 범위의 inbound reply dedupe 초기화 helper |
plugin-sdk/channel-contract-testing | 광범위한 테스트 barrel 없이 사용하는 좁은 범위의 채널 contract 테스트 helper |
plugin-sdk/command-auth-native | 네이티브 명령 인증 + 네이티브 session-target helper |
plugin-sdk/command-detection | 공용 명령 감지 helper |
plugin-sdk/command-primitives-runtime | 빠른 채널 경로를 위한 경량 명령 텍스트 predicate |
plugin-sdk/command-surface | command-body 정규화 및 command-surface helper |
plugin-sdk/allow-from | formatAllowFromLowercase |
plugin-sdk/channel-secret-runtime | 채널/Plugin secret 표면을 위한 좁은 범위의 secret-contract 수집 helper |
plugin-sdk/secret-ref-runtime | secret-contract/config 파싱을 위한 좁은 범위의 coerceSecretRef 및 SecretRef 타이핑 helper |
plugin-sdk/security-runtime | 공용 trust, DM gating, 외부 콘텐츠, secret 수집 helper |
plugin-sdk/ssrf-policy | 호스트 allowlist 및 사설 네트워크 SSRF 정책 helper |
plugin-sdk/ssrf-dispatcher | 광범위한 infra 런타임 표면 없이 사용하는 좁은 범위의 pinned-dispatcher helper |
plugin-sdk/ssrf-runtime | pinned-dispatcher, SSRF 보호 fetch, SSRF 정책 helper |
plugin-sdk/secret-input | secret 입력 파싱 helper |
plugin-sdk/webhook-ingress | Webhook 요청/대상 helper |
plugin-sdk/webhook-request-guards | 요청 본문 크기/시간 제한 helper |
런타임 및 저장소 하위 경로
런타임 및 저장소 하위 경로
Capability 및 테스트 하위 경로
Capability 및 테스트 하위 경로
| Subpath | 주요 export |
|---|---|
plugin-sdk/media-runtime | 공용 미디어 fetch/변환/저장 helper와 media payload 빌더 |
plugin-sdk/media-store | saveMediaBuffer 같은 좁은 범위의 미디어 저장소 helper |
plugin-sdk/media-generation-runtime | 공용 미디어 생성 failover helper, candidate 선택, 누락 모델 메시지 helper |
plugin-sdk/media-understanding | 미디어 이해 provider 타입과 provider 대상 이미지/오디오 helper export |
plugin-sdk/text-runtime | assistant-visible-text 제거, Markdown 렌더/chunking/table helper, redaction helper, directive-tag helper, safe-text 유틸리티 같은 공용 텍스트/Markdown/로깅 helper |
plugin-sdk/text-chunking | outbound 텍스트 chunking helper |
plugin-sdk/speech | 음성 provider 타입과 provider 대상 directive, 레지스트리, 검증 helper |
plugin-sdk/speech-core | 공용 음성 provider 타입, 레지스트리, directive, 정규화 helper |
plugin-sdk/realtime-transcription | 실시간 전사 provider 타입, 레지스트리 helper, 공용 WebSocket 세션 helper |
plugin-sdk/realtime-voice | 실시간 음성 provider 타입 및 레지스트리 helper |
plugin-sdk/image-generation | 이미지 생성 provider 타입 |
plugin-sdk/image-generation-core | 공용 이미지 생성 타입, failover, auth, 레지스트리 helper |
plugin-sdk/music-generation | 음악 생성 provider/request/result 타입 |
plugin-sdk/music-generation-core | 공용 음악 생성 타입, failover helper, provider 조회, model-ref 파싱 |
plugin-sdk/video-generation | 비디오 생성 provider/request/result 타입 |
plugin-sdk/video-generation-core | 공용 비디오 생성 타입, failover helper, provider 조회, model-ref 파싱 |
plugin-sdk/webhook-targets | Webhook 대상 레지스트리 및 route-install helper |
plugin-sdk/webhook-path | Webhook 경로 정규화 helper |
plugin-sdk/web-media | 공용 원격/로컬 미디어 로딩 helper |
plugin-sdk/zod | Plugin SDK 소비자를 위한 zod 재export |
plugin-sdk/testing | installCommonResolveTargetErrorCases, shouldAckReaction |
Memory 하위 경로
Memory 하위 경로
| Subpath | 주요 export |
|---|---|
plugin-sdk/memory-core | manager/config/file/CLI helper를 위한 번들된 memory-core helper 표면 |
plugin-sdk/memory-core-engine-runtime | 메모리 인덱스/검색 런타임 파사드 |
plugin-sdk/memory-core-host-engine-foundation | 메모리 호스트 foundation 엔진 export |
plugin-sdk/memory-core-host-engine-embeddings | 메모리 호스트 임베딩 contract, 레지스트리 접근, 로컬 provider, 일반 batch/원격 helper |
plugin-sdk/memory-core-host-engine-qmd | 메모리 호스트 QMD 엔진 export |
plugin-sdk/memory-core-host-engine-storage | 메모리 호스트 스토리지 엔진 export |
plugin-sdk/memory-core-host-multimodal | 메모리 호스트 멀티모달 helper |
plugin-sdk/memory-core-host-query | 메모리 호스트 쿼리 helper |
plugin-sdk/memory-core-host-secret | 메모리 호스트 secret helper |
plugin-sdk/memory-core-host-events | 메모리 호스트 이벤트 저널 helper |
plugin-sdk/memory-core-host-status | 메모리 호스트 상태 helper |
plugin-sdk/memory-core-host-runtime-cli | 메모리 호스트 CLI 런타임 helper |
plugin-sdk/memory-core-host-runtime-core | 메모리 호스트 코어 런타임 helper |
plugin-sdk/memory-core-host-runtime-files | 메모리 호스트 파일/런타임 helper |
plugin-sdk/memory-host-core | 메모리 호스트 코어 런타임 helper에 대한 vendor-neutral 별칭 |
plugin-sdk/memory-host-events | 메모리 호스트 이벤트 저널 helper에 대한 vendor-neutral 별칭 |
plugin-sdk/memory-host-files | 메모리 호스트 파일/런타임 helper에 대한 vendor-neutral 별칭 |
plugin-sdk/memory-host-markdown | 메모리 인접 Plugin용 공용 managed-Markdown helper |
plugin-sdk/memory-host-search | search-manager 접근을 위한 Active Memory 런타임 파사드 |
plugin-sdk/memory-host-status | 메모리 호스트 상태 helper에 대한 vendor-neutral 별칭 |
plugin-sdk/memory-lancedb | 번들된 memory-lancedb helper 표면 |
예약된 번들 helper 하위 경로
예약된 번들 helper 하위 경로
| Family | 현재 하위 경로 | 의도된 용도 |
|---|---|---|
| Browser | plugin-sdk/browser-cdp, plugin-sdk/browser-config-runtime, plugin-sdk/browser-config-support, plugin-sdk/browser-control-auth, plugin-sdk/browser-node-runtime, plugin-sdk/browser-profiles, plugin-sdk/browser-security-runtime, plugin-sdk/browser-setup-tools, plugin-sdk/browser-support | 번들된 browser Plugin 지원 helper (browser-support는 호환성 barrel로 유지됨) |
| Matrix | plugin-sdk/matrix, plugin-sdk/matrix-helper, plugin-sdk/matrix-runtime-heavy, plugin-sdk/matrix-runtime-shared, plugin-sdk/matrix-runtime-surface, plugin-sdk/matrix-surface, plugin-sdk/matrix-thread-bindings | 번들된 Matrix helper/런타임 표면 |
| Line | plugin-sdk/line, plugin-sdk/line-core, plugin-sdk/line-runtime, plugin-sdk/line-surface | 번들된 LINE helper/런타임 표면 |
| IRC | plugin-sdk/irc, plugin-sdk/irc-surface | 번들된 IRC helper 표면 |
| 채널별 helper | plugin-sdk/googlechat, plugin-sdk/zalouser, plugin-sdk/bluebubbles, plugin-sdk/bluebubbles-policy, plugin-sdk/mattermost, plugin-sdk/mattermost-policy, plugin-sdk/feishu-conversation, plugin-sdk/msteams, plugin-sdk/nextcloud-talk, plugin-sdk/nostr, plugin-sdk/tlon, plugin-sdk/twitch | 번들된 채널 호환성/helper seam |
| 인증/Plugin별 helper | plugin-sdk/github-copilot-login, plugin-sdk/github-copilot-token, plugin-sdk/diagnostics-otel, plugin-sdk/diffs, plugin-sdk/llm-task, plugin-sdk/thread-ownership, plugin-sdk/voice-call | 번들된 기능/Plugin helper seam; plugin-sdk/github-copilot-token은 현재 DEFAULT_COPILOT_API_BASE_URL, deriveCopilotApiBaseUrlFromToken, resolveCopilotApiToken을 export합니다 |