Plugin SDK の移行

OPENCLAW_DOCS_MARKER:accordionOpen:IHRpdGxlPSJjb21tYW5kLWF1dGgg44OY44Or44OX44OT44Or44OA44O8IC0 command-status"> 旧 (openclaw/plugin-sdk/command-auth): buildCommandsMessage、 buildCommandsMessagePaginated、buildHelpMessage。

新 (openclaw/plugin-sdk/command-status): シグネチャも エクスポートも同じです。より限定的なサブパスからインポートする点だけが異なります。command-auth は これらを互換スタブとして再エクスポートします。

// 変更前import { buildHelpMessage } from "openclaw/plugin-sdk/command-auth"; // 変更後import { buildHelpMessage } from "openclaw/plugin-sdk/command-status";

OPENCLAW_DOCS_MARKER:accordionOpen:IHRpdGxlPSLjg6Hjg7Pjgrfjg6fjg7PjgrLjg7zjg4bjgqPjg7PjgrDjg5jjg6vjg5Hjg7wgLQ resolveInboundMentionDecision"> 旧: openclaw/plugin-sdk/channel-inbound または openclaw/plugin-sdk/channel-mention-gating の resolveMentionGating(params) と resolveMentionGatingWithBypass(params)。

新: resolveInboundMentionDecision({ facts, policy })。分割された 2 つの呼び出し形式ではなく、 1 つの判定オブジェクトを使用します。

Discord、iMessage、Matrix、MS Teams、QQBot、Signal、 Telegram、WhatsApp、Zalo で採用されています。Slack 独自の app_mention イベントモデルでは、 このヘルパーを使用しません。

OPENCLAW_DOCS_MARKER:accordionOpen:IHRpdGxlPSJXZWIg5qSc57Si44OX44Ot44OQ44Kk44OA44O844GuIHRvb2woKSDjg5jjg6vjg5Hjg7wgLQ Plugin の createTool()"> 旧: openclaw/plugin-sdk/provider-web-search の tool() ファクトリー。

新: プロバイダー Plugin に createTool(...) を直接実装します。 OpenClaw では、ツールラッパーを登録するための SDK ヘルパーが不要になりました。

OPENCLAW_DOCS_MARKER:accordionOpen:IHRpdGxlPSLjg5fjg6zjg7zjg7Pjg4bjgq3jgrnjg4jjga7jg4Hjg6Pjg7Pjg43jg6vjgqjjg7Pjg5njg63jg7zjg5cgLQ BodyForAgent"> 旧: 受信チャンネルメッセージからフラットな プレーンテキストプロンプトエンベロープを構築するための api.runtime.channel.reply.formatInboundEnvelope(...) （および受信メッセージオブジェクトの channelEnvelope フィールド）。

新: BodyForAgent と構造化されたユーザーコンテキストブロック。チャンネル Plugin は、ルーティングメタデータ（スレッド、トピック、返信先、リアクション）を プロンプト文字列に連結するのではなく、型付きフィールドとして添付します。 formatAgentEnvelope(...) ヘルパーは、合成された アシスタント向けエンベロープでは引き続きサポートされますが、受信プレーンテキストエンベロープは 廃止予定です。

影響を受ける領域: inbound_claim、message_received、および旧エンベロープテキストを 後処理していたすべてのカスタム チャンネル Plugin。

OPENCLAW_DOCS_MARKER:accordionOpen:IHRpdGxlPSJkZWFjdGl2YXRlIOODleODg-OCryAt gateway_stop"> 旧: api.on("deactivate", handler)。

新: api.on("gateway_stop", handler)。シャットダウン時のクリーンアップ コントラクトは同じで、フック名のみが変わります。

// 変更前api.on("deactivate", async (event, ctx) => {  await stopPluginService(ctx);}); // 変更後api.on("gateway_stop", async (event, ctx) => {  await stopPluginService(ctx);});

deactivate は、2026-08-16 より後に削除されるまで、 非推奨の互換性エイリアスとして引き続き接続されています。

OPENCLAW_DOCS_MARKER:accordionOpen:IHRpdGxlPSJzdWJhZ2VudF9zcGF3bmluZyDjg5Xjg4Pjgq8gLQ コアスレッドバインディング"> 旧: threadBindingReady または deliveryOrigin を返す api.on("subagent_spawning", handler)。

新: チャンネルセッションバインディングアダプターを介して、コアが thread: true サブエージェントバインディングを準備するようにします。 api.on("subagent_spawned", handler) は、起動後の監視にのみ使用してください。

// 変更前api.on("subagent_spawning", async () => ({  status: "ok",  threadBindingReady: true,  deliveryOrigin: { channel: "discord", to: "channel:123", threadId: "456" },})); // 変更後api.on("subagent_spawned", async (event) => {  await observeSubagentLaunch(event);});

subagent_spawning、PluginHookSubagentSpawningEvent、 PluginHookSubagentSpawningResult、SubagentLifecycleHookRunner.runSubagentSpawning(...) は、 外部 Plugin の移行中に限り非推奨の互換性サーフェスとして残り、 2026-08-30 より後に削除されます。

OPENCLAW_DOCS_MARKER:accordionOpen:IHRpdGxlPSLmgJ3ogIPjg53jg6rjgrfjg7zjg5Xjg4Pjgq8gLQ resolveThinkingProfile"> 旧（ProviderThinkingPolicy 上の 3 つの個別フック）: isBinaryThinking(ctx)、supportsXHighThinking(ctx)、 resolveDefaultThinkingLevel(ctx)。

新: 標準の id、任意の label、 およびランク付けされたレベル一覧を含む ProviderThinkingProfile を返す単一の resolveThinkingProfile(ctx)。 OpenClaw は、保存済みの古い値をプロファイルランクに基づいて自動的にダウングレードします。

コンテキストには、provider、modelId、任意のマージ済み reasoning、 および任意のマージ済みモデル compat の情報が含まれます。プロバイダー Plugin は、 設定されたリクエストコントラクトが対応している場合にのみ、これらのカタログ情報を使用して モデル固有のプロファイルを公開できます。

3 つではなく 1 つのフックを実装してください。従来のフックは 非推奨期間中も引き続き動作しますが、プロファイル結果とは合成されません。

OPENCLAW_DOCS_MARKER:accordionOpen:IHRpdGxlPSLlpJbpg6joqo3oqLzjg5fjg63jg5DjgqTjg4Djg7wgLQ contracts.externalAuthProviders"> 旧: Plugin マニフェストでプロバイダーを宣言せずに、 外部認証フックを実装します。

新: Plugin マニフェストで contracts.externalAuthProviders を宣言 し、かつ resolveExternalAuthProfiles(...) を実装します。

{  "contracts": {    "externalAuthProviders": ["anthropic", "openai"]  }}

OPENCLAW_DOCS_MARKER:accordionOpen:IHRpdGxlPSLjg5fjg63jg5DjgqTjg4Djg7znkrDlooPlpInmlbDmpJzntKIgLQ setup.providers[].envVars"> 旧マニフェストフィールド: providerAuthEnvVars: { anthropic: ["ANTHROPIC_API_KEY"] }。

新: 同じ環境変数検索をマニフェストの setup.providers[].envVars に 反映します。これにより、セットアップとステータスの環境メタデータが 1 か所に統合され、 環境変数検索に応答するだけのために Plugin ランタイムを起動する必要がなくなります。

providerAuthEnvVars は、非推奨期間が終了するまで 互換性アダプターを通じて引き続きサポートされます。

OPENCLAW_DOCS_MARKER:accordionOpen:IHRpdGxlPSLjg6Hjg6Ljg6ogUGx1Z2luIOeZu-mMsiAt registerMemoryCapability"> 旧: 3 つの個別呼び出し — api.registerMemoryPromptSection(...)、 api.registerMemoryFlushPlan(...)、api.registerMemoryRuntime(...)。

新: メモリ状態 API での 1 回の呼び出し — registerMemoryCapability(pluginId, { promptBuilder, flushPlanResolver, runtime })。

スロットは同じで、登録呼び出しは 1 回です。追加のプロンプトおよびコーパスヘルパー （registerMemoryPromptSupplement、registerMemoryCorpusSupplement）には 影響しません。

OPENCLAW_DOCS_MARKER:accordionOpen:IHRpdGxlPSLnlJ_jga7jg4Hjg6Pjg7Pjg43jg6vpgIHkv6HntZDmnpwgLQ OutboundDeliveryResult"> 旧: ChannelSendRawResult を通じて { ok, messageId, error } を返し、 createRawChannelSendResultAdapter(...) で正規化します。

新: OutboundDeliveryResult フィールドを返し、 createAttachedChannelResultAdapter(...) でチャンネルを付加します。送信失敗時は、 エラー文字列を返すのではなく例外をスローする必要があります。生の結果型は、次の Plugin SDK メジャーリリースまで引き続き利用できます。

OPENCLAW_DOCS_MARKER:accordionOpen:IHRpdGxlPSJydW50aW1lLnRhc2tzLmZsb3cgLQ runtime.tasks.managedFlows"> 旧: runtime.tasks.flow（単数形）は、ライブのタスクフロー アクセサーを返していました。

新: runtime.tasks.managedFlows は、フローから子タスクを作成、更新、キャンセル、または実行するPlugin向けに、 管理対象TaskFlowの変更ランタイムを維持します。PluginでDTOベースの 読み取りのみが必要な場合は、runtime.tasks.flows を使用してください。

// 変更前const flow = api.runtime.tasks.flow.fromToolContext(ctx);// 変更後const flow = api.runtime.tasks.managedFlows.fromToolContext(ctx);

2026-07-26以降に削除されます。

OPENCLAW_DOCS_MARKER:accordionOpen:IHRpdGxlPSLln4vjgoHovrzjgb_mi6HlvLXjg5XjgqHjgq_jg4jjg6ogLQ エージェントのツール結果ミドルウェア"> 上記の移行方法で説明しています。完全を期すため、ここにも記載します。 削除された埋め込みランナー専用の api.registerEmbeddedExtensionFactory(...) パスは、 contracts.agentToolResultMiddleware 内の明示的なランタイムリストを使用する api.registerAgentToolResultMiddleware(...) に置き換えられます。

OPENCLAW_DOCS_MARKER:accordionOpen:IHRpdGxlPSJPcGVuQ2xhd1NjaGVtYVR5cGXjgqjjgqTjg6rjgqLjgrkgLQ OpenClawConfig"> openclaw/plugin-sdk から再エクスポートされる OpenClawSchemaType は現在、 OpenClawConfig に対する1行のエイリアスです。正規の名前を使用してください。

// 変更前import type { OpenClawSchemaType } from "openclaw/plugin-sdk";// 変更後import type { OpenClawConfig } from "openclaw/plugin-sdk/config-schema";