OpenClaw를
CometAPI로
설정하기
CometAPI를 OpenClaw의 커스텀 모델 공급자로 사용하세요: 하나의 API로 500개 이상의 모델, 최대 20% 할인. 이 가이드는 현재 OpenClaw 온보딩 플로우(2026.3.8+)에 맞춰 설치, 공급자 설정, 검증 및 모델 전환을 다룹니다.
# 샘플 전용—프로덕션 전에 사용 중인 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" }]
}
}
}
}가이드 범위
및 사전 요구사항
CometAPI로 OpenClaw 설정
CometAPI를 OpenClaw의 커스텀 모델 공급자로 사용하여 하나의 API로 500개 이상의 모델에 접근하고, 지원 라우트에서 최대 20% 할인을 받으세요. 이 페이지는 현재 OpenClaw 온보딩 플로우(2026.3.8+)를 따릅니다.
사전 요구사항
Node.js >= 22와 CometAPI API 키가 필요합니다. 데몬 설치의 경우 COMETAPI_KEY를 ~/.openclaw/.env에 저장하여 openclaw.json이 ${COMETAPI_KEY}로 참조할 수 있게 하세요.
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 참조를 사용하세요. 버전 업그레이드 후에는 설정 참조.
하나의 CometAPI 키에
왜 세 개의 공급자가 필요한가
설치, 온보드, 설정,
검증, 전환
OpenClaw는 ~/.openclaw/openclaw.json 를 편집하는 소스 설정으로 사용합니다. 커스텀 공급자는 에이전트별 models.json 파일로 ~/.openclaw/agents/<agentId>/에 실체화됩니다. 업그레이드 후에는 설정 참조 및 환경 변수 가이드를 사용하여 키와 동작을 재확인하세요. CometAPI 베이스 URL은 라이브 문서의 정의만을 따르세요.
{
"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 또는 서비스 관리자를 통해 변수를 주입하세요.
라이브 요금은
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 | 참조 데이터 기준 |
통합 전에
이것들을 확인하세요
이 설정에 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 모델 페이지의 어떤 모델이든 해당 공급자 블록에 추가할 수 있습니다.