Codex コンピューター操作

Computer Use は、ローカルデスクトップ制御用の Codex ネイティブ MCP Plugin です。OpenClaw はデスクトップアプリを同梱せず、デスクトップ操作自体を実行せず、 Codex の権限を迂回しません。同梱の codex Plugin は Codex app-server の準備のみを行います。 Codex の Plugin サポートを有効化し、設定された Computer Use Plugin を検索またはインストールし、computer-use MCP サーバーが利用可能か確認してから、 Codex モードのターン中のネイティブ MCP ツール呼び出しを Codex に委ねます。

OpenClaw がすでにネイティブ Codex ハーネスを使用している場合は、このページを使用してください。 ランタイム自体のセットアップについては、Codex ハーネスを参照してください。

これは OpenClaw 組み込みの Node ベースのコンピューターツールとは異なります。同じエージェント契約で、エージェントが Gateway 上または別の Node 上のどちらで実行される場合でも、ペアリングされた Mac を制御する必要がある場合は、組み込みツールを使用してください。Codex app-server にローカル MCP のインストール、権限、ネイティブツール呼び出しを管理させる場合は、Codex Computer Use を使用してください。

OpenClaw.app と Peekaboo

OpenClaw.app の Peekaboo 統合は、Codex Computer Use とは別のものです。 macOS アプリは PeekabooBridge ソケットをホストでき、peekaboo CLI は Peekaboo 独自の自動化ツール向けに、アプリのローカルのアクセシビリティおよび画面収録の許可を再利用できます。 このブリッジは Codex Computer Use をインストールまたはプロキシせず、 Codex Computer Use も PeekabooBridge ソケット経由で呼び出しません。

OpenClaw.app を Peekaboo CLI 自動化の権限対応ホストとして使用する場合は、Peekaboo ブリッジを使用してください。 Codex モードの OpenClaw エージェントが、ターン開始前に Codex ネイティブの computer-use MCP Plugin を 利用できるようにする場合は、このページを使用してください。

iOS アプリ

iOS アプリは Codex Computer Use とは別のものです。Codex の computer-use MCP サーバーを インストールまたはプロキシせず、デスクトップ制御バックエンドでもありません。 代わりに、iOS アプリは OpenClaw Node として接続し、canvas.*、camera.*、screen.*、 location.*、talk.* などの Node コマンドを通じてモバイル機能を公開します。

Gateway を通じてエージェントに iPhone Node を操作させる場合は、iOSを使用してください。 Codex モードのエージェントが Codex ネイティブの Computer Use Plugin を通じて ローカルの macOS デスクトップを制御する場合は、このページを使用してください。

cua-driver MCP の直接利用

デスクトップ制御を公開する方法は、Codex Computer Use だけではありません。 OpenClaw が管理するランタイムから TryCua のドライバーを直接呼び出す場合は、 Codex 固有のマーケットプレイスフローではなく、OpenClaw の MCP レジストリを通じて アップストリームの cua-driver mcp サーバーを使用してください。

cua-driver のインストール後、OpenClaw 用コマンドを出力させるには次を実行します。

cua-driver mcp-config --client openclaw

または、stdio サーバーを直接登録します。

openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'

この方法では、ドライバースキーマや構造化 MCP レスポンスを含む、 アップストリームの MCP ツールサーフェスがそのまま維持されます。CUA ドライバーを通常の OpenClaw MCP サーバーとして利用する場合に使用してください。Codex モードのターン内で Codex app-server に Plugin のインストール、MCP の再読み込み、ネイティブツール呼び出しを 管理させる場合は、このページの Codex Computer Use セットアップを使用してください。

CUA のドライバーは macOS 専用で、アクセシビリティや画面収録など、 アプリが要求するローカル macOS の権限が引き続き必要です。OpenClaw は cua-driver をインストールせず、それらの権限を付与せず、 アップストリームドライバーの安全モデルを迂回しません。

クイックセットアップ

スレッド開始前に Codex モードのターンで Computer Use を利用可能にする必要がある場合は、 plugins.entries.codex.config.computerUse を設定します。autoInstall: true を指定すると Computer Use が有効になり、OpenClaw はターン開始前にそれをインストールまたは再有効化できます。

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          computerUse: {            autoInstall: true,          },        },      },    },  },  agents: {    defaults: {      model: "openai/gpt-5.6-sol",    },  },}

この設定では、OpenClaw は Codex モードの各ターン開始前に Codex app-server を確認します。 Computer Use が存在しなくても、Codex app-server がインストール可能なマーケットプレイスを すでに検出している場合、OpenClaw は Codex app-server に Plugin のインストールまたは 再有効化と、MCP サーバーの再読み込みを要求します。macOS では、一致するマーケットプレイスが 登録されておらず、標準のデスクトップアプリバンドルが存在する場合、OpenClaw は /Applications/ChatGPT.app/Contents/Resources/plugins/openai-bundled にある 同梱 Codex マーケットプレイスの登録も試みます。従来のスタンドアロンインストール向けには、 /Applications/Codex.app/Contents/Resources/plugins/openai-bundled が フォールバックとして維持されます。それでもセットアップで MCP サーバーを利用可能にできない場合、 スレッド開始前にターンが失敗します。

Computer Use の設定変更後、既存の Codex スレッドがすでに開始されている場合は、 テスト前に対象チャットで /new または /reset を使用してください。

macOS では、Computer Use の管理された起動は、まず /Applications/ChatGPT.app/Contents/Resources/codex にあるデスクトップアプリの バイナリを優先し、従来のスタンドアロンインストールでは /Applications/Codex.app/Contents/Resources/codex にフォールバックします。 これは、独自のクライアントを起動する単発の Computer Use ステータスおよび インストールコマンドにも適用されます。これにより、デスクトップ制御はローカル macOS の 権限を所有するアプリバンドルの管理下に置かれます。デスクトップアプリがインストールされていない場合、 OpenClaw は Plugin の隣にインストールされた管理対象 Codex バイナリにフォールバックします。 デフォルトの分離されたエージェントホームを使用する通常の管理対象 Codex ターンでは、 古いデスクトップアプリによって現在のモデルサポートが隠されないよう、まずその固定パッケージを優先します。 ユーザー単位のホームではネイティブ Computer Use の状態を読み込めるため、 デスクトップが引き続き優先されます。有効な Codex 設定で Computer Use が有効になっている 分離されたエージェントホームでも、デスクトップが引き続き優先されます。 明示的な appServer.command 設定または OPENCLAW_CODEX_APP_SERVER_BIN は、 この管理された選択より引き続き優先されます。

OpenClaw は、1 つの実行中 Gateway 内で、ネイティブ Codex 設定の読み取りと Computer Use のインストールを直列化します。別の Codex プロセスや別の Gateway は、 この排他制御の対象外です。Gateway の外部でネイティブ Codex Plugin 設定を変更した後は、 新しい選択を利用する前に Gateway を再起動し、新しいチャットを開始してください。

コマンド

codex Plugin のコマンドサーフェスを利用できる任意のチャット画面から、 /codex computer-use コマンドを使用します。これらは OpenClaw のチャット／ランタイムコマンドであり、 openclaw codex ... CLI サブコマンドではありません。

/codex computer-use status/codex computer-use install/codex computer-use install --source <marketplace-source>/codex computer-use install --marketplace-path <path>/codex computer-use install --marketplace <name>

status はデフォルトのアクションで、読み取り専用です。マーケットプレイスソースの追加、 Plugin のインストール、Codex Plugin サポートの有効化は行いません。Computer Use を 有効にする設定がない場合、単発のインストールコマンドを実行した後でも、 status が無効と報告することがあります。

install は Codex app-server の Plugin サポートを有効化し、必要に応じて設定済みの マーケットプレイスソースを追加し、Codex app-server を通じて設定済み Plugin を インストールまたは再有効化し、MCP サーバーを再読み込みして、MCP サーバーがツールを 公開していることを確認します。インストールは信頼されたホストリソースを変更するため、 install を実行できるのは、所有者または operator.admin Gateway クライアントだけです。 その他の認可済み送信者は、オーバーライドを指定した場合も含め、 読み取り専用の status コマンドを引き続き使用できます。

以前のリリースでは、単発の --plugin、--server、--mcp-server 識別情報の オーバーライドを受け付けていました。代わりに、computerUse.pluginName と computerUse.mcpServerName を永続的に設定してください。従来の識別情報フラグが使用されると、 コマンドは永続化すべき正確な設定を示し、移行案内で、要求されたアクションと サポートされるマーケットプレイスフラグを再掲します。

マーケットプレイスの選択肢

OpenClaw は、Codex 自体が公開しているものと同じ app-server API を使用します。 マーケットプレイスフィールドでは、Codex が computer-use を検索する場所を選択します。

新しい Codex ホームでは、公式マーケットプレイスの初期化に少し時間がかかる場合があります。 インストール中、OpenClaw は marketplaceDiscoveryTimeoutMs ミリ秒 （デフォルトは 60 秒）を上限として plugin/list をポーリングします。

既知の複数のマーケットプレイスに Computer Use が含まれる場合、OpenClaw は openai-bundled、openai-curated、local の順に優先します。 不明で曖昧な一致がある場合は安全側に倒して失敗し、marketplaceName または marketplacePath の設定を求めます。

同梱の macOS マーケットプレイス

現在の ChatGPT デスクトップビルドでは、Computer Use が次の場所に同梱されています。 従来のスタンドアロン Codex デスクトップビルドでは、Codex.app 配下で同じレイアウトを使用します。

/Applications/ChatGPT.app/Contents/Resources/plugins/openai-bundled/plugins/computer-use/Applications/Codex.app/Contents/Resources/plugins/openai-bundled/plugins/computer-use

computerUse.autoInstall が true で、computer-use を含むマーケットプレイスが 登録されていない場合、OpenClaw は存在する最初の標準同梱マーケットプレイスルートの追加を試みます。

/Applications/ChatGPT.app/Contents/Resources/plugins/openai-bundled/Applications/Codex.app/Contents/Resources/plugins/openai-bundled

Codex を使用して、シェルから明示的に登録することもできます。

codex plugin marketplace add /Applications/ChatGPT.app/Contents/Resources/plugins/openai-bundled

標準外の Codex アプリパスを使用する場合は、/codex computer-use install --source <marketplace-root> を一度実行するか、computerUse.marketplacePath に ローカルマーケットプレイスファイルのパスを設定してください。--marketplace-path は、 同梱マーケットプレイスルートではなく、マーケットプレイスの JSON ファイルパスがある場合にのみ使用してください。

共有 Plugin キャッシュ

デフォルトの pluginCacheMode: "independent" では、各 Codex ホームとその Plugin キャッシュは管理されません。app-server 起動前に、同梱の Computer Use Plugin を アクティブな Codex ホームから検出可能な Plugin キャッシュへコピーするには、 pluginCacheMode: "shared" を設定します。実行中の Codex クライアントが バージョン付き Plugin ディレクトリを引き続き参照できるため、共有モードでは古いキャッシュ済み バージョンが保持されます。置換コピーに失敗した場合も、アクティブなキャッシュが保持されます。 明示的な marketplaceName または marketplacePath の設定は、この整合処理を無効化し、 OpenClaw がその選択を上書きしないようにします。

リモートカタログの制限

Codex app-server はリモート専用カタログの項目を一覧表示および読み取りできますが、 現在はリモートの plugin/install をサポートしていません。つまり、marketplaceName では ステータス確認用にリモート専用マーケットプレイスを選択できますが、インストールおよび 再有効化には、引き続き marketplaceSource または marketplacePath を介した ローカルマーケットプレイスが必要です。

ステータスで、Plugin はリモート Codex マーケットプレイスから利用可能だが リモートインストールは未対応と表示された場合は、ローカルソースまたはパスを指定して インストールを実行してください。

/codex computer-use install --source <marketplace-source>/codex computer-use install --marketplace-path <path>

設定リファレンス

ターン開始時の自動インストールは、設定された marketplaceSource の値を意図的に拒否します。 新しいソースの追加は明示的なセットアップ操作であるため、まず /codex computer-use install --source <marketplace-source> を一度実行し、その後は autoInstall により、検出済みのローカルマーケットプレイスから再有効化できるようにします。 設定された marketplacePath はホスト上のローカルパスであるため、ターン開始時の自動インストールで使用できます。

各フィールドでは、対応する設定キーが未設定の場合に確認される環境変数による上書きも利用できます。

OpenClaw が確認する内容

OpenClaw は内部で安定したセットアップ理由を報告し、チャット向けに ユーザー表示用のステータスを整形します。

チャット出力には、Plugin の状態、MCP サーバーの状態、マーケットプレイス、 利用可能な場合はツール、および失敗したセットアップ手順に固有のメッセージが含まれます。

macOS の権限

Computer Use は macOS 専用です。Codex が所有する MCP サーバーがアプリを検査または操作するには、 事前にローカル OS の権限が必要になる場合があります。OpenClaw が Computer Use は インストール済みであるものの MCP サーバーを利用できないと報告する場合は、まず Codex 側の Computer Use セットアップを確認してください。

• Codex app-server が、デスクトップ操作を実行するホストと同じホスト上で稼働している。
• Computer Use Plugin が Codex 設定で有効になっている。
• computer-use MCP サーバーが Codex app-server の MCP ステータスに表示される。
• macOS がデスクトップ操作アプリに必要な権限を付与している。
• 現在のホストセッションから操作対象のデスクトップにアクセスできる。

computerUse.enabled が true の場合、OpenClaw は意図的にフェイルクローズします。 設定で必須とされたネイティブデスクトップツールなしに、Codex モードのターンが 暗黙的に続行されることはありません。

トラブルシューティング

ステータスが未インストールと表示される。 /codex computer-use install を実行します。 マーケットプレイスが検出されない場合は、--source または --marketplace-path を渡します。

ステータスがインストール済みだが無効と表示される。 /codex computer-use install を 再度実行します。Codex app-server のインストール処理により、Plugin 設定が有効な状態で書き戻されます。

ステータスがリモートインストールは非対応と表示される。 ローカルのマーケットプレイス ソースまたはパスを使用します。リモート専用のカタログエントリは確認できますが、 現在の app-server API ではインストールできません。

ステータスが MCP サーバーを利用できないと表示される。 MCP サーバーを再読み込みするため、 インストールを一度再実行します。引き続き利用できない場合は、Codex Computer Use アプリ、 Codex app-server の MCP ステータス、または macOS の権限を修正します。

ステータスまたはプローブが computer-use.list_apps でタイムアウトする。 Plugin と MCP サーバーは存在しますが、ローカルの Computer Use ブリッジが応答していません。 Codex Computer Use を終了または再起動し、必要に応じて Codex Desktop を再起動してから、 新しい OpenClaw セッションで再試行します。ホストが以前、古い管理対象 Codex app-server を介して Computer Use を実行していた場合は、デスクトップにバンドルされたマーケットプレイスから インストール済み Plugin を更新します（スタンドアロンの Codex デスクトップインストールでは Codex.app のパスを使用します）。

/codex computer-use install --source /Applications/ChatGPT.app/Contents/Resources/plugins/openai-bundled

Computer Use ツールが Native hook relay unavailable と表示する。 Codex ネイティブの ツールフックが、ローカルブリッジまたは Gateway フォールバックを介して、アクティブな OpenClaw リレーに到達できませんでした。/new または /reset を使用して、新しい OpenClaw セッションを開始します。一度動作した後、後続のツール呼び出しで再び失敗する場合、 /new は現在の試行をクリアしているだけです。古いスレッドとフック登録を破棄するため、 Codex app-server または OpenClaw Gateway を再起動してから、新しいセッションで再試行します。

ターン開始時の自動インストールがソースを拒否する。 これは意図された動作です。 まず明示的に /codex computer-use install --source <marketplace-source> を実行してソースを追加します。その後は、ターン開始時の自動インストールで 検出済みのローカルマーケットプレイスを使用できます。

関連項目

• Codex ハーネス
• Peekaboo ブリッジ
• iOS アプリ