快速开始
插件 SDK 子路径
插件 SDK 通过 openclaw/plugin-sdk/ 下的一组窄子路径暴露。
本页按用途分组列出常用子路径。生成的 200+ 个子路径完整列表位于 scripts/lib/plugin-sdk-entrypoints.json；
保留的内置插件辅助子路径也会出现在其中，但除非某个文档页面明确将其公开，否则它们只是实现细节。维护者可以使用 pnpm plugins:boundary-report:summary 审核活跃的保留辅助子路径；未使用的保留辅助导出会使 CI 报告失败，而不是作为休眠的兼容性债务留在公共 SDK 中。
插件作者指南见 插件 SDK 概览。
插件入口
| 子路径 | 关键导出 |
|---|---|
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-sdk/plugin-test-api |
用于直接插件注册单元测试的最小 OpenClawPluginApi mock 构建器 |
plugin-sdk/agent-runtime-test-contracts |
用于 auth profiles、递送抑制、回退分类、工具钩子、提示词叠加、schema 和转录修复的原生 agent runtime 适配器契约夹具 |
plugin-sdk/channel-test-helpers |
渠道账户生命周期、目录、发送配置、运行时 mock、钩子、内置渠道入口、信封时间戳、配对回复和通用渠道契约测试辅助函数 |
plugin-sdk/channel-target-testing |
共享的渠道目标解析错误用例测试套件 |
plugin-sdk/plugin-test-contracts |
插件注册、package manifest、公共产物、运行时 API、导入副作用和直接导入契约辅助函数 |
plugin-sdk/plugin-test-runtime |
用于测试的插件运行时、注册表、提供商注册、设置向导和运行时任务流夹具 |
plugin-sdk/provider-test-contracts |
提供商运行时、认证、发现、新手引导、catalog、媒体能力、重放策略、实时 STT 实时音频、Web 搜索/抓取和向导契约辅助函数 |
plugin-sdk/provider-http-test-mocks |
供会执行 plugin-sdk/provider-http 的提供商测试按需启用的 Vitest HTTP/auth mock |
plugin-sdk/test-env |
测试环境、fetch/network、一次性 HTTP 服务器、传入请求、实时测试、临时文件系统和时间控制夹具 |
plugin-sdk/test-fixtures |
通用 CLI、沙箱、skill、agent-message、system-event、模块重新加载、内置插件路径、终端、分块、auth-token 和类型化用例测试夹具 |
plugin-sdk/test-node-mocks |
用于 Vitest vi.mock("node:*") 工厂内部的聚焦 Node 内置 mock 辅助函数 |
plugin-sdk/migration |
迁移提供商条目辅助函数，例如 createMigrationItem、reason 常量、条目状态标记、脱敏辅助函数和 summarizeMigrationItems |
plugin-sdk/migration-runtime |
运行时迁移辅助函数，例如 copyMigrationFileItem、withCachedMigrationConfigRuntime 和 writeMigrationReport |
渠道子路径
| 子路径 | 关键导出 |
|---|---|
plugin-sdk/channel-core |
defineChannelPluginEntry、defineSetupPluginEntry、createChatChannelPlugin、createChannelPluginBase |
plugin-sdk/config-schema |
根级 openclaw.json Zod schema 导出（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 |
共享渠道配置 schema 原语，以及 Zod 和直接 JSON/TypeBox 构建器 |
plugin-sdk/bundled-channel-config-schema |
仅用于维护中的内置插件的内置 OpenClaw 渠道配置 schema |
plugin-sdk/channel-config-schema-legacy |
内置渠道配置 schema 的已弃用兼容性别名 |
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、兼容性 facade、持久最终能力派生、发送/回执/副作用能力的能力证明辅助函数、MessageReceiveContext、接收确认策略证明、defineFinalizableLivePreviewAdapter、deliverWithFinalizableLivePreviewAdapter、实时预览和实时最终化器能力证明、持久恢复状态、RenderedMessageBatch、消息回执类型，以及回执 ID 辅助函数。参见 频道消息 API。旧版 createChannelTurnReplyPipeline 仅保留给兼容性分发器。 |
plugin-sdk/channel-message-runtime |
可能加载出站投递的运行时投递辅助函数，包括 deliverInboundReplyWithMessageSendContext、sendDurableMessageBatch、withDurableMessageSendContext、dispatchChannelMessageReplyWithBase 和 recordChannelMessageReplyDispatch。应从监控/发送运行时模块使用，而不是热路径插件引导文件。 |
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 |
出站投递、身份、发送委托、会话、格式化和载荷规划辅助函数 |
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 |
精简渠道配置 schema 原语 |
plugin-sdk/channel-config-writes |
渠道配置写入授权辅助函数 |
plugin-sdk/channel-plugin-common |
共享渠道插件前导导出 |
plugin-sdk/allowlist-config-edit |
允许列表配置编辑/读取辅助函数 |
plugin-sdk/group-access |
共享群组访问决策辅助函数 |
plugin-sdk/direct-dm |
共享直接私信认证/保护辅助函数 |
plugin-sdk/discord |
已弃用的 Discord 兼容性 facade，用于已发布的 @openclaw/[email protected] 和跟踪中的所有者兼容性；新插件应使用通用渠道 SDK 子路径 |
plugin-sdk/telegram-account |
已弃用的 Telegram 账号解析兼容性 facade，用于跟踪中的所有者兼容性；新插件应使用注入的运行时辅助函数或通用渠道 SDK 子路径 |
plugin-sdk/zalouser |
已弃用的 Zalo Personal 兼容性 facade，用于仍导入发送者命令授权的已发布 Lark/Zalo 包；新插件应使用 plugin-sdk/command-auth |
plugin-sdk/interactive-runtime |
语义消息呈现、投递和旧版交互式回复辅助函数。参见 消息呈现 |
plugin-sdk/channel-inbound |
入站去抖、提及匹配、提及策略辅助函数和信封辅助函数的兼容性 barrel |
plugin-sdk/channel-inbound-debounce |
精简入站去抖辅助函数 |
plugin-sdk/channel-mention-gating |
精简提及策略、提及标记和提及文本辅助函数，不包含更广泛的入站运行时表面 |
plugin-sdk/channel-envelope |
精简入站信封格式化辅助函数 |
plugin-sdk/channel-location |
渠道位置上下文和格式化辅助函数 |
plugin-sdk/channel-logging |
用于入站丢弃和输入中/确认失败的渠道日志辅助函数 |
plugin-sdk/channel-send-result |
回复结果类型 |
plugin-sdk/channel-actions |
渠道消息操作辅助函数，以及为插件兼容性保留的已弃用原生 schema 辅助函数 |
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 和秘密目标类型 |
Provider subpaths
| 子路径 | 关键导出 |
|---|---|
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/cli-backend |
CLI 后端默认值 + watchdog 常量 |
plugin-sdk/provider-auth-runtime |
提供商插件的运行时 API key 解析辅助函数 |
plugin-sdk/provider-auth-api-key |
API key 新手引导/配置文件写入辅助函数，例如 upsertApiKeyProfile |
plugin-sdk/provider-auth-result |
标准 OAuth 鉴权结果构建器 |
plugin-sdk/provider-auth-login |
提供商插件的共享交互式登录辅助函数 |
plugin-sdk/provider-env-vars |
提供商鉴权环境变量查找辅助函数 |
plugin-sdk/provider-auth |
createProviderApiKeyAuthMethod、ensureApiKeyFromOptionEnvOrPrompt、upsertAuthProfile、upsertApiKeyProfile、writeOAuthCredentials、已弃用的 resolveOpenClawAgentDir 兼容性导出 |
plugin-sdk/provider-model-shared |
ProviderReplayFamily、buildProviderReplayFamilyHooks、normalizeModelCompat、共享 replay 策略构建器、提供商端点辅助函数，以及模型 ID 规范化辅助函数，例如 normalizeNativeXaiModelId |
plugin-sdk/provider-catalog-runtime |
提供商目录扩充运行时钩子，以及用于契约测试的插件提供商注册表衔接点 |
plugin-sdk/provider-catalog-shared |
findCatalogTemplate、buildSingleProviderApiKeyCatalog、buildManifestModelProviderConfig、supportsNativeStreamingUsageCompat、applyProviderNativeStreamingUsageCompat |
plugin-sdk/provider-http |
通用提供商 HTTP/端点能力辅助函数、提供商 HTTP 错误，以及音频转录 multipart 表单辅助函数 |
plugin-sdk/provider-web-fetch-contract |
窄范围 web-fetch 配置/选择契约辅助函数，例如 enablePluginInConfig 和 WebFetchProviderPlugin |
plugin-sdk/provider-web-fetch |
Web-fetch 提供商注册/缓存辅助函数 |
plugin-sdk/provider-web-search-config-contract |
面向不需要插件启用接线的提供商的窄范围 web-search 配置/凭证辅助函数 |
plugin-sdk/provider-web-search-contract |
窄范围 web-search 配置/凭证契约辅助函数，例如 createWebSearchProviderContractFields、enablePluginInConfig、resolveProviderWebSearchPluginConfig，以及带作用域的凭证 setter/getter |
plugin-sdk/provider-web-search |
Web-search 提供商注册/缓存/运行时辅助函数 |
plugin-sdk/provider-tools |
ProviderToolCompatFamily、buildProviderToolCompatFamilyHooks、Gemini schema 清理 + 诊断，以及 xAI 兼容性辅助函数，例如 resolveXaiModelCompatPatch / applyXaiModelCompat |
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 |
窄范围群组激活模式和命令解析辅助函数 |
Auth and security subpaths
| 子路径 | 关键导出 |
|---|---|
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/插件审批回复 payload 辅助函数 |
plugin-sdk/approval-runtime |
Exec/插件审批 payload 辅助函数、原生审批路由/运行时辅助函数，以及结构化审批显示辅助函数，例如 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 |
命令正文规范化和命令 surface 辅助函数 |
plugin-sdk/allow-from |
formatAllowFromLowercase |
plugin-sdk/channel-secret-runtime |
面向渠道/插件密钥 surface 的窄范围密钥契约收集辅助函数 |
plugin-sdk/secret-ref-runtime |
面向密钥契约/配置解析的窄范围 coerceSecretRef 和 SecretRef 类型辅助函数 |
plugin-sdk/security-runtime |
共享信任、私信门控、受根目录边界约束的文件/路径辅助函数，包括仅创建写入、同步/异步原子文件替换、同级临时写入、跨设备移动回退、私有文件存储辅助函数、symlink 父目录保护、外部内容、敏感文本脱敏、常量时间密钥比较和密钥收集辅助函数 |
plugin-sdk/ssrf-policy |
主机 allowlist 和私有网络 SSRF 策略辅助函数 |
plugin-sdk/ssrf-dispatcher |
不包含宽泛 infra 运行时 surface 的窄范围 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 |
请求正文大小/超时辅助函数 |
运行时和存储子路径
| 子路径 | 关键导出 |
|---|---|
plugin-sdk/runtime |
宽泛的运行时、日志记录、备份、插件安装辅助工具 |
plugin-sdk/runtime-env |
精简的运行时环境、日志记录器、超时、重试和退避辅助工具 |
plugin-sdk/browser-config |
支持的浏览器配置门面，用于规范化配置文件/默认值、CDP URL 解析和浏览器控制认证辅助工具 |
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 格式化、等待、版本、参数调用和懒加载命令组辅助工具 |
plugin-sdk/gateway-runtime |
Gateway 网关客户端、事件循环就绪客户端启动辅助工具、网关 CLI RPC、网关协议错误和渠道状态补丁辅助工具 |
plugin-sdk/config-types |
仅类型的配置表面，用于插件配置形状，例如 OpenClawConfig 和渠道/提供商配置类型 |
plugin-sdk/plugin-config-runtime |
运行时插件配置查找辅助工具，例如 requireRuntimeConfig、resolvePluginConfigObject 和 resolveLivePluginConfigObject |
plugin-sdk/config-mutation |
事务性配置变更辅助工具，例如 mutateConfigFile、replaceConfigFile 和 logConfigUpdated |
plugin-sdk/runtime-config-snapshot |
当前进程配置快照辅助工具，例如 getRuntimeConfig、getRuntimeConfigSnapshot 和测试快照 setter |
plugin-sdk/telegram-command-config |
Telegram 命令名称/描述规范化以及重复/冲突检查，即使内置 Telegram 契约表面不可用也可使用 |
plugin-sdk/text-autolink-runtime |
文件引用自动链接检测，无需宽泛的文本运行时 barrel |
plugin-sdk/approval-runtime |
执行/插件审批辅助工具、审批能力构建器、认证/配置文件辅助工具、原生路由/运行时辅助工具，以及结构化审批显示路径格式化 |
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 |
用于启动时加载插件的轻量级 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 |
共享的被动渠道、Status 和环境代理辅助原语 |
plugin-sdk/models-provider-runtime |
/models 命令/提供商回复辅助工具 |
plugin-sdk/skill-commands-runtime |
技能命令列表辅助工具 |
plugin-sdk/native-command-registry |
原生命令注册表构建/序列化辅助工具 |
plugin-sdk/agent-harness |
用于底层 Agent harness 的实验性可信插件表面：harness 类型、活动运行 Steer/中止辅助工具、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 |
感知 dispatcher 的运行时 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 兼容导出 |
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 |
媒体理解提供商类型，以及面向提供商的图像/音频辅助导出 |
plugin-sdk/text-runtime |
共享文本/Markdown/日志辅助函数，例如剥离助手可见文本、Markdown 渲染/分块/表格辅助函数、遮盖辅助函数、指令标签辅助函数，以及安全文本实用工具 |
plugin-sdk/text-chunking |
出站文本分块辅助函数 |
plugin-sdk/speech |
语音提供商类型，以及面向提供商的指令、注册表、验证、OpenAI 兼容 TTS 构建器和语音辅助导出 |
plugin-sdk/speech-core |
共享语音提供商类型、注册表、指令、规范化和语音辅助导出 |
plugin-sdk/realtime-transcription |
实时转录提供商类型、注册表辅助函数，以及共享 WebSocket 会话辅助函数 |
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/webhook-targets |
Webhook 目标注册表和路由安装辅助函数 |
plugin-sdk/webhook-path |
Webhook 路径规范化辅助函数 |
plugin-sdk/web-media |
共享远程/本地媒体加载辅助函数 |
plugin-sdk/zod |
为插件 SDK 使用者重新导出的 zod |
plugin-sdk/testing |
面向旧版插件测试的宽泛兼容性桶文件。新的扩展测试应改为导入聚焦的 SDK 子路径，例如 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 |
最小化的 createTestPluginApi 辅助函数，用于直接插件注册单元测试，无需导入仓库测试辅助桥接 |
plugin-sdk/agent-runtime-test-contracts |
用于认证、投递、回退、工具钩子、提示词叠加、架构和转录投影测试的原生智能体运行时适配器契约夹具 |
plugin-sdk/channel-test-helpers |
面向渠道的测试辅助函数，用于通用操作/设置/状态契约、目录断言、账户启动生命周期、发送配置线程化、运行时模拟、状态问题、出站投递和钩子注册 |
plugin-sdk/channel-target-testing |
用于渠道测试的共享目标解析错误场景套件 |
plugin-sdk/plugin-test-contracts |
插件包、注册、公共产物、直接导入、运行时 API 和导入副作用契约辅助函数 |
plugin-sdk/provider-test-contracts |
提供商运行时、认证、设备发现、新手引导、目录、向导、媒体能力、重放策略、实时 STT 现场音频、Web 搜索/获取和流契约辅助函数 |
plugin-sdk/provider-http-test-mocks |
针对会执行 plugin-sdk/provider-http 的提供商测试，可选择启用的 Vitest HTTP/认证模拟 |
plugin-sdk/test-fixtures |
通用 CLI 运行时捕获、沙箱上下文、技能写入器、智能体消息、系统事件、模块重新加载、内置插件路径、终端文本、分块、认证令牌和类型化用例夹具 |
plugin-sdk/test-node-mocks |
聚焦的 Node 内建模拟辅助函数，用于 Vitest vi.mock("node:*") 工厂内部 |
Memory 子路径
| 子路径 | 关键导出 |
|---|---|
plugin-sdk/memory-core |
面向管理器/配置/文件/CLI 辅助函数的内置 memory-core 辅助接口 |
plugin-sdk/memory-core-engine-runtime |
记忆索引/搜索运行时门面 |
plugin-sdk/memory-core-host-engine-foundation |
记忆宿主基础引擎导出 |
plugin-sdk/memory-core-host-engine-embeddings |
记忆宿主嵌入契约、注册表访问、本地提供商，以及通用批处理/远程辅助函数 |
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 |
面向记忆相邻插件的共享托管 Markdown 辅助函数 |
plugin-sdk/memory-host-search |
用于访问搜索管理器的主动记忆运行时门面 |
plugin-sdk/memory-host-status |
面向记忆宿主状态辅助函数的供应商中立别名 |
保留的内置辅助函数子路径
目前没有保留的内置辅助函数 SDK 子路径。所有者特定的
辅助函数位于所属插件包内，而可复用的宿主契约
使用通用 SDK 子路径，例如 plugin-sdk/gateway-runtime、
plugin-sdk/security-runtime 和 plugin-sdk/plugin-config-runtime。