codex-plugin bereidt alleen Codex app-server
voor: deze schakelt Codex-pluginondersteuning in, vindt of installeert de
geconfigureerde Codex Computer Use-plugin, controleert of de computer-use
MCP-server beschikbaar is en laat Codex daarna de native MCP-toolaanroepen
beheren tijdens Codex-modusbeurten.
Gebruik deze pagina wanneer OpenClaw al de native Codex-harness gebruikt. Zie
Codex-harness voor de runtime-installatie zelf.
OpenClaw.app en Peekaboo
De Peekaboo-integratie van OpenClaw.app staat los van Codex Computer Use. De macOS-app kan een PeekabooBridge-socket hosten zodat depeekaboo CLI de lokale
toestemmingen voor Toegankelijkheid en Schermopname van de app opnieuw kan
gebruiken voor Peekaboo’s eigen automatiseringstools. Die bridge installeert of
proxyt Codex Computer Use niet, en Codex Computer Use roept niet aan via de
PeekabooBridge-socket.
Gebruik Peekaboo-bridge wanneer je wilt dat
OpenClaw.app een machtigingsbewuste host is voor Peekaboo CLI-automatisering.
Gebruik deze pagina wanneer een OpenClaw-agent in Codex-modus de native
computer-use MCP-plugin van Codex beschikbaar moet hebben voordat de beurt
start.
iOS-app
De iOS-app staat los van Codex Computer Use. Deze installeert of proxyt de Codexcomputer-use MCP-server niet en is geen backend voor desktopbediening. In
plaats daarvan maakt de iOS-app verbinding als OpenClaw-node en stelt deze
mobiele mogelijkheden beschikbaar via node-opdrachten zoals canvas.*,
camera.*, screen.*, location.* en talk.*.
Gebruik iOS wanneer je wilt dat een agent een iPhone-node via
de Gateway aanstuurt. Gebruik deze pagina wanneer een agent in Codex-modus de
lokale macOS-desktop moet bedienen via de native Computer Use-plugin van Codex.
Directe cua-driver MCP
Codex Computer Use is niet de enige manier om desktopbediening beschikbaar te maken. Als je wilt dat door OpenClaw beheerde runtimes TryCua’s driver direct aanroepen, gebruik dan de upstreamcua-driver mcp-server via OpenClaw’s
MCP-register in plaats van de Codex-specifieke marketplace-flow.
Vraag na het installeren van cua-driver om de OpenClaw-opdracht:
cua-driver niet, verleent die machtigingen
niet en omzeilt het veiligheidsmodel van de upstream driver niet.
Snelle installatie
Stelplugins.entries.codex.config.computerUse in wanneer Codex-modusbeurten
Computer Use beschikbaar moeten hebben voordat een thread start. autoInstall: true meldt Computer Use aan en laat OpenClaw het installeren of opnieuw
inschakelen vóór de beurt:
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled voordat het
faalt. Als de installatie de MCP-server nog steeds niet beschikbaar kan maken,
mislukt de beurt voordat de thread start.
Gebruik na het wijzigen van de Computer Use-configuratie /new of /reset in
de betrokken chat voordat je test, als er al een bestaande Codex-thread is
gestart.
Bij door macOS beheerde stdio-start geeft OpenClaw de voorkeur aan de
ondertekende desktop-Codex-appbundel op
/Applications/Codex.app/Contents/Resources/codex wanneer die bestaat. Zo
blijft Computer Use onder de appbundel die eigenaar is van de lokale
machtigingen voor desktopbediening. Als de desktop-app niet is geïnstalleerd,
valt OpenClaw terug op de beheerde Codex-binary die naast de plugin is
geïnstalleerd. Als een geïnstalleerde desktop-app initialiseert met een niet
ondersteunde app-serverversie, sluit OpenClaw dat child-proces en probeert het
de volgende beheerde binary-kandidaat, in plaats van een verouderde desktop-app
de plugin-lokale fallback te laten overschaduwen. Expliciete
appServer.command-configuratie of OPENCLAW_CODEX_APP_SERVER_BIN overschrijft
deze beheerde selectie nog steeds.
Opdrachten
Gebruik de/codex computer-use-opdrachten vanaf elk chatoppervlak waar het
opdrachtoppervlak van de codex-plugin beschikbaar is. Dit zijn OpenClaw
chat-/runtime-opdrachten, geen openclaw codex ... CLI-subopdrachten:
status is alleen-lezen. Deze voegt geen marketplace-bronnen toe, installeert
geen plugins en schakelt geen Codex-pluginondersteuning in. Als er geen
configuratie is die Computer Use aanmeldt, kan status uitgeschakeld melden,
zelfs na een eenmalige installatieopdracht.
install schakelt Codex app-server-pluginondersteuning in, voegt optioneel een
geconfigureerde marketplace-bron toe, installeert of schakelt de geconfigureerde
plugin opnieuw in via Codex app-server, laadt MCP-servers opnieuw en verifieert
dat de MCP-server tools beschikbaar maakt. Omdat installatie vertrouwde
hostbronnen wijzigt, kan alleen een eigenaar of een operator.admin
Gateway-client install uitvoeren. Andere geautoriseerde afzenders kunnen de
alleen-lezen opdracht status blijven gebruiken, ook met overschrijvingen.
Marketplace-keuzes
OpenClaw gebruikt dezelfde app-server-API die Codex zelf beschikbaar stelt. De marketplace-velden bepalen waar Codexcomputer-use moet vinden.
| Veld | Gebruik wanneer | Installatieondersteuning |
|---|---|---|
| Geen marketplace-veld | Je wilt dat Codex app-server marketplaces gebruikt die het al kent. | Ja, wanneer app-server een lokale marketplace retourneert. |
marketplaceSource | Je hebt een Codex marketplace-bron die app-server kan toevoegen. | Ja, voor expliciete /codex computer-use install. |
marketplacePath | Je kent het lokale marketplace-bestandspad op de host al. | Ja, voor expliciete installatie en automatische installatie bij beurtstart. |
marketplaceName | Je wilt één al geregistreerde marketplace op naam selecteren. | Alleen ja wanneer de geselecteerde marketplace een lokaal pad heeft. |
plugin/list
gedurende maximaal marketplaceDiscoveryTimeoutMs milliseconden. De standaard
is 60 seconden.
Als meerdere bekende marketplaces Computer Use bevatten, geeft OpenClaw de
voorkeur aan openai-bundled, daarna openai-curated en daarna local.
Onbekende dubbelzinnige matches falen gesloten en vragen je om
marketplaceName of marketplacePath in te stellen.
Gebundelde macOS-marketplace
Recente Codex-desktopbuilds bundelen Computer Use hier:computerUse.autoInstall waar is en er geen marketplace met
computer-use is geregistreerd, probeert OpenClaw automatisch de standaard
gebundelde marketplace-root toe te voegen:
/codex computer-use install --source <marketplace-root> uit of stel
computerUse.marketplacePath in op een lokaal marketplace-bestandspad. Gebruik
--marketplace-path alleen wanneer je het marketplace JSON-bestandspad hebt,
niet de gebundelde marketplace-root.
Limiet voor externe catalogus
Codex app-server kan catalogusvermeldingen die alleen extern zijn weergeven en lezen, maar ondersteunt momenteel geen externeplugin/install. Dat betekent
dat marketplaceName een alleen-externe marketplace kan selecteren voor
statuscontroles, maar installaties en opnieuw inschakelen nog steeds een lokale
marketplace nodig hebben via marketplaceSource of marketplacePath.
Als status zegt dat de plugin beschikbaar is in een externe Codex marketplace
maar externe installatie niet wordt ondersteund, voer dan install uit met een
lokale bron of pad:
Configuratiereferentie
| Veld | Standaard | Betekenis |
|---|---|---|
enabled | inferred | Computer Use vereisen. Staat standaard op waar wanneer een ander Computer Use-veld is ingesteld. |
autoInstall | false | Installeren of opnieuw inschakelen vanuit al ontdekte marketplaces bij beurtstart. |
marketplaceDiscoveryTimeoutMs | 60000 | Hoelang install wacht op marketplace-detectie door Codex app-server. |
marketplaceSource | unset | Brontekst doorgegeven aan Codex app-server marketplace/add. |
marketplacePath | unset | Lokaal Codex marketplace-bestandspad dat de plugin bevat. |
marketplaceName | unset | Geregistreerde Codex marketplace-naam om te selecteren. |
pluginName | computer-use | Codex marketplace-pluginnaam. |
mcpServerName | computer-use | MCP-servernaam die door de geïnstalleerde plugin beschikbaar wordt gemaakt. |
marketplaceSource-waarden. Het toevoegen van een nieuwe bron is een expliciete
installatiehandeling, dus gebruik één keer /codex computer-use install --source <marketplace-source> en laat autoInstall daarna toekomstige herinschakelingen
afhandelen vanuit ontdekte lokale marketplaces. Automatische installatie bij
beurtstart kan een geconfigureerde marketplacePath gebruiken, omdat dat al een
lokaal pad op de host is.
Wat OpenClaw controleert
OpenClaw rapporteert intern een stabiele installatiereden en formatteert de gebruikersgerichte status voor chat:| Reden | Betekenis | Volgende stap |
|---|---|---|
disabled | computerUse.enabled is naar false opgelost. | Stel enabled of een ander Computer Use-veld in. |
marketplace_missing | Er was geen overeenkomende marketplace beschikbaar. | Configureer bron, pad of marketplace-naam. |
plugin_not_installed | Marketplace bestaat, maar de Plugin is niet geinstalleerd. | Voer install uit of schakel autoInstall in. |
plugin_disabled | Plugin is geinstalleerd maar uitgeschakeld in de Codex-configuratie. | Voer install uit om deze opnieuw in te schakelen. |
remote_install_unsupported | Geselecteerde marketplace is alleen remote. | Gebruik marketplaceSource of marketplacePath. |
mcp_missing | Plugin is ingeschakeld, maar de MCP-server is niet beschikbaar. | Controleer Codex Computer Use en OS-machtigingen. |
ready | Plugin en MCP-tools zijn beschikbaar. | Start de Codex-modusbeurt. |
check_failed | Een Codex app-server-aanvraag is mislukt tijdens de statuscontrole. | Controleer app-server-connectiviteit en logs. |
auto_install_blocked | De setup bij beurtstart zou een nieuwe bron moeten toevoegen. | Voer eerst een expliciete install uit. |
macOS-machtigingen
Computer Use is macOS-specifiek. De MCP-server die eigendom is van Codex kan lokale OS- machtigingen nodig hebben voordat deze apps kan inspecteren of bedienen. Als OpenClaw zegt dat Computer Use is geinstalleerd maar de MCP-server niet beschikbaar is, controleer dan eerst de Computer Use-setup aan Codex-zijde:- Codex app-server draait op dezelfde host waar desktopbediening moet plaatsvinden.
- De Computer Use-Plugin is ingeschakeld in de Codex-configuratie.
- De
computer-useMCP-server verschijnt in de MCP-status van Codex app-server. - macOS heeft de vereiste machtigingen verleend voor de desktopbedieningsapp.
- De huidige hostsessie heeft toegang tot de desktop die wordt bediend.
computerUse.enabled true is. Een
Codex-modusbeurt mag niet stilzwijgend doorgaan zonder de native desktoptools
die de configuratie vereiste.
Probleemoplossing
Status zegt niet geinstalleerd. Voer/codex computer-use install uit. Als de
marketplace niet wordt ontdekt, geef dan --source of --marketplace-path mee.
Status zegt geinstalleerd maar uitgeschakeld. Voer /codex computer-use install opnieuw uit.
Codex app-server-install schrijft de Plugin-configuratie terug naar ingeschakeld.
Status zegt dat remote-install niet wordt ondersteund. Gebruik een lokale marketplace-bron of
-pad. Catalogusvermeldingen die alleen remote zijn, kunnen worden bekeken maar niet worden geinstalleerd via de
huidige app-server-API.
Status zegt dat de MCP-server niet beschikbaar is. Voer install eenmaal opnieuw uit zodat MCP-
servers herladen. Als deze niet beschikbaar blijft, herstel dan de Codex Computer Use-app,
de MCP-status van Codex app-server of macOS-machtigingen.
Status of een probe krijgt een time-out op computer-use.list_apps. De Plugin en MCP-
server zijn aanwezig, maar de lokale Computer Use-bridge heeft niet geantwoord. Sluit of
herstart Codex Computer Use, start Codex Desktop indien nodig opnieuw en probeer het daarna opnieuw in een
nieuwe OpenClaw-sessie. Als de host eerder Computer Use uitvoerde via een oudere
beheerde Codex app-server, vernieuw dan de geinstalleerde Plugin vanuit de gebundelde desktop-
marketplace:
Native hook relay unavailable. De Codex-native
toolhook kon geen actieve OpenClaw-relay bereiken via de lokale bridge of
Gateway-fallback. Start een nieuwe OpenClaw-sessie met /new of /reset. Als het
eenmaal werkt en daarna opnieuw mislukt bij een latere toolaanroep, wist /new alleen de
huidige poging; herstart de Codex app-server of OpenClaw Gateway zodat oude threads
en hookregistraties worden verwijderd, en probeer het daarna opnieuw in een nieuwe sessie.
Automatische install bij beurtstart weigert een bron. Dit is opzettelijk. Voeg eerst de
bron toe met expliciet /codex computer-use install --source <marketplace-source>;
daarna kan toekomstige automatische install bij beurtstart de ontdekte lokale
marketplace gebruiken.