Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Computer Use is een Codex-native MCP-Plugin voor lokale desktopbesturing. OpenClaw
vendort de desktop-app niet, voert zelf geen desktopacties uit en omzeilt geen
Codex-machtigingen. De meegeleverde codex-Plugin bereidt alleen Codex app-server voor:
deze schakelt ondersteuning voor Codex-Plugins in, vindt of installeert de geconfigureerde Codex
Computer Use-Plugin, controleert of de computer-use MCP-server beschikbaar is, en
laat Codex daarna eigenaar zijn van de native MCP-toolaanroepen tijdens Codex-modusbeurten.
Gebruik deze pagina wanneer OpenClaw de native Codex-harness al gebruikt. Zie voor de
runtimeconfiguratie zelf Codex-harness.
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 de peekaboo CLI de
lokale Accessibility- en Screen Recording-toestemmingen van de app kan hergebruiken 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 begint.
iOS-app
De iOS-app staat los van Codex Computer Use. Deze installeert of proxyt de
Codex computer-use MCP-server niet en is geen backend voor desktopbesturing.
In plaats daarvan maakt de iOS-app verbinding als een OpenClaw-node en stelt mobiele
mogelijkheden beschikbaar via node-opdrachten zoals canvas.*, camera.*, screen.*,
location.* en talk.*.
Gebruik iOS wanneer je wilt dat een agent een iPhone-node aanstuurt via
de Gateway. Gebruik deze pagina wanneer een agent in Codex-modus de lokale
macOS-desktop moet besturen via de native Computer Use-Plugin van Codex.
Directe cua-driver MCP
Codex Computer Use is niet de enige manier om desktopbesturing beschikbaar te maken. Als je wilt dat
door OpenClaw beheerde runtimes TryCua’s driver rechtstreeks aanroepen, gebruik dan de upstream
cua-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 mcp-config --client openclaw
openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'
cua-driver niet, verleent die machtigingen niet en omzeilt het veiligheidsmodel
van de upstream driver niet.
Snelle configuratie
Stel plugins.entries.codex.config.computerUse in wanneer beurten in Codex-modus
Computer Use beschikbaar moeten hebben voordat een thread begint:
{
plugins: {
entries: {
codex: {
enabled: true,
config: {
computerUse: {
autoInstall: true,
},
},
},
},
},
agents: {
defaults: {
model: "openai/gpt-5.5",
agentRuntime: {
id: "codex",
fallback: "none",
},
},
},
}
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled voordat het
mislukt. Als de configuratie de MCP-server nog steeds niet beschikbaar kan maken, mislukt de beurt
voordat de thread begint.
Bestaande sessies behouden hun runtime- en Codex-threadbinding. Gebruik na het wijzigen van
agentRuntime of de Computer Use-configuratie /new of /reset in de betreffende
chat voordat je test.
Opdrachten
Gebruik de /codex computer-use-opdrachten vanuit elk chatoppervlak waar het
codex-Plugin-opdrachtoppervlak beschikbaar is. Dit zijn OpenClaw-chat-/runtimeopdrachten,
geen openclaw codex ... CLI-subopdrachten:
/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 is alleen-lezen. Het voegt geen marketplace-bronnen toe, installeert geen Plugins en
schakelt geen ondersteuning voor Codex-Plugins in.
install schakelt Codex app-server-Plugin-ondersteuning in, voegt optioneel een geconfigureerde
marketplace-bron toe, installeert of heractiveert de geconfigureerde Plugin via Codex
app-server, laadt MCP-servers opnieuw en controleert of de MCP-server tools beschikbaar stelt.
Marketplace-keuzes
OpenClaw gebruikt dezelfde app-server-API die Codex zelf beschikbaar stelt. De
marketplace-velden kiezen waar Codex computer-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 standaardwaarde is 60 seconden.
Als meerdere bekende marketplaces Computer Use bevatten, geeft OpenClaw de voorkeur aan
openai-bundled, daarna openai-curated, daarna local. Onbekende dubbelzinnige matches
mislukken gesloten en vragen je om marketplaceName of marketplacePath in te stellen.
Meegeleverde macOS-marketplace
Recente Codex-desktopbuilds leveren Computer Use hier mee:
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled/plugins/computer-use
computerUse.autoInstall true is en er geen marketplace met
computer-use is geregistreerd, probeert OpenClaw automatisch de standaard meegeleverde
marketplace-root toe te voegen:
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled
codex plugin marketplace add /Applications/Codex.app/Contents/Resources/plugins/openai-bundled
computerUse.marketplacePath in op een
lokaal marketplace-bestandspad of voer één keer /codex computer-use install --source <marketplace-source> uit.
Limiet van externe catalogus
Codex app-server kan externe catalogusvermeldingen die alleen op afstand bestaan weergeven en lezen, maar ondersteunt
momenteel geen externe plugin/install. Dat betekent dat marketplaceName een
externe-only marketplace kan selecteren voor statuscontroles, maar installaties en heractiveringen
nog steeds een lokale marketplace nodig hebben via marketplaceSource of marketplacePath.
Als status meldt dat de Plugin beschikbaar is in een externe Codex-marketplace maar externe
installatie niet wordt ondersteund, voer installatie uit met een lokale bron of pad:
/codex computer-use install --source <marketplace-source>
/codex computer-use install --marketplace-path <path>
Configuratiereferentie
| Veld | Standaard | Betekenis |
|---|
enabled | afgeleid | Vereist Computer Use. Standaard true wanneer een ander Computer Use-veld is ingesteld. |
autoInstall | false | Installeer of heractiveer vanuit al ontdekte marketplaces bij beurtstart. |
marketplaceDiscoveryTimeoutMs | 60000 | Hoe lang installatie wacht op marketplace-detectie door Codex app-server. |
marketplaceSource | niet ingesteld | Brontekst die wordt doorgegeven aan Codex app-server marketplace/add. |
marketplacePath | niet ingesteld | Lokaal Codex-marketplace-bestandspad dat de Plugin bevat. |
marketplaceName | niet ingesteld | Naam van geregistreerde Codex-marketplace om te selecteren. |
pluginName | computer-use | Naam van de Codex-marketplace-Plugin. |
mcpServerName | computer-use | MCP-servernaam die door de geïnstalleerde Plugin beschikbaar wordt gesteld. |
marketplaceSource-
waarden. Het toevoegen van een nieuwe bron is een expliciete configuratiehandeling, dus gebruik
één keer /codex computer-use install --source <marketplace-source> en laat daarna
autoInstall toekomstige heractiveringen vanuit ontdekte lokale marketplaces afhandelen.
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 configuratiereden en formatteert de gebruikersgerichte
status voor chat:
| Reden | Betekenis | Volgende stap |
|---|
disabled | computerUse.enabled is herleid tot false. | 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 geïnstalleerd. | Voer installatie uit of schakel autoInstall in. |
plugin_disabled | Plugin is geïnstalleerd maar uitgeschakeld in Codex-configuratie. | Voer installatie uit om deze opnieuw in te schakelen. |
remote_install_unsupported | Geselecteerde marketplace is alleen extern. | 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 beurt in Codex-modus. |
check_failed | Een Codex app-server-aanvraag is mislukt tijdens statuscontrole. | Controleer app-server-connectiviteit en logs. |
auto_install_blocked | Configuratie bij beurtstart zou een nieuwe bron moeten toevoegen. | Voer eerst expliciete installatie uit. |
macOS-machtigingen
Computer Use is macOS-specifiek. De door Codex beheerde MCP-server heeft mogelijk lokale OS-
machtigingen nodig voordat deze apps kan inspecteren of besturen. Als OpenClaw zegt dat Computer Use
is geïnstalleerd maar de MCP-server niet beschikbaar is, controleer dan eerst de Codex-kant van de Computer
Use-configuratie:
- Codex app-server draait op dezelfde host waar desktopbesturing moet
plaatsvinden.
- De Computer Use Plugin is ingeschakeld in de Codex-configuratie.
- De
computer-use MCP-server verschijnt in de MCP-status van Codex app-server.
- macOS heeft de vereiste machtigingen verleend voor de desktopbesturingsapp.
- De huidige hostsessie heeft toegang tot de desktop die wordt bestuurd.
OpenClaw faalt bewust gesloten wanneer computerUse.enabled true is. Een
beurt in Codex-modus mag niet stilzwijgend doorgaan zonder de native
desktoptools die de configuratie vereist.
Probleemoplossing
Status zegt dat het niet is geïnstalleerd. Voer /codex computer-use install uit. Als de
marketplace niet wordt gevonden, geef dan --source of --marketplace-path mee.
Status zegt dat het is geïnstalleerd maar uitgeschakeld. Voer /codex computer-use install opnieuw uit.
De installatie van Codex app-server schrijft de Plugin-configuratie weer terug als ingeschakeld.
Status zegt dat installatie op afstand niet wordt ondersteund. Gebruik een lokale marketplace-bron of
-pad. Vermeldingen in een catalogus die alleen op afstand beschikbaar is, kunnen worden bekeken maar niet worden geïnstalleerd via de
huidige app-server-API.
Status zegt dat de MCP-server niet beschikbaar is. Voer de installatie eenmaal opnieuw uit zodat MCP-
servers opnieuw laden. Als deze niet beschikbaar blijft, herstel dan de Codex Computer Use-app,
de MCP-status van Codex app-server of de 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 antwoordde niet. Sluit of
herstart Codex Computer Use, start Codex Desktop opnieuw als dat nodig is en probeer het daarna opnieuw in een
nieuwe OpenClaw-sessie.
Een Computer Use-tool zegt Native hook relay unavailable. De native Codex-
toolhook kon geen actieve OpenClaw-relay bereiken via de lokale bridge of
Gateway-fallback. Start een nieuwe OpenClaw-sessie met /new of /reset. Als dit
blijft gebeuren, herstart dan de gateway zodat oude app-server-threads en hook-
registraties worden verwijderd, en probeer het daarna opnieuw.
Automatische installatie bij het begin van een beurt weigert een bron. Dit is opzettelijk. Voeg de
bron eerst toe met expliciet /codex computer-use install --source <marketplace-source>,
waarna toekomstige automatische installatie bij het begin van een beurt de gevonden lokale
marketplace kan gebruiken.