CometAPI × OpenClaw

OpenClaw를
CometAPI로
설정하기

CometAPI를 OpenClaw의 커스텀 모델 공급자로 사용하세요: 하나의 API로 500개 이상의 모델, 최대 20% 할인. 이 가이드는 현재 OpenClaw 온보딩 플로우(2026.3.8+)에 맞춰 설치, 공급자 설정, 검증 및 모델 전환을 다룹니다.

통합 가이드 CometAPI API 키 발급

~/.openclaw/openclaw.json

# 샘플 전용—프로덕션 전에 사용 중인 OpenClaw 버전에 맞게 확인하세요
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "cometapi-claude/claude-sonnet-4-6"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "gpt-5.4", "name": "GPT-5.4" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "${COMETAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "${COMETAPI_KEY}",
        "api": "google-generative-ai",
        "models": [{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }]
      }
    }
  }
}

00 — 여기서 시작하세요

가이드 범위
및 사전 요구사항

가이드 개요

CometAPI로 OpenClaw 설정

CometAPI를 OpenClaw의 커스텀 모델 공급자로 사용하여 하나의 API로 500개 이상의 모델에 접근하고, 지원 라우트에서 최대 20% 할인을 받으세요. 이 페이지는 현재 OpenClaw 온보딩 플로우(2026.3.8+)를 따릅니다.

OpenClaw 문서 게이트웨이 설정

사전 요구사항

Node.js >= 22와 CometAPI API 키가 필요합니다. 데몬 설치의 경우 COMETAPI_KEY를 ~/.openclaw/.env에 저장하여 openclaw.json이 ${COMETAPI_KEY}로 참조할 수 있게 하세요.

CometAPI 문서

빠른 명령어

openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard

printf 'COMETAPI_KEY=%s\n' 'your_cometapi_key' >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env

추가 후 ~/.openclaw/.env 또는 공급자 설정 편집 후 openclaw gateway restart으로 한 번 재시작하고 진단을 실행하세요. 모든 명령어와 세션에서 전체 provider/model 참조를 사용하세요. 버전 업그레이드 후에는 설정 참조.

01 — 공급자 설정 노트

하나의 CometAPI 키에
왜 세 개의 공급자가 필요한가

API 형식 기반 공급자 라우팅

OpenClaw는 API 호환성(벤더 레이블만이 아닌)으로 라우팅하므로, openai-completions, anthropic-messages, google-generative-ai에 대해 별도의 공급자를 사용하세요.

단일 키, 다중 공급자 설정

단일 COMETAPI_KEY를 유지하고 cometapi-openai, cometapi-claude, cometapi-google 블록에서 재사용하세요. 모든 곳에서 명시적인 provider/model 참조를 사용하세요.

현재 플로우 검증

온보딩을 한 번 실행하고, 변경 후 게이트웨이를 재시작한 다음 models status, 공급자 범위의 models list, doctor 진단으로 검증하세요.

02 — OpenClaw에 연결하기

설치, 온보드, 설정,
검증, 전환

버전별 주의사항

OpenClaw는 ~/.openclaw/openclaw.json 를 편집하는 소스 설정으로 사용합니다. 커스텀 공급자는 에이전트별 models.json 파일로 ~/.openclaw/agents/<agentId>/에 실체화됩니다. 업그레이드 후에는 설정 참조 및 환경 변수 가이드를 사용하여 키와 동작을 재확인하세요. CometAPI 베이스 URL은 라이브 문서의 정의만을 따르세요.

01 OpenClaw 설치 또는 업데이트

권장: curl -fsSL https://openclaw.ai/install.sh | bash. 전역 npm 설치를 유지한다면 npm install -g openclaw@latest도 사용할 수 있습니다.

02 온보딩 한 번 실행

실행: openclaw onboard --install-daemon. Model/Auth에서 기본 설치는 Skip을 선택하고, 특별히 필요하지 않으면 기본 워크스페이스를 유지하며 위저드가 데몬과 헬스 체크를 완료하도록 하세요.

03 COMETAPI_KEY 저장

데몬 설치의 경우, COMETAPI_KEY를 ~/.openclaw/.env에 추가하고 chmod 600을 실행하세요. 이미 shell/서비스 시크릿 워크플로우가 있다면 계속 사용하세요.

04 openclaw.json에 CometAPI 공급자 추가

cometapi-openai(openai-completions), cometapi-claude(anthropic-messages), cometapi-google(google-generative-ai)를 추가하고, primary를 cometapi-claude/claude-sonnet-4-6으로 설정하세요.

05 재시작 및 검증

openclaw gateway restart를 실행한 후, openclaw models status, openclaw models list --provider cometapi-claude, openclaw doctor를 실행하세요. CometAPI 공급자에 설정 스키마/인증 오류가 없어야 합니다.

06 provider/model로 모델 전환

openclaw models set cometapi-claude/claude-sonnet-4-6으로 기본값을 설정하세요. 채팅에서 /model cometapi-openai/gpt-5.4 또는 /model cometapi-google/gemini-3.1-pro-preview로 전환하세요.

07 선택사항: 클린 재설치

오래된 손상된 설정을 수리하는 경우, 게이트웨이를 중지하고 ~/.openclaw를 제거한 후 온보딩을 다시 실행하고 CometAPI 설정을 재적용하세요. 로컬 설정, 세션, 로그, 인증 상태가 초기화됩니다.

설정 스니펫(openclaw.json에 병합)

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "cometapi-claude/claude-sonnet-4-6"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "gpt-5.4", "name": "GPT-5.4" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "${COMETAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "${COMETAPI_KEY}",
        "api": "google-generative-ai",
        "models": [{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }]
      }
    }
  }
}

기본 설정은 수동으로 auth-profiles.json를 만들 필요가 없습니다. 공급자에서 ${COMETAPI_KEY} 를 사용하고 ~/.openclaw/.env, shell 또는 서비스 관리자를 통해 변수를 주입하세요.

03 — 참고 가격

라이브 요금은
CometAPI 사이트에서 확인

아래 표는 예시적인 백만 토큰당 가격을 사용합니다. 모델 카탈로그, 할인, SLA는 CometAPI 문서 및 콘솔 의 현재 표시 내용을 따릅니다.

모델(샘플)	입력 / 1M 토큰	출력 / 1M 토큰	비고
Claude Opus 4.6	$4.00	$20.00	참조 데이터 기준
MiniMax-M2.7	$0.24	$0.96	참조 데이터 기준
GLM 5 Turbo	$0.96	$3.26	참조 데이터 기준
GPT-5.4 pro	$24.00	$144	참조 데이터 기준
Gemini 3.1 Pro	$1.60	$9.60	참조 데이터 기준
qwen3.5-plus	$0.32	$1.92	참조 데이터 기준

사용 비용 설명

백만 토큰당 요금을 기준으로 예시적인 '공식 채널' 참고값과 비교한 추정입니다—이해를 위한 것이며 가격 보장이 아닙니다. 항상 CometAPI 사이트의 실시간 가격을 따르세요.

요금이 문서와 동기화됨

입력 가격

$4.00 / 1M

출력 가격

$20.00 / 1M

선택한 모델 설정에서 자동 읽기

CometAPI(1M 입력 + 1M 출력)

$24.00

공식 참고(동일 사용량)

$30.00

예시적 절감액

$6.00

참고값 대비 약 20% 낮음(예시)

04 — 자주 묻는 질문

통합 전에
이것들을 확인하세요

이 설정에 auth-profiles.json이 필요한가요?

기본 설정에는 필요하지 않습니다. OpenClaw는 ${COMETAPI_KEY}를 통해 models.providers.*.apiKey에서 공급자 apiKey를 확인할 수 있습니다. 프로필별 시크릿 저장이나 순환이 필요한 경우에만 auth-profiles.json을 사용하세요.

왜 하나의 벤더에 공급자 항목이 3개나 필요한가요?

OpenClaw는 API 형식 호환성으로 라우팅합니다. 세 가지 API 패밀리가 모두 필요하다면 openai-completions, anthropic-messages, google-generative-ai에 대해 별도 항목을 유지하세요.

설정은 실제로 어디서 편집하고 실체화되나요?

~/.openclaw/openclaw.json을 편집하세요. 커스텀 공급자는 동기화/로드 후 ~/.openclaw/agents/<agentId>/ 아래 에이전트별 models.json에 실체화됩니다.

이 가이드에서 사용되는 모델 ID는 무엇인가요?

gpt-5.4, claude-sonnet-4-6, gemini-3.1-pro-preview입니다. CometAPI 모델 페이지의 어떤 모델이든 해당 공급자 블록에 추가할 수 있습니다.

OpenClaw를CometAPI로설정하기

가이드 범위및 사전 요구사항