Deteksi perulangan alat

OpenClaw memiliki dua pagar pengaman yang bekerja sama untuk mencegah pola pemanggilan alat yang berulang, keduanya dikonfigurasi di bawah tools.loopDetection:

1. Deteksi loop (enabled) - dinonaktifkan secara default. Memantau riwayat pemanggilan alat berjalan untuk mendeteksi pola berulang dan percobaan ulang alat yang tidak dikenal.
2. Pengaman pasca-compaction (postCompactionGuard) - diaktifkan setiap kali enabled tidak secara eksplisit bernilai false. Diaktifkan setelah setiap percobaan ulang compaction dan membatalkan proses jika agen mengulangi tripel (tool, args, result) yang sama dalam jendela tersebut.

Atur tools.loopDetection.enabled: false untuk menonaktifkan kedua pagar pengaman.

Alasan fitur ini tersedia

• Mendeteksi urutan berulang yang tidak menghasilkan kemajuan.
• Mendeteksi loop tanpa hasil berfrekuensi tinggi (alat yang sama, masukan yang sama, galat berulang).
• Mendeteksi pola pemanggilan berulang tertentu untuk alat polling yang dikenal.
• Memutus siklus luapan konteks -> compaction -> loop yang sama, alih-alih membiarkannya berjalan tanpa batas.

Blok konfigurasi

Nilai default global, dengan semua bidang yang didokumentasikan ditampilkan:

{  tools: {    loopDetection: {      enabled: false, // sakelar utama untuk detektor riwayat berjalan      historySize: 30,      warningThreshold: 10,      criticalThreshold: 20,      unknownToolThreshold: 10,      globalCircuitBreakerThreshold: 30,      detectors: {        genericRepeat: true,        knownPollNoProgress: true,        pingPong: true,      },      postCompactionGuard: {        windowSize: 3, // diaktifkan setelah percobaan ulang compaction; berjalan kecuali enabled secara eksplisit bernilai false      },    },  },}

Penimpaan per agen (opsional, di agents.list[].tools.loopDetection):

{  agents: {    list: [      {        id: "safe-runner",        tools: {          loopDetection: {            enabled: true,            warningThreshold: 8,            criticalThreshold: 16,          },        },      },    ],  },}

Pengaturan per agen menimpa blok global bidang demi bidang (termasuk detectors dan postCompactionGuard bertingkat), sehingga agen hanya perlu mengatur bidang yang ingin diubah.

Perilaku bidang

Untuk exec, hashing tanpa kemajuan membandingkan hasil perintah yang stabil (status, kode keluar, penanda batas waktu terlampaui, keluaran) dan mengabaikan metadata runtime yang berubah-ubah seperti durasi, PID, ID sesi, dan direktori kerja. Hasil pengiriman pesan keluar di-hash dengan menghapus ID yang berubah-ubah pada setiap pemanggilan (ID pesan, ID berkas, stempel waktu), sehingga hasil "terkirim" tidak tampak identik dengan hasil "terkirim" lainnya. Saat ID proses tersedia, riwayat dievaluasi hanya dalam proses tersebut, sehingga siklus Heartbeat terjadwal dan proses baru tidak mewarisi jumlah loop lama dari proses sebelumnya.

Penyiapan yang disarankan

• Untuk model yang lebih kecil, atur enabled: true dan biarkan ambang pada nilai defaultnya. Model unggulan jarang memerlukan deteksi riwayat berjalan dan dapat membiarkan sakelar utama bernilai false sambil tetap memperoleh manfaat dari pengaman pasca-compaction.
• Pertahankan urutan ambang warningThreshold < criticalThreshold < globalCircuitBreakerThreshold; runtime menaikkan criticalThreshold dan globalCircuitBreakerThreshold jika Anda mengaturnya sama dengan atau di bawah ambang yang harus dilampauinya.
• Jika terjadi positif palsu:
  • Naikkan warningThreshold dan/atau criticalThreshold.
  • Secara opsional, naikkan globalCircuitBreakerThreshold.
  • Nonaktifkan hanya detektor tertentu yang menyebabkan masalah (detectors.<name>: false).
  • Kurangi historySize untuk jendela riwayat yang lebih pendek.
• Untuk menonaktifkan semuanya, termasuk pengaman pasca-compaction, atur tools.loopDetection.enabled: false secara eksplisit.

Pengaman pasca-compaction

Setelah percobaan ulang compaction akibat luapan konteks, pelaksana mengaktifkan pengaman berjendela pendek untuk beberapa pemanggilan alat berikutnya. Jika agen menghasilkan tripel (toolName, argsHash, resultHash) yang sama sebanyak postCompactionGuard.windowSize kali dalam jendela tersebut, pengaman menyimpulkan bahwa compaction tidak memutus loop dan membatalkan proses dengan galat compaction_loop_persisted.

Pengaman dikendalikan oleh penanda utama tools.loopDetection.enabled dengan satu pengecualian: pengaman tetap aktif saat penanda tidak ditetapkan atau bernilai true, dan hanya dinonaktifkan ketika penanda secara eksplisit bernilai false. Hal ini disengaja - pengaman tersedia untuk keluar dari loop compaction yang jika tidak ditangani akan menghabiskan token tanpa batas, sehingga pengguna tanpa konfigurasi tetap mendapatkan perlindungan.

{  tools: {    loopDetection: {      // sakelar utama; atur false untuk menonaktifkan pengaman beserta detektor berjalan      enabled: true,      postCompactionGuard: {        windowSize: 3, // default      },    },  },}

• windowSize yang lebih rendah bersifat lebih ketat (lebih sedikit percobaan sebelum pembatalan).
• windowSize yang lebih tinggi memberi agen lebih banyak percobaan pemulihan.
• Pengaman tidak pernah membatalkan selama hasil terus berubah; hanya hasil yang identik per bita di seluruh jendela yang memicunya.
• Pengaman hanya diaktifkan segera setelah percobaan ulang compaction, bukan pada titik lain dalam suatu proses.

Log dan perilaku yang diharapkan

Saat loop terdeteksi, OpenClaw mencatat peristiwa loop dan memperingatkan atau memblokir siklus alat berikutnya berdasarkan tingkat keparahan, sehingga melindungi dari pengeluaran token tak terkendali dan kebuntuan sambil mempertahankan akses alat normal.

• Peringatan diberikan terlebih dahulu.
• Pemblokiran menyusul setelah pola bertahan melewati ambang peringatan.
• Ambang kritis memblokir siklus alat berikutnya dan menampilkan alasan deteksi loop yang jelas dalam catatan proses.
• Pengaman pasca-compaction menghasilkan galat compaction_loop_persisted yang menyebutkan alat penyebab dan jumlah pemanggilan identik.

Terkait