Alat exec OpenClaw

Exec adalah alat yang membuat agen benar-benar dapat bekerja, sekaligus alat yang paling perlu diperlakukan dengan hati-hati. Ia adalah shell, ia menulis file, dan tempat ia berjalan adalah soal resolusi, bukan jawaban yang tetap. Berikut permukaan parameternya, aturan penempatannya, lima mode kebijakan beserta peninjau yang ada di dalam salah satunya, dan perintah sesi yang dapat memperketat tetapi tidak pernah melonggarkan.

Parameter dan penempatan

• Perintah adalah satu-satunya parameter wajib; direktori kerja, override environment, jeda yield sebelum dipindah ke latar belakang, flag latar belakang langsung, timeout per panggilan dalam detik, flag pseudo-terminal untuk program yang hanya berjalan di terminal, mode ask, pemilih node, dan flag elevated melengkapi permukaannya, dan timeout nol menonaktifkan timeout proses untuk panggilan tersebut.
• Parameter host hanya menerima auto, sandbox, gateway, atau node dan bukan pemilih nama host; auto mewarisi host yang dikonfigurasi termasuk override agen dan sesi, dan jika itu juga auto, ia di-resolve ke sandbox saat runtime sandbox aktif dan ke gateway jika tidak, sementara sesi yang mewajibkan sandbox tetap berada di sandbox apa pun yang terjadi.
• Selama runtime sandbox aktif, auto menjaga exec tetap di sandbox dan menolak override gateway atau node per panggilan, sehingga memaksakan salah satunya berarti mengatur host yang dikonfigurasi secara eksplisit; menjalankan di node memerlukan node yang disandingkan, terhubung, dan mendukung perintah run, dan jika beberapa node yang memenuhi syarat terhubung, target harus dipilih di konfigurasi atau per sesi.
• Eksekusi di host menolak override environment path dan loader untuk mencegah pembajakan biner, menormalkan override pager menjadi nilai kosong alih-alih meneruskan nama executable, mengatur variabel penanda agar profil shell dapat mendeteksi konteks exec, dan di gateway menggabungkan path login shell sambil memuat snapshot startup yang direkam, yang mengecualikan variabel yang tampak seperti rahasia.

exec adalah permukaan shell yang mengubah sistem: perintah dapat membuat, mengedit, atau menghapus file di mana pun sistem file host atau sandbox yang dipilih mengizinkannya.

Lima mode dan peninjau

Kunci mode adalah pengatur kebijakan kanonis, dan semua hal lain diturunkan darinya. Deny memblokir exec sepenuhnya. Allowlist hanya menjalankan perintah yang ada di daftar izin atau safe-bin dan tidak menanyakan apa pun. Ask langsung menjalankan perintah yang cocok dengan daftar izin dan mengirim sisanya ke manusia. Auto langsung menjalankan yang cocok dan menyerahkan perintah tidak cocok yang memenuhi syarat ke peninjau native yang mengembalikan allow, deny, atau ask, di mana allow menjalankan perintah berisiko rendah atau sedang satu kali, deny mengembalikan alasan yang harus dihormati agen alih-alih diakali, dan tiga penolakan berturut-turut dalam satu sesi meneruskan perintah ketiga ke manusia. Full berjalan tanpa prompt kebijakan biasa, dan exec host tanpa persetujuan menjadi default untuk gateway dan node karena default kebijakan host, bukan karena host auto. Di gateway, perintah harus lolos pemeriksaan pengikatan file yang dapat berubah sebelum ditinjau: seluruh rantai dispatch diikat saat peninjauan dan diperiksa ulang sebelum dijalankan, executable yang dilindungi berdasarkan path asli hasil resolve dan yang dapat ditulisi juga berdasarkan hash kontennya, sehingga executable baru yang muncul lebih awal di search path membuat eksekusi yang sudah disetujui ditolak. Wrapper perintah shell, penetapan environment, dan rantai lain yang tidak dapat diikat melewati peninjau dan mengambil jalur manusia sekali jalan sebagai gantinya.

Inline eval, path, dan sesi

• Strict inline eval adalah opt-in terpisah yang nonaktif secara default: saat evaluasi persetujuan host biasa berjalan, fitur ini mewajibkan persetujuan peninjau atau persetujuan eksplisit untuk bentuk interpreter inline yang dikenali, bahkan saat kebijakan mengizinkan full dan off, mencakup flag eval dari interpreter dan pembawa yang umum, dan bentuk inline eval tidak pernah menjadi aturan allow yang permanen.
• Penanganan path berbeda per host: gateway menggabungkan path login shell dan dengan aman menambahkan direktori yang dikonfigurasi di depan tepat sebelum eksekusi, sandbox menjalankan login shell di dalam kontainer sehingga profil dapat mereset path dan entri yang dikonfigurasi ditambahkan di depan setelah profil dimuat, dan host node sepenuhnya mengabaikan override path, sehingga entri tambahan harus ditempatkan di environment layanan node.
• Perintah sesi mengatur default penempatan per sesi, sementara security dan ask hanya berlaku untuk pesan saat ini; perintah ini hanya dipatuhi untuk pengirim yang berwenang, pengirim eksternal boleh menyimpan default penempatan secara permanen sementara klien internal memerlukan scope administratif, dan saat sebuah sesi memiliki mode izin, override per giliran hanya dapat memperketatnya, tidak pernah melonggarkannya.

Persetujuan exec di OpenClaw adalah alur persetujuan yang diumpankan oleh mode-mode ini, dan persetujuan exec lanjutan di OpenClaw adalah aturan safe-bin dan pengikatan di baliknya.

Dua hal yang sering disalahpahami

Yang pertama adalah menganggap alat file sebagai permukaan tulis: menonaktifkannya tidak menjadikan exec baca-saja, karena shell menulis di mana pun host yang dipilih mengizinkannya. Yang kedua adalah menganggap sandbox aktif: sandbox nonaktif secara default, sehingga host auto yang implisit di-resolve ke gateway, sementara permintaan sandbox yang eksplisit gagal secara tertutup alih-alih diam-diam berjalan di host. Subalat patch terstruktur perlu diketahui karena alasan yang sama, sebab mengizinkan alat write secara implisit juga mengizinkannya, sementara menolak write tidak menolaknya. Menonaktifkan exec sepenuhnya adalah keputusan kebijakan alat, dan di luar sesi dengan akses penuh, batas minimum persetujuan host tetap berlaku. Penjelasan sandbox OpenClaw menjelaskan isolasinya, dan panduan skill OpenClaw menjelaskan file instruksi yang biasanya menggerakkan perintah-perintah ini.

Di Diali

Di Diali, setiap asisten berjalan di runtime-nya sendiri dengan konfigurasi yang dibuat dari dasbor dan diganti di setiap rilis, sehingga shell yang dijangkau agen adalah runtime milik pelanggan tersebut dan bukan yang lain. OpenClaw yang di-hosting di Diali menjelaskan asisten yang di-hosting, dan keamanan Diali menjelaskan batas di sekitarnya.

• Menonaktifkan alat file tidak menjadikan shell baca-saja.
• Sandbox nonaktif secara default; auto lalu berarti gateway.
• Override per giliran memperketat kebijakan, tidak pernah melonggarkannya.