Alibaba Cloud HITL (Human-in-the-Loop) eklentisi, AI Agent'lar tarafından Alibaba Cloud CLI (aliyun) aracılığıyla başlatılan orta ve yüksek riskli bulut işlemlerini duraklatır ve çalıştırılmadan önce kullanıcı onayı ister. Şu anda yalnızca OpenClaw üzerinde desteklenmektedir.
HITL öncesi ve sonrası
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Başlangıç
HITL, bir OpenClaw eklentisi olarak çalışır. Gerekirse önce OpenClaw'ı yükleyin.
Yüklemeden önce aşağıdakileri doğrulayın:
OpenClaw sürümü >= 2026.3.24 (kontrol etmek için
openclaw --versionkomutunu çalıştırın).Node.js sürümü >= 22.0.0 (kontrol etmek için
node --versionkomutunu çalıştırın).Geçerli kimlik bilgileriyle yüklü Alibaba Cloud CLI (
aliyun). CLI'yi yükleyin (Linux) | Kimlik bilgilerini yapılandırın.
Adım 1: Eklentiyi yükleyin
Eklentiyi yüklemek için şu komutu çalıştırın:
openclaw plugins install @alicloud/alibabacloud-hitl-claw-plugin
Beklenen çıktı:
Installed plugin: alibabacloud-hitl-claw-plugin
Restart the gateway to load plugins.
Adım 2: Eklentinin yüklendiğini doğrulayın
openclaw plugins list
Çıktıda @alicloud/alibabacloud-hitl-claw-plugin bulunduğunu doğrulayın. Eksikse OpenClaw'ı yeniden başlatıp tekrar kontrol edin.
Adım 3: Onay sürecini test edin
OpenClaw'da Agent'tan bir bulut kaynağını değiştirmesini isteyin. Örneğin, "Bir RAM kullanıcısı
CLI Useroluştur" deyin.Agent,
aliyun ram create-userkomutunu çalıştırmadan önce duraklar. Onaylamak için OpenClaw'daki Open Approval bağlantısına tıklayın.İşlemi engellemek için Cancel seçeneğine tıklayın. RAM kullanıcısının oluşturulmadığını doğrulayın.
Adım 4: (İsteğe bağlı) DingTalk bildirimlerini yapılandırın
Varsayılan olarak onay istekleri OpenClaw kullanıcı arayüzünde görünür. DingTalk mobil bildirimleri almak için:
openclaw config set session.dmScope per-channel-peer
Onay istekleri daha sonra OpenClaw'a bağlı DingTalk kanalına gönderilir. Onaylamak için bağlantıyı açın.
Nasıl çalışır?
Eklenti, her aliyun CLI komutunun içeriğini, CLI sürümünü ve oturum bilgilerini (kimlik bilgileri hariç) Alibaba Cloud Dolandırıcılık Tespiti hizmetine gönderir. İki olası sonuç vardır:
ALLOW
ESCALATE: Kaynak serbest bırakma, izin değişikliği veya güvenlik yapılandırması değişikliği gibi yüksek riskli olarak belirlenen yazma işlemleri, kullanıcı onayı beklenirken askıya alınır.
Alibaba Cloud, Dolandırıcılık Tespiti kurallarını sunucu tarafında sürdürür ve günceller; eklenti yükseltmesi gerekmez. HITL eklentisi kaynak kodu (MIT lisansı).
Zaman aşımı süresi içinde (varsayılan olarak 10 dakika) yanıt alınamazsa işlem otomatik olarak iptal edilir. Kaynaklar etkilenmez.
Hassas bilgiler yerel olarak işlenir ve asla sunucuya gönderilmez.
İşlem günlüklerini görüntüleyin
HITL eklenti günlüğü: Her komutun Dolandırıcılık Tespiti sonucunu, onay durumunu ve yürütme sonucunu kaydeder. Varsayılan günlük yolu:
/tmp/openclaw.ActionTrail: Agent tarafından yürütülen API çağrılarını kaydeder. ActionTrail konsolu oturumunu açın. Event Query sayfasında olayları Event Type ve Event Name değerlerine göre filtreleyin.
Gelişmiş yapılandırma
HITL davranışını özelleştirmek için ~/.openclaw/extensions/alibabacloud-hitl-claw-plugin/config.json dosyasını düzenleyin:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
SSS
HITL, CLI komutlarının davranışını değiştirir mi?
Hayır. Komut sonuçları, parametreler ve çıktılar değişmez. HITL yalnızca çalıştırmadan önce Dolandırıcılık Tespiti ekler.
Benzer işlemleri onayladıktan sonra otomatik olarak atlanır mı?
Hayır. Her işlem bağımsız olarak değerlendirilir. Toplu işlemler (birden çok kaynağı silme gibi) her komut için ayrı onay gerektirir.
Onaylanmış bir işlemi geri alabilir miyim?
Onaylandıktan sonra komut hemen çalıştırılır ve geri alınamaz. Onaylamadan önce komutu ve hedef kaynağı gözden geçirin.
HITL'nin bir maliyeti var mı?
HITL eklentisi ücretsizdir ve açık kaynaklıdır (MIT lisansı).
HITL eklentisini nasıl kaldırırım?
openclaw plugins uninstall @alicloud/alibabacloud-hitl-claw-plugin komutunu çalıştırın. Kaldırma işleminden sonra Agent, Dolandırıcılık Tespiti olmadan komutları doğrudan yürütür.