Tüm Ürünler
Search
Belge Merkezi

Cloud Skills Portal:Identify high-risk AI Agent operations with the HITL plug-in

Son Güncelleme:Oct 08, 2026

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ı


Senaryolar


HITL olmadan


HITL ile


Kaynak oluşturma


Agent doğrudan oluşturur; beklenmeyen ücretlere yol açabilir


Duraklatır, işlem ayrıntılarını gösterir ve onaydan sonra devam eder


Kaynakları silme veya serbest bırakma


Agent doğrudan yürütür; kullanıcı işlem tamamlandıktan sonra fark eder


Duraklatır ve hedef kaynağı gösterir; onaydan sonra devam eder


Yapılandırmaları değiştirme


Agent doğrudan yürütür; değişiklik hemen etkili olur


Duraklatır ve değişikliği gösterir; iptal edilirse yapılandırma değişmez


Salt okunur işlemler


Normal çalışma


Milisaniye düzeyinde gecikme ek yüküyle normal çalışma

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 --version komutunu çalıştırın).

  • Node.js sürümü >= 22.0.0 (kontrol etmek için node --version komutunu ç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

  1. OpenClaw'da Agent'tan bir bulut kaynağını değiştirmesini isteyin. Örneğin, "Bir RAM kullanıcısı CLI User oluştur" deyin.

  2. Agent, aliyun ram create-user komutunu çalıştırmadan önce duraklar. Onaylamak için OpenClaw'daki Open Approval bağlantısına tıklayın.

  3. İş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ı).

Not
  • 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:


Parametre


Tür


Varsayılan Değer


Açıklama


enabled


boolean


true


HITL'yi kaldırmadan geçici olarak devre dışı bırakın (örneğin hata ayıklama için)


confirmationTimeoutSeconds


number


600


Saniye cinsinden onay zaman aşımı. Zaman aşımından sonra işlemler otomatik olarak iptal edilir.

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.