Plugin SDK 子路径目录

概述

Plugin SDK 以一组窄子路径形式暴露在 openclaw/plugin-sdk/ 下。每个子路径是独立的小模块，按用途分组。可用 pnpm plugin-sdk:surface 审计公开导出数量。

子路径	关键导出
`plugin-sdk/plugin-entry`	`definePluginEntry`
`plugin-sdk/channel-core`	`defineChannelPluginEntry`, `createChatChannelPlugin`, `defineSetupPluginEntry`, `buildChannelConfigSchema`
`plugin-sdk/provider-entry`	`defineSingleProviderPluginEntry`
`plugin-sdk/migration`	迁移辅助工具

子路径	用途
`plugin-sdk/channel-setup`	可选安装 setup 界面构建器
`plugin-sdk/setup-runtime`	setup 时运行时辅助工具（import 安全）
`plugin-sdk/setup-tools`	setup/安装 CLI/归档/文档辅助工具
`plugin-sdk/account-core`	多账号配置/操作门控辅助工具
`plugin-sdk/channel-ingress-runtime`	实验性高级 channel 入站运行时解析器
`plugin-sdk/channel-message`	消息生命周期契约辅助工具
`plugin-sdk/channel-message-runtime`	运行时投递辅助工具
`plugin-sdk/channel-mention-gating`	提及策略决策辅助工具

子路径	用途
`plugin-sdk/provider-auth`	API Key 认证方法
`plugin-sdk/provider-model-shared`	共享 replay/模型辅助工具
`plugin-sdk/provider-stream`	流式包装器辅助工具
`plugin-sdk/provider-tools`	工具 Schema 兼容辅助工具
`plugin-sdk/provider-http`	通用 HTTP/端点辅助工具
`plugin-sdk/provider-catalog-shared`	Provider 目录辅助工具

子路径	用途
`plugin-sdk/runtime-store`	`createPluginRuntimeStore`
`plugin-sdk/config-contracts`	配置类型（`OpenClawConfig` 等）
`plugin-sdk/config-mutation`	事务性配置写入
`plugin-sdk/runtime-config-snapshot`	当前进程配置快照
`plugin-sdk/security-runtime`	信任、DM 门控、文件路径辅助工具
`plugin-sdk/gateway-runtime`	Gateway 客户端和 RPC 辅助工具
`plugin-sdk/agent-harness`	实验性低级 Agent 执行器 SDK 面

子路径	用途
`plugin-sdk/speech`	语音 Provider 类型和辅助工具
`plugin-sdk/realtime-transcription`	实时转录 Provider 类型
`plugin-sdk/realtime-voice`	实时语音 Provider 类型
`plugin-sdk/image-generation`	图像生成 Provider 类型
`plugin-sdk/video-generation`	视频生成 Provider 类型
`plugin-sdk/media-runtime`	共享媒体辅助工具

子路径	用途
`plugin-sdk/memory-core`	捆绑记忆核心辅助工具
`plugin-sdk/memory-host-core`	记忆宿主核心运行时辅助工具（厂商中立别名）
`plugin-sdk/memory-host-search`	主动记忆运行时搜索管理器访问

不应在新代码中使用：plugin-sdk/compat、plugin-sdk/infra-runtime、plugin-sdk/config-runtime、plugin-sdk/channel-runtime、plugin-sdk/zod（直接从 zod 导入）。