Tích hợp Memoh

Độ 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

Memoh là một nền tảng AI agent (tác tử thông minh) mã nguồn mở, tự lưu trữ; mỗi bot chạy trong một container riêng biệt, có bộ nhớ bền vững và hệ thống tệp độc lập, đồng thời có thể kết nối với nhiều kênh như Telegram, Discord, Feishu, QQ, WeChat, v.v. Nó hỗ trợ bất kỳ nhà cung cấp mô hình nào tương thích OpenAI, vì vậy có thể tích hợp trực tiếp với Byesu API.

Trước khi bắt đầu

Hãy vào Bảng điều khiển → Token để tạo một token (có dạng sk-xxxx). Khi tạo, nhất định phải chọn đúng nhóm, vì nhóm quyết định bạn được dùng những mô hình nào và hệ số tính phí ra sao — nếu chưa rõ nên chọn nhóm nào thì hãy xem trước Chọn nhóm.

Bước 1: Cài đặt Memoh

Memoh được triển khai chỉ với một lệnh qua Docker. Trên máy chủ của bạn, hãy chạy:

curl -fsSL https://memoh.sh | sudo sh

Bạn cũng có thể triển khai thủ công: git clone --depth 1 https://github.com/memohai/Memoh.git rồi vào thư mục, trước tiên chạy cp conf/app.docker.toml config.toml (chỉnh sửa nếu cần), sau đó docker compose up -d — đừng bỏ sót bước sao chép tệp cấu hình này, nếu không sẽ không khởi động được. Sau khi cài xong, hãy truy cập bảng quản trị bằng trình duyệt:

• Địa chỉ: http://localhost:8082 (với máy chủ từ xa, thay bằng IP/tên miền tương ứng)
• Tài khoản mặc định: admin　Mật khẩu: admin123

Lưu ý bảo mật

Sau lần đăng nhập đầu tiên, hãy đổi mật khẩu mặc định ngay lập tức để tránh bảng quản trị bị người khác truy cập.

Bước 2: Thêm nhà cung cấp (điền base_url và API Key)

Sau khi đăng nhập bảng quản trị, vào mục «Quản lý nhà cung cấp / Provider Management», thêm mới một nhà cung cấp tương thích OpenAI (có thể đặt tên là byesu) và điền:

Trường	Nội dung điền
API Base URL	https://byesu.com/v1
API Key	Token bạn đã tạo trong bảng điều khiển byesu, ví dụ sk-xxxx

Sau khi điền xong, nhấn «Lưu».

/v1 ở cuối base_url

Memoh dùng giao thức tương thích OpenAI, base_url bắt buộc phải có /v1, tức là https://byesu.com/v1; đừng bỏ sót và cũng đừng viết lặp thành /v1/v1.

Bước 3: Nhập mô hình

Vào mục «Quản lý mô hình / Model Management», dùng «Tự động nhập» để lấy các mô hình khả dụng từ nhà cung cấp này, hoặc thêm thủ công tên mô hình bạn cần. Nên điền các mô hình thực sự khả dụng trên byesu, ví dụ:

gpt-5.5
claude-opus-4-8
gemini-3.1-pro-high

Mô hình phải khớp với nhóm

Việc có gọi được một mô hình nào đó hay không do nhóm của token quyết định. Nếu khi nhập hoặc gọi mà báo mô hình không khả dụng, phần lớn là do chọn nhóm chưa đúng; hãy quay lại bảng điều khiển để đổi nhóm của token, xem chi tiết ở Chọn nhóm.

Bước 4: Cấu hình bot và kiểm tra

1. Vào «Cài đặt → Cấu hình mô hình / Model Configuration» của một bot nào đó.
2. Chuyển mô hình hội thoại mặc định sang mô hình byesu đã nhập ở bước trước (ví dụ claude-opus-4-8).
3. Lưu lại.

Sau đó, trên kênh tương ứng (Telegram / Discord / Feishu, v.v.) hoặc trong khung hội thoại của bảng điều khiển, hãy gửi cho bot một tin nhắn; nếu nhận được phản hồi bình thường thì việc tích hợp đã thành công.

Bị kẹt?

Câu hỏi thường gặp

• Báo lỗi 401 / Token không hợp lệ: API Key điền sai hoặc dính khoảng trắng thừa, hãy sao chép lại sk-xxxx từ bảng điều khiển. Xem chi tiết ở Lỗi thường gặp #auth.
• Báo số dư không đủ: Hạn mức tài khoản đã dùng hết, hãy vào bảng điều khiển để nạp tiền. Xem chi tiết ở Lỗi thường gặp #balance.
• Báo không có kênh khả dụng / mô hình không khả dụng: Nhóm của token không hỗ trợ mô hình này, hãy đổi mô hình hoặc đổi nhóm. Xem chi tiết ở Lỗi thường gặp #no-channel và Chọn nhóm.
• Hết thời gian kết nối / lấy mô hình thất bại: Kiểm tra xem base_url có phải là https://byesu.com/v1 không (có /v1, dùng https), cũng như máy chủ có kết nối ra ngoài Internet thông suốt hay không. Xem chi tiết ở Lỗi thường gặp #timeout.

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