CometAPI와 함께 OpenClaw 사용하기

CometAPI를 OpenClaw의 모델 provider로 사용하세요 — 하나의 API로 500개 이상의 모델을 사용할 수 있습니다.

사전 요구 사항

Node.js ≥ 22 — nvm을 통한 설치 권장
활성 API key가 있는 CometAPI 계정 — 여기에서 발급

설치

CometAPI API key 받기

CometAPI 콘솔에 로그인하세요. Add API Key를 클릭하고 CometAPI API key를 복사하세요.

OpenClaw 설치 또는 업데이트

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

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

또는 npm으로 설치하세요:

npm install -g openclaw@latest

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

openclaw onboard --install-daemon

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

openclaw gateway status
openclaw dashboard

구성

CometAPI 키 저장

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

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

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

CometAPI provider 구성

CometAPI는 네 가지 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 블록과 일치하는 CometAPI Models page의 현재 model ID로 바꾸세요.

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 키는 $\{COMETAPI_KEY\} env var를 통해 models.providers.*.apiKey에서 확인됩니다. auth-profiles.json은 여러 키에 대해 profile별 자격 증명 순환을 원할 때만 필요합니다.

검증

재시작 및 확인

.env를 추가하거나 provider 구성을 변경한 후 게이트웨이를 재시작하세요:

openclaw gateway restart

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

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

설정이 성공적으로 완료되면 다음과 같이 표시됩니다:

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

CometAPI provider가 인증된 것으로 표시되는 OpenClaw models status

모델 전환

# 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 구성을 적용하기 전에 온보딩을 다시 실행하세요:

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

이렇게 하면 모든 로컬 구성, 세션, 로그, 인증 상태 및 워크스페이스가 제거됩니다. 그런 다음 3–5단계를 다시 따르세요.

개요

AI 코딩 에이전트

AI 에이전트

AI 채팅 클라이언트

번역 및 언어

자동화 플랫폼

관측성 및 평가

AI 프레임워크

CometAPI와 함께 OpenClaw 사용하기

사전 요구 사항

설치

구성

검증

모델 전환

문제 해결

​사전 요구 사항

​설치

​구성

​검증

​모델 전환

​문제 해결

사전 요구 사항

설치

구성

검증

모델 전환

문제 해결