​

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

​

Kiểm tra nhanh

• openclaw status — tóm tắt cục bộ: khả năng kết nối/mode của gateway, gợi ý cập nhật, tuổi xác thực kênh liên kết, phiên và hoạt động gần đây.
• openclaw status --all — chẩn đoán cục bộ đầy đủ (chỉ đọc, có màu, an toàn để dán khi gỡ lỗi).
• openclaw status --deep — cũng kiểm tra Gateway đang chạy (kiểm tra từng kênh khi được hỗ trợ).
• openclaw health --json — yêu cầu Gateway đang chạy cung cấp ảnh chụp 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 kích hoạt agent.
• Nhật ký: theo dõi /tmp/openclaw/openclaw-*.log và lọc các mục web-heartbeat, web-reconnect, web-auto-reply, web-inbound.

​

Chẩn đoán sâu

• Thông tin xác thực trên đĩa: ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json (thời gian sửa đổi gần đây).
• Lưu trữ phiên: ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json (đường dẫn có thể được ghi đè trong cấu hình). Số lượng và người nhận gần đây được hiển thị qua status.
• Quy trình liên kết lại: openclaw channels logout && openclaw channels login --verbose khi mã trạng thái 409–515 hoặc loggedOut xuất hiện trong nhật ký. (Lưu ý: quy trình đăng nhập QR tự động khởi động lại một lần cho trạng thái 515 sau khi ghép đôi.)

​

Cấu hình giám sát sức khỏe

• gateway.channelHealthCheckMinutes: tần suất gateway kiểm tra sức khỏe kênh. Mặc định: 5. Đặt 0 để vô hiệu hóa khởi động lại giám sát sức khỏe toàn cầu.
• gateway.channelStaleEventThresholdMinutes: thời gian một kênh kết nối có thể không hoạt động trước khi giám sát sức khỏe coi nó là không hoạt động và khởi động lại. Mặc định: 30. Giữ giá trị này lớn hơn hoặc bằng gateway.channelHealthCheckMinutes.
• gateway.channelMaxRestartsPerHour: giới hạn khởi động lại giám sát sức khỏe trong một giờ cho mỗi kênh/tài khoản. Mặc định: 10.
• channels.<provider>.healthMonitor.enabled: vô hiệu hóa khởi động lại giám sát sức khỏe cho một kênh cụ thể trong khi vẫn giữ giám sát toàn cầu.
• channels.<provider>.accounts.<accountId>.healthMonitor.enabled: ghi đè đa tài khoản có ưu tiên hơn cài đặt cấp kênh.
• Các ghi đè theo kênh này áp dụng cho các giám sát kênh tích hợp hiện có: Discord, Google Chat, iMessage, Microsoft Teams, Signal, Slack, Telegram, và WhatsApp.

​

Khi có sự cố

• logged out hoặc trạng thái 409–515 → liên kết lại với openclaw channels logout sau đó openclaw channels login.
• Gateway không thể truy cập → khởi động nó: openclaw gateway --port 18789 (sử dụng --force nếu cổng bận).
• Không có tin nhắn đến → xác nhận điện thoại liên kết đang trực tuyến và người gửi được phép (channels.whatsapp.allowFrom); đối với trò chuyện nhóm, đảm bảo danh sách cho phép và quy tắc đề cập khớp (channels.whatsapp.groups, agents.list[].groupChat.mentionPatterns).

​

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