Bỏ qua tới nội dung
RexAPFTài liệuMở RexAPF Web
Tài liệuTrợ giúp
WebDesktopCLIAPI

Khắc phục sự cố thường gặp

Cách xử lý lỗi đăng nhập, lỗi API 401/402/429, kết nối OAuth thất bại, quyền macOS của RexAPF Desktop và máy RexAPF CLI ngoại tuyến.

5 phút đọc
Trên trang này
  1. Đăng nhập
  2. Trên RexAPF Web
  3. Trên RexAPF Desktop và CLI
  4. Lỗi API 401, 402, 429
  5. Xác định mã lỗi
  6. Kiểm tra khoá (401)
  7. Kiểm tra số dư và gói (402)
  8. Kiểm tra hạn mức (429)
  9. Kết nối OAuth (Gmail, Drive, Notion, Slack…)
  10. Quyền macOS trên RexAPF Desktop
  11. Máy RexAPF CLI ngoại tuyến
  12. Vẫn chưa xử lý được

Bài này gom các lỗi hay gặp nhất theo từng nhóm. Tìm đúng thông báo bạn thấy trên màn hình, rồi làm theo cách xử lý tương ứng.

Đăng nhập

Trên RexAPF Web

Thông báoCách xử lý
Email/tên đăng nhập hoặc mật khẩu không đúng.Kiểm tra lại, hoặc nhấn Quên mật khẩu? để đặt lại qua email
Email chưa được xác minhMở liên kết xác minh trong hộp thư, hoặc gửi lại email xác minh
Thử lại sau ít phútBạn đã thử quá nhiều lần. Chờ vài phút rồi thử lại
Tài khoản đã bị tạm khoáLiên hệ hỗ trợ
Email này đã liên kết với một tài khoản khác…Đăng nhập bằng phương thức bạn đã dùng lúc đầu (Google, GitHub, hoặc email và mật khẩu)

Tài khoản tạo bằng Google hoặc GitHub không có mật khẩu riêng; hãy dùng Tiếp tục với Google hoặc Tiếp tục với GitHub.

Trên RexAPF Desktop và CLI

Desktop và CLI đăng nhập qua trình duyệt hệ thống. Nếu trình duyệt không tự mở, Desktop có nút Sao chép liên kết đăng nhập; CLI in sẵn liên kết ra terminal.

  • Hết thời gian đăng nhập: liên kết có hiệu lực ngắn. Bắt đầu lại lần đăng nhập mới.
  • RexLLM không phản hồi: kiểm tra mạng, proxy hoặc tường lửa rồi thử lại.
  • Phiên RexLLM đã kết thúc: đăng nhập lại từ menu tài khoản ở cuối thanh bên.
  • CLI qua SSH không mở được trình duyệt: xem Cài đặt RexAPF CLI.

Lỗi API 401, 402, 429

Áp dụng cho mọi yêu cầu gọi API Gateway bằng khoá API, kể cả từ Claude Code, Codex hay Cursor. Đọc trường code trong thân lỗi để biết nguyên nhân.

  1. Xác định mã lỗi

    Xem mã HTTP và trường code trong thông báo lỗi của công cụ, ví dụ 402 và insufficient_credit.

  2. Kiểm tra khoá (401)

    invalid_api_key: khoá sai, thiếu ký tự hoặc dính dấu cách. api_key_revoked: khoá đã bị thu hồi. Mở API Gateway › Khóa API, kiểm tra cột Trạng thái; nếu khoá ở trạng thái Đã thu hồi, nhấn Tạo khóa API và cập nhật công cụ.

  3. Kiểm tra số dư và gói (402)

    insufficient_credit: không có gói còn hạn và số dư bằng 0. subscription_expired: gói đã hết hạn. Mở API Gateway › Thanh toán để nạp credit qua VietQR hoặc gia hạn gói.

  4. Kiểm tra hạn mức (429)

    plan_usage_window_limit: hết ngân sách cửa sổ của gói; thông báo ghi thời điểm đặt lại. daily_spending_limit hoặc monthly_spending_limit: chạm giới hạn chi tiêu. Nếu gửi quá nhiều yêu cầu mỗi phút so với RPM của gói, giảm tần suất rồi thử lại sau ít giây.

rexapf.com/api-gateway/dashboard
Tạo mớiMáy tínhPhòngQuy trìnhTự động hoáPhê duyệtBộ nhớThành phẩmAPI GatewayKết nốiKỹ năngTrợ lý của tôiKênh
API Gateway
  1. 1Thẻ Hạn mức gói: Đã dùng, Còn lại, Ngân sách và Đặt lại sau
  2. 2Công tắc Chuyển sang dùng credit khi hết hạn mức
  3. 3Liên kết Thanh toán để nạp credit hoặc đổi gói
Kiểm tra hạn mức khi gặp lỗi 429
Không bị chặn giữa tác vụ dài

Nếu bạn có gói thuê bao và có số dư credit, bật Chuyển sang dùng credit khi hết hạn mức. Hết ngân sách cửa sổ, yêu cầu trừ vào credit thay vì nhận 429.

Bảng đầy đủ các mã lỗi, gồm 403 và 5xx, ở Mã lỗi & giới hạn.

Kết nối OAuth (Gmail, Drive, Notion, Slack…)

Hiện tượngCách xử lý
Thẻ kết nối hiện Cần kết nối lạiMở menu trên thẻ, chọn Kết nối lại và xác thực lại với nhà cung cấp
Quay lại trang Kết nối nhưng không thấy Đã kết nối thành công.Lượt xác thực có thể đã quá hạn. Phiên xác thực chỉ có hiệu lực khoảng 10 phút; bắt đầu lại từ nút + trên thẻ dịch vụ
Gmail hoặc Google Calendar không kết nối đượcKhi cấp quyền, giữ quyền xem thông tin tài khoản Google; RexAPF cần xác minh danh tính tài khoản trước khi kích hoạt kết nối
Agent không ghi được dữ liệuKết nối đang ở Chỉ đọc. Tạo lại kết nối với Đọc & Ghi

Hướng dẫn kết nối từng dịch vụ ở Kết nối.

Quyền macOS trên RexAPF Desktop

Điều khiển máy tính cần hai quyền macOS: Trợ năng và Ghi màn hình.

  1. Mở Cài đặt › Điều khiển máy tính trong RexAPF.
  2. Với quyền đang Chưa cho phép, nhấn Mở Cài đặt và bật RexAPF trong Quyền riêng tư & Bảo mật.
  3. Quay lại RexAPF và nhấn Kiểm tra lại.
Đã cho phép mà trạng thái không đổi

macOS chỉ áp dụng quyền Ghi màn hình khi ứng dụng khởi động lại. Thoát hẳn RexAPF bằng ⌘Q rồi mở lại. Nếu vẫn báo Không khởi động được điều khiển máy tính, tắt rồi bật lại Dùng điều khiển máy tính.

Chi tiết ở Computer use.

Máy RexAPF CLI ngoại tuyến

Khi RexAPF Web báo Máy đang ngoại tuyến hoặc daemon RexAPF chưa chạy., kiểm tra trên chính máy đó:

bash
$ rexapf remote status
Dòng trong remote statusÝ nghĩa và cách xử lý
Điều khiển từ Web: tắtChưa bật chia sẻ. Chạy rexapf connect <thư-mục>
Daemon: không chạyChạy rexapf daemon install để cài và khởi động dịch vụ nền
relay offline hoặc relay connectingDaemon chạy nhưng chưa nối được relay. Kiểm tra mạng và xem log bằng lệnh rexapf daemon logs in ra
relay signed-outCLI đã đăng xuất. Chạy rexapf login
Chạy sau khi thoát SSH (linger): TẮTDaemon dừng khi bạn thoát SSH. Chạy lệnh được in kèm, thường là sudo loginctl enable-linger <tên-user>, rồi rexapf daemon install
ssh — vps
$ rexapf remote status
Điều khiển từ Web: bật
Tên máy: vps-sg
Truy cập: theo tài khoản (mọi trình duyệt đăng nhập cùng tài khoản)
Agent RexLLM Web giao việc: tắt (bật: rexapf remote agent on)
Daemon: không chạy
Dịch vụ nền: chưa cài
Ví dụ remote status khi daemon chưa chạy

Nếu Agent trên Web báo Máy chưa cho phép Agent Web giao việc, chạy rexapf remote agent on. Xem thêm Kết nối từ xa và Chạy trên VPS.

Vẫn chưa xử lý được

Câu hỏi thường gặpGiải đáp nhanh về tài khoản, gói và nền tảng.Liên hệ hỗ trợHỏi trực tiếp trong nhóm Telegram.
Trang này có hữu ích không?Cập nhật 22/10/2026