Chính sách thử lại

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Mục tiêu

• Thử lại theo từng yêu cầu HTTP, không theo từng luồng nhiều bước.
• Giữ nguyên thứ tự bằng cách chỉ thử lại bước hiện tại.
• Tránh lặp lại các thao tác không có tính lũy đẳng.

​

Mặc định

• Số lần thử: 3
• Giới hạn độ trễ tối đa: 30000 ms
• Độ dao động ngẫu nhiên: 0.1 (10 phần trăm)
• Mặc định của nhà cung cấp:
  • Độ trễ tối thiểu của Telegram: 400 ms
  • Độ trễ tối thiểu của Discord: 500 ms

​

Hành vi

​

Nhà cung cấp mô hình

• OpenClaw để SDK của nhà cung cấp xử lý các lần thử lại ngắn thông thường.
• Với các SDK dựa trên Stainless như Anthropic và OpenAI, các phản hồi có thể thử lại (408, 409, 429 và 5xx) có thể bao gồm retry-after-ms hoặc retry-after. Khi thời gian chờ đó dài hơn 60 giây, OpenClaw chèn x-should-retry: false để SDK trả lỗi ngay lập tức và cơ chế chuyển đổi dự phòng mô hình có thể chuyển sang hồ sơ xác thực khác hoặc mô hình dự phòng.
• Ghi đè giới hạn bằng OPENCLAW_SDK_RETRY_MAX_WAIT_SECONDS=<seconds>. Đặt thành 0, false, off, none hoặc disabled để cho phép SDK tự xử lý các lần ngủ Retry-After dài ở bên trong.

​

Discord

• Chỉ thử lại khi có lỗi giới hạn tốc độ (HTTP 429).
• Dùng retry_after của Discord khi có, nếu không thì dùng backoff lũy thừa.

​

Telegram

• Thử lại khi có lỗi tạm thời (429, hết thời gian chờ, kết nối/đặt lại/đã đóng, tạm thời không khả dụng).
• Dùng retry_after khi có, nếu không thì dùng backoff lũy thừa.
• Lỗi phân tích cú pháp Markdown không được thử lại; chúng quay về văn bản thuần túy.

​

Cấu hình

{
  channels: {
    telegram: {
      retry: {
        attempts: 3,
        minDelayMs: 400,
        maxDelayMs: 30000,
        jitter: 0.1,
      },
    },
    discord: {
      retry: {
        attempts: 3,
        minDelayMs: 500,
        maxDelayMs: 30000,
        jitter: 0.1,
      },
    },
  },
}

​

Ghi chú

• Thử lại áp dụng theo từng yêu cầu (gửi tin nhắn, tải lên phương tiện, phản ứng, cuộc thăm dò, nhãn dán).
• Các luồng tổng hợp không thử lại những bước đã hoàn tất.

​

Liên quan

• Chuyển đổi dự phòng mô hình
• Hàng đợi lệnh