Plugin HITL secara efektif meningkatkan keamanan Resource Management cloud dengan secara otomatis mengidentifikasi operasi cloud berisiko tinggi yang dilakukan oleh AI agent dan memperkenalkan mekanisme konfirmasi manual. - Portal Cloud Skills

HITL (Human-in-the-Loop, kolaborasi manusia-mesin) meningkatkan keamanan AI dengan meminta konfirmasi manusia sebelum operasi kritis. Plugin HITL Alibaba Cloud dapat secara otomatis mengidentifikasi operasi sumber daya cloud berisiko menengah hingga tinggi yang diprakarsai oleh AI agent melalui Alibaba Cloud CLI (aliyun), menangguhkan operasi tersebut, dan menunggu konfirmasi pengguna sebelum dieksekusi. Alat OpenClaw telah diadaptasi.

Perbandingan sebelum dan setelah plugin diaktifkan

Skenario	HITL tidak diaktifkan	Aktifkan HITL
Buat sumber daya	Agent langsung membuatnya; biaya tak terduga mungkin timbul	Dijeda sebelum eksekusi, tampilkan detail operasi, dan jalankan setelah dikonfirmasi
Hapus atau lepas sumber daya	Pengguna dapat langsung menemukan agen setelah operasi selesai.	Ditangguhkan dan menampilkan sumber daya target, lalu dieksekusi setelah dikonfirmasi.
Ubah konfigurasi	Agent langsung melakukannya; perubahan langsung berlaku	Ditangguhkan dan menampilkan konten yang diubah. Konfigurasi tidak terpengaruh jika dibatalkan secara manual.
Operasi hanya-baca	Eksekusi normal	Eksekusi normal dengan latensi tambahan beberapa milidetik

Panduan Pengguna

HITL saat ini hanya didukung sebagai plugin OpenClaw. Jika OpenClaw belum diinstal, lihat Instal OpenClaw.

Pastikan lingkungan berikut sebelum menginstal plugin:

OpenClaw >= 2026.3.24 (jalankan openclaw --version untuk melihat versi).
Node.js >= 22.0.0 (dependensi runtime OpenClaw; jalankan node --version untuk melihat versi).
Alibaba Cloud CLI (aliyun) telah diinstal dan dikonfigurasi dengan kredensial yang valid. Untuk informasi lebih lanjut, lihat Instal CLI (Linux) dan Konfigurasi kredensial.

Langkah 1: Instal plugin

Jalankan perintah berikut untuk menginstal plugin:

openclaw plugins install @alicloud/alibabacloud-hitl-claw-plugin

Output terminal setelah instalasi berhasil:

Installed plugin: alibabacloud-hitl-claw-plugin
Restart the gateway to load plugins.

Langkah 2: Verifikasi bahwa plugin telah dimuat

openclaw plugins list

Pastikan output berisi @alicloud/alibabacloud-hitl-claw-plugin. Jika tidak, restart OpenClaw dan periksa kembali.

Langkah 3: Uji proses konfirmasi

Di OpenClaw, kirim perintah ke Agent untuk mengubah sumber daya cloud, misalnya, "Buat RAM user CLI User".
Agent berhenti sejenak sebelum menjalankan perintah aliyun ram create-user. OpenClaw menampilkan permintaan konfirmasi; klik tautan Open Approval untuk konfirmasi manual.
Jika Anda memilih Cancel untuk menghentikan operasi (RAM user tidak dibuat), pastikan plugin HITL memblokir operasi tersebut.

Langkah 4: (Opsional) Konfigurasi notifikasi DingTalk

Permintaan konfirmasi ditampilkan pada antarmuka OpenClaw secara default. Untuk menerima notifikasi seluler melalui DingTalk, jalankan perintah berikut:

openclaw config set session.dmScope per-channel-peer

Setelah konfigurasi, pastikan permintaan didorong ke saluran DingTalk yang terkait dengan OpenClaw. Buka tautan tersebut untuk menyetujui operasi.

Prinsip kerja

Plugin HITL mengirim konten, versi CLI, dan informasi sesi dari setiap perintah CLI aliyun ke Alibaba Cloud untuk Fraud Detection (tidak termasuk kredensial akun). Dua hasil dikembalikan:

ALLOW
ESCALATE: Jika operasi tulis diidentifikasi sebagai operasi berisiko tinggi—seperti pelepasan sumber daya, perubahan izin, atau modifikasi konfigurasi keamanan—agent menangguhkan operasi dan menunggu konfirmasi pengguna.

Aturan Fraud Detection dikelola oleh Alibaba Cloud dan terus diperbarui tanpa perlu melakukan upgrade plugin. Untuk informasi lebih lanjut, lihat kode sumber plugin HITL (lisensi MIT).

Catatan

Jika tidak ada respons yang diterima dalam periode timeout operasi (10 menit secara default), operasi secara otomatis dibatalkan dan sumber daya tidak terpengaruh.
Informasi sensitif diproses secara lokal dan tidak dikirim ke server.

Lihat catatan operasi

Log plugin HITL: mencatat hasil Fraud Detection, hasil persetujuan, dan status eksekusi setiap perintah. Secara default, log disimpan di /tmp/openclaw.
ActionTrail: Mencatat panggilan API yang benar-benar dieksekusi oleh Agent. MasukKonsol ActionTrail. Pada halaman Event Query, filter event berdasarkan Event Type dan Event Name.

Konfigurasi lanjutan

Anda dapat menyesuaikan perilaku plugin dengan mengedit file konfigurasi plugin HITL di ~/.openclaw/extensions/alibabacloud-hitl-claw-plugin/config.json:

Item konfigurasi	Jenis	Nilai Default	Deskripsi
`enabled`	boolean	`true`	Nonaktifkan sementara HITL (misalnya, saat debugging) tanpa meng-uninstal plugin
`confirmationTimeoutSeconds`	number	`600`	Timeout konfirmasi (dalam detik). Operasi secara otomatis dibatalkan setelah melewati batas waktu

FAQ

Apakah HITL mengubah perilaku perintah CLI?

Tidak. Hasil eksekusi, parameter, dan output perintah tetap tidak berubah. HITL hanya menambahkan Fraud Detection sebelum eksekusi.

Apakah operasi serupa akan dilewati secara otomatis setelah saya mengonfirmasinya?

Tidak. Setiap operasi dievaluasi secara independen. Jika Anda ingin melakukan operasi jenis yang sama sekaligus—misalnya menghapus beberapa sumber daya—Anda harus mengonfirmasi setiap perintah secara terpisah.

Konfirmasi tertunda. Bisakah saya membatalkannya?

Perintah langsung dieksekusi setelah dikonfirmasi dan tidak dapat dibatalkan melalui HITL. Kami menyarankan Anda memeriksa konten perintah dan sumber daya target sebelum mengonfirmasi.

Apakah HITL dikenai biaya?

Plugin HITL gratis dan open source dengan lisensi MIT.

Bagaimana cara meng-uninstal plugin HITL?

Jalankan openclaw plugins uninstall @alicloud/alibabacloud-hitl-claw-plugin. Setelah plugin di-uninstal, agent langsung mengeksekusi perintah dan tidak lagi melakukan Fraud Detection.