Міграція SDK плагінів

OpenClaw перейшов від широкого шару зворотної сумісності до сучасної архітектури плагінів зі сфокусованими, задокументованими імпортами. Якщо ваш плагін було створено до появи нової архітектури, цей посібник допоможе вам виконати міграцію.

Що змінюється

Стара система плагінів надавала дві надто широкі поверхні, які дозволяли плагінам імпортувати все, що їм потрібно, з єдиної точки входу:

openclaw/plugin-sdk/compat — єдиний імпорт, який повторно експортував десятки допоміжних засобів. Його було запроваджено, щоб старі плагіни на основі хуків продовжували працювати, поки будувалася нова архітектура плагінів.
openclaw/extension-api — міст, який надавав плагінам прямий доступ до допоміжних засобів на стороні хоста, як-от вбудований запускальник агента.

Обидві поверхні тепер застарілі. Вони досі працюють під час виконання, але нові плагіни не повинні їх використовувати, а наявним плагінам слід перейти на нові механізми до того, як у наступному великому випуску їх буде видалено.

Шар зворотної сумісності буде видалено в одному з майбутніх великих випусків. Плагіни, які все ще імпортують із цих поверхонь, перестануть працювати, коли це станеться.

Чому це змінилося

Старий підхід спричиняв проблеми:

Повільний запуск — імпорт одного допоміжного засобу завантажував десятки не пов’язаних між собою модулів
Циклічні залежності — широкі повторні експорти спрощували створення циклів імпорту
Неясна поверхня API — не було способу зрозуміти, які експорти є стабільними, а які внутрішніми

Сучасний SDK плагінів вирішує це: кожен шлях імпорту (openclaw/plugin-sdk/\<subpath\>) є невеликим, самодостатнім модулем із чітким призначенням і задокументованим контрактом. Застарілі зручні шви провайдера для вбудованих каналів також зникли. Імпорти на кшталт openclaw/plugin-sdk/slack, openclaw/plugin-sdk/discord, openclaw/plugin-sdk/signal, openclaw/plugin-sdk/whatsapp, допоміжні шви з брендингом каналів і openclaw/plugin-sdk/telegram-core були приватними скороченнями для монорепозиторію, а не стабільними контрактами плагінів. Натомість використовуйте вузькі загальні підшляхи SDK. Усередині вбудованого робочого простору плагінів зберігайте допоміжні засоби, що належать провайдеру, у власному api.ts або runtime-api.ts цього плагіна. Поточні приклади вбудованих провайдерів:

Anthropic зберігає допоміжні засоби потокової передачі, специфічні для Claude, у власному шві api.ts / contract-api.ts
OpenAI зберігає конструктори провайдерів, допоміжні засоби для моделей за замовчуванням і конструктори провайдерів реального часу у власному api.ts
OpenRouter зберігає конструктор провайдера та допоміжні засоби для онбордингу/конфігурації у власному api.ts

Як виконати міграцію

Перевірте резервну поведінку обгортки Windows

Якщо ваш плагін використовує openclaw/plugin-sdk/windows-spawn, невизначені обгортки Windows .cmd/.bat тепер завершуються без резервного варіанта, якщо ви явно не передасте allowShellFallback: true.

// Before
const program = applyWindowsSpawnProgramPolicy({ candidate });

// After
const program = applyWindowsSpawnProgramPolicy({
  candidate,
  // Only set this for trusted compatibility callers that intentionally
  // accept shell-mediated fallback.
  allowShellFallback: true,
});

Якщо ваш викликаючий код не покладається навмисно на резервний варіант через оболонку, не встановлюйте allowShellFallback і натомість обробіть викинуту помилку.

Знайдіть застарілі імпорти

Знайдіть у своєму плагіні імпорти з будь-якої із застарілих поверхонь:

grep -r "plugin-sdk/compat" my-plugin/
grep -r "openclaw/extension-api" my-plugin/

Замініть їх на сфокусовані імпорти

Кожен експорт зі старої поверхні відповідає певному сучасному шляху імпорту:

// Before (deprecated backwards-compatibility layer)
import {
  createChannelReplyPipeline,
  createPluginRuntimeStore,
  resolveControlCommandGate,
} from "openclaw/plugin-sdk/compat";

// After (modern focused imports)
import { createChannelReplyPipeline } from "openclaw/plugin-sdk/channel-reply-pipeline";
import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
import { resolveControlCommandGate } from "openclaw/plugin-sdk/command-auth";

Для допоміжних засобів на стороні хоста використовуйте впроваджене середовище виконання плагіна замість прямого імпорту:

// Before (deprecated extension-api bridge)
import { runEmbeddedPiAgent } from "openclaw/extension-api";
const result = await runEmbeddedPiAgent({ sessionId, prompt });

// After (injected runtime)
const result = await api.runtime.agent.runEmbeddedPiAgent({ sessionId, prompt });

Такий самий шаблон застосовується до інших застарілих допоміжних засобів мосту:

Старий імпорт	Сучасний еквівалент
`resolveAgentDir`	`api.runtime.agent.resolveAgentDir`
`resolveAgentWorkspaceDir`	`api.runtime.agent.resolveAgentWorkspaceDir`
`resolveAgentIdentity`	`api.runtime.agent.resolveAgentIdentity`
`resolveThinkingDefault`	`api.runtime.agent.resolveThinkingDefault`
`resolveAgentTimeoutMs`	`api.runtime.agent.resolveAgentTimeoutMs`
`ensureAgentWorkspace`	`api.runtime.agent.ensureAgentWorkspace`
допоміжні засоби сховища сесій	`api.runtime.agent.session.*`

Зберіть і протестуйте

pnpm build
pnpm test -- my-plugin/

Довідник шляхів імпорту

Таблиця поширених шляхів імпорту

Шлях імпорту	Призначення	Ключові експорти
`plugin-sdk/plugin-entry`	Канонічний допоміжний засіб точки входу плагіна	`definePluginEntry`
`plugin-sdk/core`	Застарілий узагальнений повторний експорт для визначень/конструкторів точок входу каналів	`defineChannelPluginEntry`, `createChatChannelPlugin`
`plugin-sdk/config-schema`	Експорт кореневої схеми конфігурації	`OpenClawSchema`
`plugin-sdk/provider-entry`	Допоміжний засіб точки входу для одного провайдера	`defineSingleProviderPluginEntry`
`plugin-sdk/channel-core`	Сфокусовані визначення та конструктори точок входу каналів	`defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase`
`plugin-sdk/setup`	Спільні допоміжні засоби майстра налаштування	Запити списку дозволених, конструктори стану налаштування
`plugin-sdk/setup-runtime`	Допоміжні засоби середовища виконання для етапу налаштування	Безпечні для імпорту адаптери патчів налаштування, допоміжні засоби приміток пошуку, `promptResolvedAllowFrom`, `splitSetupEntries`, делеговані проксі налаштування
`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`, нормалізація ідентифікатора облікового запису
`plugin-sdk/account-resolution`	Допоміжні засоби пошуку облікового запису	Допоміжні засоби пошуку облікового запису + резервного значення за замовчуванням
`plugin-sdk/account-helpers`	Вузькі допоміжні засоби для облікових записів	Допоміжні засоби списку облікових записів/дій з обліковими записами
`plugin-sdk/channel-setup`	Адаптери майстра налаштування	`createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, а також `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries`
`plugin-sdk/channel-pairing`	Примітиви прив’язування DM	`createChannelPairingController`
`plugin-sdk/channel-reply-pipeline`	Налаштування префікса відповіді та індикатора набору	`createChannelReplyPipeline`
`plugin-sdk/channel-config-helpers`	Фабрики адаптерів конфігурації	`createHybridChannelConfigAdapter`
`plugin-sdk/channel-config-schema`	Конструктори схем конфігурації	Типи схем конфігурації каналу
`plugin-sdk/telegram-command-config`	Допоміжні засоби конфігурації команд Telegram	Нормалізація назв команд, обрізання описів, перевірка дублікатів/конфліктів
`plugin-sdk/channel-policy`	Визначення політики груп/DM	`resolveChannelGroupRequireMention`
`plugin-sdk/channel-lifecycle`	Відстеження стану облікового запису	`createAccountStatusSink`
`plugin-sdk/inbound-envelope`	Допоміжні засоби для вхідного конверта	Спільні допоміжні засоби маршруту + побудови конверта
`plugin-sdk/inbound-reply-dispatch`	Допоміжні засоби вхідних відповідей	Спільні допоміжні засоби запису та диспетчеризації
`plugin-sdk/messaging-targets`	Розбір цілей повідомлень	Допоміжні засоби розбору/зіставлення цілей
`plugin-sdk/outbound-media`	Допоміжні засоби вихідних медіа	Спільне завантаження вихідних медіа
`plugin-sdk/outbound-runtime`	Допоміжні засоби середовища виконання вихідних повідомлень	Допоміжні засоби вихідної ідентичності/делегата надсилання
`plugin-sdk/thread-bindings-runtime`	Допоміжні засоби прив’язок потоків	Життєвий цикл прив’язок потоків і допоміжні засоби адаптера
`plugin-sdk/agent-media-payload`	Застарілі допоміжні засоби медіанавантаження	Конструктор медіанавантаження агента для застарілих макетів полів
`plugin-sdk/channel-runtime`	Застарілий shim сумісності	Лише застарілі утиліти середовища виконання каналу
`plugin-sdk/channel-send-result`	Типи результатів надсилання	Типи результатів відповіді
`plugin-sdk/runtime-store`	Постійне сховище плагіна	`createPluginRuntimeStore`
`plugin-sdk/runtime`	Широкі допоміжні засоби середовища виконання	Допоміжні засоби runtime/логування/резервного копіювання/встановлення плагіна
`plugin-sdk/runtime-env`	Вузькі допоміжні засоби оточення runtime	Допоміжні засоби логера/оточення runtime, таймаутів, повторів і backoff
`plugin-sdk/plugin-runtime`	Спільні допоміжні засоби runtime плагіна	Допоміжні засоби команд/хуків/http/інтерактивної взаємодії плагіна
`plugin-sdk/hook-runtime`	Допоміжні засоби конвеєра хуків	Спільні допоміжні засоби конвеєра webhook/внутрішніх хуків
`plugin-sdk/lazy-runtime`	Допоміжні засоби відкладеного runtime	`createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeMethodBinder`, `createLazyRuntimeNamedExport`, `createLazyRuntimeSurface`
`plugin-sdk/process-runtime`	Допоміжні засоби процесів	Спільні допоміжні засоби exec
`plugin-sdk/cli-runtime`	Допоміжні засоби CLI runtime	Форматування команд, очікування, допоміжні засоби версій
`plugin-sdk/gateway-runtime`	Допоміжні засоби gateway	Клієнт gateway і допоміжні засоби патчів стану каналу
`plugin-sdk/config-runtime`	Допоміжні засоби конфігурації	Допоміжні засоби завантаження/запису конфігурації
`plugin-sdk/telegram-command-config`	Допоміжні засоби команд Telegram	Допоміжні засоби перевірки команд Telegram зі стабільним резервним варіантом, коли поверхня контракту вбудованого Telegram недоступна
`plugin-sdk/approval-runtime`	Допоміжні засоби запитів на погодження	Навантаження погодження exec/плагіна, допоміжні засоби можливостей/профілю погодження, нативна маршрутизація/середовище виконання погодження
`plugin-sdk/approval-auth-runtime`	Допоміжні засоби автентифікації погодження	Визначення затверджувача, автентифікація дій у тому самому чаті
`plugin-sdk/approval-client-runtime`	Допоміжні засоби клієнта погодження	Допоміжні засоби профілю/фільтра нативного погодження exec
`plugin-sdk/approval-delivery-runtime`	Допоміжні засоби доставки погодження	Адаптери можливостей/доставки нативного погодження
`plugin-sdk/approval-native-runtime`	Допоміжні засоби цілей погодження	Допоміжні засоби прив’язування цілей/облікових записів нативного погодження
`plugin-sdk/approval-reply-runtime`	Допоміжні засоби відповідей на погодження	Допоміжні засоби навантаження відповіді погодження exec/плагіна
`plugin-sdk/security-runtime`	Допоміжні засоби безпеки	Спільні допоміжні засоби довіри, шлюзування DM, зовнішнього вмісту та збирання секретів
`plugin-sdk/ssrf-policy`	Допоміжні засоби політики SSRF	Допоміжні засоби списку дозволених хостів і політики приватної мережі
`plugin-sdk/ssrf-runtime`	Допоміжні засоби SSRF runtime	Закріплений dispatcher, guarded fetch, допоміжні засоби політики SSRF
`plugin-sdk/collection-runtime`	Допоміжні засоби обмеженого кешу	`pruneMapToMaxSize`
`plugin-sdk/diagnostic-runtime`	Допоміжні засоби шлюзування діагностики	`isDiagnosticFlagEnabled`, `isDiagnosticsEnabled`
`plugin-sdk/error-runtime`	Допоміжні засоби форматування помилок	`formatUncaughtError`, `isApprovalNotFoundError`, допоміжні засоби графа помилок
`plugin-sdk/fetch-runtime`	Допоміжні засоби обгорнутого fetch/proxy	`resolveFetch`, допоміжні засоби proxy
`plugin-sdk/host-runtime`	Допоміжні засоби нормалізації хоста	`normalizeHostname`, `normalizeScpRemoteHost`
`plugin-sdk/retry-runtime`	Допоміжні засоби повтору	`RetryConfig`, `retryAsync`, виконавці політик
`plugin-sdk/allow-from`	Форматування списку дозволених	`formatAllowFromLowercase`
`plugin-sdk/allowlist-resolution`	Мапування вхідних даних списку дозволених	`mapAllowlistResolutionInputs`
`plugin-sdk/command-auth`	Допоміжні засоби шлюзування команд і поверхні команд	`resolveControlCommandGate`, допоміжні засоби авторизації відправника, допоміжні засоби реєстру команд
`plugin-sdk/secret-input`	Розбір секретного вводу	Допоміжні засоби секретного вводу
`plugin-sdk/webhook-ingress`	Допоміжні засоби запитів webhook	Утиліти цілей webhook
`plugin-sdk/webhook-request-guards`	Допоміжні засоби захисту запитів webhook	Допоміжні засоби читання/обмеження тіла запиту
`plugin-sdk/reply-runtime`	Спільне середовище виконання відповіді	Вхідна диспетчеризація, heartbeat, планувальник відповіді, розбиття на частини
`plugin-sdk/reply-dispatch-runtime`	Вузькі допоміжні засоби диспетчеризації відповіді	Допоміжні засоби фіналізації + диспетчеризації провайдера
`plugin-sdk/reply-history`	Допоміжні засоби історії відповідей	`buildHistoryContext`, `buildPendingHistoryContextFromMap`, `recordPendingHistoryEntry`, `clearHistoryEntriesIfEnabled`
`plugin-sdk/reply-reference`	Планування посилань на відповіді	`createReplyReferencePlanner`
`plugin-sdk/reply-chunking`	Допоміжні засоби розбиття відповіді	Допоміжні засоби розбиття тексту/markdown
`plugin-sdk/session-store-runtime`	Допоміжні засоби сховища сесій	Допоміжні засоби шляху сховища + updated-at
`plugin-sdk/state-paths`	Допоміжні засоби шляхів стану	Допоміжні засоби каталогів стану та OAuth
`plugin-sdk/routing`	Допоміжні засоби маршрутизації/ключів сесії	`resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId`, допоміжні засоби нормалізації ключа сесії
`plugin-sdk/status-helpers`	Допоміжні засоби стану каналу	Конструктори зведень стану каналу/облікового запису, типові значення runtime-state, допоміжні засоби метаданих проблем
`plugin-sdk/target-resolver-runtime`	Допоміжні засоби визначення цілей	Спільні допоміжні засоби визначення цілей
`plugin-sdk/string-normalization-runtime`	Допоміжні засоби нормалізації рядків	Допоміжні засоби нормалізації slug/рядків
`plugin-sdk/request-url`	Допоміжні засоби URL запитів	Витяг рядкових URL із request-подібних вхідних даних
`plugin-sdk/run-command`	Допоміжні засоби команд із таймаутом	Виконавець команд із таймаутом і нормалізованими stdout/stderr
`plugin-sdk/param-readers`	Зчитувачі параметрів	Поширені зчитувачі параметрів інструментів/CLI
`plugin-sdk/tool-send`	Витягування надсилання інструмента	Витяг канонічних полів цілі надсилання з аргументів інструмента
`plugin-sdk/temp-path`	Допоміжні засоби тимчасових шляхів	Спільні допоміжні засоби шляху тимчасового завантаження
`plugin-sdk/logging-core`	Допоміжні засоби логування	Логер підсистеми й допоміжні засоби редагування
`plugin-sdk/markdown-table-runtime`	Допоміжні засоби markdown-таблиць	Допоміжні засоби режиму markdown-таблиць
`plugin-sdk/reply-payload`	Типи відповідей повідомлень	Типи навантаження відповіді
`plugin-sdk/provider-setup`	Кураторські допоміжні засоби налаштування локальних/self-hosted провайдерів	Допоміжні засоби виявлення/конфігурації self-hosted провайдерів
`plugin-sdk/self-hosted-provider-setup`	Сфокусовані допоміжні засоби налаштування self-hosted провайдерів, сумісних з OpenAI	Ті самі допоміжні засоби виявлення/конфігурації self-hosted провайдерів
`plugin-sdk/provider-auth-runtime`	Допоміжні засоби runtime-автентифікації провайдера	Допоміжні засоби визначення API-ключа під час виконання
`plugin-sdk/provider-auth-api-key`	Допоміжні засоби налаштування API-ключа провайдера	Допоміжні засоби онбордингу/запису профілю API-ключа
`plugin-sdk/provider-auth-result`	Допоміжні засоби результату автентифікації провайдера	Стандартний конструктор результату OAuth-автентифікації
`plugin-sdk/provider-auth-login`	Допоміжні засоби інтерактивного входу провайдера	Спільні допоміжні засоби інтерактивного входу
`plugin-sdk/provider-env-vars`	Допоміжні засоби змінних середовища провайдера	Допоміжні засоби пошуку auth env vars провайдера
`plugin-sdk/provider-model-shared`	Спільні допоміжні засоби моделі/повторного відтворення провайдера	`ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні конструктори політики повторного відтворення, допоміжні засоби endpoint провайдера та нормалізації ідентифікатора моделі
`plugin-sdk/provider-catalog-shared`	Спільні допоміжні засоби каталогу провайдера	`findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat`
`plugin-sdk/provider-onboard`	Патчі онбордингу провайдера	Допоміжні засоби конфігурації онбордингу
`plugin-sdk/provider-http`	Допоміжні засоби HTTP провайдера	Загальні допоміжні засоби можливостей HTTP/endpoint провайдера
`plugin-sdk/provider-web-fetch`	Допоміжні засоби web-fetch провайдера	Допоміжні засоби реєстрації/кешу провайдера web-fetch
`plugin-sdk/provider-web-search`	Допоміжні засоби web-search провайдера	Допоміжні засоби реєстрації/кешу/конфігурації провайдера web-search
`plugin-sdk/provider-tools`	Допоміжні засоби сумісності інструментів/схем провайдера	`ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схеми Gemini + діагностика та допоміжні засоби сумісності xAI, такі як `resolveXaiModelCompatPatch` / `applyXaiModelCompat`
`plugin-sdk/provider-usage`	Допоміжні засоби використання провайдера	`fetchClaudeUsage`, `fetchGeminiUsage`, `fetchGithubCopilotUsage` та інші допоміжні засоби використання провайдера
`plugin-sdk/provider-stream`	Допоміжні засоби обгортки потоку провайдера	`ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи обгорток потоку та спільні допоміжні засоби обгорток Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot
`plugin-sdk/keyed-async-queue`	Упорядкована асинхронна черга	`KeyedAsyncQueue`
`plugin-sdk/media-runtime`	Спільні допоміжні засоби медіа	Допоміжні засоби отримання/перетворення/зберігання медіа плюс конструктори медіанавантаження
`plugin-sdk/media-understanding`	Допоміжні засоби media-understanding	Типи провайдера media understanding плюс орієнтовані на провайдера експорти допоміжних засобів зображень/аудіо
`plugin-sdk/text-runtime`	Спільні допоміжні засоби тексту	Видалення видимого для асистента тексту, рендеринг/розбиття/таблиці markdown, редагування, допоміжні засоби тегів директив, утиліти безпечного тексту та пов’язані допоміжні засоби тексту/логування
`plugin-sdk/text-chunking`	Допоміжні засоби розбиття тексту	Допоміжний засіб розбиття вихідного тексту
`plugin-sdk/speech`	Допоміжні засоби speech	Типи speech-провайдера плюс орієнтовані на провайдера допоміжні засоби директив, реєстру та перевірки
`plugin-sdk/speech-core`	Спільне ядро speech	Типи speech-провайдера, реєстр, директиви, нормалізація
`plugin-sdk/realtime-transcription`	Допоміжні засоби транскрипції в реальному часі	Типи провайдера та допоміжні засоби реєстру
`plugin-sdk/realtime-voice`	Допоміжні засоби голосу в реальному часі	Типи провайдера та допоміжні засоби реєстру
`plugin-sdk/image-generation-core`	Спільне ядро генерації зображень	Допоміжні засоби типів, failover, auth і реєстру для генерації зображень
`plugin-sdk/video-generation`	Допоміжні засоби генерації відео	Типи провайдера/запиту/результату генерації відео
`plugin-sdk/video-generation-core`	Спільне ядро генерації відео	Допоміжні засоби типів генерації відео, failover, пошуку провайдера та розбору model-ref
`plugin-sdk/interactive-runtime`	Допоміжні засоби інтерактивних відповідей	Нормалізація/скорочення навантаження інтерактивних відповідей
`plugin-sdk/channel-config-primitives`	Примітиви конфігурації каналу	Вузькі примітиви schema конфігурації каналу
`plugin-sdk/channel-config-writes`	Допоміжні засоби запису конфігурації каналу	Допоміжні засоби авторизації запису конфігурації каналу
`plugin-sdk/channel-plugin-common`	Спільна преамбула каналу	Експорти спільної преамбули плагіна каналу
`plugin-sdk/channel-status`	Допоміжні засоби стану каналу	Спільні допоміжні засоби знімка/зведення стану каналу
`plugin-sdk/allowlist-config-edit`	Допоміжні засоби конфігурації списку дозволених	Допоміжні засоби редагування/читання конфігурації списку дозволених
`plugin-sdk/group-access`	Допоміжні засоби доступу до груп	Спільні допоміжні засоби рішень щодо доступу до груп
`plugin-sdk/direct-dm`	Допоміжні засоби прямих DM	Спільні допоміжні засоби auth/guard для прямих DM
`plugin-sdk/extension-shared`	Спільні допоміжні засоби розширення	Примітиви допоміжних засобів пасивного каналу/стану
`plugin-sdk/webhook-targets`	Допоміжні засоби цілей webhook	Реєстр цілей webhook і допоміжні засоби встановлення маршрутів
`plugin-sdk/webhook-path`	Допоміжні засоби шляху webhook	Допоміжні засоби нормалізації шляху webhook
`plugin-sdk/web-media`	Спільні допоміжні засоби web media	Допоміжні засоби завантаження віддалених/локальних медіа
`plugin-sdk/zod`	Повторний експорт Zod	Повторно експортований `zod` для споживачів SDK плагінів
`plugin-sdk/memory-core`	Вбудовані допоміжні засоби memory-core	Поверхня допоміжних засобів memory manager/config/file/CLI
`plugin-sdk/memory-core-engine-runtime`	Фасад runtime рушія memory	Фасад runtime індексування/пошуку memory
`plugin-sdk/memory-core-host-engine-foundation`	Базовий рушій memory для хоста	Експорти базового рушія memory для хоста
`plugin-sdk/memory-core-host-engine-embeddings`	Рушій embeddings memory для хоста	Експорти рушія embeddings memory для хоста
`plugin-sdk/memory-core-host-engine-qmd`	Рушій QMD memory для хоста	Експорти рушія QMD memory для хоста
`plugin-sdk/memory-core-host-engine-storage`	Рушій зберігання memory для хоста	Експорти рушія зберігання memory для хоста
`plugin-sdk/memory-core-host-multimodal`	Багатомодальні допоміжні засоби memory для хоста	Багатомодальні допоміжні засоби memory для хоста
`plugin-sdk/memory-core-host-query`	Допоміжні засоби запитів memory для хоста	Допоміжні засоби запитів memory для хоста
`plugin-sdk/memory-core-host-secret`	Допоміжні засоби секретів memory для хоста	Допоміжні засоби секретів memory для хоста
`plugin-sdk/memory-core-host-status`	Допоміжні засоби стану memory для хоста	Допоміжні засоби стану memory для хоста
`plugin-sdk/memory-core-host-runtime-cli`	CLI runtime memory для хоста	Допоміжні засоби CLI runtime memory для хоста
`plugin-sdk/memory-core-host-runtime-core`	Базовий runtime memory для хоста	Допоміжні засоби базового runtime memory для хоста
`plugin-sdk/memory-core-host-runtime-files`	Допоміжні засоби файлів/runtime memory для хоста	Допоміжні засоби файлів/runtime memory для хоста
`plugin-sdk/memory-lancedb`	Вбудовані допоміжні засоби memory-lancedb	Поверхня допоміжних засобів memory-lancedb
`plugin-sdk/testing`	Утиліти тестування	Допоміжні засоби тестування та mock-об’єкти

Ця таблиця навмисно містить поширену підмножину для міграції, а не повну поверхню SDK. Повний список із понад 200 точок входу міститься у scripts/lib/plugin-sdk-entrypoints.json. Цей список усе ще містить деякі допоміжні шви вбудованих плагінів, як-от plugin-sdk/feishu, plugin-sdk/feishu-setup, plugin-sdk/zalo, plugin-sdk/zalo-setup і plugin-sdk/matrix*. Вони й далі експортуються для підтримки вбудованих плагінів і сумісності, але навмисно не включені до таблиці поширеної міграції й не є рекомендованою ціллю для нового коду плагінів. Те саме правило застосовується до інших сімейств вбудованих допоміжних засобів, таких як:

допоміжні засоби підтримки браузера: plugin-sdk/browser-cdp, plugin-sdk/browser-config-support, plugin-sdk/browser-control-auth, plugin-sdk/browser-profiles, plugin-sdk/browser-support
Matrix: plugin-sdk/matrix*
LINE: plugin-sdk/line*
IRC: plugin-sdk/irc*
поверхні вбудованих допоміжних засобів/плагінів, як-от plugin-sdk/googlechat, plugin-sdk/zalouser, plugin-sdk/bluebubbles*, plugin-sdk/mattermost*, plugin-sdk/msteams, plugin-sdk/nextcloud-talk, plugin-sdk/nostr, plugin-sdk/tlon, plugin-sdk/twitch, plugin-sdk/github-copilot-login, plugin-sdk/github-copilot-token, plugin-sdk/diagnostics-otel, plugin-sdk/diffs, plugin-sdk/llm-task, plugin-sdk/thread-ownership і plugin-sdk/voice-call

plugin-sdk/github-copilot-token наразі надає вузьку поверхню допоміжних засобів токена: DEFAULT_COPILOT_API_BASE_URL, deriveCopilotApiBaseUrlFromToken і resolveCopilotApiToken. Використовуйте найвужчий імпорт, який відповідає задачі. Якщо ви не можете знайти експорт, перегляньте джерело в src/plugin-sdk/ або запитайте в Discord.

Хронологія видалення

Коли	Що відбувається
Зараз	Застарілі поверхні видають попередження під час виконання
Наступний великий випуск	Застарілі поверхні буде видалено; плагіни, які все ще їх використовують, перестануть працювати

Усі основні плагіни вже мігрували. Зовнішнім плагінам слід виконати міграцію до наступного великого випуску.

Тимчасове приглушення попереджень

Установіть ці змінні середовища, поки ви працюєте над міграцією:

OPENCLAW_SUPPRESS_PLUGIN_SDK_COMPAT_WARNING=1 openclaw gateway run
OPENCLAW_SUPPRESS_EXTENSION_API_WARNING=1 openclaw gateway run

Це тимчасовий обхідний шлях, а не постійне рішення.

Пов’язане

Початок роботи — створіть свій перший плагін
Огляд SDK — повний довідник імпортів за підшляхами
Плагіни каналів — створення плагінів каналів
Плагіни провайдерів — створення плагінів провайдерів
Внутрішня будова плагінів — детальний розбір архітектури
Маніфест плагіна — довідник схеми маніфесту

Overview

Plugins

Skills

Automation & Tasks

Tools

Agent coordination

Міграція SDK плагінів

Міграція SDK плагінів

Що змінюється

Чому це змінилося

Як виконати міграцію

Довідник шляхів імпорту

Хронологія видалення

Тимчасове приглушення попереджень

Пов’язане

Overview

Plugins

Skills

Automation & Tasks

Tools

Agent coordination

​Міграція SDK плагінів

​Що змінюється

​Чому це змінилося

​Як виконати міграцію

​Довідник шляхів імпорту

​Хронологія видалення

​Тимчасове приглушення попереджень

​Пов’язане

Міграція SDK плагінів

Що змінюється

Чому це змінилося

Як виконати міграцію

Довідник шляхів імпорту

Хронологія видалення

Тимчасове приглушення попереджень

Пов’язане