Skip to main content
Plugin SDK には、限定された公開サブパスと、openclaw/plugin-sdk/ 配下のリポジトリ専用バンドル ヘルパーが含まれています。このページでは両方を一覧化し、 private-local のエントリを明示的に示します。境界は次の 3 ファイルで定義されます。
  • scripts/lib/plugin-sdk-entrypoints.json: ビルドでコンパイルされる、保守対象のエントリポイント一覧。
  • scripts/lib/plugin-sdk-private-local-only-subpaths.json: 型付きで文書化された SDK から 除外される内部サブパス。本番用エントリは、別途公開される公式 Plugin 向けに JavaScript 専用のホストランタイムエクスポートとして引き続き利用できますが、 テスト専用エントリはエクスポートされません。
  • src/plugin-sdk/entrypoints.ts: 非推奨 サブパス、予約済みバンドルヘルパー、サポート対象のバンドルファサード、および Plugin 所有の公開サーフェスに関する分類メタデータ。
メンテナーは pnpm plugin-sdk:surface で公開エクスポート数を、 pnpm plugins:boundary-report:summary で使用中の予約済みヘルパーサブパスを監査します。 未使用の予約済みヘルパーエクスポートは、休眠中の互換性負債として 公開 SDK に残るのではなく、CI レポートを失敗させます。 Plugin 作成ガイドについては、Plugin SDK の概要を参照してください。

Plugin エントリ

互換性ヘルパーと private-local ヘルパー

後期期間の非推奨サブパスのみが引き続きエクスポートされます。2026 年 7 月のエイリアスと 未使用のサブパスは削除され、バンドル専用ヘルパーは 公開パッケージから削除されて、以下で private-local として示されています。保守対象のリストは scripts/lib/plugin-sdk-deprecated-public-subpaths.json です。CI はバンドルされた plugin-sdk/text-runtime を拒否します。これらは互換性専用であり、plugin-sdk/zod は 互換性再エクスポートです。zodzod から直接インポートしてください。広範なドメイン バレル plugin-sdk/agent-runtimeplugin-sdk/channel-lifecycleplugin-sdk/conversation-runtimeplugin-sdk/hook-runtimeplugin-sdk/media-runtimeplugin-sdk/plugin-runtime、および plugin-sdk/security-runtime も同様に、対象を限定した サブパスを優先するため非推奨です。 OpenClaw の Vitest ベースのテストヘルパーサブパスはリポジトリローカル専用であり、 パッケージからはエクスポートされなくなりました: agent-runtime-test-contractschannel-contract-testingchannel-target-testingchannel-test-helpersplugin-state-test-runtimeplugin-test-apiplugin-test-contractsplugin-test-runtimeprovider-http-test-mocksprovider-test-contractsreply-payload-testingsqlite-runtime-testingtest-envtest-fixturestest-livetest-live-authtest-media-generationtest-media-understandingtest-node-mocks、および testing。非公開のバンドルヘルパーサーフェス ssrf-runtime-internalcodex-native-task-runtime もリポジトリローカル 専用です。

バンドル Plugin ヘルパーのサブパス

バンドル専用ヘルパーモジュールは、2026 年 7 月の整理以降 private-local です。所有者をまたぐインポートは、パッケージ契約のガードレールによってブロックされます。src/plugin-sdk/entrypoints.ts は、引き続き公開されるサポート対象のバンドルファサードを別途追跡します。これらは、汎用契約が plugin-sdk/qa-runner-runtimeplugin-sdk/telegram-account を置き換えるまで、対応するバンドル Plugin によって実装される SDK エントリポイントであり、新規コードでは非推奨です。以下の各行の注記を参照してください。
後期期間のチャンネル互換性サブパスは、それぞれの レジストリ日付までのみ公開されたままです。ダイレクト DM アクセス、返信オプション、ペアリング パス、チャンネルランタイムの分割サブパスなど、7 月のエイリアスは削除され、バンドル専用ヘルパーは private-local になりました。
プロバイダー使用量スナップショットは通常、1つ以上のクォータ windows を報告し、それぞれに ラベル、使用率、任意のリセット時刻が含まれます。リセット可能なクォータ期間ではなく残高または アカウント状態のテキストを公開するプロバイダーは、パーセンテージを捏造せず、空の windows 配列を持つ summary を返す必要があります。 OpenClaw はその概要テキストをステータス出力に表示します。使用量エンドポイントが失敗した場合、または 利用可能な使用量データを返さなかった場合にのみ error を使用してください。
予約済みバンドルヘルパー SDK サブパスは、バンドルされた Plugin コード向けの、所有者固有の対象を絞ったサーフェスです。 パッケージのビルドとエイリアス処理を決定的に保つため SDK インベントリで追跡されますが、一般的な Plugin 作成 API ではありません。 新しい再利用可能なホスト契約には、plugin-sdk/gateway-runtimeplugin-sdk/ssrf-runtime などの汎用 SDK サブパスを使用してください。

関連項目