跳轉到主要內容
外掛 SDK 以 openclaw/plugin-sdk/ 下的一組窄版公開子路徑公開。本頁依用途分組列出常用子路徑。三個檔案定義此介面：
  • scripts/lib/plugin-sdk-entrypoints.json：建置會編譯的維護中進入點清單。
  • scripts/lib/plugin-sdk-private-local-only-subpaths.json：僅限 repo 本機的測試/內部子路徑。套件匯出是清單扣除此列表。
  • src/plugin-sdk/entrypoints.ts：已棄用子路徑、保留的內建輔助工具、支援的內建 facade，以及外掛擁有的公開介面的分類中繼資料。
維護者使用 pnpm plugin-sdk:surface 稽核公開匯出數量，並使用 pnpm plugins:boundary-report:summary 稽核啟用中的保留輔助工具子路徑；未使用的保留輔助工具匯出會讓 CI 報告失敗，而不是以休眠相容性債務的形式留在公開 SDK 中。 如需外掛作者指南，請參閱外掛 SDK 概觀。

​
外掛進入點

子路徑主要匯出
plugin-sdk/plugin-entrydefinePluginEntry
plugin-sdk/coredefineChannelPluginEntry, createChatChannelPlugin, createChannelPluginBase, defineSetupPluginEntry, buildChannelConfigSchema, buildJsonChannelConfigSchema
plugin-sdk/provider-entrydefineSingleProviderPluginEntry
plugin-sdk/migration遷移提供者項目輔助工具，例如 createMigrationItem、原因常數、項目狀態標記、遮蔽輔助工具，以及 summarizeMigrationItems
plugin-sdk/migration-runtime執行階段遷移輔助工具，例如 copyMigrationFileItem、resolvePlannedMigrationTargets、withCachedMigrationConfigRuntime，以及 writeMigrationReport
plugin-sdk/health供內建健康狀態消費者使用的 Doctor 健康檢查註冊、偵測、修復、選取、嚴重性與發現項目類型
plugin-sdk/config-schema已棄用。根 openclaw.json Zod schema（OpenClawSchema）；請改為定義外掛本機 schema，並使用 plugin-sdk/json-schema-runtime 驗證

​
已棄用的相容性與測試輔助工具

已棄用的子路徑仍會匯出給較舊的外掛使用，但新程式碼應使用下方聚焦的 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 這類寬版 barrel 僅供相容性使用，而 plugin-sdk/zod 是相容性重新匯出：請直接從 zod 匯入 zod。寬版領域 barrel 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 支援測試輔助工具子路徑僅限 repo 本機使用，且不再是套件匯出：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 也僅限 repo 本機使用。

​
保留的內建外掛輔助工具子路徑

plugin-sdk/codex-mcp-projection 是唯一的保留子路徑：它是內建 Codex 外掛擁有的相容性介面，不是通用 SDK API。跨擁有者外掛匯入會受到套件合約防護機制阻擋，且當保留子路徑停止被匯入時，CI 會失敗。plugin-sdk/codex-native-task-runtime 僅限 repo 本機使用，並非套件匯出。 src/plugin-sdk/entrypoints.ts 也會追蹤支援的內建 facade，也就是由其內建外掛支援的 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-coredefineChannelPluginEntry、defineSetupPluginEntry、createChatChannelPlugin、createChannelPluginBase
plugin-sdk/json-schema-runtime用於外掛自有結構描述的快取 JSON Schema 驗證輔助工具
plugin-sdk/channel-setupcreateOptionalChannelSetupSurface、createOptionalChannelSetupAdapter、createOptionalChannelSetupWizard，以及 DEFAULT_ACCOUNT_ID、createTopLevelChannelDmPolicy、setSetupChannelEnabled、splitSetupEntries
plugin-sdk/setup共用設定精靈輔助工具、設定翻譯器、允許清單提示、設定狀態建構器
plugin-sdk/setup-runtimecreateSetupTranslator、createPatchedAccountSetupAdapter、createEnvPatchedAccountSetupAdapter、createSetupInputPresenceValidator、noteChannelLookupFailure、noteChannelLookupSummary、promptResolvedAllowFrom、splitSetupEntries、createAllowlistSetupWizardProxy、createDelegatedSetupWizardProxy
plugin-sdk/setup-adapter-runtime已棄用的相容性別名；請使用 plugin-sdk/setup-runtime
plugin-sdk/setup-toolsformatCliCommand、detectBinary、extractArchive、resolveBrewExecutable、formatDocsLink、CONFIG_DIR
plugin-sdk/account-core多帳號設定／動作閘門輔助工具、預設帳號後援輔助工具
plugin-sdk/account-idDEFAULT_ACCOUNT_ID、帳號 ID 正規化輔助工具
plugin-sdk/account-resolution帳號查找與預設後援輔助工具
plugin-sdk/account-helpers精簡帳號清單／帳號動作輔助工具
plugin-sdk/access-groups存取群組允許清單解析與已遮蔽群組診斷輔助工具
plugin-sdk/channel-pairingcreateChannelPairingController
plugin-sdk/channel-reply-pipeline已棄用的相容性 facade。請使用 plugin-sdk/channel-outbound。
plugin-sdk/channel-config-helperscreateHybridChannelConfigAdapter、resolveChannelDmAccess、resolveChannelDmAllowFrom、resolveChannelDmPolicy、normalizeChannelDmPolicy、normalizeLegacyDmAliases
plugin-sdk/channel-config-schema共用頻道設定結構描述原語，加上 Zod 與直接 JSON/TypeBox 建構器
plugin-sdk/bundled-channel-config-schema僅供受維護的內建外掛使用的內建 OpenClaw 頻道設定結構描述
plugin-sdk/chat-channel-idsBUNDLED_CHAT_CHANNEL_IDS、BUNDLED_CHAT_CHANNEL_ENVELOPE_PREFIXES、ChatChannelId。標準內建／官方聊天頻道 ID，加上格式化標籤／別名，供需要辨識信封前綴文字且不想硬編碼自身表格的外掛使用。
plugin-sdk/channel-config-schema-legacy內建頻道設定結構描述的已棄用相容性別名
plugin-sdk/telegram-command-config已棄用的 Telegram 命令名稱／描述正規化與重複／衝突檢查；新外掛程式碼請使用外掛本機命令設定處理
plugin-sdk/command-gating精簡命令授權閘門輔助工具
plugin-sdk/channel-policyresolveChannelGroupRequireMention
plugin-sdk/channel-ingress低階頻道輸入相容性介面。新的接收路徑應使用 plugin-sdk/channel-ingress-runtime。
plugin-sdk/channel-ingress-runtime實驗性高階頻道輸入執行階段解析器與路由事實建構器，供已遷移的頻道接收路徑使用。優先使用此項，而不是在每個外掛中組裝有效允許清單、命令允許清單與舊版投影。請參閱頻道輸入 API。
plugin-sdk/channel-lifecycle已棄用的相容性 facade。請使用 plugin-sdk/channel-outbound。
plugin-sdk/channel-outbound訊息生命週期合約，加上回覆管線選項、回條、即時預覽／串流、生命週期輔助工具、輸出身分、酬載規劃、持久傳送，以及訊息傳送情境輔助工具。請參閱頻道輸出 API。
plugin-sdk/channel-messageplugin-sdk/channel-outbound 的已棄用相容性別名，加上舊版回覆派送 facade。
plugin-sdk/channel-message-runtimeplugin-sdk/channel-outbound 的已棄用相容性別名，加上舊版回覆派送 facade。
plugin-sdk/inbound-envelope共用輸入路由與信封建構器輔助工具
plugin-sdk/inbound-reply-dispatch已棄用的相容性 facade。輸入執行器與派送述詞請使用 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已棄用的相容性 facade。請使用 plugin-sdk/channel-outbound。
plugin-sdk/outbound-runtime已棄用的相容性 facade。請使用 plugin-sdk/channel-outbound。
plugin-sdk/poll-runtime精簡輪詢正規化輔助工具
plugin-sdk/thread-bindings-runtime對話串繫結生命週期與配接器輔助工具
plugin-sdk/agent-media-payloadAgent 媒體酬載根目錄與載入器
plugin-sdk/conversation-runtime已棄用的寬泛 conversation/thread 繫結、配對與已設定繫結輔助工具桶；請優先使用聚焦的繫結子路徑，例如 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-sdk/allowlist-config-edit允許清單設定編輯／讀取輔助工具
plugin-sdk/group-access已棄用的群組存取決策輔助工具；請使用 plugin-sdk/channel-ingress-runtime 的 resolveChannelMessageIngress
plugin-sdk/direct-dm、plugin-sdk/direct-dm-access已棄用的相容性 facade。請使用 plugin-sdk/channel-inbound。
plugin-sdk/direct-dm-guard-policy精簡直接 DM 加密前防護政策輔助工具
plugin-sdk/discord已棄用的 Discord 相容性 facade，用於已發布的 @openclaw/discord@2026.3.13 與受追蹤的擁有者相容性；新外掛應使用通用頻道 SDK 子路徑
plugin-sdk/telegram-account已棄用的 Telegram 帳號解析相容性 facade，用於受追蹤的擁有者相容性；新外掛應使用注入的執行階段輔助工具或通用頻道 SDK 子路徑
plugin-sdk/zalouser已棄用的 Zalo Personal 相容性 facade，用於仍匯入寄件者命令授權的已發布 Lark/Zalo 套件；新外掛應使用通用頻道 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已棄用的相容性 facade。請使用 plugin-sdk/channel-inbound 或 plugin-sdk/channel-outbound。
plugin-sdk/channel-pairing-paths已棄用的相容性 facade。請使用 plugin-sdk/channel-pairing。
plugin-sdk/channel-reply-options-runtime已棄用的相容性 facade。請使用 plugin-sdk/channel-outbound。
plugin-sdk/channel-streaming已棄用的相容性 facade。請使用 plugin-sdk/channel-outbound。
plugin-sdk/channel-send-result回覆結果型別
plugin-sdk/channel-actions頻道訊息動作輔助工具，加上為外掛相容性保留的已棄用原生結構描述輔助工具
plugin-sdk/channel-route共用路由正規化、剖析器驅動的目標解析、對話串 ID 字串化、去重／壓縮路由鍵、已解析目標型別，以及路由／目標比較輔助工具
plugin-sdk/channel-targets目標解析輔助工具；路由比較呼叫端應使用 plugin-sdk/channel-route
plugin-sdk/channel-contract頻道合約型別
plugin-sdk/channel-feedback回饋／反應接線
已棄用的頻道輔助工具系列僅為已發布外掛的相容性而保留。移除計畫是：在外部外掛遷移期間保留它們，讓 repo/ bundled 外掛維持使用 channel-inbound 和 channel-outbound，然後在下一次主要 SDK 清理中移除相容性子路徑。這適用於舊的頻道訊息/執行階段、頻道串流、直接 DM 存取、輸入輔助工具分支、回覆選項，以及配對路徑系列。
子路徑主要匯出
plugin-sdk/provider-entrydefineSingleProviderPluginEntry
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/provider-setup 或外掛自有的設定輔助工具
plugin-sdk/cli-backend命令列介面後端預設值 + 看門狗常數
plugin-sdk/provider-auth-runtime供應商驗證執行階段輔助工具：OAuth loopback 流程、權杖交換、驗證持久化與 API 金鑰解析
plugin-sdk/provider-oauth-runtime通用供應商 OAuth 回呼型別、回呼頁面呈現、PKCE／狀態輔助工具、授權輸入解析、權杖到期輔助工具與中止輔助工具
plugin-sdk/provider-auth-api-keyAPI 金鑰 onboarding／設定檔寫入輔助工具，例如 upsertApiKeyProfile
plugin-sdk/provider-auth-result標準 OAuth 驗證結果建構器
plugin-sdk/provider-env-vars供應商驗證環境變數查找輔助工具
plugin-sdk/provider-authcreateProviderApiKeyAuthMethod、ensureApiKeyFromOptionEnvOrPrompt、upsertAuthProfile、upsertApiKeyProfile、writeOAuthCredentials、OpenAI Codex 驗證匯入輔助工具、已棄用的 resolveOpenClawAgentDir 相容性匯出
plugin-sdk/provider-model-sharedProviderReplayFamily、buildProviderReplayFamilyHooks、normalizeModelCompat、共用重播政策建構器、供應商端點輔助工具與共用模型 ID 正規化輔助工具
plugin-sdk/provider-catalog-live-runtime即時供應商模型目錄輔助工具，用於受保護的 /models 風格探索：buildLiveModelProviderConfig、fetchLiveProviderModelRows、getCachedLiveProviderModelRows、fetchLiveProviderModelIds、LiveModelCatalogHttpError、clearLiveCatalogCacheForTests、模型 ID 篩選、TTL 快取與靜態備援
plugin-sdk/provider-catalog-runtime供應商目錄增強執行階段 hook 與外掛供應商登錄接縫，用於合約測試
plugin-sdk/provider-catalog-sharedfindCatalogTemplate、buildSingleProviderApiKeyCatalog、buildManifestModelProviderConfig、supportsNativeStreamingUsageCompat、applyProviderNativeStreamingUsageCompat
plugin-sdk/provider-http通用供應商 HTTP／端點能力輔助工具、供應商 HTTP 錯誤與音訊轉錄 multipart 表單輔助工具
plugin-sdk/provider-web-fetch-contract精簡的網頁擷取設定／選擇合約輔助工具，例如 enablePluginInConfig 與 WebFetchProviderPlugin
plugin-sdk/provider-web-fetch網頁擷取供應商註冊／快取輔助工具
plugin-sdk/provider-web-search-config-contract精簡的網頁搜尋設定／憑證輔助工具，適用於不需要外掛啟用接線的供應商
plugin-sdk/provider-web-search-contract精簡的網頁搜尋設定／憑證合約輔助工具，例如 createWebSearchProviderContractFields、enablePluginInConfig、resolveProviderWebSearchPluginConfig，以及具作用域的憑證 setter／getter
plugin-sdk/provider-web-search網頁搜尋供應商註冊／快取／執行階段輔助工具
plugin-sdk/embedding-providers一般嵌入供應商型別與讀取輔助工具，包括 EmbeddingProviderAdapter、getEmbeddingProvider(...) 與 listEmbeddingProviders(...)；外掛透過 api.registerEmbeddingProvider(...) 註冊供應商，因此會強制執行 manifest 擁有權
plugin-sdk/provider-toolsProviderToolCompatFamily、buildProviderToolCompatFamilyHooks，以及 DeepSeek／Gemini／OpenAI 結構描述清理 + 診斷
plugin-sdk/provider-usage供應商用量快照型別、共用用量擷取輔助工具，以及 fetchClaudeUsage 等供應商擷取器
plugin-sdk/provider-streamProviderStreamFamily、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原生供應商傳輸輔助工具，例如受保護的 fetch、工具結果文字擷取、傳輸訊息轉換與可寫入傳輸事件串流
plugin-sdk/provider-onboardOnboarding 設定修補輔助工具
plugin-sdk/global-singleton行程本機 singleton／map／cache 輔助工具
plugin-sdk/group-activation精簡群組啟用模式與命令解析輔助工具
供應商用量快照通常會報告一個或多個配額 windows，每個都包含 標籤、已使用百分比，以及選用的重設時間。若供應商公開的是餘額或 帳戶狀態文字，而不是可重設的配額視窗，應回傳 summary 並搭配空的 windows 陣列，而不是捏造百分比。 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原生核准能力／傳遞配接器
plugin-sdk/approval-gateway-runtime共用核准閘道解析輔助工具
plugin-sdk/approval-handler-adapter-runtime輕量原生核准配接器載入輔助工具，用於熱通道進入點
plugin-sdk/approval-handler-runtime較廣泛的核准處理器執行階段輔助工具；當較精簡的配接器／閘道接縫已足夠時，優先使用它們
plugin-sdk/approval-native-runtime原生核准目標、帳戶繫結、路由閘門、轉送備援，以及本機原生 exec 提示抑制輔助工具
plugin-sdk/approval-reaction-runtime硬編碼核准 reaction 綁定、reaction 提示 payload、reaction 目標儲存、reaction 提示文字輔助工具，以及本機原生 exec 提示抑制的相容性匯出
plugin-sdk/approval-reply-runtimeExec／外掛核准回覆 payload 輔助工具
plugin-sdk/approval-runtimeExec／外掛核准 payload 輔助工具、核准能力建構器、核准驗證／設定檔輔助工具、原生核准路由／執行階段輔助工具，以及結構化核准顯示輔助工具，例如 formatApprovalDisplayPath
plugin-sdk/reply-dedupe已棄用的精簡入站回覆去重重設輔助工具
plugin-sdk/command-auth-native原生命令驗證、動態引數選單格式化與原生工作階段目標輔助工具
plugin-sdk/command-detection共用命令偵測輔助工具
plugin-sdk/command-primitives-runtime輕量命令文字 predicate，用於熱通道路徑
plugin-sdk/command-surface命令本文正規化與命令介面輔助工具
plugin-sdk/allow-fromformatAllowFromLowercase
plugin-sdk/provider-auth-login-flow-runtime延遲供應商驗證登入流程輔助工具，用於私人通道與網頁 UI 裝置碼配對
plugin-sdk/channel-secret-runtime已棄用的廣泛秘密合約介面（collectSimpleChannelFieldAssignments、getChannelSurface、pushAssignment、秘密目標型別）；請優先使用下方聚焦的子路徑
plugin-sdk/channel-secret-basic-runtime精簡秘密合約匯出，用於非 TTS 通道／外掛秘密介面
plugin-sdk/channel-secret-tts-runtime精簡巢狀通道 TTS 秘密指派輔助工具
plugin-sdk/secret-ref-runtime精簡的 coerceSecretRef 與 SecretRef 型別輔助工具，用於秘密合約／設定解析
plugin-sdk/secret-provider-integration僅型別 SecretRef 供應商整合 manifest 與預設集合約，用於發布外部秘密供應商預設集的外掛
plugin-sdk/security-runtime已棄用的廣泛 barrel，涵蓋信任、DM 閘門、根目錄界定的檔案／路徑輔助工具（包括僅建立寫入）、同步／非同步原子檔案替換、同層暫存寫入、跨裝置移動備援、私有檔案儲存輔助工具、符號連結父層防護、外部內容、敏感文字遮蔽、常數時間秘密比較與秘密收集輔助工具；請優先使用聚焦的安全性／SSRF／秘密子路徑
plugin-sdk/ssrf-policy主機 allowlist 與私人網路 SSRF 政策輔助工具
plugin-sdk/ssrf-dispatcher精簡 pinned dispatcher 輔助工具，不含廣泛基礎設施執行階段介面
plugin-sdk/ssrf-runtimePinned dispatcher、SSRF 防護 fetch、SSRF 錯誤與 SSRF 政策輔助工具
plugin-sdk/secret-input秘密輸入解析輔助工具
plugin-sdk/webhook-ingress網路鉤子請求／目標輔助工具與原始 websocket／body 強制轉換
plugin-sdk/webhook-request-guards請求本文大小／逾時輔助工具
子路徑主要匯出
plugin-sdk/runtime執行階段、記錄、備份輔助工具、外掛安裝路徑警告，以及程序輔助工具
plugin-sdk/runtime-env精簡的執行階段環境、記錄器、逾時、重試，以及退避輔助工具
plugin-sdk/browser-config受支援的瀏覽器設定 facade，用於正規化設定檔/預設值、CDP URL 解析，以及瀏覽器控制驗證輔助工具
plugin-sdk/agent-harness-task-runtime適用於使用主機核發工作範圍的 harness-backed agent 的通用工作生命週期與完成交付輔助工具
plugin-sdk/codex-mcp-projection保留的內建 Codex 輔助工具，用於將使用者 MCP 伺服器設定投影到 Codex thread 設定；不適用於第三方外掛
plugin-sdk/codex-native-task-runtime儲存庫本機的內建 Codex 輔助工具，用於原生工作鏡像/執行階段接線；不是套件匯出
plugin-sdk/channel-runtime-context通用通道執行階段內容註冊與查找輔助工具
plugin-sdk/matrix已棄用的 Matrix 相容性 facade，供較舊的第三方通道套件使用；新外掛應直接匯入 plugin-sdk/run-command
plugin-sdk/mattermost已棄用的 Mattermost 相容性 facade，供較舊的第三方通道套件使用；新外掛應直接匯入通用 SDK 子路徑
plugin-sdk/runtime-storecreatePluginRuntimeStore
plugin-sdk/plugin-runtime已棄用的外掛命令、hook、HTTP、互動式輔助工具廣泛 barrel；建議改用聚焦的外掛執行階段子路徑
plugin-sdk/hook-runtime已棄用的網路鉤子/內部 hook 管線輔助工具廣泛 barrel；建議改用聚焦的 hook/外掛執行階段子路徑
plugin-sdk/lazy-runtime延遲執行階段匯入/繫結輔助工具，例如 createLazyRuntimeModule、createLazyRuntimeMethod 和 createLazyRuntimeSurface
plugin-sdk/process-runtime程序 exec 輔助工具
plugin-sdk/cli-runtime已棄用的命令列介面格式化、等待、版本、引數叫用，以及延遲命令群組輔助工具廣泛 barrel；建議改用聚焦的命令列介面/執行階段子路徑
plugin-sdk/qa-live-transport-scenarios共用即時傳輸 QA 情境 ID、基準覆蓋率輔助工具，以及情境選擇輔助工具
plugin-sdk/qa-runner-runtime受支援的 facade，透過命令列介面命令介面公開外掛 QA 情境
plugin-sdk/tts-runtime受支援的文字轉語音設定結構描述與執行階段輔助工具 facade
plugin-sdk/gateway-method-runtime保留的閘道方法分派輔助工具，供宣告 contracts.gatewayMethodDispatch: ["authenticated-request"] 的外掛 HTTP 路由使用
plugin-sdk/gateway-runtime閘道用戶端、事件迴圈就緒用戶端啟動輔助工具、閘道命令列介面 RPC、閘道協定錯誤、公告的 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 和測試快照 setter
plugin-sdk/text-autolink-runtime不透過廣泛 text barrel 的檔案參照自動連結偵測
plugin-sdk/reply-runtime共用傳入/回覆執行階段輔助工具、分塊、分派、心跳偵測、回覆規劃器
plugin-sdk/reply-dispatch-runtime精簡的回覆分派/完成與對話標籤輔助工具
plugin-sdk/reply-history共用短時間窗回覆歷史輔助工具。新的訊息回合程式碼應使用 createChannelHistoryWindow；較低階的 map 輔助工具仍僅作為已棄用的相容性匯出
plugin-sdk/reply-referencecreateReplyReferencePlanner
plugin-sdk/reply-chunking精簡文字/Markdown 分塊輔助工具
plugin-sdk/session-store-runtime工作階段工作流程輔助工具（getSessionEntry、listSessionEntries、patchSessionEntry、upsertSessionEntry）、依工作階段身分界定的近期使用者/助理逐字稿文字讀取、有界讀取、舊版工作階段儲存路徑/工作階段鍵輔助工具、updated-at 讀取，以及僅供轉換使用的整體儲存/檔案路徑相容性輔助工具，不包含廣泛設定寫入/維護匯入
plugin-sdk/session-transcript-runtime逐字稿身分、限定範圍的目標/讀取/寫入輔助工具、更新發布、寫入鎖，以及逐字稿記憶命中鍵
plugin-sdk/sqlite-runtime聚焦的 SQLite agent 結構描述、路徑與交易輔助工具，供第一方執行階段使用，不包含資料庫生命週期控制
plugin-sdk/cron-store-runtime排程儲存路徑/載入/儲存輔助工具
plugin-sdk/state-paths狀態/OAuth 目錄路徑輔助工具
plugin-sdk/plugin-state-runtime外掛 sidecar SQLite 鍵控狀態型別，加上外掛自有資料庫的集中式連線 pragma 與 WAL 維護設定
plugin-sdk/routing路由/工作階段鍵/帳號繫結輔助工具，例如 resolveAgentRoute、buildAgentSessionKey 和 resolveDefaultAgentBoundAccountId
plugin-sdk/status-helpers共用通道/帳號狀態摘要輔助工具、執行階段狀態預設值，以及議題中繼資料輔助工具
plugin-sdk/target-resolver-runtime共用目標解析器輔助工具
plugin-sdk/string-normalization-runtimeSlug/字串正規化輔助工具
plugin-sdk/request-url從類 fetch/request 輸入擷取字串 URL
plugin-sdk/run-command具逾時功能的命令執行器，提供正規化的 stdout/stderr 結果
plugin-sdk/param-readers常用工具/命令列介面參數讀取器
plugin-sdk/tool-plugin定義簡單的具型別 agent 工具外掛，並公開靜態中繼資料供 manifest 產生使用
plugin-sdk/tool-payload從工具結果物件擷取正規化 payload
plugin-sdk/tool-send從工具引數擷取標準 send 目標欄位
plugin-sdk/sandbox沙盒後端型別與 SSH/OpenShell 命令輔助工具，包含快速失敗的 exec 命令預檢
plugin-sdk/temp-path共用暫存下載路徑輔助工具與私有安全暫存工作區
plugin-sdk/logging-core子系統記錄器與遮蔽輔助工具
plugin-sdk/markdown-table-runtimeMarkdown 表格模式與轉換輔助工具
plugin-sdk/model-session-runtime模型/工作階段覆寫輔助工具，例如 applyModelOverrideToSessionEntry 和 resolveAgentMaxConcurrent
plugin-sdk/talk-config-runtimeTalk 供應商設定解析輔助工具
plugin-sdk/json-store小型 JSON 狀態讀取/寫入輔助工具
plugin-sdk/json-unsafe-integers將不安全整數常值保留為字串的 JSON 解析輔助工具
plugin-sdk/file-lock可重入檔案鎖輔助工具
plugin-sdk/persistent-dedupe磁碟支援的去重快取輔助工具
plugin-sdk/acp-runtimeACP 執行階段/工作階段與回覆分派輔助工具
plugin-sdk/acp-runtime-backend輕量 ACP 後端註冊與回覆分派輔助工具，供啟動時載入的外掛使用
plugin-sdk/acp-binding-resolve-runtime不含生命週期啟動匯入的唯讀 ACP 繫結解析
plugin-sdk/agent-config-primitives已棄用的 agent 執行階段設定結構描述 primitive；請從維護中的外掛自有介面匯入結構描述 primitive
plugin-sdk/boolean-param寬鬆布林參數讀取器
plugin-sdk/dangerous-name-runtime危險名稱比對解析輔助工具
plugin-sdk/device-bootstrap裝置 bootstrap 與配對權杖輔助工具
plugin-sdk/extension-shared共用被動通道、狀態與 ambient 代理輔助 primitive
plugin-sdk/models-provider-runtime/models 命令/供應商回覆輔助工具
plugin-sdk/skill-commands-runtimeSkill 命令清單輔助工具
plugin-sdk/native-command-registry原生命令登錄/建置/序列化輔助工具
plugin-sdk/agent-harness實驗性的受信任外掛介面，用於低階 agent harness：harness 型別、active-run steering/abort 輔助工具、OpenClaw 工具橋接輔助工具、runtime-plan 工具政策輔助工具、終端結果分類、工具進度格式化/詳細資料輔助工具，以及 attempt 結果工具
plugin-sdk/provider-zai-endpoint已棄用的 Z.AI 供應商自有端點偵測 facade；請使用 Z.AI 外掛公開 API
plugin-sdk/async-lock-runtime程序本機 async lock 輔助工具，適用於小型執行階段狀態檔案
plugin-sdk/channel-activity-runtime通道活動遙測輔助工具
plugin-sdk/concurrency-runtime有界 async 工作並行輔助工具
plugin-sdk/dedupe-runtime記憶體內與 persistent-backed 去重快取輔助工具
plugin-sdk/delivery-queue-runtime外送待處理交付 drain 輔助工具
plugin-sdk/file-access-runtime安全本機檔案與媒體來源路徑輔助工具
plugin-sdk/heartbeat-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-runtimeExec 核准政策檔案輔助工具，不含廣泛 infra-runtime barrel
plugin-sdk/infra-runtime已棄用的相容性 shim；請使用上述聚焦的執行階段子路徑
plugin-sdk/collection-runtime小型有界快取輔助工具
plugin-sdk/diagnostic-runtime診斷旗標、事件與 trace-context 輔助工具
plugin-sdk/error-runtime錯誤圖、格式化、共用錯誤分類輔助工具、isApprovalNotFoundError
plugin-sdk/fetch-runtime包裝過的 fetch、代理、EnvHttpProxyAgent 選項，以及固定 lookup 輔助工具
plugin-sdk/runtime-fetch感知 dispatcher 的執行階段 fetch，不含代理/guarded-fetch 匯入
plugin-sdk/inline-image-data-url-runtime行內圖片 data URL 清理器與簽章 sniffing 輔助工具，不含廣泛 media runtime 介面
plugin-sdk/response-limit-runtime有界 response-body 讀取器，不含廣泛 media runtime 介面
plugin-sdk/session-binding-runtime目前對話繫結狀態，不含已設定的繫結路由或配對儲存
plugin-sdk/context-visibility-runtime內容可見性解析與補充內容篩選，不含廣泛設定/安全性匯入
plugin-sdk/string-coerce-runtime精簡 primitive record/字串強制轉換與正規化輔助工具，不含 Markdown/記錄匯入
plugin-sdk/host-runtime主機名稱與 SCP 主機正規化輔助工具
plugin-sdk/retry-runtime重試設定與重試執行器輔助工具
plugin-sdk/agent-runtime已棄用的 agent 目錄/身分/工作區輔助工具廣泛 barrel，包含 resolveAgentDir、resolveDefaultAgentDir，以及已棄用的 resolveOpenClawAgentDir 相容性匯出；建議改用聚焦的 agent/執行階段子路徑
plugin-sdk/directory-runtime設定支援的目錄查詢/去重
plugin-sdk/keyed-async-queueKeyedAsyncQueue
子路徑主要匯出
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-sdk/video-generation影片生成提供者/請求/結果型別
plugin-sdk/video-generation-core共用的影片生成型別、容錯移轉輔助工具、提供者查找與模型參照剖析
plugin-sdk/transcripts共用的逐字稿來源提供者型別、登錄表輔助工具、工作階段描述元與語句中繼資料
plugin-sdk/webhook-targets網路鉤子目標登錄表與路由安裝輔助工具
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儲存庫內部的最小 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儲存庫內部的外掛套件、註冊、公開成品、直接匯入、執行階段 API 與匯入副作用合約輔助工具
plugin-sdk/plugin-state-test-runtime儲存庫內部的外掛狀態儲存區、入口佇列與狀態 DB 測試輔助工具
plugin-sdk/provider-test-contracts儲存庫內部的提供者執行階段、驗證、探索、上線、目錄、精靈、媒體能力、重播政策、即時 STT 現場音訊、網頁搜尋/擷取與串流合約輔助工具
plugin-sdk/provider-http-test-mocks儲存庫內部可選用的 Vitest HTTP/驗證模擬，用於測試會操作 plugin-sdk/provider-http 的提供者
plugin-sdk/reply-payload-testing用於將中繼資料附加到回覆酬載夾具的儲存庫內部輔助工具
plugin-sdk/sqlite-runtime-testing第一方測試用的儲存庫內部 SQLite 生命週期輔助工具
plugin-sdk/test-fixtures儲存庫內部的通用命令列介面執行階段擷取、沙箱情境、技能寫入器、代理訊息、系統事件、模組重新載入、隨附外掛路徑、終端文字、分塊、驗證權杖與型別化案例夾具
plugin-sdk/test-node-mocks儲存庫內部聚焦的 Node 內建模擬輔助工具，用於 Vitest vi.mock("node:*") 工廠內
子路徑主要匯出
plugin-sdk/memory-core已棄用的相容性別名；請使用 plugin-sdk/memory-host-core
plugin-sdk/memory-core-engine-runtime已棄用的記憶索引/搜尋執行階段外觀；建議使用供應商中立的 memory-host 子路徑
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已棄用的記憶主機多模態輔助工具；建議使用供應商中立的 memory-host 子路徑
plugin-sdk/memory-core-host-query已棄用的記憶主機查詢輔助工具；建議使用供應商中立的 memory-host 子路徑
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記憶主機命令列介面執行階段輔助工具
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供記憶相鄰外掛使用的共用受管理 Markdown 輔助工具
plugin-sdk/memory-host-search用於存取搜尋管理器的主動記憶執行階段外觀
plugin-sdk/memory-host-status已棄用的相容性別名；請使用 plugin-sdk/memory-core-host-status
保留的隨附輔助工具 SDK 子路徑，是面向隨附外掛程式碼的精簡擁有者特定介面。它們會在 SDK 清單中追蹤，讓套件建置與別名保持確定性，但它們不是一般外掛作者 API。新的可重用主機合約應使用通用 SDK 子路徑，例如 plugin-sdk/gateway-runtime、plugin-sdk/ssrf-runtime 與 plugin-sdk/plugin-config-runtime。
子路徑擁有者與用途
plugin-sdk/codex-mcp-projection隨附 Codex 外掛輔助工具，用於將使用者 MCP 伺服器設定投影到 Codex app-server 執行緒設定中（保留的套件匯出）
plugin-sdk/codex-native-task-runtime隨附 Codex 外掛輔助工具，用於將 Codex app-server 原生子代理鏡像到 OpenClaw 工作狀態中（僅限儲存庫內部，不是套件匯出）

​
相關