TokenLab

코딩 도구

TokenLab Provider 설정

자체 호스팅된 OpenClaw 인스턴스를 TokenLab에 연결

에이전트가 이 설정을 수행하도록 하기

컴퓨터에서 이미 실행 중인 에이전트에 이 작업을 복사하세요:

Read this guide and help me connect OpenClaw to TokenLab:
https://tokenlab.sh/docs/ko/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.

이 가이드는 자체 호스팅 OpenClaw를 위한 것입니다. TokenLab 플러그인이 가장 빠른 설정 방법이며, 특정 API 형식이 필요한 경우 수동 구성을 사용할 수 있습니다.

플러그인 설치

선택 사항: 게시된 제공자 플러그인 0.1.3을 설치합니다. 아래 설명된 것과 동일한 Gateway 환경을 통해 TOKENLAB_API_KEY를 제공하고 세션 전용 모델 선택을 사용하세요. 플러그인 온보딩 마법사가 기본 모델을 변경하므로, 이 가이드에서는 openclaw onboard를 실행하지 않습니다. 기존 플러그인 항목과 권한을 유지하세요. 요청을 수행하기 전에 설치된 플러그인 및 모델 목록을 확인하세요.

설치 프로그램이 요청하는 기능을 검토하고 클라이언트의 확인 프롬프트를 따르세요. 관련 없는 권한을 부여하거나 기존 플러그인의 권한을 변경하지 마세요.

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

수동으로 제공자 구성

OpenClaw가 Responses, Claude Messages, Gemini 또는 MiniMax 형식을 별도로 필요로 할 때만 models.providers를 사용하세요. 일반적인 채팅의 경우 tokenlab 항목만으로 충분합니다.

제공자OpenClaw api용도baseUrl
tokenlabopenai-completionsGPT, DeepSeek, Qwen 및 대부분의 OpenAI 호환 호출https://api.tokenlab.sh/v1
tokenlab-responsesopenai-responses/v1/responses 의미 체계를 기대하는 OpenAI Responses 워크플로우https://api.tokenlab.sh/v1
tokenlab-claudeanthropic-messages네이티브 Claude Messages APIhttps://api.tokenlab.sh
tokenlab-geminigoogle-generative-ai네이티브 Gemini API 형식https://api.tokenlab.sh
tokenlab-minimaxanthropic-messagesMessages 형식을 통한 MiniMax 모델https://api.tokenlab.sh

/v1 접미사는 openai-completions 및 openai-responses에만 사용하세요.

anthropic-messages 및 google-generative-ai와 같은 네이티브 제공자는 /v1 없이 https://api.tokenlab.sh를 사용해야 합니다. 그렇지 않으면 OpenClaw가 잘못된 제공자 경로를 구성할 수 있습니다.

사전 요구 사항

  • 자체 호스팅된 OpenClaw 인스턴스
  • OpenClaw 2026.9.4의 경우, Node.js >=24.16.0 <25 || >=26.1.0을 사용하세요 (버전 요구 사항). 다른 OpenClaw 릴리스의 경우 해당 릴리스의 요구 사항을 확인하세요.
  • TokenLab API Key — 여기서 발급받으세요

구성

OpenClaw 구성을 편집하세요:

  • 자체 호스팅: ~/.openclaw/openclaw.json

models.providers 아래에 TokenLab 제공자를 추가하세요:

실행 중인 Gateway와 동일한 프로필, OPENCLAW_STATE_DIR 및 OPENCLAW_CONFIG_PATH를 사용하세요. 병합하기 전에 활성 구성을 백업하세요. 해당 인스턴스의 신뢰할 수 있는 전역 .env 또는 서비스 환경에 TOKENLAB_API_KEY를 넣으세요. 터미널 export나 프로젝트 .env만으로는 백그라운드 Gateway에 도달하지 못할 수 있습니다. 환경 처리를 참조하세요.

활성 구성을 백업하세요. TokenLab 항목만 추가하고 기존 제공자, 계정, 기본 모델 선택 및 권한을 유지하세요. 이름이 이미 사용 중인 경우 다른 이름을 선택하고 명령을 업데이트하세요. 설정을 취소하려면 추가한 항목만 제거하거나 이전 백업으로 복원하세요.

{
  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" }
        ]
      }
    }
  }
}

5개 제공자 모두 동일한 API Key를 사용합니다. TokenLab 계정은 하나만 있으면 됩니다.

위의 models 배열은 일반적인 예시만 보여줍니다. 필요에 따라 각 제공자에 모델 ID를 더 추가하세요.

모델 사용

OpenClaw는 여전히 provider/model 형식으로 모델을 참조합니다:

OpenClaw 2026.9.4의 경우, -s를 사용하여 현재 세션에 대해서만 모델을 선택하세요. agents.defaults.model, 에이전트 기본값 및 권한은 변경하지 마세요. /model default -s를 사용하여 이 세션을 구성된 기본값으로 되돌리세요.

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

모델 예시

제공자모델 참조설명
tokenlabtokenlab/gpt-5.6-terraOpenAI 호환 (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-m3Messages 형식을 통한 MiniMax

tokenlab.sh/models에서 사용 가능한 모든 모델을 찾아보세요.

제공자별 사용 시기

  • tokenlab: 대부분의 범용 에이전트 및 채팅 사용 사례에 대한 기본 선택.
  • tokenlab-responses: OpenClaw 워크플로우가 OpenAI Responses 의미 체계에 명시적으로 의존하는 경우 사용.
  • tokenlab-claude: Claude의 네이티브 Messages 동작을 원할 때 사용.
  • tokenlab-gemini: Gemini 네이티브 요청/응답 형식이나 기존 Gemini 스타일 통합을 원할 때 사용.
  • tokenlab-minimax: Messages 형식을 통해 MiniMax 모델을 사용하려는 경우 사용.

Gemini 네이티브 동작이 필요하지 않은 경우, OpenAI 호환 형식을 통해 tokenlab/gemini-*로 Gemini 모델을 호출할 수 있습니다.

일반적인 실수

설정 확인

해당 인스턴스를 재시작한 다음 선택된 모델과 제공자를 검사하세요. --probe 없는 models status는 모델 호출 테스트를 수행하지 않습니다. 라이브 --probe 또는 채팅 메시지는 토큰을 소비할 수 있습니다. 설정이 작동한다고 선언하기 전에 일치하는 TokenLab 요청에 대해 실제 응답을 확인하세요. 복원하려면 이전 모델을 선택하고 추가한 TokenLab 항목만 제거하세요.

openclaw gateway restart
openclaw models status

동일한 에이전트에서 이미지 및 비디오 생성

OpenClaw는 TokenLab MCP 서버를 사용하여 이미지와 짧은 비디오를 만들 수도 있습니다. 각 생성 비용은 동일한 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

작은따옴표를 유지하세요. OpenClaw는 키가 아닌 변수에 대한 참조를 저장하며, 서버를 시작할 때 실행되는 환경에서 TOKENLAB_API_KEY를 읽습니다. probe는 TokenLab 도구 목록을 표시합니다. 그런 다음 시도해 보세요:

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는 작업 ID를 반환합니다. 에이전트는 비디오가 준비될 때까지 get_task_status를 호출합니다.

다음 단계

OpenClaw가 연결되면 다음 가이드가 TokenLab을 더 효과적으로 사용하는 데 도움이 됩니다:

  • API 형식 — OpenAI, Responses, Anthropic 및 Gemini 경로 간의 차이점 이해
  • IDE / SDK 호환성 — /v1/responses가 더 적합한 경우 확인
  • 오류 처리 — 일반적인 실패 모드 및 복구 패턴 학습
  • 모델 개요 — 에이전트에 연결하기 전에 모델 ID 찾아보기

이 페이지의 내용