Documentation Index
Fetch the complete documentation index at: https://docs2.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 時，請使用此頁面。若要設定執行階段本身，請參閱 Codex harness。
OpenClaw.app 與 Peekaboo
OpenClaw.app 的 Peekaboo 整合與 Codex Computer Use 是分開的。macOS 應用程式可以託管 PeekabooBridge socket，讓 peekaboo CLI 能重用應用程式的本機輔助使用與螢幕錄製授權，供 Peekaboo 自己的自動化工具使用。該橋接不會安裝或代理 Codex Computer Use，而 Codex Computer Use 也不會透過 PeekabooBridge socket 呼叫。
當你想讓 OpenClaw.app 成為具權限感知能力的 Peekaboo CLI 自動化主機時，請使用 Peekaboo bridge。當 Codex 模式的 OpenClaw agent 應在回合開始前取得 Codex 原生 computer-use MCP Plugin 時，請使用此頁面。
iOS 應用程式
iOS 應用程式與 Codex Computer Use 是分開的。它不會安裝或代理 Codex computer-use MCP 伺服器，也不是桌面控制後端。相反地，iOS 應用程式會作為 OpenClaw Node 連線，並透過 canvas.*、camera.*、screen.*、location.* 和 talk.* 等 Node 命令公開行動裝置功能。
當你想讓 agent 透過 Gateway 驅動 iPhone Node 時，請使用 iOS。當 Codex 模式 agent 應透過 Codex 原生 Computer Use Plugin 控制本機 macOS 桌面時，請使用此頁面。
直接使用 cua-driver MCP
Codex Computer Use 不是公開桌面控制的唯一方式。如果你想讓 OpenClaw 管理的執行階段直接呼叫 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",
},
},
}
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled 註冊內建的 Codex marketplace。如果設定仍無法讓 MCP 伺服器可用，回合會在線程開始前失敗。
變更 Computer Use 設定後，如果既有 Codex 線程已經開始，請在測試前於受影響的聊天中使用 /new 或 /reset。
在任何可用 codex Plugin 命令介面的聊天介面中，使用 /codex computer-use 命令。這些是 OpenClaw 聊天/執行階段命令，不是 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 source、安裝 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 使用它已知的 marketplace。 | 是，當 app-server 傳回本機 marketplace 時。 |
marketplaceSource | 你有 Codex marketplace source，且 app-server 可以新增。 | 是，用於明確的 /codex computer-use install。 |
marketplacePath | 你已知道主機上的本機 marketplace 檔案路徑。 | 是，用於明確安裝與回合開始自動安裝。 |
marketplaceName | 你想依名稱選取一個已註冊的 marketplace。 | 僅當選取的 marketplace 有本機路徑時支援。 |
plugin/list，最長達 marketplaceDiscoveryTimeoutMs 毫秒。預設值為 60 秒。
如果多個已知 marketplace 包含 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，且沒有已註冊的 marketplace 包含 computer-use 時，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 項目，但目前不支援遠端 plugin/install。這表示 marketplaceName 可以為狀態檢查選取僅遠端的 marketplace，但安裝與重新啟用仍需要透過 marketplaceSource 或 marketplacePath 使用本機 marketplace。
如果狀態顯示 Plugin 可在遠端 Codex marketplace 中使用，但不支援遠端安裝，請使用本機 source 或 path 執行 install：
/codex computer-use install --source <marketplace-source>
/codex computer-use install --marketplace-path <path>
設定參考
| 欄位 | 預設值 | 意義 |
|---|
enabled | 推斷 | 要求 Computer Use。當設定另一個 Computer Use 欄位時，預設為 true。 |
autoInstall | false | 在回合開始時，從已發現的 marketplace 安裝或重新啟用。 |
marketplaceDiscoveryTimeoutMs | 60000 | install 等待 Codex app-server marketplace 探索的時間長度。 |
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 處理未來從已發現本機 marketplace 的重新啟用。回合開始自動安裝可以使用已設定的 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。 | 先執行明確 install。 |
macOS 權限
Computer Use 僅適用於 macOS。Codex 擁有的 MCP 伺服器可能需要本機 OS 權限，才能檢查或控制應用程式。如果 OpenClaw 表示 Computer Use 已安裝，但 MCP 伺服器不可用，請先驗證 Codex 端的 Computer Use 設定：
- Codex app-server 正在應發生桌面控制的同一台主機上執行。
- Computer Use Plugin 已在 Codex 設定中啟用。
computer-use MCP server 出現在 Codex app-server MCP 狀態中。- macOS 已授予桌面控制應用程式所需的權限。
- 目前的主機工作階段可以存取受控制的桌面。
當 computerUse.enabled 為 true 時，OpenClaw 會刻意採取失敗即拒絕執行的行為。Codex 模式的回合不應在沒有設定所要求的原生桌面工具時默默繼續。
疑難排解
狀態顯示未安裝。 執行 /codex computer-use install。如果未探索到 marketplace，請傳入 --source 或 --marketplace-path。
狀態顯示已安裝但停用。 再次執行 /codex computer-use install。Codex app-server 安裝會將 Plugin 設定寫回啟用狀態。
狀態顯示不支援遠端安裝。 使用本機 marketplace 來源或路徑。只能檢查遠端 catalog 項目，但無法透過目前的 app-server API 安裝。
狀態顯示 MCP server 無法使用。 重新執行一次安裝，讓 MCP server 重新載入。如果仍然無法使用，請修正 Codex Computer Use 應用程式、Codex app-server MCP 狀態或 macOS 權限。
狀態或 probe 在 computer-use.list_apps 上逾時。 Plugin 和 MCP server 已存在，但本機 Computer Use bridge 沒有回應。結束或重新啟動 Codex Computer Use，必要時重新啟動 Codex Desktop，然後在新的 OpenClaw 工作階段中重試。
Computer Use 工具顯示 Native hook relay unavailable。 Codex 原生工具 hook 無法透過本機 bridge 或 Gateway 備援連線到作用中的 OpenClaw relay。使用 /new 或 /reset 啟動新的 OpenClaw 工作階段。如果持續發生，請重新啟動 gateway，讓舊的 app-server 執行緒和 hook 註冊被丟棄，然後重試。
回合開始自動安裝拒絕某個來源。 這是預期行為。請先使用明確的 /codex computer-use install --source <marketplace-source> 新增來源，之後的回合開始自動安裝就能使用已探索到的本機 marketplace。
相關內容
