# Xử lý sự cố

> Cách xử lý khi việc đang chờ, thất bại hoặc chưa rõ kết quả — mọi lý do chờ, lỗi việc và cách khắc phục các vấn đề thường gặp.

Source: https://x.builera.app/docs/vi/troubleshooting
Last checked: 2026-10-24

Bắt đầu từ cảnh báo hoặc trạng thái của việc: ở đó luôn nêu rõ lý do. Tìm lý do tương ứng bên dưới.

## Vấn đề thường gặp {#common-problems}

| Bạn thấy gì | Vì sao | Cách xử lý |
|---|---|---|
| **VPS “…” mất kết nối** | VPS đã lâu không báo về. | Đảm bảo VPS đang chạy, có mạng và cửa sổ agent đang mở. Sau khi khởi động lại, Windows phải đăng nhập thì agent mới khởi chạy. |
| **VPS cần cập nhật** | Agent cũ hơn phiên bản X-Buddy yêu cầu. Agent vẫn báo về và tự cập nhật, nhưng không nhận việc. | Thường không cần làm gì: agent cài bản cập nhật ngay khi không có việc đang chạy và không mở Xem từ xa. |
| **Proxy “…” không kết nối được** | Proxy không phản hồi, từ chối thông tin đăng nhập hoặc sai loại. | Kiểm tra hạn dùng, địa chỉ, cổng, tên đăng nhập, mật khẩu và loại (HTTP hoặc SOCKS5), rồi kiểm tra lại trên trang **Proxy**. |
| **Proxy “…” lệch IP** | Proxy hiện đi ra từ IP hoặc vị trí khác trước. Các nick dùng proxy này đang chờ. | Sửa proxy để đi ra từ vị trí cũ, rồi kiểm tra lại. |
| **Nick … bị đăng xuất khỏi X** | X đã kết thúc phiên. | Đăng nhập lại qua [Xem từ xa](/docs/vi/x-accounts#sign-in-through-remote-view). |
| **Nick … cần mở khoá X Chat** | X Chat đang khoá hoặc mã đã lưu không đúng. | Lưu mã đúng trong tab **Hộp thư** của nick, hoặc mở khoá trong Xem từ xa. Mã đã lưu bị sai sẽ không được thử lại để tránh X Chat bị khoá. |
| **Thao tác “…” đang hỏng vì X đổi giao diện** | X đổi trang nên X-Buddy không tìm thấy nút cần bấm. | Hãy chờ: X-Buddy cập nhật cách tìm các thành phần trên X mà không cần cài lại agent. Lỗi này không hạ trạng thái an toàn của nick. |
| **Đồng bộ nick … chưa lấy được …** | Một phần đồng bộ thất bại. Các phần còn lại vẫn dùng được. | Hệ thống tự thử lại. Nếu lặp lại liên tục, có thể X đã đổi cách hiển thị dữ liệu đó. |
| **Nick … bị giảm tốc** | X báo giới hạn tốc độ. | Việc chờ đến khi đủ 30 phút kể từ lần báo giới hạn gần nhất, rồi tự chạy tiếp nếu không còn lý do chờ nào khác. Xem [Hạn mức, giờ chạy và an toàn](/docs/vi/limits-and-safety). |
| **Màn hình VPS quá nhỏ cho X** | Màn hình VPS nhỏ hơn 1024×720, thường do cửa sổ Remote Desktop nhỏ. | Phóng to hoặc đóng Remote Desktop. Thoát bằng **Thoát Remote an toàn**. |

## Việc đang chờ {#held-jobs}

Việc đang chờ chưa thất bại. X-Buddy kiểm tra điều kiện trước khi giao bất kỳ việc nào; khi một lý do được giải quyết, việc tự được đánh thức và kiểm tra điều kiện lại — nên sau đó có thể xuất hiện lý do thứ hai.

### Nick {#the-x-account}

| Lý do hiển thị | Hết chờ khi |
|---|---|
| **Nick đang tạm dừng** | Bạn cho nick chạy lại. |
| **Nick cần xử lý an toàn** | Bạn xử lý vấn đề trên X và xác nhận nick được chạy lại. |
| **Nick chưa đăng nhập X** | Nick đăng nhập lại (Xem từ xa). |
| **X Chat của nick chưa mở khoá — …** | X Chat được mở khoá. Chỉ việc gửi tin chờ; đồng bộ hộp thư vẫn tiếp tục. |
| **Đang xem từ xa** | Bạn đóng Xem từ xa. |
| **Nick đang làm việc khác** | Việc hiện tại hoàn tất. Mỗi nick chỉ chạy một việc tại một thời điểm. |
| **X báo giới hạn tốc độ — nick tạm chờ rồi tự chạy tiếp** | Hết thời gian chờ 30 phút. |

### Hạn mức và lịch chạy {#limits-and-schedule}

| Lý do hiển thị | Hết chờ khi |
|---|---|
| **Ngoài giờ chạy** | Khung giờ được phép tiếp theo bắt đầu, hoặc bạn đổi giờ chạy. |
| **Đang nghỉ giữa giờ** | Hết giờ nghỉ. |
| **Ngày nghỉ của nick** | Đến ngày làm việc tiếp theo. |
| **Chưa mở trong giai đoạn làm ấm** | Làm ấm tới tuần cho phép hành động đó, hoặc bạn đổi thiết lập làm ấm. |
| **Hết hạn mức hôm nay** | Đến nửa đêm theo múi giờ của nick, hoặc bạn tăng hạn mức. |
| **Hết hạn mức 7 ngày gần nhất — chờ có lượt trống** | Các hành động cũ ra khỏi khung 7 ngày, hoặc bạn tăng hạn mức. |
| **Chờ khoảng nghỉ giữa hai lần** | Đã đủ khoảng cách tối thiểu. |
| **Chống follow rồi bỏ: chờ đủ ngày** | Đã đủ số ngày kể từ lần follow hoặc bỏ follow. |
| **Người nhận nằm trong danh sách loại trừ** | Chỉ khi bạn gỡ người đó khỏi danh sách — chỉ làm vậy nếu việc liên hệ với họ là phù hợp. |

### VPS, proxy và agent {#vps-proxy-and-agent}

| Lý do hiển thị | Hết chờ khi |
|---|---|
| **Chưa gán VPS** | Bạn gán nick vào một VPS. |
| **VPS mất kết nối** | Agent báo về trở lại. |
| **VPS cần cập nhật** | Agent cài phiên bản yêu cầu. |
| **VPS đang mở tối đa số Chrome** | Một cửa sổ Chrome khác trên VPS đó đóng lại. |
| **Proxy lỗi hoặc đổi IP** | Proxy vượt qua kiểm tra trở lại. |
| **Màn hình VPS quá nhỏ cho X (…)** | Màn hình đạt 1024×720 trở lên. |
| **Agent trên VPS báo phần lõi không khớp chữ ký — …** | Agent cài phiên bản đúng, có chữ ký. |
| **Agent trên VPS dùng giao thức quá cũ (hoặc mới hơn máy chủ) — …** | Agent và X-Buddy dùng phiên bản tương thích. |

### Workspace và kết nối {#workspace-and-connections}

| Lý do hiển thị | Hết chờ khi |
|---|---|
| **Hệ thống đang bảo trì** | Bảo trì kết thúc. |
| **Hành động đang bị tắt toàn hệ thống** | X-Buddy bật lại hành động đó. |
| **Workspace bị đình chỉ** | Workspace hoạt động trở lại. |
| **Kết nối MCP / API đang tạm dừng** | Kết nối được bật lại. |
| **Mọi kết nối MCP / API của workspace đang tạm dừng** | Các kết nối được bật lại cho workspace. |
| **Người tạo kết nối không còn quyền làm việc này** | Người có vai trò phù hợp tạo kết nối. |
| **Nhường lượt cho việc tự động đến hạn (sau 5 lệnh tức thì liên tiếp)** | Việc tự động đến hạn đã được chạy; lệnh gọi trực tiếp chạy sau khoảng 30 giây. |

## Kết quả chưa rõ {#unknown-outcomes}

Đôi khi X-Buddy không biết thao tác ghi đã tới X chưa — trang hết thời gian chờ, hoặc VPS ngừng báo về. Hệ thống không bao giờ đoán và không cứ thế làm lại.

1. **Kiểm tra X trước.** Với follow, like, đăng lại và các hành động tương tự, hệ thống đọc X tối đa 3 lần — ngay lập tức, sau 10 phút và sau 30 phút — rồi ghi nhận những gì tìm thấy. Đây chỉ là thao tác đọc.
2. **Tin nhắn thì khác.** Với tin nhắn, X-Buddy tìm trong hộp thư. Nếu sau 40 phút vẫn chưa thấy, việc sẽ thông báo điều đó và tin nhắn **không tự được gửi lại**.
3. **Sau đó hỏi bạn.** Nếu vẫn chưa rõ, việc chuyển sang **Cần kiểm tra**. Kiểm tra X rồi chọn:
   - **Đã làm trên X** — đã xảy ra; tiếp tục.
   - **Thử lại** — chưa xảy ra; làm lại.
   - **Dừng** — không làm nữa.

### Cách ly kết quả trên VPS {#vps-quarantine}

Nếu VPS đã làm xong nhưng không báo về kịp, kết quả được giữ trên VPS và hiển thị trên trang **VPS & Agent**, không bao giờ tự gửi lại. Kiểm tra X và nhật ký hoạt động, rồi chọn **Cho VPS xoá**. Thao tác này xoá bản kết quả lưu trên VPS — không hoàn tác bất kỳ điều gì trên X. VPS gửi bằng chứng tới X-Buddy trước khi xoá.

## Lỗi việc {#job-errors}

| Thông báo của việc | Cách xử lý |
|---|---|
| Giao diện X vừa thay đổi nên không tìm thấy nút cần bấm. | Chờ bản cập nhật của X-Buddy; không cần cài lại. |
| Đã thao tác nhưng chưa xác minh được kết quả trên X. | Kiểm tra X trước khi thử lại. |
| Mẫu tin có chỗ điền (ví dụ @tên) mà người này chưa có giá trị — chưa gửi gì. | Điền giá trị cho người này, hoặc đổi mẫu. |
| Chưa xác minh được việc trên X — X-Buddy đang tự đọc lại trên X (tối đa 3 lần trong 30 phút) trước khi hỏi bạn. Không làm lại khi chưa rõ. | Hãy chờ; xem [Kết quả chưa rõ](#unknown-outcomes). |
| Chưa thấy tin này trong hộp thư sau 40 phút — … Không tự gửi lại. | Kiểm tra hội thoại trên X trước khi gửi lại. |
| Không mở được người hoặc bài này trên X (có thể đã xoá, bị khoá hoặc đổi tên). | Kiểm tra đối tượng đích. |
| X không cho phép thao tác này với người hoặc bài này. | Không có gì cần sửa trong X-Buddy. |
| Mạng của VPS chập chờn. / X phản hồi quá chậm. | Hệ thống thử lại; kiểm tra mạng VPS nếu lỗi tiếp diễn. |
| Chrome trên VPS bị đóng bất ngờ. | Hệ thống thử lại; kiểm tra RAM trống trên VPS. |
| Đã hết hạn mức cho thao tác này hôm nay. | Chờ tới ngày mai hoặc tăng hạn mức. |
| Dừng vì X báo nick cần kiểm tra (xác minh, khoá hoặc bị giới hạn). | Xử lý trên X, rồi cho nick chạy lại. |
| Proxy từ chối tên đăng nhập hoặc mật khẩu. / Không kết nối được tới proxy. / Sai loại proxy (HTTP hoặc SOCKS5). | Sửa proxy. |
| X Chat của nick chưa mở khoá. / X báo mã X Chat đã lưu không đúng. | Lưu mã đúng, hoặc mở khoá trong Xem từ xa. |
| Bản agent trên VPS chưa làm được thao tác này. | Chờ agent cập nhật. |
| VPS không báo kết quả về kịp. | Kiểm tra trên X trước khi thử lại — có thể thao tác đã xảy ra. |
| Quá giờ hẹn nên việc không chạy nữa. | Tạo lại với hạn chót muộn hơn nếu vẫn cần. |
| Hồ sơ trình duyệt của nick bị hỏng. | Liên hệ đội vận hành X-Buddy; không tạo lại nick (hồ sơ phải được giữ nguyên). |
| Chuỗi bước của chiến dịch bị lỗi. / Mẫu tin nhắn của bước này đang trống. | Sửa chiến dịch. |

Các lỗi khác hiển thị **Việc không hoàn thành.** — xem **Nhật ký** để biết chi tiết.

## Vẫn chưa giải quyết được? {#still-stuck}

- [Khái niệm cốt lõi](/docs/vi/concepts#job-outcomes) giải thích từng trạng thái việc.
- Với lỗi API, xem [Lỗi](/docs/vi/errors).