79 lines
2.6 KiB
Markdown
79 lines
2.6 KiB
Markdown
---
|
|
summary: "Trung tâm xử lý sự cố: Triệu chứng → Kiểm tra → Cách sửa"
|
|
read_when:
|
|
- Bạn thấy một thông báo lỗi và muốn tìm cách khắc phục
|
|
- Bộ cài báo "thành công" nhưng lệnh CLI không hoạt động
|
|
---
|
|
|
|
# Xử lý sự cố (Troubleshooting)
|
|
|
|
## 60 giây đầu tiên
|
|
|
|
Hãy chạy các lệnh này theo thứ tự:
|
|
|
|
```bash
|
|
moltbot status
|
|
moltbot status --all
|
|
moltbot gateway probe
|
|
moltbot logs --follow
|
|
moltbot doctor
|
|
```
|
|
|
|
Nếu Gateway có thể kết nối được, hãy kiểm tra sâu hơn bằng lệnh:
|
|
|
|
```bash
|
|
moltbot status --deep
|
|
```
|
|
|
|
## Các trường hợp lỗi phổ biến
|
|
|
|
### Lỗi `moltbot: command not found`
|
|
|
|
Hầu hết là do vấn đề về đường dẫn (PATH) của Node/npm. Hãy bắt đầu từ đây:
|
|
- [Kiểm tra PATH của Node/npm](../../install.vi.md#nodejs--npm-path-sanity)
|
|
|
|
### Bộ cài bị lỗi (hoặc bạn muốn xem nhật ký đầy đủ)
|
|
|
|
Hãy chạy lại bộ cài ở chế độ chi tiết (verbose) để xem toàn bộ quá trình:
|
|
|
|
```bash
|
|
curl -fsSL https://molt.bot/install.sh | bash -s -- --verbose
|
|
```
|
|
|
|
### Gateway báo "Unauthorized", không thể kết nối hoặc liên tục kết nối lại
|
|
|
|
- [Xử lý sự cố Gateway](../../gateway/troubleshooting.vi.md)
|
|
- [Xác thực Gateway](../../gateway/authentication.vi.md)
|
|
|
|
### Giao diện điều khiển (Control UI) lỗi trên HTTP (yêu cầu nhận diện thiết bị)
|
|
|
|
- [Xử lý sự cố Gateway](../../gateway/troubleshooting.vi.md)
|
|
- [Giao diện điều khiển](../../web/control-ui.vi.md#insecure-http)
|
|
|
|
### Lỗi SSL khi truy cập `docs.molt.bot` (Do mạng Comcast/Xfinity)
|
|
|
|
Một số nhà mạng có thể chặn tên miền này. Hãy thử tắt "Advanced Security" hoặc sử dụng VPN/Hotspot điện thoại để kiểm tra.
|
|
|
|
### Dịch vụ báo đang chạy nhưng lệnh kiểm tra (probe) thất bại
|
|
|
|
- [Xử lý sự cố Gateway](../../gateway/troubleshooting.vi.md)
|
|
- [Tiến trình chạy ngầm / Dịch vụ](../../gateway/background-process.vi.md)
|
|
|
|
### Lỗi Mô hình/Xác thực (Hết hạn mức, lỗi thanh toán)
|
|
|
|
- [Mô hình AI](../../cli/models.vi.md)
|
|
- [Khái niệm Xác thực / OAuth](../../concepts/oauth.vi.md)
|
|
|
|
### Khi bạn muốn gửi yêu cầu hỗ trợ
|
|
|
|
Hãy đính kèm báo cáo an toàn từ lệnh sau:
|
|
|
|
```bash
|
|
moltbot status --all
|
|
```
|
|
|
|
Đồng thời, nếu có thể, hãy gửi kèm vài dòng cuối của nhật ký từ lệnh `moltbot logs --follow`.
|
|
|
|
---
|
|
Tài liệu liên quan: [Cài đặt](../../install.vi.md), [Xác thực Gateway](../../gateway/authentication.vi.md).
|