TokenLab Provider 설정

기존 에이전트에 설정 맡기기Copy Anchor Link

컴퓨터에서 이미 사용할 수 있는 에이전트에 다음 작업을 복사해 전달하세요.

이 가이드를 읽고 OpenClaw의 TokenLab 연결을 도와주세요:
https://tokenlab.sh/docs/ko/guides/tokenlab-provider
설치된 버전과 현재 적용된 설정을 먼저 확인하세요.
기존 계정, 제공자, 권한 및 기타 설정을 보존하세요.
로컬 파일을 백업하고 변경할 내용을 보여 주세요.
필요한 API 키는 제가 로컬로 입력하겠습니다. 채팅에서 키를 요구하거나 출력하거나 붙여 넣지 마세요.
먼저 설정이 정상적으로 로드되는지 확인하세요.
유료 요청 테스트는 실행 전에 비용을 별도로 설명하세요.

권장: 플러그인 설치Copy Anchor Link

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

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

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

수동 프로바이더 구성Copy Anchor Link

별도의 Responses API, Claude native, Gemini native 또는 MiniMax native 경로가 명시적으로 필요한 경우에만 아래의 models.providers 수동 구성을 사용하세요.

수동 구성을 선택한다면 tokenlab만 구성하는 것으로 충분합니다. Responses API, Claude native, Gemini native, 또는 MiniMax native 동작이 명시적으로 필요할 때만 다른 프로바이더를 추가하세요.

사전 요구사항Copy Anchor Link

• self-hosted OpenClaw 인스턴스
• OpenClaw 2026.9.4에는 Node.js >=24.16.0 <25 || >=26.1.0이 필요합니다(버전 요구 사항). 다른 OpenClaw 릴리스는 해당 릴리스의 요구 사항을 확인하세요.
• TokenLab API Key — Get one here

구성Copy Anchor Link

OpenClaw 구성 파일을 편집하세요:

• 셀프 호스트: ~/.openclaw/openclaw.json

models.providers 아래에 TokenLab 프로바이더를 추가합니다:

실행 중인 Gateway와 같은 profile, OPENCLAW_STATE_DIR, OPENCLAW_CONFIG_PATH를 사용하고 설정을 백업하세요. TOKENLAB_API_KEY는 해당 인스턴스의 신뢰할 수 있는 전역 .env나 서비스 환경에 둡니다. 터미널 export나 프로젝트 .env만으로는 백그라운드에 전달되지 않을 수 있습니다. 환경 안내를 참고하세요.

활성 구성을 백업하세요. 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-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" }
        ]
      }
    }
  }
}

모델 사용 방법Copy Anchor Link

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

OpenClaw 2026.9.4에서는 -s로 현재 세션에만 모델을 선택하세요. agents.defaults.model, 에이전트 기본값과 권한을 유지하세요. /model default -s로 이 세션을 구성된 기본 모델로 되돌릴 수 있습니다.

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

모델 예시Copy Anchor Link

사용 가능한 모든 모델은 tokenlab.sh/models에서 확인하세요.

어떤 프로바이더를 언제 사용해야 하나요Copy Anchor Link

• tokenlab: 대부분의 범용 에이전트 및 채팅 사용 사례에 대한 기본 선택입니다.
• tokenlab-responses: OpenClaw 워크플로우가 명시적으로 OpenAI Responses 의미론에 의존할 때 사용하세요.
• tokenlab-claude: Claude의 네이티브 Messages 동작이 필요할 때 사용하세요.
• tokenlab-gemini: Gemini 네이티브 요청/응답 포맷이나 기존 Gemini 스타일 통합을 사용하고자 할 때 사용하세요.
• tokenlab-minimax: MiniMax의 네이티브 경로를 사용하고자 할 때 사용하세요.

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

흔한 실수Copy Anchor Link

설정 확인Copy Anchor Link

같은 인스턴스를 재시작하고 모델과 제공자를 확인하세요. --probe 없는 models status는 모델 호출 테스트가 아닙니다. 실제 탐색이나 대화는 token을 사용할 수 있습니다. 응답과 TokenLab 기록을 비교하세요. 복구할 때는 이전 모델을 선택하고 추가한 항목만 제거합니다.

openclaw gateway restart
openclaw models status

다음 단계Copy Anchor Link

OpenClaw가 연결된 후, 다음 가이드들이 TokenLab를 보다 효과적으로 사용하는 데 도움이 됩니다:

• API 형식 — OpenAI, Responses, Anthropic, Gemini 경로 간 차이 이해
• IDE / SDK Compatibility — 언제 /v1/responses가 더 적합한지 확인
• 오류 처리 — 일반적인 실패 모드 및 복구 패턴 학습
• 모델 개요 — 에이전트에 연결하기 전에 모델 ID를 살펴보세요