ネイティブ Codex Plugin

ネイティブ Codex Plugin サポートにより、Codex モードの OpenClaw エージェントは、OpenClaw ターンを処理する同じ Codex スレッド内で、Codex app-server 独自のアプリと Plugin 機能を使用できます。

OpenClaw は Codex Plugin を合成 codex_plugin_* OpenClaw 動的ツールに変換しません。Plugin 呼び出しはネイティブ Codex トランスクリプト内に残り、アプリに裏付けられた MCP 実行は Codex app-server が所有します。

ベースの Codex ハーネス が動作してからこのページを使用してください。

要件

• 選択した OpenClaw エージェントランタイムはネイティブ Codex ハーネスである必要があります。
• plugins.entries.codex.enabled は true である必要があります。
• plugins.entries.codex.config.codexPlugins.enabled は true である必要があります。
• V1 は、移行によってソース Codex ホームにソースインストール済みとして観測された openai-curated Plugin のみをサポートします。
• ターゲットの Codex app-server は、期待されるマーケットプレイス、Plugin、アプリのインベントリを参照できる必要があります。

codexPlugins は、OpenClaw 実行、通常の OpenAI プロバイダー実行、ACP 会話バインディング、またはその他のハーネスには効果がありません。これらのパスは、ネイティブ apps 設定を持つ Codex app-server スレッドを作成しないためです。

OpenAI 側の Codex アクセス、アプリの可用性、ワークスペースのアプリ/Plugin 制御は、サインイン済みの Codex アカウントに由来します。OpenAI アカウントと管理モデルについては、ChatGPT プランで Codex を使用するを参照してください。

クイックスタート

ソース Codex ホームからの移行をプレビューします。

openclaw migrate codex --dry-run

ネイティブ Plugin アクティベーションを計画する前に、移行でソースアプリのアクセシビリティを確認したい場合は、厳格なソースアプリ検証を使用します。

openclaw migrate codex --dry-run --verify-plugin-apps

計画が適切に見えたら、移行を適用します。

openclaw migrate apply codex --yes

移行は、対象 Plugin に対して明示的な codexPlugins エントリを書き込み、選択された Plugin に対して Codex app-server plugin/install を呼び出します。一般的な移行後の設定は次のようになります。

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          codexPlugins: {            enabled: true,            allow_destructive_actions: true,            plugins: {              "google-calendar": {                enabled: true,                marketplaceName: "openai-curated",                pluginName: "google-calendar",              },            },          },        },      },    },  },}

codexPlugins を変更した後、新しい Codex 会話は更新されたアプリセットを自動的に取り込みます。現在の会話を更新するには /new または /reset を使用します。Plugin の有効化または無効化の変更に Gateway の再起動は必要ありません。

チャットから Plugin を管理する

Codex ハーネスを操作している同じチャットから、設定済みのネイティブ Codex Plugin を確認または変更したい場合は、/codex plugins を使用します。

/codex plugins/codex plugins list/codex plugins disable google-calendar/codex plugins enable google-calendar

/codex plugins は /codex plugins list のエイリアスです。リスト出力には、plugins.entries.codex.config.codexPlugins.plugins からの設定済み Plugin キー、オン/オフ状態、Codex Plugin 名、マーケットプレイスが表示されます。

enable と disable は ~/.openclaw/openclaw.json の OpenClaw 設定にのみ書き込みます。~/.codex/config.toml を編集したり、新しい Codex Plugin をインストールしたりしません。Plugin の状態を変更できるのは、所有者または operator.admin スコープを持つ Gateway クライアントのみです。

設定済み Plugin を有効化すると、グローバルな codexPlugins.enabled スイッチもオンになります。移行が auth_required を返したため Plugin が無効として書き込まれた場合は、OpenClaw で有効化する前に Codex でアプリを再認可してください。

ネイティブ Plugin セットアップの仕組み

この統合には 3 つの個別の状態があります。

• インストール済み: Codex は、ターゲット app-server ランタイム内にローカル Plugin バンドルを持っています。
• 有効: OpenClaw 設定は、Codex ハーネスターンで Plugin を利用可能にする意思があります。
• アクセス可能: Codex app-server は、Plugin のアプリエントリがアクティブなアカウントで利用可能であり、移行済み Plugin ID にマッピングできることを確認します。

移行は、永続的なインストール/適格性ステップです。計画中、OpenClaw はソース Codex plugin/read の詳細を読み取り、ソース Codex app-server アカウント応答が ChatGPT サブスクリプションアカウントであることを確認します。ChatGPT 以外のアカウント応答、または欠落したアカウント応答では、アプリに裏付けられた Plugin は codex_subscription_required でスキップされます。デフォルトでは、移行はソース app/list を呼び出しません。アカウントゲートを通過したアプリに裏付けられたソース Plugin は、ソースアプリアクセシビリティ検証なしで計画され、アカウント検索のトランスポート失敗は codex_account_unavailable でスキップされます。--verify-plugin-apps を指定すると、移行は新しいソース app/list スナップショットを取得し、ネイティブアクティベーションを計画する前に、所有されているすべてのアプリが存在し、有効で、アクセス可能であることを要求します。このモードでは、アカウント検索のトランスポート失敗はソースアプリインベントリゲートにフォールスルーします。ランタイムアプリインベントリは、移行後のターゲットセッションアクセシビリティチェックです。その後、Codex ハーネスセッションセットアップは、有効かつアクセス可能な Plugin アプリ用に制限的なスレッドアプリ設定を計算します。

スレッドアプリ設定は、OpenClaw が Codex ハーネスセッションを確立するとき、または古くなった Codex スレッドバインディングを置き換えるときに計算されます。ターンごとには再計算されないため、/codex plugins enable と /codex plugins disable は新しい Codex 会話に影響します。現在の会話で更新されたアプリセットを取り込みたい場合は、/new または /reset を使用してください。

V1 サポート境界

V1 は意図的に狭くなっています。

• ソース Codex app-server インベントリにすでにインストールされていた openai-curated Plugin のみが移行対象です。
• アプリに裏付けられたソース Plugin は、移行時のサブスクリプションゲートを通過する必要があります。--verify-plugin-apps はソースアプリインベントリゲートを追加します。サブスクリプションゲート付きのアカウントに加えて、検証モードでは、アクセス不可、無効、欠落したソースアプリ、またはソースアプリインベントリ更新失敗は、有効な設定エントリではなくスキップされた手動項目として報告されます。読み取れない Plugin 詳細は、ソースアプリインベントリゲートの前にスキップされます。
• 移行は marketplaceName と pluginName を持つ明示的な Plugin ID を書き込みます。ローカル marketplacePath キャッシュパスは書き込みません。
• codexPlugins.enabled はグローバルな有効化スイッチです。
• plugins["*"] ワイルドカードはなく、任意のインストール権限を付与する設定キーもありません。
• サポートされていないマーケットプレイス、キャッシュ済み Plugin バンドル、フック、Codex 設定ファイルは、手動レビュー用に移行レポートに保持されます。

アプリインベントリと所有権

OpenClaw は app-server app/list を通じて Codex アプリインベントリを読み取り、1 時間キャッシュし、古いエントリまたは欠落したエントリを非同期で更新します。キャッシュはメモリ内のみです。CLI または Gateway を再起動すると破棄され、OpenClaw は次の app/list 読み取りから再構築します。

移行とランタイムは別々のキャッシュキーを使用します。

• ソース移行検証は、ソース Codex ホームとソース app-server 起動オプションを使用します。これは --verify-plugin-apps が設定されている場合にのみ実行され、その計画実行のために新しいソース app/list 走査を強制します。
• ターゲットランタイムセットアップは、Codex スレッドアプリ設定を構築するときに、ターゲットエージェントの Codex app-server ID を使用します。Plugin アクティベーションはそのターゲットキャッシュキーを無効化し、その後 plugin/install の後に強制更新します。

Plugin アプリは、OpenClaw が安定した所有権を通じて移行済み Plugin にマッピングし直せる場合にのみ公開されます。

• Plugin 詳細からの正確なアプリ ID
• 既知の MCP サーバー名
• 一意で安定したメタデータ

表示名のみ、または曖昧な所有権は、次のインベントリ更新で所有権が証明されるまで除外されます。

スレッドアプリ設定

OpenClaw は Codex スレッドに制限的な config.apps パッチを注入します。_default は無効化され、有効化された移行済み Plugin が所有するアプリのみが有効化されます。

OpenClaw は、有効なグローバルまたは Plugin ごとの allow_destructive_actions ポリシーからアプリレベルの destructive_enabled を設定し、Codex がネイティブアプリツール注釈から破壊的ツールメタデータを強制するようにします。true、"auto"、"ask" は destructive_enabled: true を設定し、false は false に設定します。_default アプリ設定は open_world_enabled: false で無効化されます。有効化された Plugin アプリは open_world_enabled: true で出力されます。OpenClaw は個別の Plugin オープンワールドポリシーノブを公開せず、Plugin ごとの破壊的ツール名拒否リストも維持しません。

ツール承認モードは、Plugin アプリではデフォルトで自動です。そのため、非破壊的な読み取りツールは同一スレッドの承認 UI なしで実行できます。破壊的ツールは引き続き各アプリの destructive_enabled ポリシーによって制御されます。

破壊的アクションポリシー

移行済み Codex Plugin では、破壊的な Plugin elicitation はデフォルトで許可されますが、安全でないスキーマと曖昧な所有権は引き続き fail closed になります。

• グローバルな allow_destructive_actions のデフォルトは true です。
• Plugin ごとの allow_destructive_actions は、その Plugin についてグローバルポリシーを上書きします。
• ポリシーが false の場合、OpenClaw は決定論的な拒否を返します。
• ポリシーが true の場合、OpenClaw は、ブール値の承認フィールドなど、承認応答にマッピングできる安全なスキーマのみを自動承認します。
• ポリシーが "auto" の場合、OpenClaw は破壊的な Plugin アクションを Codex に公開しますが、所有権が証明された MCP 承認 elicitation を OpenClaw Plugin 承認に変換してから Codex 承認応答を返します。
• ポリシーが "ask" の場合、OpenClaw は "auto" と同じ Codex 書き込み/破壊的ゲートを使用し、スレッド開始前にそのアプリの永続的な Codex ツールごとの承認上書きをクリアし、ワンショットの承認または拒否のみを提供します。これにより、永続的な承認が後続の書き込みアクションプロンプトを抑制できないようにします。
• "ask" を使用する各許可済みアプリについて、OpenClaw はそのアプリの Codex 人間承認レビューアを選択し、Codex が承認 elicitation を OpenClaw に送信するようにします。その他のアプリと非アプリスレッド承認は、設定済みのレビューアとポリシーを維持します。
• Plugin ID の欠落、曖昧な所有権、ターン ID の欠落、誤ったターン ID、または安全でない elicitation スキーマは、プロンプトせずに拒否されます。

トラブルシューティング

auth_required: 移行は Plugin をインストールしましたが、そのアプリの 1 つがまだ認証を必要としています。再認可して有効化するまで、明示的な Plugin エントリは無効として書き込まれます。

app_inaccessible、app_disabled、または app_missing: --verify-plugin-apps が設定されている間に、ソース Codex アプリインベントリが所有されているすべてのアプリを存在、有効、アクセス可能として表示しなかったため、移行は Plugin をインストールしませんでした。Codex でアプリを再認可または有効化し、--verify-plugin-apps を指定して移行を再実行してください。

app_inventory_unavailable: 厳格なソースアプリ検証が要求され、ソース Codex アプリインベントリの更新に失敗したため、移行は Plugin をインストールしませんでした。ソース Codex app-server アクセスを修正するか、より速いアカウントゲート付き計画を受け入れる場合は --verify-plugin-apps なしで再試行してください。

codex_subscription_required: ソース Codex app-server アカウントが ChatGPT サブスクリプションアカウントでログインしていなかったため、移行はアプリに裏付けられた Plugin をインストールしませんでした。サブスクリプション認証で Codex アプリにログインし、移行を再実行してください。

codex_account_unavailable: ソース Codex app-server アカウントを読み取れなかったため、移行はアプリに裏付けられた Plugin をインストールしませんでした。ソース Codex app-server 認証を修正するか、アカウント検索が失敗したときにソースアプリインベントリで適格性を判断したい場合は --verify-plugin-apps を指定して再実行してください。

marketplace_missing または plugin_missing: ターゲット Codex app-server は、期待される openai-curated マーケットプレイスまたは Plugin を参照できません。ターゲットランタイムに対して移行を再実行するか、Codex app-server の Plugin 状態を調べてください。

app_inventory_missing または app_inventory_stale: アプリ準備状態は空または古いキャッシュに由来していました。OpenClaw は非同期更新をスケジュールし、所有権と準備状態が判明するまで Plugin アプリを除外します。

app_ownership_ambiguous: アプリインベントリは表示名でのみ一致したため、そのアプリは Codex スレッドに公開されません。

設定を変更したがエージェントが Plugin を認識できない場合: /codex plugins list を使用して設定済みの状態を確認し、その後 /new または /reset を使用します。既存の Codex スレッドバインディングは、OpenClaw が新しいハーネスセッションを確立するか、古いバインディングを置き換えるまで、開始時のアプリ設定を保持します。

破壊的アクションが拒否される場合: グローバルおよび Plugin ごとの allow_destructive_actions 値を確認します。ポリシーが true、"auto"、または "ask" の場合でも、安全でないエリシテーションスキーマやあいまいな Plugin ID は引き続きフェイルクローズします。

関連

• Codex ハーネス
• Codex ハーネスリファレンス
• Codex ハーネスランタイム
• 設定リファレンス
• CLI の移行