Codex Computer Use

기준일: 2026-07-26
공식 기준: Codex Computer Use

Codex Computer Use 문서는 OpenClaw 공식 문서(plugins/codex-computer-use)를 한국어로 정리한 가이드입니다. Set up Codex Computer Use for Codex-mode OpenClaw agents 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Set up Codex Computer Use for Codex-mode OpenClaw agents

한국어 가이드 범위: plugins/codex-computer-use 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• iOS app
• Direct cua-driver MCP
• 빠른 설정
• 명령
• Marketplace choices
• Bundled macOS marketplace
• Shared plugin cache
• Remote catalog limit
• Configuration reference
• What OpenClaw checks
• macOS permissions
• 트러블슈팅
• 관련 문서

상세 내용

본문

Computer Use is a Codex-native MCP plugin for local desktop control. OpenClaw does not vendor the desktop app, execute desktop actions itself, or bypass Codex permissions. The bundled codex plugin only prepares Codex app-server: it enables Codex plugin support, finds or installs the configured Computer Use plugin, checks that the computer-use MCP server is available, and then lets Codex own the native MCP tool calls during Codex-mode turns.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

OpenClaw.app and Peekaboo

OpenClaw.app's Peekaboo integration is separate from Codex Computer Use. The macOS app can host a PeekabooBridge socket so the peekaboo CLI can reuse the app's local Accessibility and Screen Recording grants for Peekaboo's own automation tools. That bridge does not install or proxy Codex Computer Use, and Codex Computer Use does not call through the PeekabooBridge socket.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

iOS app

The iOS app is separate from Codex Computer Use. It does not install or proxy the Codex computer-use MCP server and it is not a desktop-control backend. Instead, the iOS app connects as an OpenClaw node and exposes mobile capabilities through node commands such as canvas.*, camera.*, screen.*, location.*, and talk.*.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Direct cua-driver MCP

Codex Computer Use is not the only way to expose desktop control. If you want OpenClaw-managed runtimes to call TryCua's driver directly, use the upstream cua-driver mcp server through OpenClaw's MCP registry instead of the Codex-specific marketplace flow.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

cua-driver mcp-config --client openclaw

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

빠른 설정

Set plugins.entries.codex.config.computerUse when Codex-mode turns must have Computer Use available before a thread starts. autoInstall: true opts Computer Use in and lets OpenClaw install or re-enable it before the turn:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

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

명령

Use the /codex computer-use commands from any chat surface where the codex plugin command surface is available. These are OpenClaw chat/runtime commands, not openclaw codex ... CLI subcommands:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

/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>

Marketplace choices

OpenClaw uses the same app-server API that Codex itself exposes. The marketplace fields choose where Codex should find computer-use.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Field	Use when	Install support
No marketplace field	You want Codex app-server to use marketplaces it already knows.	Yes, when app-server returns a local marketplace.
marketplaceSource	You have a Codex marketplace source app-server can add.	Yes, for explicit /codex computer-use install.
marketplacePath	You already know the local marketplace file path on the host.	Yes, for explicit install and turn-start auto-install.
marketplaceName	You want to select one already registered marketplace by name.	Yes only when the selected marketplace has a local path.

Bundled macOS marketplace

Current ChatGPT desktop builds bundle Computer Use here; legacy standalone Codex desktop builds use the same layout under Codex.app:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

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

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

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

Shared plugin cache

The default pluginCacheMode: "independent" leaves each Codex home and its plugin cache unmanaged. Set pluginCacheMode: "shared" to copy the bundled Computer Use plugin into the active Codex home's discoverable plugin cache before app-server startup. Shared mode preserves older cached versions because running Codex clients can still reference their versioned plugin directories; a failed replacement copy also preserves the active cache. Explicit marketplaceName or marketplacePath configuration disables this reconciliation so OpenClaw does not override that selection.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Remote catalog limit

Codex app-server can list and read remote-only catalog entries, but it does not currently support remote plugin/install. That means marketplaceName can select a remote-only marketplace for status checks, but installs and re-enables still need a local marketplace via marketplaceSource or marketplacePath.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

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

Configuration reference

Turn-start auto-install intentionally refuses configured marketplaceSource values. Adding a new source is an explicit setup operation, so use /codex computer-use install --source once, then let autoInstall handle future re-enables from discovered local marketplaces. Turn-start auto-install can use a configured marketplacePath, because that is already a local path on the host.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Field	Default	Meaning
enabled	inferred	Require Computer Use. Defaults to true when another Computer Use field is set.
autoInstall	false	Provision the native client and install or re-enable the plugin at turn start.
marketplaceDiscoveryTimeoutMs	60000	How long install waits for Codex app-server marketplace discovery.
liveTestTimeoutMs	60000	Timeout for the temporary readiness thread and its cleanup requests.
toolCallTimeoutMs	60000	Timeout for the Computer Use list_apps readiness tool call.
healthCheckEnabled	false	Run periodic readiness probes while the owning app-server client is active.
healthCheckIntervalMinutes	60	Probe cadence; accepted values are 30, 60, 120, or 240 minutes.
pluginCacheMode	independent	Use shared to refresh the Codex-home cache from the bundled desktop plugin.
strictReadiness	false	Stop startup on a failed live probe instead of continuing with a warning.
autoRepair	false	Kill stale scoped Computer Use MCP children and retry a failed probe once.
marketplaceSource	unset	Source string passed to Codex app-server marketplace/add.
marketplacePath	unset	Local Codex marketplace file path containing the plugin.
marketplaceName	unset	Registered Codex marketplace name to select.
pluginName	computer-use	Codex marketplace plugin name.
mcpServerName	computer-use	MCP server name exposed by the installed plugin.

Field	Env var
enabled	OPENCLAW_CODEX_COMPUTER_USE
autoInstall	OPENCLAW_CODEX_COMPUTER_USE_AUTO_INSTALL
marketplaceDiscoveryTimeoutMs	OPENCLAW_CODEX_COMPUTER_USE_MARKETPLACE_DISCOVERY_TIMEOUT_MS
liveTestTimeoutMs	OPENCLAW_CODEX_COMPUTER_USE_LIVE_TEST_TIMEOUT_MS
toolCallTimeoutMs	OPENCLAW_CODEX_COMPUTER_USE_TOOL_CALL_TIMEOUT_MS
healthCheckEnabled	OPENCLAW_CODEX_COMPUTER_USE_HEALTH_CHECK_ENABLED
healthCheckIntervalMinutes	OPENCLAW_CODEX_COMPUTER_USE_HEALTH_CHECK_INTERVAL_MINUTES
pluginCacheMode	OPENCLAW_CODEX_COMPUTER_USE_PLUGIN_CACHE_MODE
strictReadiness	OPENCLAW_CODEX_COMPUTER_USE_STRICT_READINESS
autoRepair	OPENCLAW_CODEX_COMPUTER_USE_AUTO_REPAIR
marketplaceSource	OPENCLAW_CODEX_COMPUTER_USE_MARKETPLACE_SOURCE
marketplacePath	OPENCLAW_CODEX_COMPUTER_USE_MARKETPLACE_PATH
marketplaceName	OPENCLAW_CODEX_COMPUTER_USE_MARKETPLACE_NAME
pluginName	OPENCLAW_CODEX_COMPUTER_USE_PLUGIN_NAME
mcpServerName	OPENCLAW_CODEX_COMPUTER_USE_MCP_SERVER_NAME

What OpenClaw checks

OpenClaw reports a stable setup reason internally and formats the user-facing status for chat:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Reason	Meaning	Next step
disabled	computerUse.enabled resolved to false.	Set enabled or another Computer Use field.
marketplace_missing	No matching marketplace was available.	Configure source, path, or marketplace name.
plugin_not_installed	Marketplace exists, but the plugin is not installed.	Run install or enable autoInstall.
plugin_disabled	Plugin is installed but disabled in Codex config.	Run install to re-enable it.
remote_install_unsupported	Selected marketplace is remote-only.	Use marketplaceSource or marketplacePath.
mcp_missing	Plugin is enabled, but the MCP server is unavailable.	Check Codex Computer Use and OS permissions.
ready	Plugin and MCP tools are available.	Start the Codex-mode turn.
check_failed	A Codex app-server request failed during status check.	Check app-server connectivity and logs.
auto_install_blocked	Turn-start setup would need to add a new source.	Run explicit install first.

macOS permissions

This Codex-owned Computer Use path runs on macOS, where the MCP server may need local OS permissions before it can inspect or control apps. (For cross-platform desktop control on Windows and Linux node hosts, see the cua-computer fulfiller.) If OpenClaw says Computer Use is installed but the MCP server is unavailable, verify the Codex-side Computer Use setup first:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Codex app-server is running on the same host where desktop control should
• The Computer Use plugin is enabled in Codex config.
• The computer-use MCP server appears in Codex app-server MCP status.
• macOS has granted the required permissions for the desktop-control app.
• The current host session can access the desktop being controlled.

트러블슈팅

marketplace is not discovered, pass --source or --marketplace-path.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

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

관련 문서

주요 항목:

• Codex harness
• Peekaboo bridge
• iOS app

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/plugins/codex-computer-use
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

cua-driver mcp-config --client openclaw

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

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

/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>

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

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

관련 링크

• 공식 원문: plugins/codex-computer-use
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.