TokenLab

Công cụ lập trình

Thiết lập TokenLab Provider

Kết nối một instance OpenClaw tự lưu trữ (self-hosted) với TokenLab

Để agent của tôi thiết lập việc này

Sao chép tác vụ này vào một agent đang chạy trên máy tính của bạn:

Read this guide and help me connect OpenClaw to TokenLab:
https://tokenlab.sh/docs/vi/guides/tokenlab-provider
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.

Hướng dẫn này dành cho OpenClaw tự lưu trữ. Plugin TokenLab là cách thiết lập nhanh nhất; cấu hình thủ công khả dụng khi bạn cần một định dạng API cụ thể.

Cài đặt plugin

Tùy chọn: cài đặt plugin provider đã xuất bản 0.1.3. Cung cấp TOKENLAB_API_KEY thông qua cùng môi trường Gateway được mô tả bên dưới và chỉ sử dụng lựa chọn model theo phiên. Trình hướng dẫn cài đặt plugin sẽ thay đổi model mặc định, vì vậy hướng dẫn này không chạy openclaw onboard. Giữ nguyên các mục plugin và quyền hiện có. Kiểm tra plugin đã cài đặt và danh sách model trước khi thực hiện yêu cầu.

Xem lại các khả năng được yêu cầu bởi trình cài đặt và làm theo các lời nhắc xác nhận của client. Không cấp các quyền không liên quan hoặc thay đổi quyền của các plugin hiện có.

openclaw plugins install @tokenlabai/openclaw-provider@0.1.3
openclaw plugins list
openclaw models list --provider tokenlab
/model tokenlab/claude-sonnet-5 -s
/model default -s

npm · GitHub

Cấu hình provider thủ công

Chỉ sử dụng models.providers khi OpenClaw cần các định dạng Responses, Claude Messages, Gemini hoặc MiniMax riêng biệt. Đối với chat thông thường, mục tokenlab là đủ.

ProviderOpenClaw apiTốt nhất chobaseUrl
tokenlabopenai-completionsGPT, DeepSeek, Qwen và hầu hết các lệnh gọi tương thích với OpenAIhttps://api.tokenlab.sh/v1
tokenlab-responsesopenai-responsesCác quy trình làm việc OpenAI Responses yêu cầu ngữ nghĩa /v1/responseshttps://api.tokenlab.sh/v1
tokenlab-claudeanthropic-messagesNative Claude Messages APIhttps://api.tokenlab.sh
tokenlab-geminigoogle-generative-aiĐịnh dạng Native Gemini APIhttps://api.tokenlab.sh
tokenlab-minimaxanthropic-messagesCác model MiniMax qua định dạng Messageshttps://api.tokenlab.sh

Chỉ sử dụng hậu tố /v1 cho openai-completions và openai-responses.

Các provider native như anthropic-messages và google-generative-ai nên sử dụng https://api.tokenlab.sh mà không có /v1, nếu không OpenClaw có thể tạo ra đường dẫn provider sai.

Điều kiện tiên quyết

  • Một instance OpenClaw tự lưu trữ
  • Đối với OpenClaw 2026.9.4, sử dụng Node.js >=24.16.0 <25 || >=26.1.0 (yêu cầu phiên bản). Đối với các bản phát hành OpenClaw khác, hãy kiểm tra các yêu cầu của bản phát hành đó.
  • Một TokenLab API Key — Lấy tại đây

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 các provider TokenLab vào dưới models.providers:

Sử dụng cùng profile, OPENCLAW_STATE_DIR và OPENCLAW_CONFIG_PATH như Gateway đang chạy. Sao lưu cấu hình hiện tại trước khi hợp nhất. Đặt TOKENLAB_API_KEY vào tệp .env toàn cục đáng tin cậy hoặc môi trường dịch vụ của instance đó; việc export trong terminal hoặc chỉ dùng tệp .env của dự án có thể không tiếp cận được Gateway chạy ngầm. Xem xử lý môi trường.

Sao lưu cấu hình hiện tại. Chỉ thêm mục TokenLab và giữ nguyên các provider, tài khoản, lựa chọn default-model và quyền hiện có. Nếu tên đã được sử dụng, hãy chọn tên khác và cập nhật các lệnh. Để hoàn tác thiết lập, chỉ cần xóa mục bạn đã thêm hoặc khôi phục bản sao lưu trước đó.

{
  models: {
    mode: "merge",
    providers: {
      tokenlab: {
        api: "openai-completions",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "gpt-5.6-terra", name: "GPT-5.6 Terra" },
          { id: "deepseek-v4-pro", name: "DeepSeek V4 Pro" },
          { id: "qwen3-coder-flash", name: "Qwen 3 Coder Flash" }
        ]
      },
      "tokenlab-responses": {
        api: "openai-responses",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "gpt-5.6-terra", name: "GPT-5.6 Terra (Responses)" },
          { id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
        ]
      },
      "tokenlab-claude": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "claude-sonnet-5", name: "Claude Sonnet 5" },
          { id: "claude-opus-5", name: "Claude Opus 5" }
        ]
      },
      "tokenlab-gemini": {
        api: "google-generative-ai",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "gemini-3.6-flash", name: "Gemini 3.6 Flash" },
          { id: "gemini-2.5-pro", name: "Gemini 2.5 Pro" }
        ]
      },
      "tokenlab-minimax": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "minimax-m3", name: "MiniMax M3" }
        ]
      }
    }
  }
}

Cả 5 provider đều sử 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 nhiều ID model vào mỗi provider khi cần.

Sử dụng Models

OpenClaw vẫn tham chiếu các model theo định dạng provider/model:

Đối với OpenClaw 2026.9.4, chỉ chọn model cho phiên hiện tại với -s. Giữ nguyên agents.defaults.model, các mặc định của agent và quyền. Sử dụng /model default -s để đưa phiên này trở về mặc định đã cấu hình.

/model tokenlab-claude/claude-sonnet-5 -s
/model default -s

Ví dụ về Model

ProviderTham chiếu modelMô tả
tokenlabtokenlab/gpt-5.6-terraTương thích OpenAI (Chat Completions)
tokenlab-responsestokenlab-responses/gpt-5.6-terraResponses API
tokenlab-claudetokenlab-claude/claude-sonnet-5Claude Messages
tokenlab-geminitokenlab-gemini/gemini-3.6-flashGemini
tokenlab-minimaxtokenlab-minimax/minimax-m3MiniMax qua Messages

Duyệt qua tất cả các model khả dụng tại tokenlab.sh/models.

Khi nào nên 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 thông thường.
  • tokenlab-responses: sử dụng khi quy trình làm việc OpenClaw của bạn phụ thuộc rõ ràng vào ngữ nghĩa OpenAI Responses.
  • tokenlab-claude: sử dụng khi bạn muốn hành vi Messages native của Claude.
  • tokenlab-gemini: sử dụng khi bạn muốn định dạng request/response native của Gemini hoặc các tích hợp kiểu Gemini hiện có.
  • tokenlab-minimax: sử dụng khi bạn muốn các model MiniMax qua định dạng Messages.

Nếu bạn không cần hành vi native của Gemini, bạn vẫn có thể gọi các model Gemini thông qua tokenlab/gemini-* trên định dạng tương thích với OpenAI.

Các lỗi thường gặp

Xác minh thiết lập

Khởi động lại instance đó, sau đó kiểm tra model và provider đã chọn. models status mà không có --probe sẽ không thực hiện kiểm tra gọi model. Một lệnh --probe trực tiếp hoặc một tin nhắn chat có thể tiêu tốn token. Kiểm tra phản hồi thực tế so với yêu cầu TokenLab tương ứng trước khi tuyên bố thiết lập đã hoạt động. Để khôi phục, hãy chọn model trước đó và chỉ xóa các mục TokenLab bạn đã thêm.

openclaw gateway restart
openclaw models status

Tạo hình ảnh và video trong cùng một agent

OpenClaw cũng có thể tạo hình ảnh và video ngắn với TokenLab MCP server. Mỗi lần tạo đều được thanh toán từ cùng số dư TokenLab.

openclaw mcp add tokenlab \
  --command npx \
  --arg -y \
  --arg @tokenlabai/mcp-server@0.6.48 \
  --env TOKENLAB_MCP_TOOL_PROFILE=core \
  --env 'TOKENLAB_API_KEY=${TOKENLAB_API_KEY}'
openclaw mcp probe tokenlab

Giữ nguyên các dấu nháy đơn. OpenClaw sau đó lưu trữ tham chiếu đến biến, không phải key, và đọc TOKENLAB_API_KEY từ môi trường mà nó chạy khi khởi động server. Lệnh probe liệt kê các công cụ TokenLab. Sau đó thử:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_video trả về một ID tác vụ. Agent sẽ gọi get_task_status cho đến khi video sẵn sàng.

Các bước tiếp theo

Khi OpenClaw đã được kết nối, các hướng dẫn này giúp bạn sử dụng TokenLab hiệu quả hơn:

  • API Formats — hiểu sự khác biệt giữa các lộ trình OpenAI, Responses, Anthropic và Gemini
  • IDE / SDK Compatibility — xem khi nào /v1/responses là lựa chọn phù hợp hơn
  • Error Handling — tìm hiểu các chế độ lỗi phổ biến và các mẫu khôi phục
  • Models Overview — duyệt qua các ID model trước khi đưa chúng vào các agent

Trên trang này