Coding Agent 설정

OpenClaw API 및 사용자 지정 모델 설정

OpenClaw의 models.providers에 BetterToken API Key와 Base URL을 입력하세요. Responses 또는 Chat Completions 모델로 연결을 확인하세요.

openai-responses: /v1/responses; openai-completions: /v1/chat/completions. Base URL: https://bettertoken.ai/v1.

주요 설정

필드	값
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	`YOUR_MODEL_ID`

준비 사항

최신 OpenClaw 설치
BetterToken API Key 생성
모델 광장 또는 Key 설정 대화 상자에서 Model ID 복사

가입하고 BetterToken API Key 받기

이미 계정이 있나요? 로그인하고 잔액을 충전한 다음 콘솔에서 키를 만드세요.

설치하기

macOS / Linux

curl -fsSL https://openclaw.ai/install.sh | bash

Windows

iwr -useb https://openclaw.ai/install.ps1 | iex

명령줄 설정

BetterToken 자동 설정 스크립트는 OpenClaw 설정을 작성합니다. Node.js가 필요합니다. API Key 또는 Model ID를 인수로 전달하지 않으면 직접 입력하라는 메시지가 표시됩니다.

macOS / Linux

curl -fsSL "https://bettertoken.ai/install-openclaw-provider.sh" | bash

Windows

iwr "https://bettertoken.ai/install-openclaw-provider.ps1" -OutFile "$env:TEMP\install-openclaw-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-openclaw-provider.ps1"

agents.defaults.model.primary에 설정 화면에 표시된 YOUR_MODEL_ID가 사용되었는지 확인한 뒤 아래의 검증 및 Gateway 재시작 명령을 실행하세요.

수동 설정

OpenClaw 설정

~/.openclaw/openclaw.json을 수정하세요. Model ID의 제공자와 일치하는 예제만 사용하세요.

예제에는 이해를 돕기 위해 API Key 자리표시자가 사용됩니다. 저장할 설정에서는 OpenClaw가 models.providers.bettertoken.apiKey에 SecretRef 또는 환경 변수 치환을 권장합니다. 공유 파일에 실제 Key를 저장하는 대신 공식 인증 정보 안내를 따르세요.

Responses API

{
  "models": {
    "mode": "merge",
    "providers": {
      "bettertoken": {
        "baseUrl": "https://bettertoken.ai/v1",
        "apiKey": "YOUR_API_KEY",
        "api": "openai-responses",
        "models": [
          {
            "id": "YOUR_MODEL_ID",
            "name": "YOUR_MODEL_ID"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bettertoken/YOUR_MODEL_ID"
      }
    }
  }
}

Chat Completions

{
  "models": {
    "mode": "merge",
    "providers": {
      "bettertoken": {
        "baseUrl": "https://bettertoken.ai/v1",
        "apiKey": "YOUR_API_KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "YOUR_MODEL_ID",
            "name": "YOUR_MODEL_ID"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bettertoken/YOUR_MODEL_ID"
      }
    }
  }
}

openai-responses: /v1/responses; openai-completions: /v1/chat/completions. Base URL: https://bettertoken.ai/v1.

연결 확인

다음을 실행하세요.

openclaw config validate
openclaw gateway restart
openclaw models list
openclaw models status

검증을 통과하고 Gateway가 다시 시작되며 모델 목록과 상태에 bettertoken/YOUR_MODEL_ID가 표시되면 설정이 활성화된 것입니다. 기존 세션에서 이전 모델을 계속 사용한다면 새 세션을 시작하고 다시 확인하세요.

모델 전환

새 모델을 models.providers.bettertoken.models에 추가한 뒤 agents.defaults.model.primary를 bettertoken/YOUR_MODEL_ID로 변경하세요. 저장하고 검증한 뒤 Gateway를 다시 시작하세요.

흔한 오류

오류	해결 방법
`config validate` 실패	JSON 쉼표, 따옴표, 괄호를 확인하세요.
`401`	`apiKey`를 다시 복사하고 공백을 제거하세요.
`404`	`openai-responses`: `/v1/responses`; `openai-completions`: `/v1/chat/completions`. Base URL: `https://bettertoken.ai/v1`.
모델이 표시되지 않음	제공자 모델 목록과 `agents.defaults.model.primary`에 모두 있는지 확인하세요.
기존 세션에서 이전 모델 사용	`openclaw gateway restart`를 실행하고 새 세션을 만드세요.