openclaw/plugin-sdk/ 아래의 좁은 공개 하위 경로 집합으로 노출됩니다. 이 페이지는 목적별로 그룹화된 일반적으로 사용되는 하위 경로를 정리합니다. 생성된 컴파일러 엔트리포인트 인벤토리는 scripts/lib/plugin-sdk-entrypoints.json에 있으며, 패키지 exports는 scripts/lib/plugin-sdk-private-local-only-subpaths.json에 나열된 repo-local 테스트/내부 하위 경로를 제외한 공개 부분집합입니다. Maintainer는 pnpm plugin-sdk:surface로 공개 export 수를, pnpm plugins:boundary-report:summary로 활성 예약 헬퍼 하위 경로를 감사할 수 있습니다. 사용되지 않는 예약 헬퍼 exports는 휴면 호환성 부채로 공개 SDK에 남아 있지 않고 CI 보고서를 실패시킵니다.
Plugin 작성 가이드는 Plugin SDK 개요를 참조하세요.
Plugin 항목
| 하위 경로 | 주요 exports |
|---|---|
plugin-sdk/plugin-entry | definePluginEntry |
plugin-sdk/core | defineChannelPluginEntry, createChatChannelPlugin, createChannelPluginBase, defineSetupPluginEntry, buildChannelConfigSchema, buildJsonChannelConfigSchema |
plugin-sdk/config-schema | OpenClawSchema |
plugin-sdk/provider-entry | defineSingleProviderPluginEntry |
plugin-sdk/migration | createMigrationItem 같은 마이그레이션 provider 항목 헬퍼, reason 상수, 항목 상태 마커, redaction 헬퍼, summarizeMigrationItems |
plugin-sdk/migration-runtime | copyMigrationFileItem, resolvePlannedMigrationTargets, withCachedMigrationConfigRuntime, writeMigrationReport 같은 런타임 마이그레이션 헬퍼 |
plugin-sdk/health | 번들 health 소비자를 위한 Doctor health-check 등록, 감지, 복구, 선택, 심각도, finding 타입 |
사용 중단된 호환성 및 테스트 헬퍼
사용 중단된 하위 경로는 이전 Plugin을 위해 계속 export되지만, 새 코드는 아래의 집중된 SDK 하위 경로를 사용해야 합니다. 유지 관리되는 목록은scripts/lib/plugin-sdk-deprecated-public-subpaths.json에 있으며, CI는 여기에서 번들 프로덕션 import를 거부합니다. compat, config-types, infra-runtime, text-runtime, zod 같은 broad barrel은 호환성 전용입니다. zod는 zod에서 직접 import하세요.
OpenClaw의 Vitest 기반 test-helper 하위 경로는 repo-local 전용이며 더 이상 패키지 exports가 아닙니다: agent-runtime-test-contracts, channel-contract-testing, channel-target-testing, channel-test-helpers, plugin-test-api, plugin-test-contracts, plugin-test-runtime, provider-http-test-mocks, provider-test-contracts, test-env, test-fixtures, test-node-mocks, testing.
예약된 번들 Plugin 헬퍼 하위 경로
이 하위 경로는 일반 SDK API가 아니라 소유 번들 Plugin을 위한 Plugin 소유 호환성 표면입니다:plugin-sdk/codex-mcp-projection 및 plugin-sdk/codex-native-task-runtime. 교차 소유자 extension import는 패키지 계약 가드레일에 의해 차단됩니다.
Channel subpaths
Channel subpaths
| 하위 경로 | 주요 내보내기 |
|---|---|
plugin-sdk/channel-core | defineChannelPluginEntry, defineSetupPluginEntry, createChatChannelPlugin, createChannelPluginBase |
plugin-sdk/config-schema | 루트 openclaw.json Zod 스키마 내보내기(OpenClawSchema) |
plugin-sdk/json-schema-runtime | Plugin 소유 스키마용 캐시된 JSON Schema 검증 헬퍼 |
plugin-sdk/channel-setup | createOptionalChannelSetupSurface, createOptionalChannelSetupAdapter, createOptionalChannelSetupWizard, 그리고 DEFAULT_ACCOUNT_ID, createTopLevelChannelDmPolicy, setSetupChannelEnabled, splitSetupEntries |
plugin-sdk/setup | 공유 설정 마법사 헬퍼, 설정 번역기, 허용 목록 프롬프트, 설정 상태 빌더 |
plugin-sdk/setup-runtime | 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-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/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, 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은 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-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-sdk/channel-secret-runtime | collectSimpleChannelFieldAssignments, getChannelSurface, pushAssignment 및 비밀 대상 타입 같은 좁은 비밀 계약 헬퍼 |
channel-inbound 및 channel-outbound에 유지한 다음, 다음 주요 SDK 정리에서 호환성 하위 경로를 제거합니다. 이는 기존 채널 메시지/런타임, 채널 스트리밍, 직접 DM 접근, 인바운드 헬퍼 분할, 응답 옵션, 페어링 경로 계열에 적용됩니다.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 | 네이티브 exec 승인 프로필/필터 헬퍼 |
plugin-sdk/approval-delivery-runtime | 네이티브 승인 기능/전달 adapter |
plugin-sdk/approval-gateway-runtime | 공유 승인 Gateway 확인 헬퍼 |
plugin-sdk/approval-handler-adapter-runtime | 핫 채널 진입점을 위한 가벼운 네이티브 승인 adapter 로딩 헬퍼 |
plugin-sdk/approval-handler-runtime | 더 넓은 승인 handler 런타임 헬퍼. 충분한 경우 더 좁은 adapter/Gateway 연결부를 선호하세요 |
plugin-sdk/approval-native-runtime | 네이티브 승인 대상, 계정 바인딩, route gate, 전달 fallback, 로컬 네이티브 exec 프롬프트 억제 헬퍼 |
plugin-sdk/approval-reaction-runtime | 하드코딩된 승인 reaction 바인딩, reaction 프롬프트 payload, reaction 대상 저장소, reaction 힌트 텍스트 헬퍼, 로컬 네이티브 exec 프롬프트 억제를 위한 호환성 내보내기 |
plugin-sdk/approval-reply-runtime | exec/Plugin 승인 reply payload 헬퍼 |
plugin-sdk/approval-runtime | exec/Plugin 승인 payload 헬퍼, 네이티브 승인 라우팅/런타임 헬퍼, formatApprovalDisplayPath 같은 구조화된 승인 표시 헬퍼 |
plugin-sdk/reply-dedupe | 좁은 인바운드 reply dedupe 초기화 헬퍼 |
plugin-sdk/channel-contract-testing | 넓은 testing barrel 없는 좁은 채널 계약 테스트 헬퍼 |
plugin-sdk/command-auth-native | 네이티브 명령 인증, 동적 인수 메뉴 형식, 네이티브 세션 대상 헬퍼 |
plugin-sdk/command-detection | 공유 명령 감지 헬퍼 |
plugin-sdk/command-primitives-runtime | 핫 채널 경로를 위한 가벼운 명령 텍스트 predicate |
plugin-sdk/command-surface | 명령 본문 정규화 및 명령 surface 헬퍼 |
plugin-sdk/allow-from | formatAllowFromLowercase |
plugin-sdk/provider-auth-login-flow-runtime | 비공개 채널 및 Web UI device-code 페어링을 위한 지연 프로바이더 인증 로그인 흐름 헬퍼 |
plugin-sdk/channel-secret-runtime | 채널/Plugin secret surface를 위한 좁은 secret-contract collection 헬퍼 |
plugin-sdk/secret-ref-runtime | secret-contract/config 파싱을 위한 좁은 coerceSecretRef 및 SecretRef typing 헬퍼 |
plugin-sdk/secret-provider-integration | 외부 secret 프로바이더 preset을 게시하는 Plugin을 위한 타입 전용 SecretRef 프로바이더 통합 manifest 및 preset 계약 |
plugin-sdk/security-runtime | 공유 신뢰, DM gating, create-only 쓰기, 동기/비동기 원자적 파일 교체, sibling temp 쓰기, 교차 장치 move fallback, 비공개 파일 저장소 헬퍼, symlink-parent guard, 외부 콘텐츠, 민감 텍스트 redact, constant-time secret 비교, secret collection 헬퍼를 포함한 root-bounded 파일/경로 헬퍼 |
plugin-sdk/ssrf-policy | 호스트 allowlist 및 private-network SSRF 정책 헬퍼 |
plugin-sdk/ssrf-dispatcher | 넓은 infra 런타임 surface 없는 좁은 pinned-dispatcher 헬퍼 |
plugin-sdk/ssrf-runtime | Pinned-dispatcher, SSRF 보호 fetch, SSRF 오류, SSRF 정책 헬퍼 |
plugin-sdk/secret-input | Secret 입력 파싱 헬퍼 |
plugin-sdk/webhook-ingress | Webhook 요청/대상 헬퍼 및 raw websocket/body coercion |
plugin-sdk/webhook-request-guards | 요청 본문 크기/timeout 헬퍼 |
Runtime and storage subpaths
Runtime and storage subpaths
| 하위 경로 | 주요 내보내기 |
|---|---|
plugin-sdk/runtime | 광범위한 런타임/로깅/백업/Plugin 설치 헬퍼 |
plugin-sdk/runtime-env | 좁은 런타임 env, 로거, 타임아웃, 재시도, 백오프 헬퍼 |
plugin-sdk/browser-config | 정규화된 프로필/기본값, CDP URL 파싱, 브라우저 제어 인증 헬퍼를 위한 지원 브라우저 config facade |
plugin-sdk/agent-harness-task-runtime | 호스트가 발급한 작업 범위를 사용하는 harness 기반 agent를 위한 일반 작업 수명 주기 및 완료 전달 헬퍼 |
plugin-sdk/codex-mcp-projection | 사용자 MCP server config를 Codex thread config로 투영하기 위한 예약된 번들 Codex 헬퍼; 서드파티 plugins용 아님 |
plugin-sdk/codex-native-task-runtime | 네이티브 작업 미러/런타임 연결을 위한 비공개 번들 Codex 헬퍼; 서드파티 plugins용 아님 |
plugin-sdk/channel-runtime-context | 일반 channel runtime-context 등록 및 조회 헬퍼 |
plugin-sdk/matrix | 이전 서드파티 channel packages를 위한 사용 중단된 Matrix 호환성 facade; 새 plugins는 plugin-sdk/run-command를 직접 import해야 함 |
plugin-sdk/mattermost | 이전 서드파티 channel packages를 위한 사용 중단된 Mattermost 호환성 facade; 새 plugins는 일반 SDK 하위 경로를 직접 import해야 함 |
plugin-sdk/runtime-store | createPluginRuntimeStore |
plugin-sdk/plugin-runtime | 공유 plugin command/hook/http/interactive 헬퍼 |
plugin-sdk/hook-runtime | 공유 webhook/internal hook pipeline 헬퍼 |
plugin-sdk/lazy-runtime | createLazyRuntimeModule, createLazyRuntimeMethod, createLazyRuntimeSurface 같은 지연 런타임 import/binding 헬퍼 |
plugin-sdk/process-runtime | 프로세스 exec 헬퍼 |
plugin-sdk/cli-runtime | CLI formatting, wait, version, argument-invocation, 지연 command-group 헬퍼 |
plugin-sdk/qa-live-transport-scenarios | 공유 라이브 transport QA scenario id, 기준 coverage 헬퍼, scenario-selection 헬퍼 |
plugin-sdk/gateway-method-runtime | contracts.gatewayMethodDispatch: ["authenticated-request"]를 선언하는 plugin HTTP routes를 위한 예약된 Gateway method dispatch 헬퍼 |
plugin-sdk/gateway-runtime | Gateway client, event-loop-ready client start 헬퍼, gateway CLI RPC, gateway protocol errors, advertised LAN host resolution, channel-status patch 헬퍼 |
plugin-sdk/config-contracts | OpenClawConfig 및 channel/provider config types 같은 plugin config shapes를 위한 집중형 type-only config surface |
plugin-sdk/plugin-config-runtime | requireRuntimeConfig, resolvePluginConfigObject, resolveLivePluginConfigObject 같은 런타임 plugin-config 조회 헬퍼 |
plugin-sdk/config-mutation | mutateConfigFile, replaceConfigFile, logConfigUpdated 같은 transactional config mutation 헬퍼 |
plugin-sdk/message-tool-delivery-hints | 공유 message-tool delivery metadata hint 문자열 |
plugin-sdk/runtime-config-snapshot | getRuntimeConfig, getRuntimeConfigSnapshot, test snapshot setter 같은 현재 프로세스 config snapshot 헬퍼 |
plugin-sdk/telegram-command-config | 번들 Telegram contract surface를 사용할 수 없는 경우에도 Telegram command-name/description 정규화 및 duplicate/conflict 검사 |
plugin-sdk/text-autolink-runtime | 광범위한 text barrel 없이 file-reference autolink 감지 |
plugin-sdk/approval-reaction-runtime | 하드코딩된 approval reaction bindings, reaction prompt payloads, reaction target stores, reaction hint text 헬퍼, local native exec prompt suppression을 위한 호환성 export |
plugin-sdk/approval-runtime | Exec/plugin approval 헬퍼, approval-capability builders, auth/profile 헬퍼, native routing/runtime 헬퍼, structured approval display path formatting |
plugin-sdk/reply-runtime | 공유 inbound/reply runtime 헬퍼, chunking, dispatch, heartbeat, reply planner |
plugin-sdk/reply-dispatch-runtime | 좁은 reply dispatch/finalize 및 conversation-label 헬퍼 |
plugin-sdk/reply-history | 공유 short-window reply-history 헬퍼. 새 message-turn 코드는 createChannelHistoryWindow를 사용해야 하며, 하위 수준 map 헬퍼는 사용 중단된 호환성 export로만 유지됨 |
plugin-sdk/reply-reference | createReplyReferencePlanner |
plugin-sdk/reply-chunking | 좁은 text/markdown chunking 헬퍼 |
plugin-sdk/session-store-runtime | 세션 워크플로 헬퍼(getSessionEntry, listSessionEntries, patchSessionEntry, upsertSessionEntry), 세션 identity별 제한된 최근 user/assistant transcript text 읽기, legacy session store path/session-key 헬퍼, updated-at 읽기, 전환 전용 whole-store/file-path 호환성 헬퍼 |
plugin-sdk/session-transcript-runtime | Transcript identity, scoped target/read/write 헬퍼, update publishing, write locks, transcript memory hit keys |
plugin-sdk/sqlite-runtime | first-party 런타임을 위한 집중형 SQLite agent-schema, path, transaction 헬퍼 |
plugin-sdk/cron-store-runtime | Cron store path/load/save 헬퍼 |
plugin-sdk/state-paths | State/OAuth dir path 헬퍼 |
plugin-sdk/plugin-state-runtime | Plugin sidecar SQLite keyed-state types와 plugin 소유 databases를 위한 중앙 집중식 connection pragma 및 WAL maintenance setup |
plugin-sdk/routing | resolveAgentRoute, buildAgentSessionKey, resolveDefaultAgentBoundAccountId 같은 route/session-key/account binding 헬퍼 |
plugin-sdk/status-helpers | 공유 channel/account status summary 헬퍼, runtime-state defaults, issue metadata 헬퍼 |
plugin-sdk/target-resolver-runtime | 공유 target resolver 헬퍼 |
plugin-sdk/string-normalization-runtime | Slug/string 정규화 헬퍼 |
plugin-sdk/request-url | fetch/request-like 입력에서 string URLs 추출 |
plugin-sdk/run-command | 정규화된 stdout/stderr 결과를 제공하는 timed command runner |
plugin-sdk/param-readers | 공통 tool/CLI param reader |
plugin-sdk/tool-plugin | 간단한 typed agent-tool plugin을 정의하고 manifest 생성을 위한 static metadata 노출 |
plugin-sdk/tool-payload | tool result objects에서 정규화된 payloads 추출 |
plugin-sdk/tool-send | tool args에서 표준 send target fields 추출 |
plugin-sdk/sandbox | fail-fast exec command preflight를 포함한 Sandbox backend types 및 SSH/OpenShell command 헬퍼 |
plugin-sdk/temp-path | 공유 temp-download path 헬퍼 및 비공개 보안 temp workspaces |
plugin-sdk/logging-core | Subsystem logger 및 redaction 헬퍼 |
plugin-sdk/markdown-table-runtime | Markdown table mode 및 conversion 헬퍼 |
plugin-sdk/model-session-runtime | applyModelOverrideToSessionEntry, resolveAgentMaxConcurrent 같은 model/session override 헬퍼 |
plugin-sdk/talk-config-runtime | Talk provider config resolution 헬퍼 |
plugin-sdk/json-store | 작은 JSON state read/write 헬퍼 |
plugin-sdk/json-unsafe-integers | 안전하지 않은 integer literals를 strings로 보존하는 JSON parsing 헬퍼 |
plugin-sdk/file-lock | Re-entrant file-lock 헬퍼 |
plugin-sdk/persistent-dedupe | Disk-backed dedupe cache 헬퍼 |
plugin-sdk/acp-runtime | ACP runtime/session 및 reply-dispatch 헬퍼 |
plugin-sdk/acp-runtime-backend | startup-loaded plugins를 위한 경량 ACP backend registration 및 reply-dispatch 헬퍼 |
plugin-sdk/acp-binding-resolve-runtime | lifecycle startup imports 없는 read-only ACP binding resolution |
plugin-sdk/agent-config-primitives | 좁은 agent runtime config-schema primitives |
plugin-sdk/boolean-param | 느슨한 boolean param reader |
plugin-sdk/dangerous-name-runtime | Dangerous-name matching resolution 헬퍼 |
plugin-sdk/device-bootstrap | Device bootstrap 및 pairing token 헬퍼 |
plugin-sdk/extension-shared | 공유 passive-channel, status, ambient proxy helper primitives |
plugin-sdk/models-provider-runtime | /models command/provider reply 헬퍼 |
plugin-sdk/skill-commands-runtime | Skill command listing 헬퍼 |
plugin-sdk/native-command-registry | Native command registry/build/serialize 헬퍼 |
plugin-sdk/agent-harness | low-level agent harnesses를 위한 실험적 trusted-plugin surface: harness types, active-run steer/abort 헬퍼, OpenClaw tool bridge 헬퍼, runtime-plan tool policy 헬퍼, terminal outcome classification, tool progress formatting/detail 헬퍼, attempt result utilities |
plugin-sdk/provider-zai-endpoint | 사용 중단된 Z.AI provider-owned endpoint detection facade; Z.AI plugin public API를 사용 |
plugin-sdk/async-lock-runtime | 작은 runtime state files를 위한 process-local async lock 헬퍼 |
plugin-sdk/channel-activity-runtime | Channel activity telemetry 헬퍼 |
plugin-sdk/concurrency-runtime | 제한된 async task concurrency 헬퍼 |
plugin-sdk/dedupe-runtime | In-memory 및 persistent-backed dedupe cache 헬퍼 |
plugin-sdk/delivery-queue-runtime | Outbound pending-delivery drain 헬퍼 |
plugin-sdk/file-access-runtime | 안전한 local-file 및 media-source path 헬퍼 |
plugin-sdk/heartbeat-runtime | Heartbeat wake, event, visibility 헬퍼 |
plugin-sdk/number-runtime | Numeric coercion 헬퍼 |
plugin-sdk/secure-random-runtime | Secure token/UUID 헬퍼 |
plugin-sdk/system-event-runtime | System event queue 헬퍼 |
plugin-sdk/transport-ready-runtime | Transport readiness wait 헬퍼 |
plugin-sdk/exec-approvals-runtime | 광범위한 infra-runtime barrel 없이 exec approval policy file 헬퍼 |
plugin-sdk/infra-runtime | 사용 중단된 compatibility shim; 위의 집중형 runtime 하위 경로를 사용 |
plugin-sdk/collection-runtime | 작은 bounded cache 헬퍼 |
plugin-sdk/diagnostic-runtime | Diagnostic flag, event, trace-context 헬퍼 |
plugin-sdk/error-runtime | Error graph, formatting, shared error classification 헬퍼, isApprovalNotFoundError |
plugin-sdk/fetch-runtime | Wrapped fetch, proxy, EnvHttpProxyAgent option, pinned lookup 헬퍼 |
plugin-sdk/runtime-fetch | proxy/guarded-fetch imports 없는 dispatcher-aware runtime fetch |
plugin-sdk/inline-image-data-url-runtime | 광범위한 media runtime surface 없는 inline image data URL sanitizer 및 signature sniffing 헬퍼 |
plugin-sdk/response-limit-runtime | 광범위한 media runtime surface 없는 bounded response-body reader |
plugin-sdk/session-binding-runtime | configured binding routing 또는 pairing stores 없는 현재 conversation binding state |
plugin-sdk/session-store-runtime | 광범위한 config writes/maintenance imports 없는 session-store 헬퍼 |
plugin-sdk/sqlite-runtime | database lifecycle controls 없는 집중형 SQLite agent-schema, path, transaction 헬퍼 |
plugin-sdk/context-visibility-runtime | 광범위한 config/security imports 없는 context visibility resolution 및 supplemental context filtering |
plugin-sdk/string-coerce-runtime | markdown/logging imports 없는 좁은 primitive record/string coercion 및 normalization 헬퍼 |
plugin-sdk/host-runtime | Hostname 및 SCP host normalization 헬퍼 |
plugin-sdk/retry-runtime | Retry config 및 retry runner 헬퍼 |
plugin-sdk/agent-runtime | resolveAgentDir, resolveDefaultAgentDir, 사용 중단된 resolveOpenClawAgentDir 호환성 export를 포함한 agent dir/identity/workspace 헬퍼 |
plugin-sdk/directory-runtime | Config-backed directory query/dedup |
plugin-sdk/keyed-async-queue | KeyedAsyncQueue |
기능 및 테스트 하위 경로
기능 및 테스트 하위 경로
| 하위 경로 | 주요 내보내기 |
|---|---|
plugin-sdk/media-runtime | saveRemoteMedia, saveResponseMedia, readRemoteMediaBuffer, 더 이상 사용되지 않는 fetchRemoteMedia를 포함한 공유 미디어 가져오기/변환/저장 헬퍼. 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 | 텍스트 및 마크다운 청킹/렌더링 헬퍼, 마크다운 표 변환, 지시문 태그 제거, 안전한 텍스트 유틸리티 |
plugin-sdk/text-chunking | 아웃바운드 텍스트 청킹 헬퍼 |
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-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/plugin-test-contracts | 저장소 로컬 Plugin 패키지, 등록, 공개 아티팩트, 직접 가져오기, 런타임 API, 가져오기 부작용 계약 헬퍼 |
plugin-sdk/provider-test-contracts | 저장소 로컬 제공자 런타임, 인증, 검색, 온보딩, 카탈로그, 마법사, 미디어 기능, 리플레이 정책, 실시간 STT 라이브 오디오, 웹 검색/가져오기, 스트림 계약 헬퍼 |
plugin-sdk/provider-http-test-mocks | plugin-sdk/provider-http를 실행하는 제공자 테스트를 위한 저장소 로컬 옵트인 Vitest HTTP/인증 목 |
plugin-sdk/test-fixtures | 저장소 로컬 일반 CLI 런타임 캡처, 샌드박스 컨텍스트, Skill 작성기, 에이전트 메시지, 시스템 이벤트, 모듈 리로드, 번들 Plugin 경로, 터미널 텍스트, 청킹, 인증 토큰, 타입 지정 사례 픽스처 |
plugin-sdk/test-node-mocks | Vitest vi.mock("node:*") 팩토리 내부에서 사용하기 위한 저장소 로컬 집중 Node 내장 목 헬퍼 |
메모리 하위 경로
메모리 하위 경로
| 하위 경로 | 주요 내보내기 |
|---|---|
plugin-sdk/memory-core | 관리자/구성/파일/CLI 헬퍼를 위한 번들 메모리 코어 헬퍼 표면 |
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을 위한 공유 관리형 마크다운 헬퍼 |
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/security-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 헬퍼 |