Khắc phục sự cố

Các lỗi thường gặp và cách xử lý nhanh.


Tool báo lỗi 'Schema reject'#

Nghĩa là model trả output không khớp schema VietClaw yêu cầu (thiếu field, sai type). Hệ thống auto-retry 3 lần với prompt repair; nếu vẫn fail, chuyển sang model fallback. Anh không bị trừ credit.

Nếu lặp lại nhiều: simplify yêu cầu (chia làm 2 step), hoặc đổi sang model Ultra (Opus) ổn định hơn.

Nhân viên kẹt 'đang chạy' quá lâu#

Heartbeat cron tự scan mỗi 5 phút và force-stop các run > 10 phút. Anh có thể click STOP thủ công trong tab Run history. Credit đã tiêu tới điểm stop được tính, còn lại refund.

Quên mật khẩu / mất email#

Click 'Quên mật khẩu' tại sign-in để reset qua email. Mất luôn email: gửi support@vietclaw.ai kèm số điện thoại Zalo đăng ký + chứng minh lần thanh toán cuối (mã giao dịch SePay / 4 số cuối thẻ). Xử lý 24–48h.

Credit thấy trừ nhưng không có output#

Hiếm — thường do race condition khi tool đã trả output nhưng webhook delivery fail. Hệ thống tự reconciliate trong 1h và refund. Nếu sau 24h vẫn không thấy: support@vietclaw.ai kèm transaction_id (trong tab Audit).

Ảnh bị block 'Safety filter'#

Model upstream (Gemini / OpenAI) chặn vì nội dung dính NSFW, bạo lực, hoặc tên người thật. Anh thử đổi prompt: dùng 'người mẫu nữ Á Đông' thay vì tên cụ thể, bỏ chi tiết bạo lực. Switch sang FAL Flux (filter mềm hơn) cũng đáng thử.

Liên hệ hỗ trợ#

Email: support@vietclaw.ai · Zalo: trong app (góc trái dưới). Pro/Business có SLA 4h trong giờ hành chính VN (T2–T6 9h–18h).