Thiết lập TokenLab Provider

Để agent của tôi thiết lậpCopy Anchor Link

Sao chép nhiệm vụ này cho một agent đã hoạt động trên máy tính của bạn:

Đọc hướng dẫn này và giúp tôi kết nối OpenClaw với TokenLab:
https://tokenlab.sh/docs/vi/guides/tokenlab-provider
Trước tiên, kiểm tra phiên bản đã cài và cấu hình đang có hiệu lực.
Giữ nguyên các tài khoản, nhà cung cấp, quyền và những thiết lập khác hiện có.
Sao lưu các tệp cục bộ và trình bày những thay đổi dự kiến.
Để tôi nhập khóa API cần thiết trên máy của mình; không yêu cầu, hiển thị hoặc dán khóa trong cuộc trò chuyện.
Trước tiên, xác nhận cấu hình tải được bình thường.
Giải thích riêng chi phí của mọi phép thử có gửi yêu cầu trả phí trước khi chạy.

Khuyến nghị: cài đặt pluginCopy Anchor Link

Tùy chọn: cài plugin nhà cung cấp đã phát hành 0.1.0. Cấp TOKENLAB_API_KEY qua môi trường Gateway bên dưới và chỉ chọn mô hình cho phiên. Trình hướng dẫn thay đổi mô hình mặc định nên hướng dẫn này không chạy openclaw onboard. Giữ nguyên plugin và quyền hiện có; kiểm tra plugin đã nạp và danh sách mô hình trước khi gửi yêu cầu.

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

openclaw plugins install @tokenlabai/openclaw-provider@0.1.0
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ôngCopy Anchor Link

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.

Yêu cầu tiên quyếtCopy Anchor Link

• Một instance OpenClaw self-hosted
• OpenClaw 2026.9.4 yêu cầu Node.js >=24.16.0 <25 || >=26.1.0 (yêu cầu phiên bản). Với phiên bản OpenClaw khác, hãy kiểm tra yêu cầu của phiên bản đó.
• Một TokenLab API Key — Get one here

Cấu hìnhCopy Anchor Link

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:

Dùng cùng profile, OPENCLAW_STATE_DIR và OPENCLAW_CONFIG_PATH với Gateway đang chạy rồi sao lưu cấu hình. Đặt TOKENLAB_API_KEY trong .env toàn cục đáng tin cậy hoặc môi trường dịch vụ của phiên bản đó. Export ở terminal hay .env dự án có thể không tới tiến trình nền. Xem môi trường.

Sao lưu cấu hình đang dùng. Chỉ thêm mục TokenLab và giữ nguyên nhà cung cấp, tài khoản, mô hình mặc định cùng quyền hiện có. Nếu tên đã được dùng, chọn tên khác và sửa lệnh tương ứng. Khi hoàn tác, chỉ xóa mục đã 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-reasoner", name: "DeepSeek Reasoner" },
          { 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.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: "${TOKENLAB_API_KEY}",
        models: [
          { id: "minimax-m3", name: "MiniMax M3" }
        ]
      }
    }
  }
}

Sử dụng ModelsCopy Anchor Link

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

Trong OpenClaw 2026.9.4, dùng -s để chọn mô hình chỉ cho phiên hiện tại. Giữ nguyên agents.defaults.model, mặc định của agent và quyền. Dùng /model default -s để đưa phiên về mô hình mặc định đã cấu hình.

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

Ví dụ ModelCopy Anchor Link

Xem tất cả model hiện có tại tokenlab.sh/models.

Khi nào sử dụng provider nàoCopy Anchor Link

• 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ếnCopy Anchor Link

Xác minh cấu hìnhCopy Anchor Link

Khởi động lại đúng phiên bản rồi kiểm tra mô hình và nhà cung cấp. models status không có --probe không thử gọi mô hình. Kiểm tra thật và tin nhắn có thể tốn token. Đối chiếu phản hồi với bản ghi TokenLab. Để khôi phục, chọn mô hình cũ và chỉ xóa mục đã thêm.

openclaw gateway restart
openclaw models status

Bước tiếp theoCopy Anchor Link

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 — hiểu sự khác nhau giữa các route OpenAI, Responses, Anthropic và Gemini
• IDE / SDK Compatibility — xem khi nào /v1/responses là lựa chọn phù hợp hơn
• Xử lý lỗi — 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 — duyệt các ID model trước khi kết nối chúng vào agents