codex_plugin_* OpenClaw 動的ツールへ変換しません。
ベースの Codex harness が動作した後に、このページを使用してください。
要件
- エージェントランタイムはネイティブ Codex harness である必要があります。
plugins.entries.codex.enabledがtrueであること。plugins.entries.codex.config.codexPlugins.enabledがtrueであること。- 対象の Codex app-server から、期待される marketplace、Plugin、アプリ inventory が見えること。
- V1 は、migration がソース Codex home で source-installed として観測した
openai-curatedPlugin のみをサポートします。
codexPlugins は OpenClaw-provider 実行、ACP conversation binding、その他の harness には効果がありません。これらの経路ではネイティブ apps config を持つ Codex app-server スレッドが作成されないためです。
OpenAI 側の Codex アカウント、アプリの可用性、workspace のアプリ/Plugin 制御は、サインイン中の Codex アカウントから取得されます。OpenAI アカウントと管理モデルについては、ChatGPT プランで Codex を使用する を参照してください。
クイックスタート
ソース Codex home から migration をプレビューします。--verify-plugin-apps を追加すると、migration がソース app/list を呼び出し、ネイティブ有効化を計画する前に、所有されているすべてのアプリが存在し、有効で、アクセス可能であることを要求します。
codexPlugins エントリを書き込み、選択された Plugin に対して Codex app-server plugin/install を呼び出します。移行後の config は次のようになります。
codexPlugins の変更後、新しい Codex conversation は更新されたアプリセットを自動的に取得します。現在の conversation を更新するには /new または /reset を実行します。Plugin の有効化/無効化の変更に Gateway の再起動は不要です。
チャットから Plugin を管理する
/codex plugins は、Codex harness を操作している同じチャットから、設定済みのネイティブ Codex Plugin を検査または変更します。
/codex plugins は /codex plugins list のエイリアスです。一覧には、plugins.entries.codex.config.codexPlugins.plugins にある各設定済み Plugin のキー、オン/オフ状態、Codex Plugin 名、marketplace が表示されます。
enable/disable は ~/.openclaw/openclaw.json にのみ書き込みます。~/.codex/config.toml を編集したり、新しい Codex Plugin をインストールしたりすることはありません。実行できるのは owner、または operator.admin scope を持つ Gateway クライアントのみです。
設定済み Plugin を有効にすると、グローバルな codexPlugins.enabled スイッチもオンになります。migration が auth_required を返したため Plugin が無効として書き込まれていた場合は、OpenClaw で有効にする前に Codex でアプリを再認可してください。
ネイティブ Plugin セットアップの仕組み
この integration は 3 つの状態を追跡します。| 状態 | 意味 |
|---|---|
| インストール済み | Codex が対象 app-server ランタイム内にローカル Plugin bundle を持っています。 |
| 有効 | OpenClaw config が Codex harness ターンでその Plugin を許可しています。 |
| アクセス可能 | Codex app-server が、その Plugin のアプリエントリがアクティブなアカウントで利用可能であり、移行済み Plugin identity に対応していることを確認します。 |
- 計画中、OpenClaw はソース Codex
plugin/readの詳細を読み取り、ソース Codex app-server アカウントが ChatGPT subscription アカウントであることを確認します。ChatGPT ではないアカウント、またはアカウント応答がない場合、アプリ支援 Plugin はcodex_subscription_requiredでスキップされます。 - デフォルトでは、migration はソース
app/list呼び出しをスキップします。アカウントゲートを通過したアプリ支援ソース Plugin は、ソースアプリのアクセシビリティ検証なしで計画され、アカウント検索の transport 失敗はcodex_account_unavailableでスキップされます。 --verify-plugin-appsを指定すると、migration は新しいソースapp/listsnapshot を取得し、ネイティブ有効化を計画する前に、所有されているすべてのアプリが存在し、有効で、アクセス可能であることを要求します。この場合、アカウント検索の transport 失敗は即時スキップではなく、ソースアプリ inventory ゲートへフォールスルーします。
/codex plugins enable/disable は新しい Codex conversation にのみ影響します。現在の conversation に変更を反映するには /new または /reset を使用してください。
V1 サポート境界
- ソース Codex app-server inventory にすでにインストールされている
openai-curatedPlugin のみが migration 対象です。 - アプリ支援ソース Plugin は、migration 時の subscription ゲートを通過する必要があります。
--verify-plugin-appsはソースアプリ inventory ゲートを追加します。Subscription ゲート対象のアカウント、および検証モードでアクセス不可/無効/欠落しているソースアプリやアプリ inventory refresh 失敗は、有効な config エントリではなく、スキップされた手動 item として報告されます。読み取り不能な Plugin 詳細は、アプリ inventory ゲートの前にスキップされます。 - Migration は明示的な Plugin identity（
marketplaceNameとpluginName）を書き込みます。ローカルmarketplacePathcache path は書き込みません。 codexPlugins.enabledは唯一のグローバル有効化スイッチです。任意のインストール権限を付与するplugins["*"]wildcard や config key はありません。- サポート外の marketplace、cached Plugin bundle、hook、Codex config ファイルは、手動 review 用に migration report に保持され、自動的には有効化されません。
アプリ inventory と ownership
OpenClaw は app-serverapp/list を通じて Codex アプリ inventory を読み取り、1 時間メモリ内にキャッシュし、古いエントリや欠落したエントリを非同期に refresh します。この cache は process-local です。CLI または Gateway を再起動すると破棄され、OpenClaw は次回の app/list 読み取りから再構築します。
Migration とランタイムは別々の cache key を使用します。
- ソース migration 検証は、ソース Codex home と start option を使用します。これは
--verify-plugin-appsを指定した場合にのみ実行され、その計画実行のために新しいソースapp/listtraversal を強制します。 - 対象ランタイムセットアップは、スレッドアプリ config を構築するときに、対象エージェントの Codex app-server identity を使用します。Plugin 有効化はその対象 cache key を invalidation し、その後
plugin/installの後で強制 refresh します。
接続済みアカウントアプリ
Owner が運用するエージェントは、一致する Plugin package を要求せずに、Codex アカウントにすでに接続されているすべてのアプリへ opt in できます。allow_all_plugins: true は、新しいネイティブ Codex スレッドが確立されるときに完全な app/list snapshot を取得し、そのアカウントでアクセス可能とマークされているアプリのみを認めます。アプリをグローバルにインストール、認証、または有効化することはありません。既存のスレッドは永続化されたアプリセットを保持します。新しく接続または取り消されたアプリを反映するには、/new、/reset、または Gateway の再起動を使用してください。
アカウントアプリはグローバルな codexPlugins.allow_destructive_actions 値を継承します。この値は true、false、"auto"、または "ask" を受け付けます。明示的な Plugin ごとの policy は、重複する app id についてグローバル policy を上書きします。Inventory 失敗時は、制限のないデフォルトへフォールバックせず fail closed します。
スレッドアプリ config
OpenClaw は Codex スレッドに制限的なconfig.apps patch を注入します。_default は無効化され、有効な移行済み Plugin が所有するアプリ、または allow_all_plugins によって認められたアクセス可能なアカウントアプリのみが有効化されます。
各アプリの destructive_enabled は、有効なグローバルまたは Plugin ごとの allow_destructive_actions policy から取得されます。true、"auto"、"ask" はすべて destructive_enabled: true を設定し、false は false を設定します。Codex は引き続き、ネイティブアプリツール annotation から destructive tool metadata を強制します。_default は open_world_enabled: false で無効化されます。有効な Plugin アプリには open_world_enabled: true が設定されます。OpenClaw は別個の Plugin レベル open-world policy knob を公開せず、Plugin ごとの destructive tool-name deny list も維持しません。
Tool approval mode は、認められたアプリに対してデフォルトで自動になるため、非破壊の read tool は同一スレッドの approval prompt なしで実行されます。Destructive tool は、各アプリの destructive_enabled policy によって引き続き制御されます。
破壊的操作 policy
移行済み Codex Plugin では destructive Plugin elicitation はデフォルトで許可されますが、安全でない schema と曖昧な ownership は fail closed します。- グローバル
allow_destructive_actionsのデフォルトはtrueです。 - Plugin ごとの
allow_destructive_actionsは、その Plugin についてグローバル policy を上書きします。 false: OpenClaw は決定的な decline を返します。true: OpenClaw は、boolean approve field など、approval response に対応付けできる安全な schema のみを自動承認します。"auto": OpenClaw は destructive Plugin action を Codex に公開し、その後 ownership が証明された MCP approval elicitation を OpenClaw Plugin approval に変換してから Codex approval response を返します。"ask": OpenClaw は"auto"と同じ Codex write/destructive gating を使用し、スレッド開始前にそのアプリの永続的な Codex per-tool approval override をクリアし、durable approval が後続の write-action prompt を抑制できないように、1 回限りの approval または denial のみを提供します。"ask"を使用する認められた各アプリについて、OpenClaw はそのアプリの Codex human approvals reviewer を選択し、Codex が approval elicitation を OpenClaw に送信するようにします。その他のアプリと非アプリのスレッド approval は、設定済み reviewer と policy を維持します。- Plugin identity の欠落、曖昧な ownership、turn id の欠落または不一致、または安全でない elicitation schema は、prompt ではなく decline します。
トラブルシューティング
| コード | 意味 | 修正 |
|---|---|---|
auth_required | 移行により Plugin はインストールされましたが、そのアプリの 1 つでまだ認証が必要です。再認可するまで、項目は無効として書き込まれます。 | Codex でアプリを再認可し、その後 OpenClaw で Plugin を有効にします。 |
app_inaccessible, app_disabled, app_missing | --verify-plugin-apps を指定した場合、ソース Codex アプリインベントリで、所有アプリがすべて存在し、有効で、アクセス可能とは示されませんでした。 | Codex でアプリを再認可または有効化し、その後 --verify-plugin-apps を指定して移行を再実行します。 |
app_inventory_unavailable | 厳密なソースアプリ検証が要求されましたが、ソース Codex アプリインベントリの更新に失敗しました。 | ソース Codex アプリサーバーへのアクセスを修正するか、--verify-plugin-apps なしで再試行して、より高速なアカウントゲート付きプランを受け入れます。 |
codex_subscription_required | ソース Codex アプリサーバーのアカウントが ChatGPT サブスクリプションアカウントではありませんでした。 | サブスクリプション認証で Codex アプリにログインし、その後移行を再実行します。 |
codex_account_unavailable | ソース Codex アプリサーバーのアカウントを読み取れませんでした。 | ソース Codex アプリサーバー認証を修正するか、--verify-plugin-apps を指定して再実行し、ソースアプリインベントリに適格性を判断させます。 |
marketplace_missing, plugin_missing | ターゲット Codex アプリサーバーから、想定される openai-curated マーケットプレイスまたは Plugin が見えません。 | ターゲットランタイムに対して移行を再実行するか、Codex アプリサーバーの Plugin 状態を調査します。 |
app_inventory_missing, app_inventory_stale | アプリの準備状態が、空または古いキャッシュから取得されました。 | OpenClaw は非同期更新を自動的にスケジュールします。Plugin アプリは、所有権と準備状態が判明するまで除外されたままです。 |
app_ownership_ambiguous | アプリインベントリは表示名だけで一致しました。 | 後の更新で所有権が証明されるまで、そのアプリは Codex スレッドから非表示のままです。 |
/codex plugins list を実行して設定済みの状態を確認し、その後 /new または /reset を実行します。既存の
Codex スレッドバインディングは、OpenClaw が新しいハーネスセッションを確立するか、古いバインディングを置き換えるまで、開始時のアプリ設定を保持します。
破壊的操作が拒否される場合: グローバルおよび Plugin ごとの
allow_destructive_actions 値を確認します。true、"auto"、または "ask" であっても、
安全でない elicitation スキーマやあいまいな Plugin ID はフェイルクローズします。