Phát hiện vòng lặp công cụ

OpenClaw có hai cơ chế bảo vệ phối hợp nhằm ngăn chặn các mẫu gọi công cụ lặp lại, cả hai đều được cấu hình trong tools.loopDetection:

1. Phát hiện vòng lặp (enabled) - mặc định bị tắt. Theo dõi lịch sử gọi công cụ luân phiên để phát hiện các mẫu lặp lại và những lần thử lại công cụ không xác định.
2. Cơ chế bảo vệ sau Compaction (postCompactionGuard) - được bật bất cứ khi nào enabled không được đặt rõ ràng thành false. Kích hoạt sau mỗi lần thử lại sau Compaction và hủy lượt chạy nếu tác tử lặp lại cùng một bộ ba (tool, args, result) trong cửa sổ.

Đặt tools.loopDetection.enabled: false để tắt cả hai cơ chế bảo vệ.

Lý do tồn tại

• Phát hiện các chuỗi lặp lại không tạo ra tiến triển.
• Phát hiện các vòng lặp không có kết quả với tần suất cao (cùng công cụ, cùng đầu vào, lỗi lặp lại).
• Phát hiện các mẫu gọi lặp lại cụ thể đối với những công cụ thăm dò đã biết.
• Ngắt chu kỳ tràn ngữ cảnh -> Compaction -> lặp lại cùng vòng lặp thay vì để chúng chạy vô thời hạn.

Khối cấu hình

Các giá trị mặc định toàn cục, hiển thị mọi trường đã được lập tài liệu:

{  tools: {    loopDetection: {      enabled: false, // công tắc chính cho các bộ phát hiện dựa trên lịch sử luân phiên      historySize: 30,      warningThreshold: 10,      criticalThreshold: 20,      unknownToolThreshold: 10,      globalCircuitBreakerThreshold: 30,      detectors: {        genericRepeat: true,        knownPollNoProgress: true,        pingPong: true,      },      postCompactionGuard: {        windowSize: 3, // kích hoạt sau lần thử lại sau Compaction; chạy trừ khi enabled được đặt rõ ràng thành false      },    },  },}

Ghi đè theo từng tác tử (tùy chọn, tại agents.list[].tools.loopDetection):

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

Cài đặt theo từng tác tử sẽ phủ lên khối toàn cục theo từng trường (bao gồm cả detectors và postCompactionGuard lồng nhau), vì vậy tác tử chỉ cần đặt những trường mà nó muốn thay đổi.

Hành vi của trường

Đối với exec, phép băm trạng thái không có tiến triển so sánh các kết quả lệnh ổn định (trạng thái, mã thoát, cờ hết thời gian, đầu ra) và bỏ qua siêu dữ liệu biến động của môi trường chạy như thời lượng, PID, ID phiên và thư mục làm việc. Kết quả gửi tin nhắn đi được băm sau khi loại bỏ các ID biến động theo từng lần gọi (ID tin nhắn, ID tệp, dấu thời gian), do đó một kết quả "đã gửi" không bị xem là giống hệt một kết quả "đã gửi" khác. Khi có ID lượt chạy, lịch sử chỉ được đánh giá trong lượt chạy đó, vì vậy các chu kỳ Heartbeat đã lên lịch và lượt chạy mới không kế thừa số lần lặp cũ từ những lượt chạy trước.

Thiết lập khuyến nghị

• Đối với các mô hình nhỏ hơn, hãy đặt enabled: true và giữ nguyên các ngưỡng mặc định. Các mô hình hàng đầu hiếm khi cần phát hiện dựa trên lịch sử luân phiên và có thể để công tắc chính ở false trong khi vẫn hưởng lợi từ cơ chế bảo vệ sau Compaction.
• Giữ thứ tự các ngưỡng warningThreshold < criticalThreshold < globalCircuitBreakerThreshold; môi trường chạy sẽ tăng criticalThreshold và globalCircuitBreakerThreshold nếu bạn đặt chúng bằng hoặc thấp hơn ngưỡng mà chúng phải vượt qua.
• Nếu xảy ra cảnh báo sai:
  • Tăng warningThreshold và/hoặc criticalThreshold.
  • Có thể tăng globalCircuitBreakerThreshold.
  • Chỉ tắt bộ phát hiện cụ thể gây ra vấn đề (detectors.<name>: false).
  • Giảm historySize để có cửa sổ lịch sử ngắn hơn.
• Để tắt mọi thứ, bao gồm cả cơ chế bảo vệ sau Compaction, hãy đặt rõ ràng tools.loopDetection.enabled: false.

Cơ chế bảo vệ sau Compaction

Sau một lần thử lại sau Compaction tiếp nối sự kiện tràn ngữ cảnh, trình chạy sẽ kích hoạt một cơ chế bảo vệ với cửa sổ ngắn cho vài lần gọi công cụ tiếp theo. Nếu tác tử phát ra cùng một bộ ba (toolName, argsHash, resultHash) đủ postCompactionGuard.windowSize lần trong cửa sổ đó, cơ chế bảo vệ kết luận rằng Compaction không ngắt được vòng lặp và hủy lượt chạy với lỗi compaction_loop_persisted.

Cơ chế bảo vệ chịu sự chi phối của cờ chính tools.loopDetection.enabled, nhưng có một điểm khác biệt: nó vẫn được bật khi cờ chưa được đặt hoặc là true, và chỉ tắt khi cờ được đặt rõ ràng thành false. Đây là chủ ý - cơ chế bảo vệ tồn tại để thoát khỏi các vòng lặp Compaction vốn sẽ tiêu tốn token không giới hạn, vì vậy người dùng không cấu hình vẫn được bảo vệ.

{  tools: {    loopDetection: {      // công tắc chính; đặt thành false để tắt cơ chế bảo vệ cùng các bộ phát hiện luân phiên      enabled: true,      postCompactionGuard: {        windowSize: 3, // mặc định      },    },  },}

• windowSize thấp hơn sẽ nghiêm ngặt hơn (ít lần thử hơn trước khi hủy).
• windowSize cao hơn cho tác tử nhiều lần thử khôi phục hơn.
• Cơ chế bảo vệ không bao giờ hủy khi kết quả vẫn thay đổi; chỉ những kết quả giống hệt từng byte trong cửa sổ mới kích hoạt nó.
• Nó chỉ kích hoạt ngay sau một lần thử lại sau Compaction, không phải tại các thời điểm khác trong lượt chạy.

Nhật ký và hành vi dự kiến

Khi phát hiện vòng lặp, OpenClaw ghi lại một sự kiện vòng lặp và cảnh báo hoặc chặn chu kỳ công cụ tiếp theo tùy theo mức độ nghiêm trọng, qua đó bảo vệ khỏi việc tiêu tốn token mất kiểm soát và tình trạng treo trong khi vẫn duy trì quyền truy cập công cụ bình thường.

• Cảnh báo xuất hiện trước.
• Việc chặn diễn ra khi một mẫu tiếp tục vượt quá ngưỡng cảnh báo.
• Các ngưỡng nghiêm trọng chặn chu kỳ công cụ tiếp theo và hiển thị rõ lý do phát hiện vòng lặp trong bản ghi lượt chạy.
• Cơ chế bảo vệ sau Compaction phát ra lỗi compaction_loop_persisted, nêu rõ công cụ vi phạm và số lần gọi giống hệt nhau.

Liên quan