Plugin の互換性

​

互換性レジストリ

• 安定した互換性コード
• ステータス: active、deprecated、removal-pending、または removed
• オーナー: sdk、config、setup、channel、provider、plugin-execution、 agent-runtime、または core
• 該当する場合の導入日と非推奨日
• 置き換えガイダンス
• 古い動作と新しい動作をカバーするドキュメント、診断、テスト

​

非推奨ポリシー

1. 新しい契約を追加する。
2. 古い動作を名前付きの互換性アダプターを通じて接続したままにする。
3. Plugin 作者が対応できる場合は、診断または警告を出力する。
4. 置き換えとタイムラインを文書化する。
5. 古いパスと新しいパスの両方をテストする。
6. 告知された移行期間が経過するまで待つ。
7. 明示的な破壊的リリース承認がある場合にのみ削除する。

​

現在の互換性領域

• openclaw/plugin-sdk/compat などのレガシーな広範 SDK インポート
• レガシーなフック専用 Plugin 形状と before_agent_start
• Plugin が gateway_stop へ移行する間のレガシーな api.on("deactivate", ...) クリーンアップフック名
• Plugin が register(api) へ移行する間のレガシーな activate(api) Plugin エントリーポイント
• openclaw/extension-api、 openclaw/plugin-sdk/channel-runtime、openclaw/plugin-sdk/command-auth ステータスビルダー、openclaw/plugin-sdk/test-utils (焦点を絞った openclaw/plugin-sdk/* テストサブパスに置き換え)、および ClawdbotConfig / OpenClawSchemaType 型エイリアスなどのレガシー SDK エイリアス
• バンドル済み Plugin の許可リストと有効化動作
• レガシーなプロバイダー/チャネル env-var マニフェストメタデータ
• プロバイダーが明示的なカタログ、認証、思考、リプレイ、トランスポートフックへ移行する間の、レガシーなプロバイダー Plugin フックと型エイリアス
• api.runtime.taskFlow、 api.runtime.subagent.getSession、api.runtime.stt、および非推奨の api.runtime.config.loadConfig() / api.runtime.config.writeConfigFile(...) などのレガシーランタイムエイリアス
• WhatsApp WebInboundMessage のフラットなコールバックフィールド (下記参照)
• WhatsApp WebInboundMessage のトップレベル入場フィールド (下記参照)
• メモリ Plugin が registerMemoryCapability へ移行する間のレガシーなメモリ Plugin 分割登録
• 埋め込みプロバイダーが api.registerEmbeddingProvider(...) と contracts.embeddingProviders へ移行する間の、レガシーなメモリ固有の埋め込みプロバイダー登録
• ネイティブメッセージスキーマ、メンションゲート、インバウンドエンベロープ整形、承認ケイパビリティのネストのためのレガシーチャネル SDK ヘルパー
• Plugin が openclaw/plugin-sdk/channel-route へ移行する間の、レガシーチャネルルートキーと比較可能ターゲットヘルパーのエイリアス
• マニフェストのコントリビューション所有権に置き換えられるアクティベーションヒント
• セットアップ記述子がコールドな setup.requiresRuntime: false メタデータへ移行する間の setup-api ランタイムフォールバック
• プロバイダーカタログフックが catalog.run(...) へ移行する間のプロバイダー discovery フック
• チャネルパッケージが openclaw.channel.exposure へ移行する間のチャネル showConfigured / showInSetup メタデータ
• Doctor がオペレーターを agentRuntime へ移行する間のレガシーランタイムポリシー設定キー
• レジストリ優先の channelConfigs メタデータが導入される間の、生成されたバンドル済みチャネル設定メタデータフォールバック
• 修復フローがオペレーターを openclaw plugins registry --refresh と openclaw doctor --fix へ移行する間の、永続化された Plugin レジストリ無効化およびインストール移行 env フラグ
• Doctor がそれらを plugins.entries.<plugin>.config へ移行する間の、レガシーな Plugin 所有の web search、web fetch、x_search 設定パス
• インストールメタデータが状態管理の Plugin 台帳へ移動する間の、レガシーな plugins.installs 作成済み設定とバンドル済み Plugin ロードパスエイリアス

​

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 を保持するメッセージでは、レガシー boolean に書き込んでも ingress グラフは書き換えられません。
• chatType は admission.conversation.kind へ移動します。

​

Plugin インスペクターパッケージ

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"

​

リリースノート