Tích hợp AstrBot

Độ khó ⌨️ Trung cấp　|　Định dạng giao diện Tương thích OpenAI　|　base_url https://byesu.com/v1

Thông tin kết nối

Địa chỉ APIhttps://byesu.com/v1

Khóa APIsk-xxxxxxxxTạo trong bảng điều khiển →

Mô hìnhgpt-5.5

Định dạng API OpenAI tương thích · tên mô hình theo bảng điều khiển

AstrBot là một nền tảng Agent chatbot mã nguồn mở, trọn gói, cho phép bạn tích hợp AI vào QQ, Feishu, DingTalk, WeChat Work và nhiều phần mềm trò chuyện khác. Chỉ cần trỏ "nhà cung cấp mô hình" của nó tới Byesu API là bạn có thể cho bot của mình sử dụng các mô hình như gpt-5.5, claude-opus-4-8, v.v.

Trước khi bắt đầu

Hãy vào Bảng điều khiển → Token để tạo một token mới (dạng sk-xxxx), và chọn đúng nhóm cho token — nhóm quyết định bạn có thể gọi những mô hình nào cùng phương thức tính phí. Nếu chưa rõ cách chọn, xem Chọn nhóm.

Bước 1: Triển khai và mở bảng quản trị AstrBot

AstrBot hỗ trợ nhiều cách triển khai như Docker, BaoTa, mã nguồn, v.v.; chi tiết triển khai xem tài liệu chính thức của AstrBot. Ví dụ khởi động nhanh bằng Docker:

docker run -d \
  --name astrbot \
  -p 6185:6185 \
  -v $PWD/astrbot/data:/AstrBot/data \
  soulter/astrbot:latest

Sau khi khởi động, mở bảng quản trị trên trình duyệt:

http://IP-máy-chủ-của-bạn:6185

Lần đầu truy cập, hệ thống sẽ hướng dẫn bạn thiết lập tài khoản và mật khẩu quản trị; sau khi đăng nhập là vào bảng điều khiển.

Bước 2: Thêm nhà cung cấp mô hình (điền base_url + Key)

Ở menu bên trái của bảng quản trị, vào Nhà cung cấp mô hình (Provider), nhấp Thêm / Tạo nhà cung cấp dịch vụ mới, rồi điền theo bảng dưới đây:

Trường	Nội dung điền
Loại nhà cung cấp	Chọn OpenAI (tương thích giao diện OpenAI)
API Base URL	https://byesu.com/v1
API Key	Token của bạn sk-xxxx
Mô hình (Model)	Tên mô hình thực của Byesu, ví dụ gpt-5.5

base_url nhất định phải có /v1

AstrBot đi qua giao diện tương thích OpenAI, nên API Base URL bắt buộc phải điền https://byesu.com/v1 (kết thúc bằng /v1). Thiếu /v1 sẽ khiến yêu cầu báo 404 / không kết nối được.

Các tên mô hình thường dùng (chọn theo nhu cầu, có thể cấu hình nhiều mô hình trong bảng):

gpt-5.5                # OpenAI, đối thoại tổng hợp
claude-opus-4-8        # Anthropic, suy luận mạnh / văn bản dài
gemini-3.1-pro-high    # Google, đa phương thức

Sau khi điền xong, nhấp Lưu. Một số phiên bản có nút "Kiểm tra / Lấy danh sách mô hình", bạn có thể nhấp để xác nhận base_url và Key đã kết nối được.

Bước 3: Đặt làm mô hình mặc định và kiểm tra

1. Vào khu vực Tệp cấu hình (Configuration) → Mô hình / Mô hình ngôn ngữ lớn.
2. Đặt Mô hình trò chuyện mặc định (Default Chat Provider / Model) thành nhà cung cấp Byesu vừa tạo ở bước trước.
3. Nhấp Lưu, và khởi động lại / tải lại cấu hình nếu cần.

Sau đó, gửi một câu trên nền tảng trò chuyện đã liên kết (hoặc tại mục kiểm tra hội thoại có sẵn trong bảng): nếu bot trả lời bình thường tức là đã tích hợp thành công. Nếu phản hồi bất thường, hãy quay lại phần cấu hình nhà cung cấp để đối chiếu lại base_url, Key và tên mô hình.

Bị kẹt?

• 401 / Xác thực thất bại: Key điền sai hoặc thiếu tiền tố sk-; hãy sao chép lại token đầy đủ và điền lại. Xem chi tiết tại Lỗi thường gặp · Xác thực.
• 404 / Không kết nối được: API Base URL thiếu /v1, đúng phải là https://byesu.com/v1.
• Báo không có kênh khả dụng / mô hình không tồn tại: Nhóm của token không bao gồm mô hình đó, hoặc tên mô hình gõ sai; hãy dùng các tên mô hình thực như gpt-5.5, claude-opus-4-8, và chọn đúng nhóm. Xem Lỗi thường gặp · Không có kênh khả dụng.
• Không đủ hạn mức: Tài khoản hoặc token đã hết hạn mức; hãy nạp tiền hoặc tăng hạn mức token rồi thử lại. Xem Lỗi thường gặp · Số dư.

Xem thêm cách khắc phục tại Lỗi thường gặp.