OpenClaw를
CoreAPI로
설정하기
CoreAPI를 OpenClaw용 사용자 정의 모델 공급자로 사용하세요. 하나의 API, 공식 정가로 다양한 모델이 제공됩니다. 이 가이드는 현재 OpenClaw 온보딩 흐름(2026.3.8+)을 따르며 설치, 공급자 구성, 확인 및 모델 전환을 다룹니다.
# 샘플 전용—프로덕션 전에 사용 중인 OpenClaw 버전에 맞게 확인하세요
{
"agents": {
"defaults": {
"model": {
"primary": "coreapi-claude/claude-sonnet-4-5-20250929"
}
}
},
"models": {
"mode": "merge",
"providers": {
"coreapi-openai": {
"baseUrl": "https://unixcore.io/v1",
"apiKey": "${COREAPI_KEY}",
"api": "openai-completions",
"models": [{ "id": "deepseek-flash", "name": "DeepSeek Flash" }]
},
"coreapi-claude": {
"baseUrl": "https://unixcore.io",
"apiKey": "${COREAPI_KEY}",
"api": "anthropic-messages",
"models": [{ "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" }]
}
}
}
}가이드 범위
및 사전 요구사항
CoreAPI로 OpenClaw 설정
CoreAPI를 OpenClaw용 사용자 정의 모델 공급자로 사용하면 하나의 API에서 공식 정가로 다양한 모델에 액세스할 수 있습니다. 이 페이지는 현재 OpenClaw 온보딩 흐름(2026.3.8+)을 따릅니다.
사전 요구사항
Node.js >= 22와 CoreAPI API 키가 필요합니다. 데몬 설치의 경우 COREAPI_KEY를 ~/.openclaw/.env에 저장하여 openclaw.json이 $COREAPI_KEY로 참조할 수 있게 하세요.
openclaw onboard --install-daemon openclaw gateway status openclaw dashboard printf 'COREAPI_KEY=%s\n' 'your_coreapi_key' >> ~/.openclaw/.env chmod 600 ~/.openclaw/.env
추가 후 ~/.openclaw/.env 또는 공급자 설정 편집 후 openclaw gateway restart으로 한 번 재시작하고 진단을 실행하세요. 모든 명령어와 세션에서 전체 provider/model 참조를 사용하세요. 버전 업그레이드 후에는 설정 참조.
하나의 CoreAPI 키에
왜 두 개의 공급자가 필요한가
설치, 온보드, 설정,
검증, 전환
OpenClaw는 ~/.openclaw/openclaw.json 를 편집하는 소스 설정으로 사용합니다. 커스텀 공급자는 에이전트별 models.json 파일로 ~/.openclaw/agents/<agentId>/에 실체화됩니다. 업그레이드 후에는 설정 참조 및 환경 변수 가이드를 사용하여 키와 동작을 재확인하세요. CoreAPI 베이스 URL은 라이브 문서의 정의만을 따르세요.
{
"agents": {
"defaults": {
"model": {
"primary": "coreapi-claude/claude-sonnet-4-5-20250929"
}
}
},
"models": {
"mode": "merge",
"providers": {
"coreapi-openai": {
"baseUrl": "https://unixcore.io/v1",
"apiKey": "${COREAPI_KEY}",
"api": "openai-completions",
"models": [{ "id": "deepseek-flash", "name": "DeepSeek Flash" }]
},
"coreapi-claude": {
"baseUrl": "https://unixcore.io",
"apiKey": "${COREAPI_KEY}",
"api": "anthropic-messages",
"models": [{ "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" }]
}
}
}
}기본 설정은 수동으로 auth-profiles.json를 만들 필요가 없습니다. 공급자에서 ${COREAPI_KEY} 를 사용하고 ~/.openclaw/.env, shell 또는 서비스 관리자를 통해 변수를 주입하세요.
라이브 요금은
CoreAPI 사이트에서 확인
아래 표는 예시적인 백만 개당 토큰 수를 사용합니다. 모델 카탈로그, 가격 및 SLA는 현재 CoreAPI 약관을 따릅니다. CoreAPI 문서 및 콘솔 의 현재 표시 내용을 따릅니다.
통합 전에
이것들을 확인하세요
이 설정에 auth-profiles.json이 필요한가요?
기본 설정에는 필요하지 않습니다. OpenClaw는 $COREAPI_KEY를 통해 models.providers.*.apiKey에서 공급자 apiKey를 확인할 수 있습니다. 프로필별 시크릿 저장이나 순환이 필요한 경우에만 auth-profiles.json을 사용하세요.
왜 하나의 벤더에 공급자 항목이 2개나 필요한가요?
OpenClaw는 API 형식 호환성으로 라우팅합니다. openai-completions, anthropic-messages에 대해 별도 항목을 유지하세요.
설정은 실제로 어디서 편집하고 실체화되나요?
~/.openclaw/openclaw.json을 편집하세요. 커스텀 공급자는 동기화/로드 후 ~/.openclaw/agents/<agentId>/ 아래 에이전트별 models.json에 실체화됩니다.
이 가이드에서 사용되는 모델 ID는 무엇인가요?
deepseek-flash, claude-sonnet-4-5-20250929입니다. CoreAPI 모델 페이지의 어떤 모델이든 해당 공급자 블록에 추가할 수 있습니다.