OpenClaw với Muapi

Kết nối OpenClaw với Muapi làm nhà cung cấp tùy chỉnh tương thích OpenAI để dùng mô hình văn bản Muapi trong agent và kênh đã kết nối.

1. Tạo khóa và chọn mô hình

Tạo khóa API trong bảng điều khiển Muapi, rồi liệt kê mô hình văn bản:

curl -s "https://api.muapi.ai/v1/models?type=text" \
  -H "Authorization: Bearer $MUAPI_API_KEY"

Chọn mô hình có capabilities.tools: true để OpenClaw dùng được công cụ.

2. Cấu hình nhà cung cấp tùy chỉnh

Đặt MUAPI_API_KEY trong môi trường chạy OpenClaw gateway. Thêm nhà cung cấp và mô hình mặc định vào cấu hình, thường là ~/.openclaw/openclaw.json:

{
  models: {
    mode: "merge",
    providers: {
      muapi: {
        baseUrl: "https://api.muapi.ai/v1",
        apiKey: "${MUAPI_API_KEY}",
        api: "openai-completions",
        models: [{ id: "YOUR_MODEL_ID", name: "Muapi text model" }],
      },
    },
  },
  agents: { defaults: { model: { primary: "muapi/YOUR_MODEL_ID" } } },
}

Thay cả hai YOUR_MODEL_ID bằng ID chính xác từ danh sách Muapi. Không lưu khóa trong tệp dự án dùng chung. Nếu OpenClaw chạy như dịch vụ, hãy cung cấp MUAPI_API_KEY trong môi trường dịch vụ.

3. Khởi chạy và kiểm tra

openclaw models list
openclaw tui

Thử tác vụ nhỏ có dùng công cụ, chẳng hạn yêu cầu tóm tắt một tệp trong workspace. Kết nối kênh nhắn tin sau khi mô hình hoạt động trong terminal.

Khắc phục sự cố

• Nếu không thấy mô hình, kiểm tra ID nhà cung cấp, ID mô hình và cú pháp JSON5.
• Nếu xác thực lỗi, xác nhận gateway đọc được MUAPI_API_KEY.
• Nếu mô hình không dùng công cụ, chọn mô hình có capabilities.tools: true.
• Bắt đầu bằng tác vụ nhỏ và theo dõi mức dùng trong bảng điều khiển Muapi.

Xem tài liệu OpenClaw về nhà cung cấp tùy chỉnh và cấu hình mô hình.