Plugins
Plugin SDK 하위 경로
Plugin SDK는 openclaw/plugin-sdk/ 아래의 좁은 하위 경로 집합으로 노출됩니다.
이 페이지는 일반적으로 사용되는 하위 경로를 목적별로 묶어 정리합니다. 생성된
200개 이상의 전체 하위 경로 목록은 scripts/lib/plugin-sdk-entrypoints.json에 있습니다.
예약된 번들 Plugin 헬퍼 하위 경로도 여기에 나타나지만, 문서 페이지에서 명시적으로
공개하지 않는 한 구현 세부 사항입니다. Maintainer는
pnpm plugins:boundary-report:summary로 활성 예약 헬퍼 하위 경로를 감사할 수 있습니다.
사용되지 않는 예약 헬퍼 export는 휴면 호환성 부채로 public SDK에 남는 대신 CI 보고서에서 실패합니다.
Plugin 작성 가이드는 Plugin SDK 개요를 참고하세요.
Plugin 엔트리
| 하위 경로 | 주요 export |
|---|---|
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/testing |
레거시 Plugin 테스트용 광범위 호환성 barrel입니다. 새 확장 테스트에는 초점이 맞춰진 테스트 하위 경로를 선호하세요 |
plugin-sdk/plugin-test-api |
직접 Plugin 등록 단위 테스트를 위한 최소 OpenClawPluginApi mock 빌더 |
plugin-sdk/agent-runtime-test-contracts |
인증 프로필, 전달 억제, fallback 분류, 도구 훅, 프롬프트 오버레이, 스키마, transcript 복구를 위한 네이티브 agent-runtime 어댑터 계약 fixture |
plugin-sdk/channel-test-helpers |
채널 계정 수명 주기, 디렉터리, send-config, 런타임 mock, 훅, 번들 채널 엔트리, envelope 타임스탬프, pairing reply, 일반 채널 계약 테스트 헬퍼 |
plugin-sdk/channel-target-testing |
공유 채널 대상 해석 오류 사례 테스트 스위트 |
plugin-sdk/plugin-test-contracts |
Plugin 등록, 패키지 매니페스트, 공개 아티팩트, 런타임 API, import 부작용, 직접 import 계약 헬퍼 |
plugin-sdk/plugin-test-runtime |
테스트용 Plugin 런타임, 레지스트리, provider-registration, setup-wizard, 런타임 TaskFlow fixture |
plugin-sdk/provider-test-contracts |
Provider 런타임, 인증, 검색, onboard, catalog, 미디어 capability, replay policy, realtime STT live-audio, web-search/fetch, wizard 계약 헬퍼 |
plugin-sdk/provider-http-test-mocks |
plugin-sdk/provider-http를 실행하는 provider 테스트용 opt-in Vitest HTTP/auth mock |
plugin-sdk/test-env |
테스트 환경, fetch/network, 일회용 HTTP 서버, 수신 요청, live-test, 임시 파일 시스템, 시간 제어 fixture |
plugin-sdk/test-fixtures |
일반 CLI, sandbox, skill, agent-message, system-event, module reload, 번들 Plugin 경로, 터미널, chunking, auth-token, typed-case 테스트 fixture |
plugin-sdk/test-node-mocks |
Vitest vi.mock("node:*") factory 안에서 사용할 초점이 맞춰진 Node builtin mock 헬퍼 |
plugin-sdk/migration |
createMigrationItem, reason 상수, item status marker, redaction 헬퍼, summarizeMigrationItems 같은 migration provider item 헬퍼 |
plugin-sdk/migration-runtime |
copyMigrationFileItem, withCachedMigrationConfigRuntime, writeMigrationReport 같은 런타임 migration 헬퍼 |
Channel subpaths
| 하위 경로 | 주요 내보내기 |
|---|---|
plugin-sdk/channel-core |
defineChannelPluginEntry, defineSetupPluginEntry, createChatChannelPlugin, createChannelPluginBase |
plugin-sdk/config-schema |
루트 openclaw.json Zod 스키마 내보내기(OpenClawSchema) |
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 |
createEnvPatchedAccountSetupAdapter |
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/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-lifecycle |
createAccountStatusSink, createChannelRunQueue, 그리고 레거시 초안 스트림 수명 주기 헬퍼. 새 미리보기 최종화 코드는 plugin-sdk/channel-message를 사용해야 합니다. |
plugin-sdk/channel-message |
defineChannelMessageAdapter, createChannelMessageAdapterFromOutbound, createReplyPrefixContext, resolveChannelMessageSourceReplyDeliveryMode 같은 저비용 메시지 수명 주기 계약 헬퍼, 호환성 파사드, durable-final 기능 도출, 전송/수신/부수 효과 기능을 위한 기능 증명 헬퍼, MessageReceiveContext, 수신 ack 정책 증명, defineFinalizableLivePreviewAdapter, deliverWithFinalizableLivePreviewAdapter, 라이브 미리보기 및 라이브 최종화 기능 증명, 내구성 복구 상태, RenderedMessageBatch, 메시지 수신 타입, 수신 ID 헬퍼. 채널 메시지 API를 참고하세요. 레거시 createChannelTurnReplyPipeline은 호환성 디스패처용으로만 남아 있습니다. |
plugin-sdk/channel-message-runtime |
deliverInboundReplyWithMessageSendContext, sendDurableMessageBatch, withDurableMessageSendContext, dispatchChannelMessageReplyWithBase, recordChannelMessageReplyDispatch를 포함하여 아웃바운드 전달을 로드할 수 있는 런타임 전달 헬퍼. 핫 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, 전송 대리자, 세션, 포매팅, 페이로드 계획 헬퍼 |
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 |
인바운드 드롭 및 입력 중/ack 실패를 위한 채널 로깅 헬퍼 |
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 및 비밀 대상 타입 같은 범위가 좁은 비밀 계약 헬퍼 |
프로바이더 하위 경로
| 하위 경로 | 주요 exports |
|---|---|
plugin-sdk/provider-entry |
defineSingleProviderPluginEntry |
plugin-sdk/lmstudio |
설정, 카탈로그 검색, 런타임 모델 준비를 위한 지원되는 LM Studio 프로바이더 facade |
plugin-sdk/lmstudio-runtime |
로컬 서버 기본값, 모델 검색, 요청 헤더, 로드된 모델 헬퍼를 위한 지원되는 LM Studio 런타임 facade |
plugin-sdk/provider-setup |
선별된 로컬/셀프 호스팅 프로바이더 설정 헬퍼 |
plugin-sdk/self-hosted-provider-setup |
OpenAI 호환 셀프 호스팅 프로바이더 설정에 집중한 헬퍼 |
plugin-sdk/cli-backend |
CLI 백엔드 기본값 + watchdog 상수 |
plugin-sdk/provider-auth-runtime |
프로바이더 plugins를 위한 런타임 API 키 확인 헬퍼 |
plugin-sdk/provider-auth-api-key |
upsertApiKeyProfile 같은 API 키 온보딩/프로필 쓰기 헬퍼 |
plugin-sdk/provider-auth-result |
표준 OAuth 인증 결과 빌더 |
plugin-sdk/provider-auth-login |
프로바이더 plugins를 위한 공유 대화형 로그인 헬퍼 |
plugin-sdk/provider-env-vars |
프로바이더 인증 환경 변수 조회 헬퍼 |
plugin-sdk/provider-auth |
createProviderApiKeyAuthMethod, ensureApiKeyFromOptionEnvOrPrompt, upsertAuthProfile, upsertApiKeyProfile, writeOAuthCredentials, 사용 중단된 resolveOpenClawAgentDir 호환성 export |
plugin-sdk/provider-model-shared |
ProviderReplayFamily, buildProviderReplayFamilyHooks, normalizeModelCompat, 공유 재생 정책 빌더, 프로바이더 엔드포인트 헬퍼, normalizeNativeXaiModelId 같은 모델 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 같은 좁은 web-fetch 구성/선택 계약 헬퍼 |
plugin-sdk/provider-web-fetch |
Web-fetch 프로바이더 등록/캐시 헬퍼 |
plugin-sdk/provider-web-search-config-contract |
plugin 활성화 배선이 필요 없는 프로바이더를 위한 좁은 web-search 구성/자격 증명 헬퍼 |
plugin-sdk/provider-web-search-contract |
createWebSearchProviderContractFields, enablePluginInConfig, resolveProviderWebSearchPluginConfig, 범위가 지정된 자격 증명 setter/getter 같은 좁은 web-search 구성/자격 증명 계약 헬퍼 |
plugin-sdk/provider-web-search |
Web-search 프로바이더 등록/캐시/런타임 헬퍼 |
plugin-sdk/provider-tools |
ProviderToolCompatFamily, buildProviderToolCompatFamilyHooks, Gemini 스키마 정리 + 진단, resolveXaiModelCompatPatch / applyXaiModelCompat 같은 xAI 호환성 헬퍼 |
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 |
좁은 그룹 활성화 모드와 명령 파싱 헬퍼 |
인증 및 보안 하위 경로
| 하위 경로 | 주요 exports |
|---|---|
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 |
넓은 테스트 barrel 없이 제공되는 좁은 채널 계약 테스트 헬퍼 |
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 |
신뢰, DM 게이팅, 생성 전용 쓰기, 동기/비동기 원자적 파일 교체, sibling 임시 쓰기, cross-device move fallback, 비공개 파일 저장소 헬퍼, 심볼릭 링크 부모 보호, 외부 콘텐츠, 민감한 텍스트 수정, 상수 시간 비밀 정보 비교, 비밀 정보 수집 헬퍼를 포함한 루트 경계 파일/경로 헬퍼 |
plugin-sdk/ssrf-policy |
호스트 허용 목록 및 비공개 네트워크 SSRF 정책 헬퍼 |
plugin-sdk/ssrf-dispatcher |
넓은 인프라 런타임 표면 없이 제공되는 좁은 pinned-dispatcher 헬퍼 |
plugin-sdk/ssrf-runtime |
Pinned-dispatcher, SSRF 보호 fetch, SSRF 오류, SSRF 정책 헬퍼 |
plugin-sdk/secret-input |
비밀 정보 입력 파싱 헬퍼 |
plugin-sdk/webhook-ingress |
Webhook 요청/대상 헬퍼 및 원시 websocket/body 강제 변환 |
plugin-sdk/webhook-request-guards |
요청 본문 크기/timeout 헬퍼 |
Runtime and storage subpaths
| 하위 경로 | 주요 내보내기 |
|---|---|
plugin-sdk/runtime |
광범위한 런타임/로깅/백업/Plugin 설치 헬퍼 |
plugin-sdk/runtime-env |
좁은 범위의 런타임 env, logger, timeout, retry, backoff 헬퍼 |
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-types |
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 |
Slug/문자열 정규화 헬퍼 |
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 엔드포인트 감지 헬퍼 |
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-store |
saveMediaBuffer 같은 좁은 범위의 미디어 저장소 헬퍼 |
plugin-sdk/media-generation-runtime |
공유 미디어 생성 장애 조치 헬퍼, 후보 선택, 누락된 모델 메시지 |
plugin-sdk/media-understanding |
미디어 이해 Provider 타입 및 Provider 대상 이미지/오디오 헬퍼 내보내기 |
plugin-sdk/text-runtime |
어시스턴트 표시 텍스트 제거, 마크다운 렌더링/청킹/테이블 헬퍼, 수정 헬퍼, 지시문 태그 헬퍼, 안전 텍스트 유틸리티 같은 공유 텍스트/마크다운/로깅 헬퍼 |
plugin-sdk/text-chunking |
아웃바운드 텍스트 청킹 헬퍼 |
plugin-sdk/speech |
음성 Provider 타입 및 Provider 대상 지시문, 레지스트리, 검증, OpenAI 호환 TTS 빌더, 음성 헬퍼 내보내기 |
plugin-sdk/speech-core |
공유 음성 Provider 타입, 레지스트리, 지시문, 정규화, 음성 헬퍼 내보내기 |
plugin-sdk/realtime-transcription |
실시간 전사 Provider 타입, 레지스트리 헬퍼, 공유 WebSocket 세션 헬퍼 |
plugin-sdk/realtime-voice |
실시간 음성 Provider 타입 및 레지스트리 헬퍼 |
plugin-sdk/image-generation |
이미지 생성 Provider 타입 및 이미지 자산/데이터 URL 헬퍼, OpenAI 호환 이미지 Provider 빌더 |
plugin-sdk/image-generation-core |
공유 이미지 생성 타입, 장애 조치, 인증, 레지스트리 헬퍼 |
plugin-sdk/music-generation |
음악 생성 Provider/요청/결과 타입 |
plugin-sdk/music-generation-core |
공유 음악 생성 타입, 장애 조치 헬퍼, Provider 조회, 모델 참조 파싱 |
plugin-sdk/video-generation |
비디오 생성 Provider/요청/결과 타입 |
plugin-sdk/video-generation-core |
공유 비디오 생성 타입, 장애 조치 헬퍼, Provider 조회, 모델 참조 파싱 |
plugin-sdk/webhook-targets |
Webhook 대상 레지스트리 및 라우트 설치 헬퍼 |
plugin-sdk/webhook-path |
Webhook 경로 정규화 헬퍼 |
plugin-sdk/web-media |
공유 원격/로컬 미디어 로딩 헬퍼 |
plugin-sdk/zod |
Plugin SDK 소비자를 위해 다시 내보낸 zod |
plugin-sdk/testing |
레거시 Plugin 테스트를 위한 광범위한 호환성 배럴입니다. 새 Extension 테스트는 대신 plugin-sdk/agent-runtime-test-contracts, plugin-sdk/plugin-test-runtime, plugin-sdk/channel-test-helpers, plugin-sdk/test-env, plugin-sdk/test-fixtures 같은 집중된 SDK 하위 경로를 가져와야 합니다 |
plugin-sdk/plugin-test-api |
저장소 테스트 헬퍼 브리지를 가져오지 않고 직접 Plugin 등록 단위 테스트를 위한 최소 createTestPluginApi 헬퍼 |
plugin-sdk/agent-runtime-test-contracts |
인증, 전달, 폴백, 도구 훅, 프롬프트 오버레이, 스키마, Transcript 투영 테스트를 위한 네이티브 에이전트 런타임 어댑터 계약 픽스처 |
plugin-sdk/channel-test-helpers |
일반 작업/설정/상태 계약, 디렉터리 어설션, 계정 시작 수명 주기, 전송 구성 스레딩, 런타임 Mock, 상태 문제, 아웃바운드 전달, 훅 등록을 위한 채널 지향 테스트 헬퍼 |
plugin-sdk/channel-target-testing |
채널 테스트를 위한 공유 대상 확인 오류 사례 모음 |
plugin-sdk/plugin-test-contracts |
Plugin 패키지, 등록, 공개 아티팩트, 직접 가져오기, 런타임 API, 가져오기 부작용 계약 헬퍼 |
plugin-sdk/provider-test-contracts |
Provider 런타임, 인증, 발견, 온보딩, 카탈로그, 마법사, 미디어 기능, 재생 정책, 실시간 STT 라이브 오디오, 웹 검색/가져오기, 스트림 계약 헬퍼 |
plugin-sdk/provider-http-test-mocks |
plugin-sdk/provider-http를 실행하는 Provider 테스트를 위한 선택적 Vitest HTTP/인증 Mock |
plugin-sdk/test-fixtures |
일반 CLI 런타임 캡처, 샌드박스 컨텍스트, Skills 작성기, 에이전트 메시지, 시스템 이벤트, 모듈 다시 로드, 번들 Plugin 경로, 터미널 텍스트, 청킹, 인증 토큰, 타입 지정 사례 픽스처 |
plugin-sdk/test-node-mocks |
Vitest vi.mock("node:*") 팩터리 내부에서 사용할 집중된 Node 내장 Mock 헬퍼 |
메모리 하위 경로
| 하위 경로 | 주요 내보내기 |
|---|---|
plugin-sdk/memory-core |
관리자/구성/파일/CLI 헬퍼를 위한 번들 메모리 코어 헬퍼 표면 |
plugin-sdk/memory-core-engine-runtime |
메모리 인덱스/검색 런타임 파사드 |
plugin-sdk/memory-core-host-engine-foundation |
메모리 호스트 기반 엔진 내보내기 |
plugin-sdk/memory-core-host-engine-embeddings |
메모리 호스트 임베딩 계약, 레지스트리 접근, 로컬 Provider, 일반 배치/원격 헬퍼 |
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-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-host-markdown |
메모리 인접 Plugin을 위한 공유 관리형 마크다운 헬퍼 |
plugin-sdk/memory-host-search |
검색 관리자 접근을 위한 활성 메모리 런타임 파사드 |
plugin-sdk/memory-host-status |
메모리 호스트 상태 헬퍼를 위한 벤더 중립 별칭 |
예약된 번들 헬퍼 하위 경로
현재 예약된 번들 헬퍼 SDK 하위 경로는 없습니다. 소유자별
헬퍼는 소유 Plugin 패키지 안에 있으며, 재사용 가능한 호스트 계약은
plugin-sdk/gateway-runtime,
plugin-sdk/security-runtime, plugin-sdk/plugin-config-runtime 같은 일반 SDK 하위 경로를 사용합니다.