Tích hợp OpenClaw

Độ khó ⌨️ Trung cấp　|　Định dạng API 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

OpenClaw (🦞) là trợ lý AI cá nhân mã nguồn mở, hỗ trợ tùy chỉnh nhà cung cấp dịch vụ mô hình. Chỉ cần trỏ nó về Byesu là xong, trên Windows / macOS / Linux đều giống nhau.

Trước khi bắt đầu

Trước tiên hãy vào Bảng điều khiển → Token để tạo một token (xem Chọn nhóm).

Cách 1: Trình hướng dẫn (đơn giản nhất)

Sau khi cài đặt, chạy trình hướng dẫn tích hợp sẵn và chọn nhà cung cấp dịch vụ "Tùy chỉnh / Tương thích OpenAI" theo hướng dẫn:

openclaw onboard

Lần lượt điền:

• Địa chỉ API / baseUrl: https://byesu.com/v1
• API key: sk-xxxx của bạn
• Mô hình: điền tên mô hình có trên Byesu (ví dụ gpt-5.5, claude-opus-4-8)

Cách 2: Tự sửa file cấu hình

Trong file cấu hình của OpenClaw (~/.openclaw/openclaw.json, định dạng JSON5), thêm một nhà cung cấp dịch vụ tùy chỉnh dưới mục models.providers:

{
  agents: {
    defaults: { model: { primary: "byesu/gpt-5.5" } },   // 默认用哪个模型
  },
  models: {
    mode: "merge",                   // 合并内置服务商，而非覆盖
    providers: {
      byesu: {
        baseUrl: "https://byesu.com/v1",
        apiKey: "${BYESU_API_KEY}",      // 建议用环境变量，避免明文
        api: "openai-completions",       // OpenAI 兼容
        models: [
          { id: "gpt-5.5", name: "Byesu GPT-5.5" },
          { id: "claude-opus-4-8", name: "Byesu Claude Opus 4.8" },
        ],
      },
    },
  },
}

Một vài điểm cần lưu ý

• baseUrl phải có /v1 (tương thích OpenAI).
• apiKey nên dùng biến môi trường ${BYESU_API_KEY} (đặt key thật vào biến môi trường), đừng commit dạng văn bản thuần lên git: export BYESU_API_KEY="sk-xxxx".
• Khi Gateway chạy dưới dạng dịch vụ nền / daemon, phải đảm bảo môi trường của tiến trình dịch vụ cũng có biến này (chỉ export trong terminal hiện tại thì tiến trình nền sẽ không đọc được và báo lỗi 401); nếu chỉ dùng trên máy cá nhân và không đưa lên git, bạn cũng có thể điền thẳng key dạng văn bản thuần vào cấu hình.
• id trong models phải khớp với tên mô hình trên Bảng điều khiển.
• Đường dẫn chính xác của file cấu hình lấy theo file mà trình hướng dẫn openclaw onboard tạo ra (một số phiên bản nằm ở ~/.config/openclaw/).

Xác minh tích hợp

openclaw models list     # Xác nhận các mô hình có tiền tố byesu/ xuất hiện trong danh sách khả dụng

Bạn cũng có thể chạy openclaw dashboard để mở UI và gửi thử một câu để kiểm tra.

Bị kẹt?

Khi không hiểu thông báo lỗi, trước tiên hãy chạy openclaw gateway --port 18789 ở chế độ tiền cảnh (foreground) để quan sát trực tiếp log và lỗi.

• 401 / Token không hợp lệ → điền sai key, hoặc dịch vụ chạy nền không đọc được biến môi trường BYESU_API_KEY (xem các điểm lưu ý ở trên) (chi tiết)
• Không có kênh khả dụng → mô hình không nằm trong nhóm của token của bạn (Chọn nhóm, chi tiết)
• Các trường hợp khác xem Lỗi thường gặp & cách khắc phục