Plugin SDK reference
Plugin SDK 하위 경로
Plugin SDK는 openclaw/plugin-sdk/ 아래의 제한된 공개 하위 경로 집합으로 노출됩니다. 이 페이지에서는 자주 사용하는 하위 경로를 용도별로 분류하여 설명합니다. 다음 세 파일이 공개 표면을 정의합니다.
scripts/lib/plugin-sdk-entrypoints.json: 빌드에서 컴파일하는 관리 대상 진입점 목록입니다.scripts/lib/plugin-sdk-private-local-only-subpaths.json: 저장소 로컬 테스트/내부 하위 경로입니다. 패키지 내보내기는 목록에서 이 리스트를 제외한 항목입니다.src/plugin-sdk/entrypoints.ts: 사용 중단된 하위 경로, 예약된 번들 헬퍼, 지원되는 번들 퍼사드 및 Plugin 소유 공개 표면의 분류 메타데이터입니다.
관리자는 pnpm plugin-sdk:surface로 공개 내보내기 개수를 감사하고 pnpm plugins:boundary-report:summary로 사용 중인 예약 헬퍼 하위 경로를 감사합니다. 사용하지 않는 예약 헬퍼 내보내기는 비활성 호환성 부채로 공개 SDK에 남는 대신 CI 보고서를 실패시킵니다.
Plugin 작성 가이드는 Plugin SDK 개요를 참조하십시오.
Plugin 진입점
| 하위 경로 | 주요 내보내기 |
|---|---|
plugin-sdk/plugin-entry |
definePluginEntry |
plugin-sdk/core |
defineChannelPluginEntry, createChatChannelPlugin, createChannelPluginBase, defineSetupPluginEntry, buildChannelConfigSchema, buildJsonChannelConfigSchema, resolveTailscalePublishedHost |
plugin-sdk/provider-entry |
defineSingleProviderPluginEntry |
plugin-sdk/migration |
createMigrationItem, 사유 상수, 항목 상태 마커, 수정 헬퍼 및 summarizeMigrationItems 등의 마이그레이션 제공자 항목 헬퍼 |
plugin-sdk/migration-runtime |
copyMigrationFileItem, resolvePlannedMigrationTargets, withCachedMigrationConfigRuntime 및 writeMigrationReport 등의 런타임 마이그레이션 헬퍼 |
plugin-sdk/health |
번들 상태 소비자를 위한 Doctor 상태 검사 등록, 감지, 복구, 선택, 심각도 및 발견 항목 유형 |
plugin-sdk/config-schema |
사용 중단됨. 루트 openclaw.json Zod 스키마(OpenClawSchema)입니다. 대신 Plugin 로컬 스키마를 정의하고 plugin-sdk/json-schema-runtime으로 검증하십시오. |
사용 중단된 호환성 및 테스트 헬퍼
이전 Plugin을 위해 사용 중단된 하위 경로를 계속 내보내지만, 새 코드는 아래의 목적별 SDK 하위 경로를 사용해야 합니다. 관리 대상 목록은 scripts/lib/plugin-sdk-deprecated-public-subpaths.json이며, CI는 번들 프로덕션 코드에서 이 목록의 항목을 가져오면 거부합니다. plugin-sdk/compat, plugin-sdk/config-types, plugin-sdk/infra-runtime, plugin-sdk/text-runtime 같은 광범위한 배럴은 호환성 전용이며, plugin-sdk/zod는 호환성을 위한 재내보내기입니다. zod에서 zod를 직접 가져오십시오. 광범위한 도메인 배럴인 plugin-sdk/agent-runtime, plugin-sdk/channel-lifecycle, plugin-sdk/channel-runtime, plugin-sdk/cli-runtime, plugin-sdk/conversation-runtime, plugin-sdk/hook-runtime, plugin-sdk/media-runtime, plugin-sdk/plugin-runtime, plugin-sdk/security-runtime도 마찬가지로 목적별 하위 경로 사용을 권장하며 사용 중단되었습니다.
OpenClaw의 Vitest 기반 테스트 헬퍼 하위 경로는 저장소 로컬 전용이며 더 이상 패키지에서 내보내지 않습니다. 해당 경로는 agent-runtime-test-contracts, channel-contract-testing, channel-target-testing, channel-test-helpers, plugin-state-test-runtime, plugin-test-api, plugin-test-contracts, plugin-test-runtime, provider-http-test-mocks, provider-test-contracts, reply-payload-testing, sqlite-runtime-testing, test-env, test-fixtures, test-node-mocks, testing입니다. 비공개 번들 헬퍼 표면인 ssrf-runtime-internal과 codex-native-task-runtime도 저장소 로컬 전용입니다.
예약된 번들 Plugin 헬퍼 하위 경로
plugin-sdk/codex-mcp-projection은 유일하게 예약된 하위 경로입니다. 이는 일반 SDK API가 아니라 번들 Codex Plugin을 위해 Plugin이 소유하는 호환성 표면입니다. 소유자가 다른 Plugin 간의 가져오기는 패키지 계약 가드레일로 차단되며, 예약된 하위 경로를 더 이상 가져오지 않으면 CI가 실패합니다.
plugin-sdk/codex-native-task-runtime은 저장소 로컬 전용이며 패키지 내보내기가 아닙니다.
src/plugin-sdk/entrypoints.ts는 일반 계약으로 대체될 때까지 해당 번들 Plugin이 지원하는 SDK 진입점인 지원 대상 번들 퍼사드도 추적합니다. 해당 경로는 plugin-sdk/discord, plugin-sdk/lmstudio, plugin-sdk/lmstudio-runtime, plugin-sdk/matrix, plugin-sdk/mattermost, plugin-sdk/memory-core-engine-runtime, plugin-sdk/provider-zai-endpoint, plugin-sdk/qa-runner-runtime, plugin-sdk/telegram-account, plugin-sdk/tts-runtime, plugin-sdk/zalouser입니다. 이 중 일부는 새 코드에서도 사용 중단되었습니다. 아래의 각 행에 있는 참고 사항을 확인하십시오.
채널 하위 경로
| 하위 경로 | 주요 내보내기 |
|---|---|
plugin-sdk/channel-core |
defineChannelPluginEntry, defineSetupPluginEntry, createChatChannelPlugin, createChannelPluginBase |
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 |
createSetupTranslator, 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-outbound를 사용하십시오. |
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/chat-channel-ids |
BUNDLED_CHAT_CHANNEL_IDS, BUNDLED_CHAT_CHANNEL_ENVELOPE_PREFIXES, ChatChannelId. 자체 테이블을 하드코딩하지 않고 봉투 접두사가 붙은 텍스트를 인식해야 하는 Plugin을 위한 표준 번들/공식 채팅 채널 ID와 포매터 레이블/별칭입니다. |
plugin-sdk/channel-config-schema-legacy |
번들 채널 구성 스키마의 사용 중단된 호환성 별칭 |
plugin-sdk/telegram-command-config |
사용 중단된 Telegram 명령 이름/설명 정규화 및 중복/충돌 검사입니다. 새 Plugin 코드에서는 Plugin 로컬 명령 구성을 사용하십시오. |
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 |
사용 중단된 호환성 퍼사드입니다. plugin-sdk/channel-outbound를 사용하십시오. |
plugin-sdk/channel-outbound |
메시지 수명 주기 계약과 응답 파이프라인 옵션, 수신 확인, 실시간 미리보기/스트리밍, 수명 주기 도우미, 아웃바운드 ID, 페이로드 계획, 내구성 있는 전송, 메시지 전송 컨텍스트 도우미입니다. 채널 아웃바운드 API를 참조하십시오. |
plugin-sdk/channel-message |
plugin-sdk/channel-outbound와 레거시 응답 디스패치 퍼사드의 사용 중단된 호환성 별칭입니다. |
plugin-sdk/channel-message-runtime |
plugin-sdk/channel-outbound와 레거시 응답 디스패치 퍼사드의 사용 중단된 호환성 별칭입니다. |
plugin-sdk/inbound-envelope |
공유 인바운드 라우트 및 봉투 빌더 도우미 |
plugin-sdk/inbound-reply-dispatch |
사용 중단된 호환성 퍼사드입니다. 인바운드 실행기와 디스패치 조건자에는 plugin-sdk/channel-inbound를, 메시지 전달 도우미에는 plugin-sdk/channel-outbound를 사용하십시오. |
plugin-sdk/messaging-targets |
사용 중단된 대상 구문 분석 별칭입니다. plugin-sdk/channel-targets를 사용하십시오. |
plugin-sdk/outbound-media |
공유 아웃바운드 미디어 로딩 및 호스팅된 미디어 상태 도우미 |
plugin-sdk/outbound-send-deps |
사용 중단된 호환성 퍼사드입니다. plugin-sdk/channel-outbound를 사용하십시오. |
plugin-sdk/outbound-runtime |
사용 중단된 호환성 퍼사드입니다. plugin-sdk/channel-outbound를 사용하십시오. |
plugin-sdk/poll-runtime |
범위가 좁은 투표 정규화 도우미 |
plugin-sdk/thread-bindings-runtime |
스레드 바인딩 수명 주기 및 어댑터 도우미 |
plugin-sdk/agent-media-payload |
에이전트 미디어 페이로드 루트 및 로더 |
plugin-sdk/conversation-runtime |
대화/스레드 바인딩, 페어링, 구성된 바인딩 도우미를 위한 사용 중단된 광범위한 배럴입니다. plugin-sdk/thread-bindings-runtime 및 plugin-sdk/session-binding-runtime과 같이 범위가 명확한 바인딩 하위 경로를 사용하는 것이 좋습니다. |
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/channel-ingress-runtime의 resolveChannelMessageIngress를 사용하십시오. |
plugin-sdk/direct-dm, plugin-sdk/direct-dm-access |
사용 중단된 호환성 퍼사드입니다. plugin-sdk/channel-inbound를 사용하십시오. |
plugin-sdk/direct-dm-guard-policy |
범위가 좁은 직접 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은 일반 채널 SDK 하위 경로를 사용해야 합니다. |
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-inbound-roots, plugin-sdk/channel-location, plugin-sdk/channel-logging |
사용 중단된 호환성 퍼사드입니다. plugin-sdk/channel-inbound 또는 plugin-sdk/channel-outbound를 사용하십시오. |
plugin-sdk/channel-pairing-paths |
사용 중단된 호환성 퍼사드입니다. plugin-sdk/channel-pairing을 사용하십시오. |
plugin-sdk/channel-reply-options-runtime |
사용 중단된 호환성 퍼사드입니다. plugin-sdk/channel-outbound를 사용하십시오. |
plugin-sdk/channel-streaming |
사용 중단된 호환성 퍼사드입니다. plugin-sdk/channel-outbound를 사용하십시오. |
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과의 호환성을 위해서만 계속 제공됩니다. 제거 계획은 다음과 같습니다. 외부 Plugin 마이그레이션 기간에는 이를 유지하고, 저장소/번들 Plugin은 channel-inbound 및 channel-outbound를 계속 사용하도록 한 다음, 다음 주요 SDK 정리 작업에서 호환성 하위 경로를 제거합니다. 이는 이전 채널 메시지/런타임, 채널 스트리밍, 직접 DM 액세스, 인바운드 헬퍼 분기, 응답 옵션 및 페어링 경로 계열에 적용됩니다.
제공자 하위 경로
| 하위 경로 | 주요 내보내기 |
|---|---|
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/provider-setup 또는 Plugin 소유 설정 도우미를 사용하십시오 |
plugin-sdk/cli-backend |
CLI 백엔드 기본값 + 감시 타이머 상수 |
plugin-sdk/provider-auth-runtime |
제공자 인증 런타임 도우미: OAuth 루프백 흐름, 토큰 교환, 인증 유지 및 API 키 확인 |
plugin-sdk/provider-oauth-runtime |
범용 제공자 OAuth 콜백 유형, 콜백 페이지 렌더링, PKCE/상태 도우미, 권한 부여 입력 구문 분석, 토큰 만료 도우미 및 중단 도우미 |
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, OpenAI Codex 인증 가져오기 도우미, 사용 중단된 resolveOpenClawAgentDir 호환성 내보내기 |
plugin-sdk/provider-model-shared |
ProviderReplayFamily, buildProviderReplayFamilyHooks, normalizeModelCompat, 공유 재생 정책 빌더, 제공자 엔드포인트 도우미 및 공유 모델 ID 정규화 도우미 |
plugin-sdk/provider-catalog-live-runtime |
보호된 /models 스타일 검색을 위한 실시간 제공자 모델 카탈로그 도우미: buildLiveModelProviderConfig, fetchLiveProviderModelRows, getCachedLiveProviderModelRows, fetchLiveProviderModelIds, LiveModelCatalogHttpError, clearLiveCatalogCacheForTests, 모델 ID 필터링, TTL 캐시 및 정적 대체 경로 |
plugin-sdk/provider-catalog-runtime |
계약 테스트를 위한 제공자 카탈로그 확장 런타임 훅 및 Plugin 제공자 레지스트리 연결부 |
plugin-sdk/provider-catalog-shared |
findCatalogTemplate, buildSingleProviderApiKeyCatalog, buildManifestModelProviderConfig, supportsNativeStreamingUsageCompat, applyProviderNativeStreamingUsageCompat |
plugin-sdk/provider-http |
범용 제공자 HTTP/엔드포인트 기능 도우미, 제공자 HTTP 오류 및 오디오 전사 멀티파트 양식 도우미 |
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 및 범위가 지정된 자격 증명 설정자/조회자 등의 제한된 웹 검색 구성/자격 증명 계약 도우미 |
plugin-sdk/provider-web-search |
웹 검색 제공자 등록/캐시/런타임 도우미 |
plugin-sdk/embedding-providers |
EmbeddingProviderAdapter, getEmbeddingProvider(...) 및 listEmbeddingProviders(...)를 포함한 범용 임베딩 제공자 유형 및 읽기 도우미입니다. 매니페스트 소유권을 적용할 수 있도록 Plugin은 api.registerEmbeddingProvider(...)를 통해 제공자를 등록합니다 |
plugin-sdk/provider-tools |
ProviderToolCompatFamily, buildProviderToolCompatFamilyHooks 및 DeepSeek/Gemini/OpenAI 스키마 정리 + 진단 |
plugin-sdk/provider-usage |
제공자 사용량 스냅샷 유형, 공유 사용량 가져오기 도우미 및 fetchClaudeUsage 등의 제공자 페처 |
plugin-sdk/provider-stream |
ProviderStreamFamily, buildProviderStreamFamilyHooks, composeProviderStreamWrappers, 스트림 래퍼 유형, 일반 텍스트 도구 호출 호환성 및 공유 Anthropic/Google/Kilocode/MiniMax/Moonshot/OpenAI/OpenRouter/Z.AI 래퍼 도우미 |
plugin-sdk/provider-stream-shared |
composeProviderStreamWrappers, createOpenAICompatibleCompletionsThinkingOffWrapper, createPlainTextToolCallCompatWrapper, createPayloadPatchStreamWrapper, createToolStreamWrapper, normalizeOpenAICompatibleReasoningPayload, setQwenChatTemplateThinking 및 Anthropic/DeepSeek/OpenAI 호환 스트림 유틸리티를 포함하는 공개 공유 제공자 스트림 래퍼 도우미 |
plugin-sdk/provider-transport-runtime |
보호된 가져오기, 도구 결과 텍스트 추출, 전송 메시지 변환 및 쓰기 가능한 전송 이벤트 스트림 등의 네이티브 제공자 전송 도우미 |
plugin-sdk/provider-onboard |
온보딩 구성 패치 도우미 |
plugin-sdk/global-singleton |
프로세스 로컬 싱글턴/맵/캐시 도우미 |
plugin-sdk/group-activation |
제한된 그룹 활성화 모드 및 명령 구문 분석 도우미 |
제공자 사용량 스냅샷은 일반적으로 하나 이상의 할당량 windows를 보고하며, 각 항목에는
레이블, 사용 비율 및 선택적 재설정 시간이 포함됩니다. 재설정 가능한 할당량 창 대신 잔액이나
계정 상태 텍스트를 노출하는 제공자는 비율을 임의로 생성하지 말고 빈 windows 배열과 함께
summary를 반환해야 합니다.
OpenClaw는 상태 출력에 해당 요약 텍스트를 표시합니다. 사용량 엔드포인트가 실패했거나
사용 가능한 사용량 데이터를 반환하지 않은 경우에만 error를 사용하십시오.
인증 및 보안 하위 경로
| 하위 경로 | 주요 내보내기 |
|---|---|
plugin-sdk/command-auth |
사용 중단된 광범위한 명령 권한 부여 표면(resolveControlCommandGate, 동적 인수 메뉴 형식을 포함한 명령 레지스트리 도우미, 발신자 권한 부여 도우미)입니다. 채널 수신/런타임 권한 부여 또는 명령 상태 도우미를 사용하십시오 |
plugin-sdk/command-status |
buildCommandsMessagePaginated 및 buildHelpMessage 등의 명령/도움말 메시지 빌더 |
plugin-sdk/approval-auth-runtime |
승인자 확인 및 동일 채팅 작업 인증 도우미 |
plugin-sdk/approval-client-runtime |
네이티브 실행 승인 프로필/필터 도우미 |
plugin-sdk/approval-delivery-runtime |
네이티브 승인 기능/전달 어댑터 |
plugin-sdk/approval-gateway-runtime |
공유 승인 Gateway 확인자 |
plugin-sdk/approval-reference-runtime |
전송 제한 승인 콜백을 위한 결정적 영구 로케이터 도우미 |
plugin-sdk/approval-handler-adapter-runtime |
핫 채널 진입점을 위한 경량 네이티브 승인 어댑터 로딩 도우미 |
plugin-sdk/approval-handler-runtime |
더 광범위한 승인 처리기 런타임 도우미입니다. 더 제한된 어댑터/Gateway 연결부로 충분한 경우 이를 우선 사용하십시오 |
plugin-sdk/approval-native-runtime |
네이티브 승인 대상, 계정 바인딩, 경로 게이트, 전달 대체 경로 및 로컬 네이티브 실행 프롬프트 억제 도우미 |
plugin-sdk/approval-reaction-runtime |
하드코딩된 승인 반응 바인딩, 반응 프롬프트 페이로드, 반응 대상 저장소, 반응 힌트 텍스트 도우미 및 로컬 네이티브 실행 프롬프트 억제를 위한 호환성 내보내기 |
plugin-sdk/approval-reply-runtime |
실행/Plugin 승인 응답 페이로드 도우미 |
plugin-sdk/approval-runtime |
실행/Plugin 승인 페이로드 도우미, 승인 기능 빌더, 승인 인증/프로필 도우미, 네이티브 승인 라우팅/런타임 도우미 및 formatApprovalDisplayPath 등의 구조화된 승인 표시 도우미 |
plugin-sdk/reply-dedupe |
사용 중단된 제한적 수신 응답 중복 제거 재설정 도우미 |
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/provider-auth-login-flow-runtime |
비공개 채널 및 Web UI 장치 코드 페어링을 위한 지연 제공자 인증 로그인 흐름 도우미 |
plugin-sdk/channel-secret-runtime |
사용 중단된 광범위한 비밀 계약 표면(collectSimpleChannelFieldAssignments, getChannelSurface, pushAssignment, 비밀 대상 유형)입니다. 아래의 세분화된 하위 경로를 우선 사용하십시오 |
plugin-sdk/channel-secret-basic-runtime |
비 TTS 채널/Plugin 비밀 표면을 위한 제한된 비밀 계약 내보내기 |
plugin-sdk/channel-secret-tts-runtime |
제한된 중첩 채널 TTS 비밀 할당 도우미 |
plugin-sdk/secret-ref-runtime |
비밀 계약/구성 구문 분석을 위한 제한된 SecretRef 유형 지정, 확인 및 계획 대상 경로 조회 |
plugin-sdk/secret-provider-integration |
외부 비밀 제공자 프리셋을 게시하는 Plugin을 위한 유형 전용 SecretRef 제공자 통합 매니페스트 및 프리셋 계약 |
plugin-sdk/security-runtime |
신뢰, DM 게이팅, 생성 전용 쓰기, 동기/비동기 원자적 파일 교체, 형제 임시 쓰기, 장치 간 이동 대체 경로, 비공개 파일 저장소 도우미, 심볼릭 링크 상위 경로 가드, 외부 콘텐츠, 민감한 텍스트 삭제, 상수 시간 비밀 비교 및 비밀 수집 도우미를 포함하는 루트 범위 제한 파일/경로 도우미용 사용 중단된 광범위한 배럴입니다. 세분화된 보안/SSRF/비밀 하위 경로를 우선 사용하십시오 |
plugin-sdk/ssrf-policy |
호스트 허용 목록 및 사설 네트워크 SSRF 정책 도우미 |
plugin-sdk/ssrf-dispatcher |
광범위한 인프라 런타임 표면이 없는 제한된 고정 디스패처 도우미 |
plugin-sdk/ssrf-runtime |
고정 디스패처, SSRF 보호 가져오기, SSRF 오류 및 SSRF 정책 도우미 |
plugin-sdk/secret-input |
비밀 입력 구문 분석 도우미 |
plugin-sdk/webhook-ingress |
Webhook 요청/대상 도우미 및 원시 웹소켓/본문 강제 변환 |
plugin-sdk/webhook-request-guards |
요청 본문 크기/시간 초과 도우미 |
Runtime and storage subpaths
| 하위 경로 | 주요 내보내기 |
|---|---|
plugin-sdk/runtime |
런타임/로깅/백업 도우미, 플러그인 설치 경로 경고 및 프로세스 도우미 |
plugin-sdk/runtime-env |
범위가 좁은 런타임 환경, 로거, 시간 제한, 재시도 및 백오프 도우미 |
plugin-sdk/browser-config |
정규화된 프로필/기본값, CDP URL 구문 분석 및 브라우저 제어 인증 도우미를 위한 지원되는 브라우저 구성 퍼사드 |
plugin-sdk/agent-harness-task-runtime |
호스트가 발급한 작업 범위를 사용하는 하네스 기반 에이전트를 위한 범용 작업 수명 주기 및 완료 전달 도우미 |
plugin-sdk/codex-mcp-projection |
사용자 MCP 서버 구성을 Codex 스레드 구성에 투영하기 위한 예약된 번들 Codex 도우미. 타사 플러그인용이 아님 |
plugin-sdk/codex-native-task-runtime |
네이티브 작업 미러/런타임 연결을 위한 저장소 로컬 번들 Codex 도우미. 패키지 내보내기가 아님 |
plugin-sdk/channel-runtime-context |
범용 채널 런타임 컨텍스트 등록 및 조회 도우미 |
plugin-sdk/matrix |
이전 타사 채널 패키지를 위한 더 이상 사용되지 않는 Matrix 호환성 퍼사드. 새 플러그인은 plugin-sdk/run-command을 직접 가져와야 함 |
plugin-sdk/mattermost |
이전 타사 채널 패키지를 위한 더 이상 사용되지 않는 Mattermost 호환성 퍼사드. 새 플러그인은 범용 SDK 하위 경로를 직접 가져와야 함 |
plugin-sdk/runtime-store |
createPluginRuntimeStore |
plugin-sdk/plugin-runtime |
플러그인 명령/훅/http/대화형 도우미를 위한 더 이상 사용되지 않는 광범위한 배럴. 목적별 플러그인 런타임 하위 경로를 사용하는 것이 좋음 |
plugin-sdk/hook-runtime |
Webhook/내부 훅 파이프라인 도우미를 위한 더 이상 사용되지 않는 광범위한 배럴. 목적별 훅/플러그인 런타임 하위 경로를 사용하는 것이 좋음 |
plugin-sdk/lazy-runtime |
createLazyRuntimeModule, createLazyRuntimeMethod, createLazyRuntimeSurface 등의 지연 런타임 가져오기/바인딩 도우미 |
plugin-sdk/process-runtime |
프로세스 실행 도우미 |
plugin-sdk/cli-runtime |
CLI 서식 지정, 대기, 버전, 인수 호출 및 지연 명령 그룹 도우미를 위한 더 이상 사용되지 않는 광범위한 배럴. 목적별 CLI/런타임 하위 경로를 사용하는 것이 좋음 |
plugin-sdk/qa-live-transport-scenarios |
공유 라이브 전송 QA 시나리오 ID, 기준 범위 도우미 및 시나리오 선택 도우미 |
plugin-sdk/qa-runner-runtime |
CLI 명령 표면을 통해 플러그인 QA 시나리오를 노출하는 지원되는 퍼사드 |
plugin-sdk/tts-runtime |
텍스트 음성 변환 구성 스키마 및 런타임 도우미를 위한 지원되는 퍼사드 |
plugin-sdk/gateway-method-runtime |
contracts.gatewayMethodDispatch: ["authenticated-request"]을 선언하는 플러그인 HTTP 경로를 위한 예약된 Gateway 메서드 디스패치 도우미 |
plugin-sdk/gateway-runtime |
Gateway 클라이언트, 이벤트 루프 준비형 클라이언트 시작 도우미, Gateway CLI RPC, Gateway 프로토콜 오류, 공지된 LAN 호스트 확인 및 채널 상태 패치 도우미 |
plugin-sdk/config-contracts |
OpenClawConfig 및 채널/제공자 구성 형식과 같은 플러그인 구성 형식을 위한 목적별 형식 전용 구성 표면 |
plugin-sdk/plugin-config-runtime |
requireRuntimeConfig, resolvePluginConfigObject, resolveLivePluginConfigObject 등의 런타임 플러그인 구성 조회 도우미 |
plugin-sdk/config-mutation |
mutateConfigFile, replaceConfigFile, logConfigUpdated 등의 트랜잭션 구성 변경 도우미 |
plugin-sdk/message-tool-delivery-hints |
공유 메시지 도구 전달 메타데이터 힌트 문자열 |
plugin-sdk/runtime-config-snapshot |
getRuntimeConfig, getRuntimeConfigSnapshot 및 테스트 스냅샷 설정자 등의 현재 프로세스 구성 스냅샷 도우미 |
plugin-sdk/text-autolink-runtime |
광범위한 텍스트 배럴을 사용하지 않는 파일 참조 자동 링크 감지 |
plugin-sdk/reply-runtime |
공유 인바운드/응답 런타임 도우미, 청크 분할, 디스패치, Heartbeat, 응답 플래너 |
plugin-sdk/reply-dispatch-runtime |
범위가 좁은 응답 디스패치/마무리 및 대화 레이블 도우미 |
plugin-sdk/reply-history |
공유 단기 응답 기록 도우미. 새 메시지 턴 코드는 createChannelHistoryWindow을 사용해야 하며, 하위 수준 맵 도우미는 더 이상 사용되지 않는 호환성 내보내기로만 유지됨 |
plugin-sdk/reply-reference |
createReplyReferencePlanner |
plugin-sdk/reply-chunking |
범위가 좁은 텍스트/마크다운 청크 분할 도우미 |
plugin-sdk/session-store-runtime |
세션 워크플로 도우미(getSessionEntry, listSessionEntries, patchSessionEntry, upsertSessionEntry), 복구/수명 주기 도우미(deleteSessionEntry, cleanupSessionLifecycleArtifacts, resolveSessionStoreBackupPaths), 전환기의 sessionFile 값을 위한 마커 도우미, 세션 ID별로 제한된 최근 사용자/어시스턴트 트랜스크립트 텍스트 읽기, 세션 저장소 경로/세션 키 도우미 및 업데이트 시각 읽기. 광범위한 구성 쓰기/유지 관리 가져오기는 포함하지 않음 |
plugin-sdk/session-transcript-runtime |
트랜스크립트 ID, 범위 지정 대상/읽기/쓰기 도우미, 표시되는 메시지 항목 투영, 업데이트 게시, 쓰기 잠금 및 트랜스크립트 메모리 적중 키 |
plugin-sdk/sqlite-runtime |
데이터베이스 수명 주기 제어를 제외한 자사 런타임용 목적별 SQLite 에이전트 스키마, 경로 및 트랜잭션 도우미 |
plugin-sdk/cron-store-runtime |
Cron 저장소 경로/로드/저장 도우미 |
plugin-sdk/state-paths |
상태/OAuth 디렉터리 경로 도우미 |
plugin-sdk/plugin-state-runtime |
플러그인 사이드카 SQLite 키 기반 상태 형식과 플러그인 소유 데이터베이스를 위한 중앙 집중식 연결 pragma 및 WAL 유지 관리 설정 |
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-plugin |
단순한 형식 지정 에이전트 도구 플러그인을 정의하고 매니페스트 생성을 위한 정적 메타데이터 노출 |
plugin-sdk/tool-payload |
도구 결과 객체에서 정규화된 페이로드 추출 |
plugin-sdk/tool-send |
도구 인수에서 표준 전송 대상 필드 추출 |
plugin-sdk/sandbox |
빠른 실패 실행 명령 사전 점검을 포함한 샌드박스 백엔드 형식 및 SSH/OpenShell 명령 도우미 |
plugin-sdk/temp-path |
공유 임시 다운로드 경로 도우미 및 비공개 보안 임시 작업 공간 |
plugin-sdk/logging-core |
하위 시스템 로거 및 민감 정보 제거 도우미 |
plugin-sdk/markdown-table-runtime |
마크다운 표 모드 및 변환 도우미 |
plugin-sdk/model-session-runtime |
applyModelOverrideToSessionEntry, resolveAgentMaxConcurrent 등의 모델/세션 재정의 도우미 |
plugin-sdk/talk-config-runtime |
대화 제공자 구성 확인 도우미 |
plugin-sdk/json-store |
소규모 JSON 상태 읽기/쓰기 도우미 |
plugin-sdk/json-unsafe-integers |
안전하지 않은 정수 리터럴을 문자열로 보존하는 JSON 구문 분석 도우미 |
plugin-sdk/file-lock |
재진입 가능 파일 잠금 도우미 |
plugin-sdk/persistent-dedupe |
디스크 기반 중복 제거 캐시 도우미 |
plugin-sdk/acp-runtime |
ACP 런타임/세션 및 응답 디스패치 도우미 |
plugin-sdk/acp-runtime-backend |
시작 시 로드되는 플러그인을 위한 경량 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 |
BOOTSTRAP_HANDOFF_OPERATOR_SCOPES을 포함한 기기 부트스트랩 및 페어링 토큰 도우미 |
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 |
하위 수준 에이전트 하네스를 위한 실험적 신뢰 플러그인 표면: 하네스 형식, 활성 실행 조정/중단 도우미, OpenClaw 도구 브리지 도우미, 런타임 계획 도구 정책 도우미, 터미널 결과 분류, 도구 진행률 서식 지정/세부 정보 도우미 및 시도 결과 유틸리티 |
plugin-sdk/provider-zai-endpoint |
더 이상 사용되지 않는 Z.AI 제공자 소유 엔드포인트 감지 퍼사드. Z.AI 플러그인 공개 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/expect-runtime |
증명 가능한 런타임 불변 조건을 위한 필수 값 어설션 도우미 |
plugin-sdk/number-runtime |
숫자 강제 변환 도우미 |
plugin-sdk/secure-random-runtime |
보안 토큰/UUID 도우미 |
plugin-sdk/system-event-runtime |
시스템 이벤트 큐 도우미 |
plugin-sdk/transport-ready-runtime |
전송 준비 상태 대기 도우미 |
plugin-sdk/exec-approvals-runtime |
광범위한 인프라 런타임 배럴을 사용하지 않는 실행 승인 정책 파일 도우미 |
plugin-sdk/infra-runtime |
더 이상 사용되지 않는 호환성 심. 위의 목적별 런타임 하위 경로를 사용해야 함 |
plugin-sdk/collection-runtime |
소규모 제한형 캐시 도우미 |
plugin-sdk/diagnostic-runtime |
진단 플래그, 이벤트 및 추적 컨텍스트 도우미 |
plugin-sdk/error-runtime |
오류 그래프, 서식 지정, 공유 오류 분류 도우미, PlatformMessageNotDispatchedError, isApprovalNotFoundError |
plugin-sdk/fetch-runtime |
래핑된 fetch, 프록시, EnvHttpProxyAgent 옵션 및 고정 조회 도우미 |
plugin-sdk/runtime-fetch |
프록시/보호된 fetch 가져오기를 사용하지 않는 디스패처 인식 런타임 fetch |
plugin-sdk/inline-image-data-url-runtime |
광범위한 미디어 런타임 표면을 사용하지 않는 인라인 이미지 데이터 URL 정리 및 시그니처 탐지 도우미 |
plugin-sdk/response-limit-runtime |
광범위한 미디어 런타임 표면을 사용하지 않는 제한형 응답 본문 판독기 |
plugin-sdk/session-binding-runtime |
구성된 바인딩 라우팅 또는 페어링 저장소를 사용하지 않는 현재 대화 바인딩 상태 |
plugin-sdk/context-visibility-runtime |
광범위한 구성/보안 가져오기를 사용하지 않는 컨텍스트 가시성 확인 및 보충 컨텍스트 필터링 |
plugin-sdk/string-coerce-runtime |
마크다운/로깅 가져오기를 사용하지 않는 범위가 좁은 기본 레코드/문자열 강제 변환 및 정규화 도우미 |
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 |
saveRemoteMedia, saveResponseMedia, readRemoteMediaBuffer 및 더 이상 사용되지 않는 fetchRemoteMedia를 포함하는 더 이상 사용되지 않는 광범위한 미디어 배럴입니다. plugin-sdk/media-store, plugin-sdk/media-mime, plugin-sdk/outbound-media 및 기능 런타임 하위 경로를 사용하고, URL을 OpenClaw 미디어로 변환해야 할 때는 버퍼 읽기보다 저장소 헬퍼를 우선 사용하십시오. |
plugin-sdk/media-mime |
제한된 범위의 MIME 정규화, 파일 확장자 매핑, MIME 감지 및 미디어 종류 헬퍼 |
plugin-sdk/media-store |
saveMediaBuffer 및 saveMediaStream과 같은 제한된 범위의 미디어 저장소 헬퍼 |
plugin-sdk/media-generation-runtime |
공유 미디어 생성 장애 조치 헬퍼, 후보 선택 및 모델 누락 메시지 |
plugin-sdk/media-understanding |
미디어 이해 제공자 유형과 제공자용 이미지/오디오/구조화된 추출 헬퍼 내보내기 |
plugin-sdk/text-chunking |
아웃바운드 텍스트 및 Markdown 청킹/렌더링 헬퍼, Markdown 표 변환, 지시문 태그 제거 및 안전한 텍스트 유틸리티 |
plugin-sdk/speech |
음성 제공자 유형과 제공자용 지시문, 레지스트리, 검증, OpenAI 호환 TTS 빌더 및 음성 헬퍼 내보내기 |
plugin-sdk/speech-core |
공유 음성 제공자 유형, 레지스트리, 지시문, 정규화 및 음성 헬퍼 내보내기 |
plugin-sdk/realtime-transcription |
실시간 전사 제공자 유형, 레지스트리 헬퍼 및 공유 WebSocket 세션 헬퍼 |
plugin-sdk/realtime-bootstrap-context |
범위가 제한된 IDENTITY.md, USER.md 및 SOUL.md 컨텍스트 삽입을 위한 실시간 프로필 부트스트랩 헬퍼 |
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 소유 음악 제공자 표면을 사용하십시오. |
plugin-sdk/video-generation |
동영상 생성 제공자/요청/결과 유형 |
plugin-sdk/video-generation-core |
공유 동영상 생성 유형, 장애 조치 헬퍼, 제공자 조회 및 모델 참조 구문 분석 |
plugin-sdk/transcripts |
공유 전사 소스 제공자 유형, 레지스트리 헬퍼, 세션 설명자 및 발화 메타데이터 |
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 테스트를 위한 저장소 로컬의 더 이상 사용되지 않는 호환성 배럴입니다. 새 저장소 테스트에서는 대신 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 |
저장소 테스트 헬퍼 브리지를 가져오지 않고 직접 Plugin 등록 단위 테스트를 수행하기 위한 저장소 로컬 최소 createTestPluginApi 헬퍼 |
plugin-sdk/agent-runtime-test-contracts |
인증, 전달, 폴백, 도구 훅, 프롬프트 오버레이, 스키마 및 전사 프로젝션 테스트를 위한 저장소 로컬 네이티브 에이전트 런타임 어댑터 계약 픽스처 |
plugin-sdk/channel-test-helpers |
일반 작업/설정/상태 계약, 디렉터리 어설션, 계정 시작 수명 주기, 전송 구성 스레딩, 런타임 모의 객체, 상태 문제, 아웃바운드 전달 및 훅 등록을 위한 저장소 로컬 채널 지향 테스트 헬퍼 |
plugin-sdk/channel-target-testing |
채널 테스트를 위한 저장소 로컬 공유 대상 해석 오류 사례 모음 |
plugin-sdk/channel-contract-testing |
광범위한 테스트 배럴이 없는 저장소 로컬의 제한된 범위의 채널 계약 테스트 헬퍼 |
plugin-sdk/plugin-test-contracts |
저장소 로컬 Plugin 패키지, 등록, 공개 아티팩트, 직접 가져오기, 런타임 API 및 가져오기 부작용 계약 헬퍼 |
plugin-sdk/plugin-state-test-runtime |
저장소 로컬 Plugin 상태 저장소, 인그레스 큐 및 상태 DB 테스트 헬퍼 |
plugin-sdk/provider-test-contracts |
저장소 로컬 제공자 런타임, 인증, 검색, 온보딩, 카탈로그, 마법사, 미디어 기능, 재생 정책, 실시간 STT 라이브 오디오, 웹 검색/가져오기 및 스트림 계약 헬퍼 |
plugin-sdk/provider-http-test-mocks |
plugin-sdk/provider-http를 실행하는 제공자 테스트를 위한 저장소 로컬 옵트인 Vitest HTTP/인증 모의 객체 |
plugin-sdk/reply-payload-testing |
응답 페이로드 픽스처에 메타데이터를 첨부하기 위한 저장소 로컬 헬퍼 |
plugin-sdk/sqlite-runtime-testing |
자사 테스트를 위한 저장소 로컬 SQLite 수명 주기 헬퍼 |
plugin-sdk/test-fixtures |
저장소 로컬 범용 CLI 런타임 캡처, 샌드박스 컨텍스트, 스킬 작성기, 에이전트 메시지, 시스템 이벤트, 모듈 다시 로드, 번들 Plugin 경로, 터미널 텍스트, 청킹, 인증 토큰 및 유형화된 사례 픽스처 |
plugin-sdk/test-node-mocks |
Vitest vi.mock("node:*") 팩토리 내부에서 사용하기 위한 저장소 로컬의 용도가 명확한 Node 내장 모의 헬퍼 |
메모리 하위 경로
| 하위 경로 | 주요 내보내기 |
|---|---|
plugin-sdk/memory-core |
더 이상 사용되지 않는 호환성 별칭입니다. plugin-sdk/memory-host-core를 사용하십시오. |
plugin-sdk/memory-core-engine-runtime |
더 이상 사용되지 않는 메모리 인덱스/검색 런타임 퍼사드입니다. 공급업체 중립적인 메모리 호스트 하위 경로를 사용하십시오. |
plugin-sdk/memory-core-host-embedding-registry |
경량 메모리 임베딩 제공자 레지스트리 헬퍼 |
plugin-sdk/memory-core-host-engine-foundation |
메모리 호스트 기반 엔진 내보내기 |
plugin-sdk/memory-core-host-engine-embeddings |
메모리 호스트 임베딩 계약, 레지스트리 접근, 로컬 제공자 및 범용 배치/원격 헬퍼입니다. 이 표면의 registerMemoryEmbeddingProvider는 더 이상 사용되지 않습니다. 새 제공자에는 범용 임베딩 제공자 API를 사용하십시오. |
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 코드를 위한 범위가 제한된 소유자별 표면입니다.
패키지 빌드와 별칭 처리를 결정적으로 유지할 수 있도록 SDK 인벤토리에서 추적하지만,
일반적인 Plugin 작성 API는 아닙니다. 재사용 가능한 새 호스트 계약에는
plugin-sdk/gateway-runtime, plugin-sdk/ssrf-runtime 및
plugin-sdk/plugin-config-runtime과 같은 범용 SDK 하위 경로를 사용해야 합니다.
| 하위 경로 | 소유자 및 용도 |
|---|---|
plugin-sdk/codex-mcp-projection |
사용자 MCP 서버 구성을 Codex 앱 서버 스레드 구성에 프로젝션하기 위한 번들 Codex Plugin 헬퍼(예약된 패키지 내보내기) |
plugin-sdk/codex-native-task-runtime |
Codex 앱 서버 네이티브 하위 에이전트를 OpenClaw 작업 상태에 미러링하기 위한 번들 Codex Plugin 헬퍼(저장소 로컬 전용, 패키지 내보내기 아님) |
관련 항목
Was this useful?
