OpenClaw

OpenClaw hỗ trợ endpoint tương thích OpenAI và Anthropic. Chuẩn bị key/model theo hướng dẫn chung.

1. Cài và khởi tạo

Cài theo Getting started. Bản được đối chiếu yêu cầu Node.js 24.16+ hoặc 26.1+. Mở wizard bằng openclaw onboard --classic, chọn cấu hình provider tùy chỉnh. Dùng API key của hệ thống thay cho đăng nhập tài khoản AI khác.

2. Thêm custom provider

Mở ~/.openclaw/openclaw.json. Nếu đã có cấu hình, gộp các mục sau vào file và giữ các channel/agent hiện có:

{  "models": {    "mode": "merge",    "providers": {      "vnaipro": {        "baseUrl": "https://api.vnaipro.app/v1",        "apiKey": "YOUR_API_KEY",        "api": "openai-completions",        "models": [          {            "id": "YOUR_MODEL_ID",            "name": "VNAI Pro model"          }        ]      }    }  },  "agents": {    "defaults": {      "model": {        "primary": "vnaipro/YOUR_MODEL_ID"      }    }  }}

Thay key và cả hai chỗ YOUR_MODEL_ID. Provider ID là vnaipro; model ref của OpenClaw là vnaipro/YOUR_MODEL_ID.

Cấu hình trên dùng Chat Completions. Nếu model của group yêu cầu giao thức khác:

Nếu cần nhiều giao thức cùng lúc, tạo provider ID riêng cho mỗi giao thức. Chỉ khai báo context window, output limit hoặc khả năng ảnh khi biết giới hạn thực của model.

3. Áp dụng và thử

openclaw doctor
openclaw models list
openclaw gateway restart
openclaw dashboard

Nếu chưa cài gateway service, làm bước Install the Gateway service trong hướng dẫn cài chính thức trước. Tạo chat mới trong dashboard, kiểm tra model đã chọn rồi gửi câu hỏi ngắn và một tác vụ đọc file.

Không thấy model: kiểm tra models.providers.vnaipro.models và model ref khớp nhau. Sai key sau khi đổi cấu hình: kiểm tra profile xác thực/provider đang dùng và khởi động lại gateway. Tham khảo lỗi chung.

Nguồn: Custom providers, Models.