iwinv API 연동 방법 (가상 서버)

iwinv API는 vLLM 모델, API Key를 통해 가상서버 OpenClaw 호스팅과 연동 할 수 있습니다.

정보

• 이 매뉴얼에서는 OpenClaw 호스팅에서 대시보드만 설정 됐다는 전제로 설명합니다.

iwinv API Key 발급

API Key 관리 매뉴얼을 참고 후 Key와 사용할 모델을 준비합니다.

모델 ID	기능	최대 입력 토큰	최대 출력 토큰
gemma4-e2b	Vision, Tools, Fast	128,000	128,000
gemma4-26b	Vision, Tools	262,000	262,000
gemma4-31b	Thinking, Vision, Tools	262,000	262,000
qwen3.6-27b	Thinking, Tools	262,000	262,000

경고

• API Key는 외부에 노출되지 않도록 주의가 필요하며 만일 노출 되었다면 즉시 삭제 후 재발급을 권장합니다.
• API Key가 유출된 후 무단으로 사용된 요금은 환불되지 않습니다.

연동 진행

1. 모델 설정

예시로 gemma4-26b 모델을 설정 했으며 명령어 사용 시 실제로 사용할 모델 ID를 입력 합니다.

openclaw-podman exec -i openclaw openclaw config set agents.defaults.model.primary "vllm/gemma4-26b"

2. iwinv API 상세 설정

다음의 표를 참고하여 내용을 수정 후 명령어를 사용하면 iwinv API 연동이 완료됩니다.

이름	예시	설명
baseUrl	https://ai-api.iwinv.kr/v1	iwinv API URL
apiKey	sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx	iwinv API Secret Key
id	gemma4-26b	사용할 모델 ID
name	gemma4-26b	사용할 모델 ID

openclaw-podman exec -i openclaw \
openclaw config set models.providers.vllm '
{
  "baseUrl": "https://ai-api.iwinv.kr/v1",
  "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "api": "openai-completions",
  "models": [
    {
      "id": "gemma4-26b",
      "name": "gemma4-26b"
    }
  ]
}
' --strict-json --merge

연동 완료

대시보드로 로그인 후 채팅을 확인하면 선택한 모델 ID가 등록이 된 것을 확인 할 수 있습니다.