HƯỚNG DẪN CẤU HÌNH BEE API VỚI 9ROUTER

💡 Đây là cách nối OpenClaw với Beeknoee thông qua 9Router. Muốn nối thẳng, không cài thêm gì, xem OpenClaw.

6:04

9Router là gì?

9Router là một AI proxy miễn phí giúp kết nối OpenClaw với các provider AI (bao gồm Beeknoee) thông qua giao diện Dashboard trực quan — không cần sửa file JSON tay.

Yêu cầu

• Windows: Windows 10 (Build 19041+) hoặc Windows 11, có WSL2 + Ubuntu
• macOS: macOS 14 trở lên
• OpenClaw đã được cài đặt
• API Key từ Beeknoee Platform

📌 Hướng dẫn tạo API Key

1. Truy cập https://platform.beeknoee.com/api-keys
2. Đăng nhập bằng tài khoản Google của bạn
3. Nhấn nút "Create API Key"
4. Nhập tên cho API Key (ví dụ: "OpenClaw")
5. Nhấn "Create"
6. Copy API Key vừa tạo

Ghi chú

Ví dụ minh họa:

• API Key: sk-bee-c6ccac913dbc41eea22xxxxxx
• Model: gpt-5.4-nano

BƯỚC 1: Mở Terminal

Windows: Nhấn phím Windows → gõ "Ubuntu" → nhấn Enter

macOS: Nhấn Command (⌘) + Space → gõ "Terminal" → nhấn Enter

Quan trọng

Trên Windows, tất cả các lệnh đều chạy trong terminal Ubuntu (WSL2), KHÔNG phải PowerShell hay CMD.

BƯỚC 2: Cài 9Router

npm install -g 9router

BƯỚC 3: Khởi động 9Router

9router

Chọn ★ Web UI (Open in Browser) → Dashboard tự mở tại:

http://localhost:20128

Windows: WSL2 tự động forward port, nên truy cập localhost:20128 trên trình duyệt Windows bình thường.

🔐 Dashboard hỏi mật khẩu: lần đầu, mật khẩu mặc định là 123456. Đăng nhập xong hãy đổi ngay trong Settings.

BƯỚC 4: Thêm Beeknoee vào 9Router

1. Trong Dashboard, vào Providers

2. Nhấn Add OpenAI Compatible

3. Điền thông tin:

4. Nhấn Check để kiểm tra kết nối
5. Nhấn Create

Mẹo

🦞 Mẹo: API Key có thể copy từ trang API Keys.

BƯỚC 5: vào Provider → chọn Beeknoee (Nếu đã cấu hình như bước 4 bạn sẽ thấy Beeknoee xuất hiện)

1. Thêm API key vào 9Router của Beeknoee AI

Điền lại giá trị và API key bạn vừa điền, nhớ ấn check để đảm bảo API key đúng.

Ra ngoài thấy API key ở trạng thái Active là chuẩn.

2. Thêm model vào 9Router của Beeknoee AI

• Mở mục Available Models

• Vào website https://platform.beeknoee.com/text-embedding-models Chọn model bạn muốn sử dụng và copy bằng cách ấn vào nút ID của model.

• Dán vào ô Model ID ở mục Available Models và ấn Add — 9Router ghi thành beeknoee/<model-id>

BƯỚC 6: Kết nối OpenClaw qua 9Router

Kết nối model AI với OpenClaw qua CLI Tools trong Dashboard

🔑 OpenClaw gọi vào 9Router nên cần API key của chính 9Router (khác API key Bee, chỉ dùng trong máy bạn): Dashboard → Endpoint → Create Key, đặt tên vd openclaw.

1. Dashboard → CLI Tools → OpenClaw — ô Endpoint giữ địa chỉ 9Router trên máy, ô API Key chọn key openclaw vừa tạo

2. Ô Model → quay lại dashboard → Providers → Beeknoee AI → Copy model bạn muốn sử dụng

3. Dán model vào ô Default Model và ấn Apply — thấy báo thành công và trạng thái Connected là xong

9Router sẽ tự sửa file config OpenClaw cho bạn ✅

BƯỚC 7: TEST

Test qua Web UI:

1. Mở trình duyệt → truy cập http://localhost:18789
2. Gõ "hello" → bot trả lời = thành công! ✅

Test qua Telegram:

1. Mở Telegram → tìm bot của bạn → gửi "hello"
2. Nếu bot không trả lời, cần pair lại:

openclaw pairing list
openclaw pairing approve telegram <code>

Lưu ý quan trọng

Quan trọng

9Router phải luôn chạy khi sử dụng OpenClaw, vì OpenClaw gọi model qua localhost:20128.

Để 9Router chạy nền, dùng PM2 (trình quản lý process):

# Cài PM2 (chỉ cần 1 lần)
npm install -g pm2

# Chạy 9Router nền
pm2 start 9router --name 9router
pm2 save

# Tự khởi động khi restart máy/WSL
pm2 startup

Một số lệnh PM2 hữu ích:

pm2 status          # Xem trạng thái
pm2 logs 9router    # Xem log
pm2 restart 9router # Restart
pm2 stop 9router    # Tạm dừng

Đổi model

Khi muốn đổi model (ví dụ từ gpt-5.4-nano sang claude-sonnet-4-6):

1. Thêm Model vào 9Router (như bước 5)
2. Mở 9Router Dashboard → CLI Tools → OpenClaw → đổi model (ví dụ beeknoee/claude-sonnet-4-6) → Apply

Hoặc sửa tay: thay id, name, và primary trong ~/.openclaw/openclaw.json

Mẹo

Copy Model ID từ trang Các Mô Hình AI.

Lưu ý

Với model Claude và các model reasoning (suy nghĩ lâu), dùng ở chế độ streaming. Nếu gặp Cloudflare Error 524 (model nghĩ >120s), đảm bảo request đặt stream: true. Xem Error Handling.

So sánh cách setup

Xử lý lỗi

9Router Dashboard không mở được

# Kiểm tra 9Router đang chạy chưa
ps aux | grep 9router

# Khởi động lại
9router

"OpenClaw CLI not installed" trên Dashboard

• Đây là do 9Router không tìm thấy lệnh openclaw trong PATH
• Giải pháp: cài lại OpenClaw (curl -fsSL https://openclaw.ai/install.sh | bash) rồi thử lại

"device token mismatch" khi kết nối Telegram

• Chạy lại: openclaw onboard → hoàn tất wizard → pair lại Telegram

OpenClaw gateway không khởi động

# Xem lỗi chi tiết
openclaw doctor

# Khôi phục config mặc định
openclaw reset
openclaw onboard

Gỡ cài đặt

Gỡ 9Router

npm uninstall -g 9router

Gỡ OpenClaw và cài lại

openclaw gateway stop
npm uninstall -g openclaw
rm -rf ~/.openclaw
curl -fsSL https://openclaw.ai/install.sh | bash

HOÀN TẤT! 🎉

Cần hỗ trợ? Liên hệ qua Beeknoee Platform hoặc email support.