Kiểm tra sức khỏe (CLI)

Hướng dẫn ngắn gọn để kiểm tra kết nối Channel mà không cần đoán mò.

Kiểm tra nhanh

  • openclaw status — tóm tắt local: khả năng kết nối Gateway/chế độ, gợi ý cập nhật, tuổi xác thực Channel đã liên kết, Session + hoạt động gần đây.
  • openclaw status --all — chẩn đoán local đầy đủ (chỉ đọc, có màu, an toàn để paste khi debug).
  • openclaw status --deep — cũng thăm dò Gateway đang chạy (thăm dò từng Channel khi được hỗ trợ).
  • openclaw health --json — yêu cầu Gateway đang chạy cung cấp snapshot sức khỏe đầy đủ (chỉ WS; không có socket Baileys trực tiếp).
  • Gửi /status như một tin nhắn độc lập trong WhatsApp/WebChat để nhận phản hồi trạng thái mà không cần gọi Agent.
  • Logs: tail /tmp/openclaw/openclaw-*.log và lọc theo web-heartbeat, web-reconnect, web-auto-reply, web-inbound.

Chẩn đoán sâu

  • Creds trên ổ đĩa: ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json (mtime nên là gần đây).
  • Session store: ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json (đường dẫn có thể được ghi đè trong config). Số lượng và người nhận gần đây được hiển thị qua status.
  • Luồng liên kết lại: openclaw channels logout && openclaw channels login --verbose khi status code 409–515 hoặc loggedOut xuất hiện trong logs. (Lưu ý: luồng đăng nhập QR tự động khởi động lại một lần cho status 515 sau khi pairing.)

Khi có lỗi xảy ra

  • logged out hoặc status 409–515 → liên kết lại với openclaw channels logout rồi openclaw channels login.
  • Gateway không thể kết nối → khởi động nó: openclaw gateway --port 18789 (dùng --force nếu port đang bận).
  • Không nhận được tin nhắn → xác nhận điện thoại đã liên kết đang online và người gửi được phép (channels.whatsapp.allowFrom); với group chat, đảm bảo allowlist + quy tắc mention khớp (channels.whatsapp.groups, agents.list[].groupChat.mentionPatterns).

Lệnh “health” chuyên dụng

openclaw health --json yêu cầu Gateway đang chạy cung cấp snapshot sức khỏe của nó (không có socket Channel trực tiếp từ CLI). Nó báo cáo creds/tuổi xác thực đã liên kết khi có sẵn, tóm tắt thăm dò từng Channel, tóm tắt session-store, và thời lượng thăm dò. Nó thoát với mã khác 0 nếu Gateway không thể kết nối hoặc thăm dò thất bại/timeout. Dùng --timeout <ms> để ghi đè mặc định 10s.