> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.
# Thiết lập TokenLab Provider
> Cấu hình TokenLab làm provider tùy chỉnh trong OpenClaw sử dụng các route tương thích OpenAI, Responses, Anthropic và Gemini
Hướng dẫn này dành cho người dùng **self-hosted OpenClaw** muốn kết nối TokenLab làm provider AI của họ.
## Khuyến nghị: cài đặt plugin
Để chạy agent OpenClaw theo cách tiêu chuẩn, hãy cài đặt plugin provider TokenLab:
```bash theme={null}
openclaw plugins install @tokenlabai/openclaw-provider
openclaw onboard --tokenlab-api-key "$TOKENLAB_API_KEY"
```
Plugin tải danh mục model chat trực tiếp của TokenLab và giữ 18 model dự phòng để khám phá khi ngoại tuyến. Model sử dụng định dạng `tokenlab/`.
[Gói npm](https://www.npmjs.com/package/@tokenlabai/openclaw-provider) · [Trang ClawHub](https://clawhub.ai/tokenlabai/plugins/openclaw-provider) · [Mã nguồn](https://github.com/hedging8563/tokenlab-openclaw-provider)
## Cấu hình provider thủ công
Chỉ dùng các mục `models.providers` thủ công bên dưới khi bạn thực sự cần các route riêng cho **Responses API**, **Claude native**, **Gemini native** hoặc **MiniMax native**.
Nếu bạn chọn cấu hình thủ công, chỉ cần cấu hình `tokenlab` là đủ. Chỉ thêm các provider khác khi bạn thực sự cần hành vi **Responses API**, **Claude native**, **Gemini native**, hoặc **MiniMax native**.
| Nhà cung cấp | OpenClaw `api` | Phù hợp cho | baseUrl |
| -------------------- | ---------------------- | ----------------------------------------------------------------------- | ---------------------------- |
| `tokenlab` | `openai-completions` | GPT, DeepSeek, Qwen, và hầu hết các gọi tương thích OpenAI | `https://api.tokenlab.sh/v1` |
| `tokenlab-responses` | `openai-responses` | Các luồng công việc OpenAI Responses mong đợi ngữ nghĩa `/v1/responses` | `https://api.tokenlab.sh/v1` |
| `tokenlab-claude` | `anthropic-messages` | API Messages gốc của Claude | `https://api.tokenlab.sh` |
| `tokenlab-gemini` | `google-generative-ai` | Định dạng API Gemini gốc | `https://api.tokenlab.sh` |
| `tokenlab-minimax` | `anthropic-messages` | Điều hướng MiniMax gốc | `https://api.tokenlab.sh` |
Chỉ sử dụng hậu tố `/v1` cho `openai-completions` và `openai-responses`.
Các nhà cung cấp gốc như `anthropic-messages` và `google-generative-ai` nên dùng `https://api.tokenlab.sh` mà không có `/v1`, nếu không OpenClaw có thể tạo sai đường dẫn upstream.
## Yêu cầu tiên quyết
* Một instance OpenClaw self-hosted
* Một TokenLab API Key — [Get one here](https://tokenlab.sh/dashboard)
## Cấu hình
Chỉnh sửa cấu hình OpenClaw của bạn:
* **Tự lưu trữ**: `~/.openclaw/openclaw.json`
Thêm provider TokenLab dưới `models.providers`:
```json5 theme={null}
{
agents: {
defaults: {
model: {
primary: "tokenlab-claude/claude-sonnet-4-6"
}
}
},
models: {
mode: "merge",
providers: {
tokenlab: {
api: "openai-completions",
baseUrl: "https://api.tokenlab.sh/v1",
apiKey: "sk-your-tokenlab-key",
models: [
{ id: "gpt-4o", name: "GPT-4o" },
{ id: "deepseek-r1", name: "DeepSeek R1" },
{ id: "qwen3-coder-flash", name: "Qwen 3 Coder Flash" }
]
},
"tokenlab-responses": {
api: "openai-responses",
baseUrl: "https://api.tokenlab.sh/v1",
apiKey: "sk-your-tokenlab-key",
models: [
{ id: "gpt-4o", name: "GPT-4o (Responses)" },
{ id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
]
},
"tokenlab-claude": {
api: "anthropic-messages",
baseUrl: "https://api.tokenlab.sh",
apiKey: "sk-your-tokenlab-key",
models: [
{ id: "claude-sonnet-4-6", name: "Claude Sonnet 4.6" },
{ id: "claude-opus-4-6", name: "Claude Opus 4.6" }
]
},
"tokenlab-gemini": {
api: "google-generative-ai",
baseUrl: "https://api.tokenlab.sh",
apiKey: "sk-your-tokenlab-key",
models: [
{ id: "gemini-3.5-flash", name: "Gemini 3.5 Flash" },
{ id: "gemini-2.5-pro", name: "Gemini 2.5 Pro" }
]
},
"tokenlab-minimax": {
api: "anthropic-messages",
baseUrl: "https://api.tokenlab.sh",
apiKey: "sk-your-tokenlab-key",
models: [
{ id: "minimax-m3", name: "MiniMax M3" }
]
}
}
}
}
```
Cả 5 nhà cung cấp đều dùng **cùng một API Key**. Bạn chỉ cần một tài khoản TokenLab.
Các mảng `models` ở trên chỉ hiển thị các ví dụ phổ biến. Thêm các model ID khác cho từng nhà cung cấp khi cần.
## Sử dụng Models
OpenClaw vẫn tham chiếu các model theo định dạng `provider/model`:
```json5 theme={null}
{
agents: {
defaults: {
model: {
primary: "tokenlab-gemini/gemini-3.5-flash"
}
}
}
}
```
### Ví dụ Model
| Nhà cung cấp | Tham chiếu model | Mô tả |
| -------------------- | ----------------------------------- | ----------------------------- |
| `tokenlab` | `tokenlab/gpt-4o` | Route tương thích OpenAI |
| `tokenlab` | `tokenlab/deepseek-r1` | Mô hình suy luận DeepSeek |
| `tokenlab-responses` | `tokenlab-responses/gpt-4o` | Route Responses API |
| `tokenlab-claude` | `tokenlab-claude/claude-sonnet-4-6` | Route Messages gốc của Claude |
| `tokenlab-gemini` | `tokenlab-gemini/gemini-3.5-flash` | Route Gemini gốc |
| `tokenlab-minimax` | `tokenlab-minimax/minimax-m3` | Route MiniMax gốc |
Browse all available models at [tokenlab.sh/models](https://tokenlab.sh/vi/models).
## Khi nào sử dụng provider nào
* `tokenlab`: lựa chọn mặc định cho hầu hết các trường hợp sử dụng agent và chat đa dụng.
* `tokenlab-responses`: dùng khi luồng công việc OpenClaw của bạn phụ thuộc rõ ràng vào ngữ nghĩa OpenAI Responses.
* `tokenlab-claude`: dùng khi bạn muốn hành vi Messages gốc của Claude.
* `tokenlab-gemini`: dùng khi bạn cần định dạng yêu cầu/đáp trả gốc của Gemini hoặc tích hợp theo kiểu Gemini hiện có.
* `tokenlab-minimax`: dùng khi bạn muốn MiniMax theo route gốc của nó.
Nếu bạn không cần hành vi Gemini-gốc, bạn vẫn có thể gọi các model Gemini thông qua `tokenlab/gemini-*` trên route tương thích OpenAI.
## Những lỗi phổ biến
Tài liệu OpenClaw hiện tại sử dụng `models.providers`. Nếu bạn giữ định dạng mảng `providers` cấp cao cũ, OpenClaw có thể bỏ qua cấu hình hoặc không thể giải quyết tiền tố provider như mong đợi.
`openai-responses` ánh xạ đến đường dẫn `/v1/responses` của TokenLab, nên `tokenlab-responses` phải sử dụng `https://api.tokenlab.sh/v1`.
`anthropic-messages` và `google-generative-ai` nên sử dụng `https://api.tokenlab.sh` mà không có `/v1`. Thêm `/v1` có thể tạo ra các đường dẫn yêu cầu không chính xác.
Có. Tài liệu OpenClaw hiện tại vẫn bao gồm provider tích hợp sẵn `google` và cũng hỗ trợ các provider tùy chỉnh sử dụng `api: "google-generative-ai"`. Vì vậy `tokenlab-gemini` vẫn là một route Gemini gốc hợp lệ cho người dùng OpenClaw.
## Xác minh cấu hình
Sau khi lưu cấu hình, khởi động lại instance OpenClaw của bạn và thử với một tin nhắn đơn giản. Nếu bạn nhận được phản hồi, provider đã được cấu hình chính xác.
```bash theme={null}
# Tự lưu trữ: khởi động lại dịch vụ
systemctl --user restart openclaw # Linux
launchctl stop cc.tokenlab.openclaw && launchctl start cc.tokenlab.openclaw # macOS
```
## Bước tiếp theo
Khi OpenClaw đã kết nối, các hướng dẫn sau sẽ giúp bạn sử dụng TokenLab hiệu quả hơn:
* [Định dạng API](/guides/api-formats) — hiểu sự khác nhau giữa các route OpenAI, Responses, Anthropic và Gemini
* [IDE / SDK Compatibility](/guides/ide-sdk-compatibility) — xem khi nào `/v1/responses` là lựa chọn phù hợp hơn
* [Xử lý lỗi](/guides/error-handling) — tìm hiểu các chế độ thất bại phổ biến và các mẫu phục hồi
* [Tổng quan mô hình](https://tokenlab.sh/vi/models) — duyệt các ID model trước khi kết nối chúng vào agents