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 是 Codex 原生的 MCP Plugin，用於本機桌面控制。OpenClaw
不會內嵌桌面應用程式、自己執行桌面動作，或繞過
Codex 權限。內建的 codex Plugin 只會準備 Codex app-server：
它會啟用 Codex Plugin 支援、尋找或安裝已設定的 Codex
Computer Use Plugin、檢查 computer-use MCP 伺服器是否可用，然後
讓 Codex 在 Codex 模式回合期間擁有原生 MCP 工具呼叫。
當 OpenClaw 已經使用原生 Codex harness 時，請使用本頁。如需
runtime 設定本身，請參閱 Codex harness。
OpenClaw.app 和 Peekaboo
OpenClaw.app 的 Peekaboo 整合與 Codex Computer Use 分開。這個
macOS 應用程式可以託管 PeekabooBridge socket，讓 peekaboo CLI 能重用
應用程式的本機輔助使用與螢幕錄製授權，以供 Peekaboo 自己的
自動化工具使用。該 bridge 不會安裝或代理 Codex Computer Use，而且
Codex Computer Use 不會透過 PeekabooBridge socket 呼叫。
當你想讓 OpenClaw.app 成為 Peekaboo CLI 自動化的權限感知主機時，請使用
Peekaboo bridge。當 Codex 模式 OpenClaw 代理需要在
回合開始前可用 Codex 的原生 computer-use MCP Plugin 時，請使用本頁。
iOS 應用程式
iOS 應用程式與 Codex Computer Use 分開。它不會安裝或代理
Codex computer-use MCP 伺服器，也不是桌面控制後端。
相反地，iOS 應用程式會以 OpenClaw node 連線，並透過
node 指令公開行動能力，例如 canvas.*、camera.*、screen.*、
location.* 和 talk.*。
當你想讓代理透過 Gateway 驅動 iPhone node 時，請使用
iOS。當 Codex 模式代理需要透過 Codex 的原生 Computer Use Plugin
控制本機 macOS 桌面時，請使用本頁。
直接 cua-driver MCP
Codex Computer Use 不是公開桌面控制的唯一方式。如果你想讓
OpenClaw 管理的 runtimes 直接呼叫 TryCua 的 driver，請透過 OpenClaw 的 MCP registry
使用上游 cua-driver mcp 伺服器，而不是使用
Codex 專用的 marketplace 流程。
安裝 cua-driver 後，可以向它要求 OpenClaw 指令：
cua-driver mcp-config --client openclaw
openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'
cua-driver、授予這些權限，或繞過上游
driver 的安全模型。
快速設定
當 Codex 模式回合必須在線程開始前可用 Computer Use 時，設定
plugins.entries.codex.config.computerUse：
{
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 的內建 Codex marketplace。
如果設定仍無法讓 MCP 伺服器可用，回合會在線程開始前失敗。
現有 session 會保留它們的 runtime 和 Codex thread 綁定。變更
agentRuntime 或 Computer Use 設定後，請在受影響的
聊天中使用 /new 或 /reset 再進行測試。
在任何可用 codex Plugin 指令表面的聊天介面中，使用
/codex computer-use 指令。這些是 OpenClaw 聊天/runtime 指令，
不是 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 是唯讀的。它不會新增 marketplace sources、安裝 Plugin，或
啟用 Codex Plugin 支援。
install 會啟用 Codex app-server Plugin 支援、選擇性新增已設定的
marketplace source、透過 Codex app-server 安裝或重新啟用已設定的 Plugin、
重新載入 MCP 伺服器，並驗證 MCP 伺服器有公開工具。
Marketplace 選擇
OpenClaw 使用 Codex 自身公開的相同 app-server API。
marketplace 欄位會選擇 Codex 應該到哪裡尋找 computer-use。
| 欄位 | 使用時機 | 安裝支援 |
|---|
| 無 marketplace 欄位 | 你想讓 Codex app-server 使用它已知的 marketplaces。 | 是，當 app-server 回傳本機 marketplace 時。 |
marketplaceSource | 你有 Codex app-server 可以新增的 Codex marketplace source。 | 是，用於明確的 /codex computer-use install。 |
marketplacePath | 你已經知道主機上的本機 marketplace 檔案路徑。 | 是，用於明確安裝和回合開始自動安裝。 |
marketplaceName | 你想依名稱選取一個已註冊的 marketplace。 | 僅當選取的 marketplace 有本機路徑時才支援。 |
plugin/list 最多
marketplaceDiscoveryTimeoutMs 毫秒。預設值是 60 秒。
如果多個已知 marketplaces 包含 Computer Use，OpenClaw 會優先選擇
openai-bundled，再來是 openai-curated，然後是 local。未知且模糊的相符項
會安全失敗，並要求你設定 marketplaceName 或 marketplacePath。
內建 macOS marketplace
近期 Codex 桌面版組建會在這裡內建 Computer Use：
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled/plugins/computer-use
computerUse.autoInstall 為 true 且沒有註冊包含
computer-use 的 marketplace 時，OpenClaw 會嘗試自動新增標準內建
marketplace root：
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled
codex plugin marketplace add /Applications/Codex.app/Contents/Resources/plugins/openai-bundled
computerUse.marketplacePath 設為
本機 marketplace 檔案路徑，或先執行一次 /codex computer-use install --source <marketplace-source>。
遠端 catalog 限制
Codex app-server 可以列出並讀取僅遠端的 catalog entries，但它目前不支援
遠端 plugin/install。這表示 marketplaceName 可以
為狀態檢查選取僅遠端 marketplace，但安裝與重新啟用
仍需要透過 marketplaceSource 或 marketplacePath 使用本機 marketplace。
如果狀態顯示該 Plugin 可在遠端 Codex marketplace 中使用，但不支援遠端
安裝，請使用本機 source 或 path 執行安裝：
/codex computer-use install --source <marketplace-source>
/codex computer-use install --marketplace-path <path>
設定參考
| 欄位 | 預設值 | 意義 |
|---|
enabled | 推斷 | 要求 Computer Use。當設定另一個 Computer Use 欄位時，預設為 true。 |
autoInstall | false | 在回合開始時，從已發現的 marketplaces 安裝或重新啟用。 |
marketplaceDiscoveryTimeoutMs | 60000 | 安裝等待 Codex app-server marketplace discovery 的時間。 |
marketplaceSource | 未設定 | 傳遞給 Codex app-server marketplace/add 的 source 字串。 |
marketplacePath | 未設定 | 包含該 Plugin 的本機 Codex marketplace 檔案路徑。 |
marketplaceName | 未設定 | 要選取的已註冊 Codex marketplace 名稱。 |
pluginName | computer-use | Codex marketplace Plugin 名稱。 |
mcpServerName | computer-use | 已安裝 Plugin 公開的 MCP 伺服器名稱。 |
marketplaceSource
值。新增 source 是明確的設定操作，因此請先使用
/codex computer-use install --source <marketplace-source> 一次，然後讓
autoInstall 從已發現的本機 marketplaces 處理未來的重新啟用。
回合開始自動安裝可以使用已設定的 marketplacePath，因為那已經是
主機上的本機路徑。
OpenClaw 會檢查什麼
OpenClaw 會在內部回報穩定的設定原因，並為聊天格式化面向使用者的
狀態：
| 原因 | 意義 | 下一步 |
|---|
disabled | computerUse.enabled 解析為 false。 | 設定 enabled 或另一個 Computer Use 欄位。 |
marketplace_missing | 沒有可用的相符 marketplace。 | 設定 source、path 或 marketplace name。 |
plugin_not_installed | Marketplace 存在，但尚未安裝該 Plugin。 | 執行 install 或啟用 autoInstall。 |
plugin_disabled | Plugin 已安裝，但在 Codex config 中被停用。 | 執行 install 以重新啟用它。 |
remote_install_unsupported | 選取的 marketplace 僅限遠端。 | 使用 marketplaceSource 或 marketplacePath。 |
mcp_missing | Plugin 已啟用，但 MCP 伺服器不可用。 | 檢查 Codex Computer Use 和 OS 權限。 |
ready | Plugin 和 MCP 工具可用。 | 開始 Codex 模式回合。 |
check_failed | 狀態檢查期間 Codex app-server 請求失敗。 | 檢查 app-server 連線能力和日誌。 |
auto_install_blocked | 回合開始設定需要新增 source。 | 先執行明確安裝。 |
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 已授予 desktop-control app 所需的權限。
- 目前的主機工作階段可以存取正在受控的桌面。
當 computerUse.enabled 為 true 時，OpenClaw 會刻意採取失敗即關閉。Codex 模式的回合不應在缺少設定所要求的原生桌面工具時默默繼續。
疑難排解
狀態顯示未安裝。 執行 /codex computer-use install。如果找不到 marketplace，請傳入 --source 或 --marketplace-path。
狀態顯示已安裝但已停用。 再次執行 /codex computer-use install。Codex app-server 安裝會將 Plugin 設定寫回已啟用狀態。
狀態顯示不支援遠端安裝。 使用本機 marketplace 來源或路徑。僅遠端的目錄項目可以檢視，但無法透過目前的 app-server API 安裝。
狀態顯示 MCP 伺服器無法使用。 重新執行一次安裝，讓 MCP 伺服器重新載入。如果仍然無法使用，請修復 Codex Computer Use app、Codex app-server MCP 狀態或 macOS 權限。
狀態或探測在 computer-use.list_apps 逾時。 Plugin 和 MCP 伺服器都存在，但本機 Computer Use bridge 沒有回應。結束或重新啟動 Codex Computer Use，必要時重新啟動 Codex Desktop，然後在新的 OpenClaw 工作階段中重試。
Computer Use 工具顯示 Native hook relay unavailable。 Codex 原生工具掛鉤無法透過本機 bridge 或 Gateway 後援連到作用中的 OpenClaw relay。使用 /new 或 /reset 啟動新的 OpenClaw 工作階段。如果持續發生，請重新啟動 Gateway，讓舊的 app-server 執行緒和掛鉤註冊被移除，然後重試。
回合開始自動安裝拒絕某個來源。 這是刻意設計。請先使用明確的 /codex computer-use install --source <marketplace-source> 加入來源，之後的回合開始自動安裝就能使用已探索到的本機 marketplace。