Сумісність Plugin

​

Реєстр сумісності

• стабільний код сумісності
• статус: active, deprecated, removal-pending або removed
• власника: sdk, config, setup, channel, provider, plugin-execution, agent-runtime або core
• дати впровадження та застарівання, якщо застосовно
• рекомендації щодо заміни
• документацію, діагностику й тести, що охоплюють стару та нову поведінку

​

Політика застарівання

1. Додайте новий контракт.
2. Збережіть стару поведінку через іменований адаптер сумісності.
3. Виводьте діагностичні повідомлення або попередження, коли автори плагінів можуть вжити заходів.
4. Задокументуйте заміну та часові межі.
5. Тестуйте як старий, так і новий шляхи.
6. Дочекайтеся завершення оголошеного періоду міграції.
7. Видаляйте лише з явним схваленням випуску з несумісними змінами.

​

Поточні сфери сумісності

• застарілі широкі імпорти SDK, як-от openclaw/plugin-sdk/compat
• застарілі форми плагінів лише з перехоплювачами та before_agent_start
• застарілі назви перехоплювачів очищення api.on("deactivate", ...), поки плагіни переходять на gateway_stop
• застарілі точки входу плагінів activate(api), поки плагіни переходять на register(api)
• застарілі псевдоніми SDK, як-от openclaw/extension-api, openclaw/plugin-sdk/channel-runtime, побудовники стану openclaw/plugin-sdk/command-auth, openclaw/plugin-sdk/test-utils (замінено спеціалізованими тестовими підшляхами openclaw/plugin-sdk/*), а також псевдоніми типів ClawdbotConfig / OpenClawSchemaType
• список дозволених вбудованих плагінів і поведінка їх увімкнення
• застарілі метадані маніфесту змінних середовища провайдера/каналу
• застарілі перехоплювачі плагінів провайдерів і псевдоніми типів, поки провайдери переходять на явні перехоплювачі каталогу, автентифікації, міркування, повторного відтворення та транспорту
• застарілі псевдоніми середовища виконання, як-от api.runtime.taskFlow, api.runtime.subagent.getSession, api.runtime.stt, і застарілі api.runtime.config.loadConfig() / api.runtime.config.writeConfigFile(...)
• плоскі поля зворотного виклику WhatsApp WebInboundMessage (див. нижче)
• поля допуску верхнього рівня WhatsApp WebInboundMessage (див. нижче)
• застаріла розділена реєстрація плагінів пам’яті, поки плагіни пам’яті переходять на registerMemoryCapability
• застаріла реєстрація провайдера вбудовувань, специфічна для пам’яті, поки провайдери вбудовувань переходять на api.registerEmbeddingProvider(...) і contracts.embeddingProviders
• застарілі допоміжні засоби SDK каналів для нативних схем повідомлень, фільтрації згадок, форматування вхідних конвертів і вкладення можливостей схвалення
• застарілі псевдоніми ключа маршруту каналу та допоміжного засобу порівняння цілей, поки плагіни переходять на openclaw/plugin-sdk/channel-route
• підказки активації, які замінюються належністю внесків маніфесту
• резервний шлях середовища виконання setup-api, поки дескриптори налаштування переходять на статичні метадані setup.requiresRuntime: false
• перехоплювачі discovery провайдера, поки перехоплювачі каталогу провайдера переходять на catalog.run(...)
• метадані каналів showConfigured / showInSetup, поки пакети каналів переходять на openclaw.channel.exposure
• застарілі ключі конфігурації політики середовища виконання, поки Doctor переводить операторів на agentRuntime
• резервні згенеровані метадані конфігурації вбудованих каналів, поки впроваджуються метадані channelConfigs, що насамперед використовують реєстр
• змінні середовища для вимкнення збереженого реєстру плагінів і міграції встановлень, поки процеси виправлення переводять операторів на openclaw plugins registry --refresh і openclaw doctor --fix
• застарілі шляхи конфігурації вебпошуку, отримання вебресурсів і x_search, що належать плагінам, поки Doctor переносить їх до plugins.entries.<plugin>.config
• застаріла авторська конфігурація plugins.installs і псевдоніми шляхів завантаження вбудованих плагінів, поки метадані встановлення переносяться до керованого станом журналу плагінів

​

Плоскі псевдоніми вхідних зворотних викликів WhatsApp

• id, timestamp та isBatched переміщуються до event.
• body, mediaPath, mediaType, mediaFileName, mediaUrl, location та untrustedStructuredContext переміщуються до payload.
• to, chatId, поля відправника/власного користувача, sendComposing, reply(...) і sendMedia(...) переміщуються до platform.
• поля replyTo* переміщуються до quote; поля теми групи/учасника/згадки переміщуються до group.

​

Поля допуску вхідних повідомлень WhatsApp

• from і conversationId переміщуються до admission.conversation.id.
• accountId переміщується до admission.accountId.
• accessControlPassed є похідним поданням сумісності для admission.ingress.decision === "allow"; у повідомленнях, які вже містять admission, запис застарілого логічного значення не переписує граф вхідного допуску.
• chatType переміщується до admission.conversation.kind.

​

Пакет інспектора плагінів

openclaw-plugin-inspector ./my-plugin

​

Приймальний контур для супроводжувачів

pnpm crabbox:run -- --provider blacksmith-testbox --timing-json --shell -- "pnpm install && pnpm build && npm exec --yes @openclaw/plugin-inspector@0.1.0 -- ./extensions/telegram --json"
pnpm crabbox:run -- --provider blacksmith-testbox --timing-json --shell -- "npm exec --yes @openclaw/plugin-inspector@0.1.0 -- ./extensions/discord --json"
pnpm crabbox:run -- --provider blacksmith-testbox --timing-json --shell -- "npm exec --yes @openclaw/plugin-inspector@0.1.0 -- <clawhub-plugin-dir> --json"

​

Примітки до випуску