OpenClaw

OpenClaw를 CometAPI에 연결하세요: curl 또는 npm으로 설치하고, 키를 ~/.openclaw/.env에 저장하고, OpenAI/Anthropic/Google provider를 구성한 뒤, 500개 이상의 모델을 실행할 수 있습니다.

CometAPI를 OpenClaw의 모델 provider로 사용하세요 — 하나의 API로 500개 이상의 모델을 사용할 수 있습니다. 이 가이드는 현재 온보딩 흐름(2026.3.8+)을 다룹니다.

​

사전 요구 사항

• Node.js ≥ 22 — nvm 사용 권장
• 활성 API 키가 있는 CometAPI 계정 — 여기에서 발급받기

1. CometAPI API 키 받기

   CometAPI 콘솔에 로그인하세요. Add API Key를 클릭한 다음 sk-xxxxx 키를 복사하세요.

   

   
2. OpenClaw 설치 또는 업데이트

   권장 — 공식 설치 프로그램을 사용하세요:

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

   또는 npm으로 설치하세요:

   npm install -g openclaw@latest
   

   그런 다음 설정 마법사를 한 번 실행하세요:

   openclaw onboard --install-daemon
   

   온보딩 중 Model/Auth 단계에서 CometAPI를 수동으로 구성하려면 Skip을 선택하세요. 온보딩이 끝나면 gateway가 실행 중인지 확인하세요:

   openclaw gateway status
   openclaw dashboard
   
3. CometAPI 키 저장

   daemon이 config 파일에 하드코딩하지 않고도 사용할 수 있도록 키를 ~/.openclaw/.env에 작성하세요:

   printf 'COMETAPI_KEY=%s\n' 'your-sk-xxxxx-key' >> ~/.openclaw/.env
   chmod 600 ~/.openclaw/.env
   

   이미 shell, 서비스 관리자 또는 secrets 워크플로를 통해 COMETAPI_KEY를 주입하고 있다면 이 단계는 건너뛰세요 — 아래 config는 변수가 어떤 방식으로 설정되었는지와 관계없이 $\{COMETAPI_KEY\}를 사용합니다.

4. CometAPI provider 구성

   CometAPI는 4가지 API 형식을 지원합니다. ~/.openclaw/openclaw.json에 하나 이상의 provider 블록을 추가하세요:

   Provider	API 형식	호출되는 엔드포인트	Base URL
   cometapi-openai	openai-completions	POST /v1/chat/completions	https://api.cometapi.com/v1
   cometapi-openai-responses	openai-responses	POST /v1/responses	https://api.cometapi.com/v1
   cometapi-claude	anthropic-messages	POST /messages	https://api.cometapi.com
   cometapi-google	google-generative-ai	POST /v1beta/...	https://api.cometapi.com/v1beta

   {
     "agents": {
       "defaults": {
         "model": {
           "primary": "cometapi-claude/your-claude-model-id"
         }
       }
     },
     "models": {
       "mode": "merge",
       "providers": {
         "cometapi-openai": {
           "baseUrl": "https://api.cometapi.com/v1",
           "apiKey": "${COMETAPI_KEY}",
           "api": "openai-completions",
           "models": [{ "id": "your-chat-model-id", "name": "OpenAI-compatible text model" }]
         },
         "cometapi-openai-responses": {
           "baseUrl": "https://api.cometapi.com/v1",
           "apiKey": "${COMETAPI_KEY}",
           "api": "openai-responses",
           "models": [{ "id": "your-responses-model-id", "name": "Responses API model" }]
         },
         "cometapi-claude": {
           "baseUrl": "https://api.cometapi.com",
           "apiKey": "${COMETAPI_KEY}",
           "api": "anthropic-messages",
           "models": [{ "id": "your-claude-model-id", "name": "Claude family model" }]
         },
         "cometapi-google": {
           "baseUrl": "https://api.cometapi.com/v1beta",
           "apiKey": "${COMETAPI_KEY}",
           "api": "google-generative-ai",
           "models": [{ "id": "your-gemini-model-id", "name": "Gemini family model" }]
         }
       }
     }
   }
   

   필요한 provider만 유지해도 되고, 네 가지를 모두 유지한 채 provider/model 참조를 사용해 형식 간 라우팅을 할 수도 있습니다.

   각 your-...-model-id 플레이스홀더를 provider 블록에 맞는 현재 모델 ID로 CometAPI Models 페이지에서 교체하세요.

   OpenAI Responses API가 필요한 모델에는 cometapi-openai-responses (api: "openai-responses")를 사용하세요. 기존 채팅 완성 경로에 있는 모델에는 cometapi-openai (api: "openai-completions")를 사용하세요. 두 방식 모두 동일한 baseUrl (https://api.cometapi.com/v1)을 공유하며, 차이는 OpenClaw가 어떤 다운스트림 엔드포인트를 호출하느냐뿐입니다.

   이 설정에서는 auth-profiles.json 파일이 필수는 아닙니다. Provider 키는 models.providers.*.apiKey에서 $\{COMETAPI_KEY\} 환경 변수를 통해 확인됩니다. auth-profiles.json은 여러 키에 대해 프로필별 자격 증명 순환을 원할 때만 필요합니다.

5. 재시작 및 확인

   .env를 추가하거나 provider config를 변경한 뒤에는 gateway를 재시작하세요:

   openclaw gateway restart
   

   그런 다음 진단을 실행하세요:

   openclaw models status
   openclaw models list --provider cometapi-claude
   openclaw doctor
   

   설정이 성공하면 다음과 같이 표시됩니다:

   • openclaw models status가 CometAPI provider에 대한 missing-auth 경고 없이 기본 모델을 cometapi-claude/your-claude-model-id로 확인합니다
   • openclaw models list --provider cometapi-claude가 구성된 모델을 나열합니다
   • openclaw doctor가 CometAPI provider에 대해 config 또는 auth 오류가 없다고 보고합니다

   
6. 모델 전환

   # Set the default model in config
   openclaw models set cometapi-claude/your-claude-model-id
   
   # Switch for the current chat session
   /model cometapi-openai/your-chat-model-id
   /model cometapi-openai-responses/your-responses-model-id
   /model cometapi-claude/your-claude-model-id
   /model cometapi-google/your-gemini-model-id
   

클린 재설치(선택 사항)

문제가 있는 이전 설정을 수정하는 경우 gateway를 중지하고 ~/.openclaw를 삭제한 다음, CometAPI config를 적용하기 전에 온보딩을 다시 실행하세요:

openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon

이렇게 하면 모든 로컬 config, 세션, 로그, auth 상태 및 workspace가 제거됩니다. 그런 다음 3–5단계를 다시 수행하세요.