Langsung ke konten utama

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

​
OpenClaw.app dan Peekaboo

Integrasi Peekaboo OpenClaw.app terpisah dari Codex Computer Use. Aplikasi macOS dapat meng-host soket PeekabooBridge sehingga CLI peekaboo dapat menggunakan kembali izin Accessibility dan Screen Recording lokal aplikasi untuk alat otomasi Peekaboo sendiri. Bridge itu tidak memasang atau memproksi Codex Computer Use, dan Codex Computer Use tidak memanggil melalui soket PeekabooBridge. Gunakan Bridge Peekaboo 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 Codex yang tersedia sebelum giliran dimulai.

​
Aplikasi iOS

Aplikasi iOS terpisah dari Codex Computer Use. Aplikasi ini tidak memasang atau memproksi 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 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 upstream cua-driver mcp melalui registry MCP OpenClaw alih-alih alur marketplace khusus Codex. Setelah memasang cua-driver, minta perintah OpenClaw darinya: 
cua-driver mcp-config --client openclaw
atau daftarkan server stdio sendiri: 
openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'
Jalur itu mempertahankan permukaan alat MCP upstream tetap utuh, termasuk skema driver dan respons MCP terstruktur. Gunakan ketika Anda ingin driver CUA tersedia sebagai server MCP OpenClaw biasa. Gunakan penyiapan Codex Computer Use di halaman ini ketika server aplikasi Codex harus memiliki instalasi plugin, pemuatan ulang MCP, dan panggilan alat 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 keselamatan driver upstream.

​
Penyiapan cepat

Atur plugins.entries.codex.config.computerUse ketika giliran mode Codex harus menyediakan Computer Use sebelum thread dimulai: 
{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          computerUse: {
            autoInstall: true,
          },
        },
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
}
Dengan konfigurasi ini, OpenClaw memeriksa server aplikasi Codex sebelum setiap giliran mode Codex. Jika Computer Use tidak ada tetapi server aplikasi Codex sudah menemukan marketplace yang dapat dipasang, OpenClaw meminta server aplikasi Codex 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. Setelah mengubah konfigurasi Computer Use, gunakan /new atau /reset di chat yang terdampak sebelum menguji jika thread Codex yang ada sudah dimulai.

​
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 hanya baca. Perintah ini tidak menambahkan sumber marketplace, memasang plugin, atau mengaktifkan dukungan plugin Codex. install mengaktifkan dukungan plugin server aplikasi Codex, secara opsional menambahkan sumber marketplace yang dikonfigurasi, memasang atau mengaktifkan ulang plugin yang dikonfigurasi melalui server aplikasi Codex, memuat ulang server MCP, dan memverifikasi bahwa server MCP mengekspos alat.

​
Pilihan marketplace

OpenClaw menggunakan API server aplikasi yang sama dengan yang diekspos Codex sendiri. Kolom marketplace memilih tempat Codex harus menemukan computer-use.
KolomGunakan ketikaDukungan pemasangan
Tidak ada kolom marketplaceAnda ingin server aplikasi Codex menggunakan marketplace yang sudah dikenalnya.Ya, ketika server aplikasi mengembalikan marketplace lokal.
marketplaceSourceAnda memiliki sumber marketplace Codex yang dapat ditambahkan server aplikasi.Ya, untuk /codex computer-use install eksplisit.
marketplacePathAnda sudah mengetahui jalur file marketplace lokal di host.Ya, untuk pemasangan eksplisit dan pemasangan otomatis saat giliran dimulai.
marketplaceNameAnda ingin memilih satu marketplace yang sudah terdaftar berdasarkan nama.Ya hanya ketika marketplace yang dipilih memiliki jalur lokal.
Home Codex baru mungkin memerlukan waktu singkat untuk menyemai marketplace resminya. Selama pemasangan, OpenClaw melakukan polling plugin/list hingga marketplaceDiscoveryTimeoutMs milidetik. Nilai defaultnya adalah 60 detik. Jika beberapa marketplace yang dikenal 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 menyertakan 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 jalur aplikasi Codex nonstandar, atur computerUse.marketplacePath ke jalur file marketplace lokal atau jalankan /codex computer-use install --source <marketplace-source> satu kali.

​
Batas katalog jarak jauh

Server aplikasi Codex 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 jalur lokal: 
/codex computer-use install --source <marketplace-source>
/codex computer-use install --marketplace-path <path>

​
Referensi konfigurasi

KolomDefaultArti
enabledinferredMewajibkan Computer Use. Default menjadi true ketika kolom Computer Use lain diatur.
autoInstallfalseMemasang atau mengaktifkan ulang dari marketplace yang sudah ditemukan saat giliran dimulai.
marketplaceDiscoveryTimeoutMs60000Lama waktu pemasangan menunggu penemuan marketplace server aplikasi Codex.
marketplaceSourceunsetString sumber yang diteruskan ke marketplace/add server aplikasi Codex.
marketplacePathunsetJalur 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.
Pemasangan otomatis saat giliran dimulai sengaja menolak nilai marketplaceSource yang dikonfigurasi. Menambahkan sumber baru adalah operasi penyiapan eksplisit, jadi gunakan /codex computer-use install --source <marketplace-source> satu kali, lalu biarkan autoInstall menangani pengaktifan ulang berikutnya dari marketplace lokal yang ditemukan. Pemasangan otomatis saat giliran dimulai dapat menggunakan marketplacePath yang dikonfigurasi, karena itu sudah merupakan jalur lokal di host.

​
Yang diperiksa OpenClaw

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

​
Izin macOS

Computer Use khusus macOS. Server MCP milik Codex mungkin memerlukan izin OS lokal sebelum dapat memeriksa atau mengontrol aplikasi. Jika OpenClaw mengatakan Computer Use sudah terpasang tetapi server MCP tidak tersedia, verifikasi penyiapan Computer Use sisi Codex terlebih dahulu:
  • Codex app-server berjalan di host yang sama tempat kontrol desktop seharusnya 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 desktop-control.
  • Sesi host saat ini dapat mengakses desktop yang sedang dikontrol.
OpenClaw sengaja gagal secara tertutup saat computerUse.enabled bernilai true. Sebuah giliran mode Codex tidak boleh berjalan diam-diam tanpa alat desktop native yang diwajibkan oleh konfigurasi.

​
Pemecahan Masalah

Status mengatakan belum terinstal. Jalankan /codex computer-use install. Jika marketplace tidak ditemukan, berikan --source atau --marketplace-path. Status mengatakan terinstal tetapi dinonaktifkan. Jalankan /codex computer-use install lagi. Instalasi Codex app-server menulis kembali konfigurasi Plugin menjadi aktif. Status mengatakan instalasi jarak jauh tidak didukung. Gunakan sumber atau path marketplace lokal. Entri katalog yang hanya jarak jauh dapat diperiksa tetapi tidak dapat diinstal melalui API app-server saat ini. Status mengatakan server MCP tidak tersedia. Jalankan ulang instalasi 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 kehabisan 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 diperlukan, lalu coba lagi dalam sesi OpenClaw baru. Alat Computer Use mengatakan Native hook relay unavailable. Hook alat native Codex tidak dapat menjangkau relay OpenClaw aktif melalui bridge lokal atau fallback Gateway. Mulai sesi OpenClaw baru dengan /new atau /reset. Jika terus terjadi, mulai ulang gateway agar thread app-server lama dan registrasi hook dihapus, lalu coba lagi. Instalasi otomatis saat awal giliran menolak sebuah sumber. Ini disengaja. Tambahkan sumber dengan /codex computer-use install --source <marketplace-source> yang eksplisit terlebih dahulu, lalu instalasi otomatis saat awal giliran berikutnya dapat menggunakan marketplace lokal yang ditemukan.

​
Terkait