Troubleshooting

60 giây đầu tiên

Chạy các lệnh sau theo thứ tự:

openclaw status
openclaw status --all
openclaw gateway probe
openclaw logs --follow
openclaw doctor

Nếu Gateway có thể kết nối được, thử kiểm tra sâu hơn:

openclaw status --deep

Các trường hợp lỗi thường gặp

`openclaw: command not found`

Hầu như luôn là vấn đề về PATH của Node/npm. Bắt đầu từ đây:

Cài đặt (kiểm tra PATH của Node/npm)

Trình cài đặt bị lỗi (hoặc bạn cần xem log đầy đủ)

Chạy lại trình cài đặt ở chế độ verbose để xem đầy đủ trace và output của npm:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --verbose

Đối với bản beta:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --beta --verbose

Các bạn cũng có thể set OPENCLAW_VERBOSE=1 thay vì dùng flag.

Gateway báo “unauthorized”, không kết nối được, hoặc cứ reconnect liên tục

Control UI bị lỗi trên HTTP (yêu cầu device identity)

`docs.openclaw.ai` hiện lỗi SSL (Comcast/Xfinity)

Một số kết nối Comcast/Xfinity chặn docs.openclaw.ai thông qua Xfinity Advanced Security. Tắt Advanced Security hoặc thêm docs.openclaw.ai vào allowlist, sau đó thử lại.

Trợ giúp Xfinity Advanced Security: https://www.xfinity.com/support/articles/using-xfinity-xfi-advanced-security
Kiểm tra nhanh: thử dùng mobile hotspot hoặc VPN để xác nhận đây là lỗi do ISP chặn

Service báo đang chạy, nhưng RPC probe thất bại

Lỗi model/auth (rate limit, billing, “all models failed”)

`/model` báo `model not allowed`

Thường là do agents.defaults.models được cấu hình như một allowlist. Khi nó không rỗng, chỉ những provider/model key trong đó mới có thể được chọn.

Kiểm tra allowlist: openclaw config get agents.defaults.models
Thêm model bạn muốn (hoặc xóa allowlist) rồi thử lại /model
Dùng /models để xem các provider/model được phép

Khi tạo issue

Paste một báo cáo an toàn:

openclaw status --all

Nếu có thể, hãy kèm theo phần log liên quan từ openclaw logs --follow.