Langsung ke konten utama

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 adalah plugin MCP asli Codex untuk kontrol desktop lokal. OpenClaw tidak menyematkan aplikasi desktop, menjalankan tindakan desktop sendiri, atau melewati izin Codex. Plugin codex bawaan hanya menyiapkan Codex app-server: plugin ini mengaktifkan dukungan plugin Codex, menemukan atau memasang plugin Codex Computer Use yang dikonfigurasi, memeriksa bahwa server MCP computer-use tersedia, lalu membiarkan Codex memiliki pemanggilan tool MCP native selama giliran mode Codex. Gunakan halaman ini ketika OpenClaw sudah menggunakan harness Codex native. Untuk penyiapan runtime itu sendiri, lihat Codex harness.

​
OpenClaw.app dan Peekaboo

Integrasi Peekaboo milik OpenClaw.app terpisah dari Codex Computer Use. Aplikasi macOS dapat meng-host socket PeekabooBridge agar CLI peekaboo dapat menggunakan ulang izin Accessibility dan Screen Recording lokal aplikasi untuk tool otomasi milik Peekaboo. Bridge tersebut tidak memasang atau mem-proxy Codex Computer Use, dan Codex Computer Use tidak memanggil melalui socket PeekabooBridge. Gunakan Peekaboo bridge ketika Anda ingin OpenClaw.app menjadi host yang sadar izin untuk otomasi CLI Peekaboo. Gunakan halaman ini ketika agen OpenClaw mode Codex harus memiliki plugin MCP computer-use native milik Codex yang tersedia sebelum giliran dimulai.

​
Aplikasi iOS

Aplikasi iOS terpisah dari Codex Computer Use. Aplikasi ini tidak memasang atau mem-proxy server MCP computer-use Codex dan bukan backend kontrol desktop. Sebaliknya, aplikasi iOS terhubung sebagai node OpenClaw dan mengekspos kapabilitas seluler melalui perintah node seperti canvas.*, camera.*, screen.*, location.*, dan talk.*. Gunakan iOS ketika Anda ingin agen mengendalikan node iPhone melalui gateway. Gunakan halaman ini ketika agen mode Codex harus mengontrol desktop macOS lokal melalui plugin Computer Use native milik Codex.

​
MCP cua-driver langsung

Codex Computer Use bukan satu-satunya cara untuk mengekspos kontrol desktop. Jika Anda ingin runtime yang dikelola OpenClaw memanggil driver TryCua secara langsung, gunakan server cua-driver mcp upstream melalui registry MCP OpenClaw, bukan alur marketplace khusus Codex. Setelah memasang cua-driver, mintalah perintah OpenClaw darinya: 
cua-driver mcp-config --client openclaw
atau daftarkan sendiri server stdio: 
openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'
Jalur itu mempertahankan permukaan tool MCP upstream tetap utuh, termasuk skema driver dan respons MCP terstruktur. Gunakan jalur ini ketika Anda ingin driver CUA tersedia sebagai server MCP OpenClaw biasa. Gunakan penyiapan Codex Computer Use di halaman ini ketika Codex app-server harus memiliki pemasangan plugin, pemuatan ulang MCP, dan pemanggilan tool native di dalam giliran mode Codex. Driver CUA khusus macOS dan tetap memerlukan izin macOS lokal yang diminta aplikasinya, seperti Accessibility dan Screen Recording. OpenClaw tidak memasang cua-driver, memberikan izin tersebut, atau melewati model keamanan driver upstream.

​
Penyiapan cepat

Atur plugins.entries.codex.config.computerUse ketika giliran mode Codex harus memiliki Computer Use yang tersedia sebelum thread dimulai: 
{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          computerUse: {
            autoInstall: true,
          },
        },
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
      agentRuntime: {
        id: "codex",
        fallback: "none",
      },
    },
  },
}
Dengan konfigurasi ini, OpenClaw memeriksa Codex app-server sebelum setiap giliran mode Codex. Jika Computer Use hilang tetapi Codex app-server sudah menemukan marketplace yang dapat dipasang, OpenClaw meminta Codex app-server untuk memasang atau mengaktifkan ulang plugin dan memuat ulang server MCP. Di macOS, ketika tidak ada marketplace yang cocok terdaftar dan bundle aplikasi Codex standar ada, OpenClaw juga mencoba mendaftarkan marketplace Codex bawaan dari /Applications/Codex.app/Contents/Resources/plugins/openai-bundled sebelum gagal. Jika penyiapan tetap tidak dapat membuat server MCP tersedia, giliran gagal sebelum thread dimulai. Sesi yang sudah ada mempertahankan runtime dan binding thread Codex-nya. Setelah mengubah agentRuntime atau konfigurasi Computer Use, gunakan /new atau /reset di chat yang terdampak sebelum menguji.

​
Perintah

Gunakan perintah /codex computer-use dari permukaan chat mana pun tempat permukaan perintah plugin codex tersedia. Ini adalah perintah chat/runtime OpenClaw, bukan subperintah CLI openclaw codex ...: 
/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 bersifat hanya baca. Perintah ini tidak menambahkan sumber marketplace, memasang plugin, atau mengaktifkan dukungan plugin Codex. install mengaktifkan dukungan plugin Codex app-server, secara opsional menambahkan sumber marketplace yang dikonfigurasi, memasang atau mengaktifkan ulang plugin yang dikonfigurasi melalui Codex app-server, memuat ulang server MCP, dan memverifikasi bahwa server MCP mengekspos tool.

​
Pilihan marketplace

OpenClaw menggunakan API app-server yang sama dengan yang diekspos Codex sendiri. Field marketplace memilih di mana Codex harus menemukan computer-use.
FieldGunakan ketikaDukungan pemasangan
Tanpa field marketplaceAnda ingin Codex app-server menggunakan marketplace yang sudah diketahuinya.Ya, ketika app-server mengembalikan marketplace lokal.
marketplaceSourceAnda memiliki sumber marketplace Codex yang dapat ditambahkan app-server.Ya, untuk /codex computer-use install eksplisit.
marketplacePathAnda sudah mengetahui path file marketplace lokal di host.Ya, untuk pemasangan eksplisit dan auto-install saat awal giliran.
marketplaceNameAnda ingin memilih satu marketplace yang sudah terdaftar berdasarkan nama.Ya hanya ketika marketplace yang dipilih memiliki path lokal.
Home Codex baru mungkin memerlukan waktu singkat untuk mengisi marketplace resmi mereka. Selama pemasangan, OpenClaw melakukan polling plugin/list hingga marketplaceDiscoveryTimeoutMs milidetik. Default-nya adalah 60 detik. Jika beberapa marketplace yang diketahui berisi Computer Use, OpenClaw memprioritaskan openai-bundled, lalu openai-curated, lalu local. Kecocokan ambigu yang tidak dikenal gagal tertutup dan meminta Anda mengatur marketplaceName atau marketplacePath.

​
Marketplace macOS bawaan

Build desktop Codex terbaru membundel Computer Use di sini: 
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled/plugins/computer-use
Ketika computerUse.autoInstall bernilai true dan tidak ada marketplace berisi computer-use yang terdaftar, OpenClaw mencoba menambahkan root marketplace bawaan standar secara otomatis: 
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled
Anda juga dapat mendaftarkannya secara eksplisit dari shell dengan Codex: 
codex plugin marketplace add /Applications/Codex.app/Contents/Resources/plugins/openai-bundled
Jika Anda menggunakan path aplikasi Codex nonstandar, atur computerUse.marketplacePath ke path file marketplace lokal atau jalankan /codex computer-use install --source <marketplace-source> sekali.

​
Batas katalog jarak jauh

Codex app-server dapat mencantumkan dan membaca entri katalog yang hanya jarak jauh, tetapi saat ini tidak mendukung plugin/install jarak jauh. Artinya, marketplaceName dapat memilih marketplace yang hanya jarak jauh untuk pemeriksaan status, tetapi pemasangan dan pengaktifan ulang tetap memerlukan marketplace lokal melalui marketplaceSource atau marketplacePath. Jika status mengatakan plugin tersedia di marketplace Codex jarak jauh tetapi pemasangan jarak jauh tidak didukung, jalankan pemasangan dengan sumber atau path lokal: 
/codex computer-use install --source <marketplace-source>
/codex computer-use install --marketplace-path <path>

​
Referensi konfigurasi

FieldDefaultArti
enabledinferredWajibkan Computer Use. Default ke true ketika field Computer Use lain diatur.
autoInstallfalsePasang atau aktifkan ulang dari marketplace yang sudah ditemukan saat awal giliran.
marketplaceDiscoveryTimeoutMs60000Berapa lama pemasangan menunggu penemuan marketplace Codex app-server.
marketplaceSourceunsetString sumber yang diteruskan ke marketplace/add Codex app-server.
marketplacePathunsetPath file marketplace Codex lokal yang berisi plugin.
marketplaceNameunsetNama marketplace Codex terdaftar yang akan dipilih.
pluginNamecomputer-useNama plugin marketplace Codex.
mcpServerNamecomputer-useNama server MCP yang diekspos oleh plugin terpasang.
Auto-install saat awal giliran sengaja menolak nilai marketplaceSource yang dikonfigurasi. Menambahkan sumber baru adalah operasi penyiapan eksplisit, jadi gunakan /codex computer-use install --source <marketplace-source> sekali, lalu biarkan autoInstall menangani pengaktifan ulang mendatang dari marketplace lokal yang ditemukan. Auto-install saat awal giliran dapat menggunakan marketplacePath yang dikonfigurasi, karena itu sudah merupakan path lokal di host.

​
Yang diperiksa OpenClaw

OpenClaw melaporkan alasan penyiapan yang stabil secara internal dan memformat status yang ditampilkan kepada pengguna untuk chat:
AlasanArtiLangkah berikutnya
disabledcomputerUse.enabled diselesaikan menjadi false.Atur enabled atau field Computer Use lain.
marketplace_missingTidak ada marketplace yang cocok tersedia.Konfigurasikan sumber, path, atau nama marketplace.
plugin_not_installedMarketplace ada, tetapi plugin tidak terpasang.Jalankan install atau aktifkan autoInstall.
plugin_disabledPlugin terpasang tetapi dinonaktifkan di konfigurasi Codex.Jalankan install untuk mengaktifkannya ulang.
remote_install_unsupportedMarketplace yang dipilih hanya jarak jauh.Gunakan marketplaceSource atau marketplacePath.
mcp_missingPlugin diaktifkan, tetapi server MCP tidak tersedia.Periksa Codex Computer Use dan izin OS.
readyPlugin dan tool MCP tersedia.Mulai giliran mode Codex.
check_failedPermintaan Codex app-server gagal selama pemeriksaan status.Periksa konektivitas app-server dan log.
auto_install_blockedPenyiapan saat awal giliran perlu menambahkan sumber baru.Jalankan install eksplisit terlebih dahulu.
Output chat menyertakan status plugin, status server MCP, marketplace, tool ketika tersedia, dan pesan spesifik untuk langkah penyiapan yang gagal.

​
Izin macOS

Computer Use khusus macOS. Server MCP yang dimiliki Codex mungkin memerlukan izin OS lokal sebelum dapat memeriksa atau mengontrol aplikasi. Jika OpenClaw mengatakan Computer Use terpasang tetapi server MCP tidak tersedia, verifikasi penyiapan Computer Use sisi Codex terlebih dahulu:
  • Codex app-server berjalan pada host yang sama tempat kontrol desktop harus terjadi.
  • Plugin Computer Use diaktifkan dalam konfigurasi Codex.
  • Server MCP computer-use muncul dalam status MCP Codex app-server.
  • macOS telah memberikan izin yang diperlukan untuk aplikasi kontrol desktop.
  • Sesi host saat ini dapat mengakses desktop yang dikontrol.
OpenClaw sengaja gagal tertutup ketika computerUse.enabled bernilai true. Giliran mode Codex tidak boleh berlanjut secara diam-diam tanpa alat desktop native yang diwajibkan oleh konfigurasi.

​
Pemecahan Masalah

Status menyatakan tidak terpasang. Jalankan /codex computer-use install. Jika marketplace tidak ditemukan, berikan --source atau --marketplace-path. Status menyatakan terpasang tetapi dinonaktifkan. Jalankan /codex computer-use install lagi. Instalasi Codex app-server menulis kembali konfigurasi plugin menjadi aktif. Status menyatakan pemasangan jarak jauh tidak didukung. Gunakan sumber atau path marketplace lokal. Entri katalog yang hanya remote dapat diperiksa tetapi tidak dapat dipasang melalui API app-server saat ini. Status menyatakan server MCP tidak tersedia. Jalankan ulang pemasangan sekali agar server MCP dimuat ulang. Jika tetap tidak tersedia, perbaiki aplikasi Codex Computer Use, status MCP Codex app-server, atau izin macOS. Status atau probe habis waktu pada computer-use.list_apps. Plugin dan server MCP ada, tetapi bridge Computer Use lokal tidak menjawab. Keluar atau mulai ulang Codex Computer Use, luncurkan ulang Codex Desktop jika perlu, lalu coba lagi dalam sesi OpenClaw baru. Alat Computer Use menyatakan Native hook relay unavailable. Hook alat native Codex tidak dapat menjangkau relay OpenClaw yang aktif melalui bridge lokal atau fallback Gateway. Mulai sesi OpenClaw baru dengan /new atau /reset. Jika ini terus terjadi, mulai ulang gateway agar thread app-server lama dan pendaftaran hook dihapus, lalu coba lagi. Pemasangan otomatis saat awal giliran menolak sumber. Ini disengaja. Tambahkan sumber dengan /codex computer-use install --source <marketplace-source> eksplisit terlebih dahulu, lalu pemasangan otomatis saat awal giliran berikutnya dapat menggunakan marketplace lokal yang ditemukan.