Codex-Computernutzung

Computer Use ist ein Codex-natives MCP-Plugin zur lokalen Desktop-Steuerung. OpenClaw liefert die Desktop-App nicht mit, führt Desktop-Aktionen nicht selbst aus und umgeht keine Codex-Berechtigungen. Das mitgelieferte codex-Plugin bereitet lediglich den Codex-App-Server vor: Es aktiviert die Codex-Plugin-Unterstützung, findet oder installiert das konfigurierte Computer Use- Plugin, prüft, ob der computer-use-MCP-Server verfügbar ist, und überlässt Codex anschließend während Durchläufen im Codex-Modus die nativen MCP-Tool-Aufrufe.

Verwenden Sie diese Seite, wenn OpenClaw bereits den nativen Codex-Harness verwendet. Informationen zur Einrichtung der Runtime selbst finden Sie unter Codex-Harness.

Dies unterscheidet sich vom integrierten Node-gestützten Computer-Tool von OpenClaw. Verwenden Sie das integrierte Tool, wenn derselbe Agent-Vertrag einen gekoppelten Mac steuern soll, unabhängig davon, ob der Agent auf dem Gateway oder einem anderen Node ausgeführt wird. Verwenden Sie Codex Computer Use, wenn der Codex-App-Server die lokale MCP-Installation, Berechtigungen und nativen Tool-Aufrufe verwalten soll.

OpenClaw.app und Peekaboo

Die Peekaboo-Integration von OpenClaw.app ist von Codex Computer Use getrennt. Die macOS-App kann einen PeekabooBridge-Socket bereitstellen, sodass die peekaboo-CLI die lokalen Freigaben der App für Bedienungshilfen und Bildschirmaufnahme für Peekaboos eigene Automatisierungstools wiederverwenden kann. Diese Bridge installiert oder vermittelt Codex Computer Use nicht, und Codex Computer Use ruft nicht über den PeekabooBridge-Socket auf.

Verwenden Sie die Peekaboo-Bridge, wenn OpenClaw.app als berechtigungsbewusster Host für die Automatisierung mit der Peekaboo-CLI dienen soll. Verwenden Sie diese Seite, wenn einem OpenClaw-Agenten im Codex-Modus das native computer-use-MCP-Plugin von Codex vor Beginn des Durchlaufs zur Verfügung stehen soll.

iOS-App

Die iOS-App ist von Codex Computer Use getrennt. Sie installiert oder vermittelt den Codex-computer-use-MCP-Server nicht und ist kein Backend zur Desktop-Steuerung. Stattdessen verbindet sich die iOS-App als OpenClaw-Node und stellt mobile Funktionen über Node-Befehle wie canvas.*, camera.*, screen.*, location.* und talk.* bereit.

Verwenden Sie iOS, wenn ein Agent einen iPhone-Node über das Gateway steuern soll. Verwenden Sie diese Seite, wenn ein Agent im Codex-Modus den lokalen macOS-Desktop über das native Computer Use-Plugin von Codex steuern soll.

Direktes cua-driver-MCP

Codex Computer Use ist nicht die einzige Möglichkeit, Desktop-Steuerung bereitzustellen. Wenn von OpenClaw verwaltete Runtimes den Treiber von TryCua direkt aufrufen sollen, verwenden Sie den vorgelagerten cua-driver mcp-Server über die MCP-Registry von OpenClaw statt des Codex-spezifischen Marketplace-Ablaufs.

Bitten Sie ihn nach der Installation von cua-driver entweder um den OpenClaw-Befehl:

cua-driver mcp-config --client openclaw

oder registrieren Sie den stdio-Server direkt:

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

Dieser Pfad erhält die vorgelagerte MCP-Tool-Oberfläche einschließlich der Treiber- Schemas und strukturierten MCP-Antworten. Verwenden Sie ihn, wenn der CUA-Treiber als normaler OpenClaw-MCP-Server verfügbar sein soll. Verwenden Sie die Einrichtung von Codex Computer Use auf dieser Seite, wenn der Codex-App-Server die Plugin-Installation, MCP-Neuladungen und nativen Tool-Aufrufe innerhalb von Durchläufen im Codex-Modus verwalten soll.

Der CUA-Treiber stellt Vorabversionen für macOS, Windows (x64 und ARM64) sowie Linux (x64 und ARM64, Vorschau-Stufe) bereit. Er benötigt weiterhin die lokalen Betriebssystem- berechtigungen, zu deren Erteilung seine App auffordert, beispielsweise Bedienungshilfen und Bildschirmaufnahme unter macOS. OpenClaw installiert cua-driver nicht, erteilt diese Berechtigungen nicht und umgeht das Sicherheitsmodell des vorgelagerten Treibers nicht.

Schnelleinrichtung

Legen Sie plugins.entries.codex.config.computerUse fest, wenn für Durchläufe im Codex-Modus Computer Use verfügbar sein muss, bevor ein Thread beginnt. autoInstall: true aktiviert Computer Use und ermöglicht OpenClaw, es vor dem Durchlauf zu installieren oder erneut zu aktivieren:

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

Mit dieser Konfiguration prüft OpenClaw vor jedem Durchlauf im Codex-Modus den Codex-App-Server. Wenn Computer Use fehlt, der Codex-App-Server aber bereits einen installierbaren Marketplace erkannt hat, weist OpenClaw den Codex-App-Server an, das Plugin zu installieren oder erneut zu aktivieren und die MCP-Server neu zu laden. Vor dem Start eines isolierten Codex-App-Servers unter macOS kopiert die automatische Installation außerdem die offizielle signierte Computer Use-Dienst-App aus dem ausgewählten Desktop-App-Bundle in das computer-use-Verzeichnis dieses Codex-Homes, wenn der native Client fehlt. Wenn unter macOS kein passender Marketplace registriert ist und ein Standard-Desktop-App-Bundle vorhanden ist, versucht OpenClaw außerdem, den mitgelieferten Codex-Marketplace aus /Applications/ChatGPT.app/Contents/Resources/plugins/openai-bundled zu registrieren, wobei /Applications/Codex.app/Contents/Resources/plugins/openai-bundled als Fallback für ältere eigenständige Installationen erhalten bleibt. Wenn die Einrichtung den MCP-Server weiterhin nicht verfügbar machen kann, schlägt der Durchlauf fehl, bevor der Thread beginnt. Strikte Bereitschaftsfehler sind Preflight-Fehler des Harnesses, sodass der Modell-Fallback nicht dieselbe lokale Bereitschaftssequenz für jeden Modellkandidaten wiederholt.

Nachdem Sie die Computer Use-Konfiguration geändert haben, verwenden Sie vor dem Testen /new oder /reset im betroffenen Chat, wenn bereits ein bestehender Codex-Thread gestartet wurde.

Unter macOS bevorzugt der verwaltete Start für Computer Use die Desktop-App-Binärdatei unter /Applications/ChatGPT.app/Contents/Resources/codex und greift anschließend für ältere eigenständige Installationen auf /Applications/Codex.app/Contents/Resources/codex zurück. Dies gilt auch für einmalige Computer Use-Status- und Installationsbefehle, die ihren eigenen Client starten. Dadurch bleibt die Desktop-Steuerung unter dem App-Bundle, das die lokalen macOS-Berechtigungen besitzt. Wenn die Desktop-App nicht installiert ist, greift OpenClaw auf die verwaltete Codex-Binärdatei zurück, die neben dem Plugin installiert ist. Gewöhnliche verwaltete Codex-Durchläufe mit dem standardmäßigen isolierten Agent-Home bevorzugen zuerst dieses angeheftete Paket, damit eine ältere Desktop-App die aktuelle Modell- unterstützung nicht überschreiben kann. Benutzerbezogene Homes bevorzugen weiterhin den Desktop, da sie nativen Computer Use-Zustand laden können. Ein isoliertes Agent-Home, dessen effektive Codex-Konfiguration Computer Use aktiviert, bevorzugt ebenfalls weiterhin den Desktop. Eine explizite appServer.command-Konfiguration oder OPENCLAW_CODEX_APP_SERVER_BIN überschreibt diese verwaltete Auswahl weiterhin.

OpenClaw serialisiert native Codex-Konfigurationslesevorgänge und die Computer Use-Installation innerhalb eines laufenden Gateways. Ein separater Codex-Prozess oder ein anderes Gateway ist nicht Teil dieser Absicherung. Starten Sie nach einer Änderung der nativen Codex-Plugin-Konfiguration außerhalb des Gateways das Gateway neu und beginnen Sie einen neuen Chat, bevor Sie sich auf die neue Auswahl verlassen.

Befehle

Verwenden Sie die /codex computer-use-Befehle auf jeder Chat-Oberfläche, auf der die Befehlsoberfläche des codex-Plugins verfügbar ist. Dies sind OpenClaw-Chat-/Runtime- Befehle und keine Unterbefehle der 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 ist die Standardaktion und schreibgeschützt: Sie fügt keine Marketplace- Quellen hinzu, installiert keine Plugins und aktiviert nicht die Codex-Plugin-Unterstützung. Wenn keine Konfiguration Computer Use aktiviert, kann status selbst nach einem einmaligen Installationsbefehl „deaktiviert“ melden.

install aktiviert die Plugin-Unterstützung des Codex-App-Servers, fügt optional eine konfigurierte Marketplace-Quelle hinzu, installiert oder reaktiviert das konfigurierte Plugin über den Codex-App-Server, lädt MCP-Server neu und überprüft, ob der MCP- Server Tools bereitstellt. Da die Installation vertrauenswürdige Host-Ressourcen ändert, kann nur ein Eigentümer oder ein operator.admin-Gateway-Client install ausführen. Andere autorisierte Absender können weiterhin den schreibgeschützten Befehl status verwenden, auch mit Überschreibungen.

Ältere Versionen akzeptierten einmalige Identitätsüberschreibungen durch --plugin, --server und --mcp-server. Konfigurieren Sie stattdessen computerUse.pluginName und computerUse.mcpServerName dauerhaft. Wenn ein älteres Identitäts-Flag verwendet wird, nennt der Befehl die genaue dauerhaft zu speichernde Einstellung und wiederholt die angeforderte Aktion sowie alle unterstützten Marketplace-Flags in seinen Migrationshinweisen.

Marketplace-Auswahl

OpenClaw verwendet dieselbe App-Server-API, die Codex selbst bereitstellt. Die Marketplace-Felder bestimmen, wo Codex computer-use finden soll.

Neue Codex-Homes benötigen möglicherweise einen kurzen Moment, um ihre offiziellen Marketplaces einzurichten. Während der Installation fragt OpenClaw plugin/list bis zu marketplaceDiscoveryTimeoutMs Millisekunden lang ab (standardmäßig 60 Sekunden).

Wenn mehrere bekannte Marketplaces Computer Use enthalten, bevorzugt OpenClaw openai-bundled, dann openai-curated und anschließend local. Unbekannte mehrdeutige Übereinstimmungen schlagen sicher fehl und fordern Sie auf, marketplaceName oder marketplacePath festzulegen.

Mitgelieferter macOS-Marketplace

Aktuelle ChatGPT-Desktop-Builds enthalten Computer Use an dieser Stelle; ältere eigenständige Codex-Desktop-Builds verwenden dasselbe Layout unter Codex.app:

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

Wenn computerUse.autoInstall wahr ist und kein Marketplace mit computer-use registriert ist, versucht OpenClaw, das erste vorhandene mitgelieferte Standard-Marketplace-Stammverzeichnis hinzuzufügen:

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

Sie können es außerdem explizit über eine Shell mit Codex registrieren:

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

Wenn Sie einen nicht standardmäßigen Codex-App-Pfad verwenden, führen Sie /codex computer-use install --source <marketplace-root> einmal aus oder legen Sie computerUse.marketplacePath auf einen lokalen Marketplace-Dateipfad fest. Verwenden Sie --marketplace-path nur, wenn Sie über den Pfad zur Marketplace-JSON-Datei verfügen, nicht für das mitgelieferte Marketplace-Stammverzeichnis.

Gemeinsamer Plugin-Cache

Der Standardwert pluginCacheMode: "independent" lässt jedes Codex-Home und dessen Plugin-Cache unverwaltet. Legen Sie pluginCacheMode: "shared" fest, um das mitgelieferte Computer Use-Plugin vor dem Start des App-Servers in den auffindbaren Plugin-Cache des aktiven Codex-Homes zu kopieren. Der gemeinsame Modus erhält ältere zwischengespeicherte Versionen, da laufende Codex-Clients weiterhin auf ihre versionierten Plugin-Verzeichnisse verweisen können; auch ein fehlgeschlagener Ersetzungskopiervorgang erhält den aktiven Cache. Eine explizite marketplaceName- oder marketplacePath-Konfiguration deaktiviert diesen Abgleich, damit OpenClaw diese Auswahl nicht überschreibt.

Beschränkung des Remote-Katalogs

Der Codex-App-Server kann reine Remote-Katalogeinträge auflisten und lesen, unterstützt derzeit jedoch kein Remote-plugin/install. Das bedeutet, dass marketplaceName für Statusprüfungen einen reinen Remote-Marketplace auswählen kann, Installationen und Reaktivierungen jedoch weiterhin einen lokalen Marketplace über marketplaceSource oder marketplacePath benötigen.

Wenn der Status meldet, dass das Plugin in einem Remote-Codex-Marketplace verfügbar ist, die Remote-Installation jedoch nicht unterstützt wird, führen Sie die Installation mit einer lokalen Quelle oder einem lokalen Pfad aus:

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

Konfigurationsreferenz

Die automatische Installation zu Beginn eines Durchlaufs lehnt konfigurierte marketplaceSource- Werte absichtlich ab. Das Hinzufügen einer neuen Quelle ist ein expliziter Einrichtungsvorgang. Verwenden Sie daher /codex computer-use install --source <marketplace-source> einmal und lassen Sie anschließend autoInstall künftige erneute Aktivierungen aus erkannten lokalen Marketplaces übernehmen. Die automatische Installation zu Beginn eines Durchlaufs kann einen konfigurierten marketplacePath verwenden, da dies bereits ein lokaler Pfad auf dem Host ist.

Jedes Feld akzeptiert außerdem eine Überschreibung durch eine Umgebungsvariable, die geprüft wird, wenn der entsprechende Konfigurationsschlüssel nicht festgelegt ist:

Was OpenClaw prüft

OpenClaw meldet intern einen stabilen Einrichtungsgrund und formatiert den benutzerseitigen Status für den Chat:

Die Chat-Ausgabe enthält den Plugin-Status, den MCP-Serverstatus, den Marketplace, die verfügbaren Tools und die spezifische Meldung für den fehlgeschlagenen Einrichtungsschritt.

macOS-Berechtigungen

Dieser zu Codex gehörende Computer-Use-Pfad wird unter macOS ausgeführt, wo der MCP-Server möglicherweise lokale Betriebssystemberechtigungen benötigt, bevor er Apps untersuchen oder steuern kann. (Informationen zur plattformübergreifenden Desktop-Steuerung auf Windows- und Linux-Node-Hosts finden Sie unter cua-computer-Fulfiller.) Wenn OpenClaw meldet, dass Computer Use installiert, der MCP-Server jedoch nicht verfügbar ist, prüfen Sie zuerst die Computer-Use-Einrichtung auf der Codex-Seite:

• Codex app-server wird auf demselben Host ausgeführt, auf dem die Desktop-Steuerung erfolgen soll.
• Das Computer-Use-Plugin ist in der Codex-Konfiguration aktiviert.
• Der MCP-Server computer-use wird im MCP-Status von Codex app-server angezeigt.
• macOS hat der Desktop-Steuerungs-App die erforderlichen Berechtigungen erteilt.
• Die aktuelle Host-Sitzung kann auf den gesteuerten Desktop zugreifen.

OpenClaw bricht absichtlich sicher ab, wenn computerUse.enabled „true“ ist. Ein Durchlauf im Codex-Modus darf nicht unbemerkt ohne die nativen Desktop-Tools fortgesetzt werden, die von der Konfiguration vorausgesetzt werden.

Fehlerbehebung

Der Status meldet, dass das Plugin nicht installiert ist. Führen Sie /codex computer-use install aus. Wenn der Marketplace nicht erkannt wird, übergeben Sie --source oder --marketplace-path.

Der Status meldet, dass das Plugin installiert, aber deaktiviert ist. Führen Sie /codex computer-use install erneut aus. Die Installation durch Codex app-server schreibt die Plugin-Konfiguration wieder als aktiviert.

Der Status meldet, dass eine Remote-Installation nicht unterstützt wird. Verwenden Sie eine lokale Marketplace- Quelle oder einen lokalen Pfad. Ausschließlich remote verfügbare Katalogeinträge können untersucht, aber über die aktuelle app-server-API nicht installiert werden.

Der Status meldet, dass der MCP-Server nicht verfügbar ist. Führen Sie die Installation einmal erneut aus, damit die MCP- Server neu geladen werden. Falls er weiterhin nicht verfügbar ist, korrigieren Sie die Codex-Computer-Use-App, den MCP-Status von Codex app-server oder die macOS-Berechtigungen.

Beim Status oder einer Prüfung tritt bei computer-use.list_apps eine Zeitüberschreitung auf. Das Plugin und der MCP-Server sind vorhanden, aber die lokale Computer-Use-Bridge hat nicht geantwortet. Beenden oder starten Sie Codex Computer Use neu, starten Sie bei Bedarf Codex Desktop neu und versuchen Sie es anschließend in einer neuen OpenClaw-Sitzung erneut. Falls auf dem Host Computer Use zuvor über einen älteren verwalteten Codex app-server ausgeführt wurde, aktualisieren Sie das installierte Plugin aus dem im Desktop gebündelten Marketplace (verwenden Sie für eigenständige Codex-Desktop-Installationen den Pfad Codex.app):

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

Ein Computer-Use-Tool meldet Native hook relay unavailable. Der native Codex-Tool-Hook konnte über die lokale Bridge oder den Gateway-Fallback kein aktives OpenClaw-Relay erreichen. Starten Sie eine neue OpenClaw-Sitzung mit /new oder /reset. Wenn es einmal funktioniert und bei einem späteren Tool-Aufruf erneut fehlschlägt, bereinigt /new nur den aktuellen Versuch. Starten Sie den Codex app-server oder OpenClaw Gateway neu, damit alte Threads und Hook-Registrierungen verworfen werden, und versuchen Sie es anschließend in einer neuen Sitzung erneut.

Die automatische Installation zu Beginn eines Durchlaufs lehnt eine Quelle ab. Dies ist beabsichtigt. Fügen Sie die Quelle zuerst explizit mit /codex computer-use install --source <marketplace-source> hinzu. Danach kann die automatische Installation zu Beginn künftiger Durchläufe den erkannten lokalen Marketplace verwenden.

Verwandte Themen

• Codex-Harness
• Peekaboo-Bridge
• iOS-App