Hướng dẫn OpenClaw cho người mới #1: Cài xong nhưng không chạy — quy trình xử lý chuẩn

Mục tiêu

Bài này giúp người mới xử lý trường hợp cài OpenClaw xong nhưng agent không phản hồi hoặc chạy chập chờn.

Quy trình chuẩn 7 bước

1. Kiểm tra gateway: chạy openclaw gateway status.
2. Nếu gateway dừng: chạy openclaw gateway start, rồi kiểm tra lại status.
3. Nếu vẫn lỗi: thử openclaw gateway restart.
4. Kiểm tra tổng quan runtime: chạy openclaw status để xem model/tool/session.
5. Xác minh model endpoint: model có phản hồi thật hay không, alias có trỏ đúng không.
6. Kiểm tra file cấu hình gần nhất: rollback nếu lỗi xuất hiện ngay sau khi sửa config.
7. Kiểm tra theo “lỗi đầu tiên” trong log: tránh xử lý lỗi dây chuyền phía sau.

Các lỗi người mới hay mắc

• Sửa nhiều thông số cùng lúc khiến không biết lỗi từ đâu.
• Debug skill trước khi xác nhận gateway/runtime đã ổn.
• Quên kiểm tra khác biệt giữa model hiện tại và default model.

Checklist xác nhận đã ổn

• Gateway ở trạng thái running.
• openclaw status không còn lỗi chặn.
• Gửi thử một câu lệnh đơn giản và nhận phản hồi ổn định.

Nguồn chính thống tham khảo

• OpenClaw Docs
• OpenClaw Source (GitHub)
• OpenClaw CLI quick reference