메인 콘텐츠로 건너뛰기

​
Venice AI (Venice 하이라이트)

Venice는 선택적으로 proprietary 모델에 익명화된 액세스를 제공하는, 개인정보 보호 우선 추론을 위한 추천 Venice 설정입니다. Venice AI는 검열 없는 모델 지원과 익명화된 프록시를 통한 주요 proprietary 모델 액세스를 포함한 개인정보 보호 중심 AI 추론을 제공합니다. 모든 추론은 기본적으로 비공개입니다. 데이터 학습 없음, 로깅 없음.

​
OpenClaw에서 Venice를 사용하는 이유

  • 오픈 소스 모델을 위한 비공개 추론(로깅 없음)
  • 필요할 때 사용할 수 있는 검열 없는 모델
  • 품질이 중요할 때 사용할 수 있는 proprietary 모델(Opus/GPT/Gemini)에 대한 익명화된 액세스
  • OpenAI 호환 /v1 엔드포인트

​
개인정보 보호 모드

Venice는 두 가지 개인정보 보호 수준을 제공합니다. 적절한 모델을 선택하려면 이를 이해하는 것이 중요합니다.
모드설명모델
비공개완전히 비공개입니다. 프롬프트/응답은 절대 저장되거나 기록되지 않습니다. 일시적입니다.Llama, Qwen, DeepSeek, Kimi, MiniMax, Venice Uncensored 등
익명화메타데이터가 제거된 상태로 Venice를 통해 프록시됩니다. 기반 provider(OpenAI, Anthropic, Google, xAI)는 익명화된 요청을 봅니다.Claude, GPT, Gemini, Grok

​
기능

  • 개인정보 보호 중심: “비공개”(완전 비공개)와 “익명화”(프록시) 모드 중에서 선택
  • 검열 없는 모델: 콘텐츠 제한이 없는 모델에 액세스
  • 주요 모델 액세스: Venice의 익명화 프록시를 통해 Claude, GPT, Gemini, Grok 사용
  • OpenAI 호환 API: 쉬운 통합을 위한 표준 /v1 엔드포인트
  • 스트리밍: ✅ 모든 모델에서 지원
  • 함수 호출: ✅ 일부 모델에서 지원(모델 기능 확인)
  • 비전: ✅ 비전 기능이 있는 모델에서 지원
  • 엄격한 속도 제한 없음: 극단적인 사용량에는 공정 사용 제한이 적용될 수 있음

​
설정

​
1. API 키 발급

  1. venice.ai에서 가입합니다
  2. Settings → API Keys → Create new key로 이동합니다
  3. API 키를 복사합니다(형식: vapi_xxxxxxxxxxxx)

​
2. OpenClaw 구성

옵션 A: 환경 변수 
export VENICE_API_KEY="vapi_xxxxxxxxxxxx"
옵션 B: 대화형 설정(권장) 
openclaw onboard --auth-choice venice-api-key
이렇게 하면 다음이 수행됩니다:
  1. API 키를 입력하라는 메시지가 표시됩니다(또는 기존 VENICE_API_KEY 사용)
  2. 사용 가능한 모든 Venice 모델이 표시됩니다
  3. 기본 모델을 선택할 수 있습니다
  4. provider가 자동으로 구성됩니다
옵션 C: 비대화형 
openclaw onboard --non-interactive \
  --auth-choice venice-api-key \
  --venice-api-key "vapi_xxxxxxxxxxxx"

​
3. 설정 확인

openclaw agent --model venice/kimi-k2-5 --message "안녕하세요, 작동하나요?"

​
모델 선택

설정 후 OpenClaw는 사용 가능한 모든 Venice 모델을 표시합니다. 필요에 따라 선택하세요.
  • 기본 모델: 강력한 비공개 reasoning과 비전을 제공하는 venice/kimi-k2-5
  • 고성능 옵션: 가장 강력한 익명화 Venice 경로인 venice/claude-opus-4-6
  • 개인정보 보호: 완전 비공개 추론을 위해 “비공개” 모델 선택
  • 기능: Venice 프록시를 통해 Claude, GPT, Gemini에 액세스하려면 “익명화” 모델 선택
기본 모델은 언제든지 변경할 수 있습니다: 
openclaw models set venice/kimi-k2-5
openclaw models set venice/claude-opus-4-6
사용 가능한 모든 모델 나열: 
openclaw models list | grep venice

​
openclaw configure로 구성하기

  1. openclaw configure를 실행합니다
  2. Model/auth를 선택합니다
  3. Venice AI를 선택합니다

​
어떤 모델을 사용해야 하나요?

사용 사례권장 모델이유
일반 채팅(기본값)kimi-k2-5강력한 비공개 reasoning과 비전
전반적으로 최고 품질claude-opus-4-6가장 강력한 익명화 Venice 옵션
개인정보 보호 + 코딩qwen3-coder-480b-a35b-instruct넓은 컨텍스트를 갖춘 비공개 코딩 모델
비공개 비전kimi-k2-5비공개 모드를 벗어나지 않고 비전 지원
빠르고 저렴함qwen3-4b경량 reasoning 모델
복잡한 비공개 작업deepseek-v3.2강력한 reasoning, 단 Venice 도구 지원 없음
검열 없음venice-uncensored콘텐츠 제한 없음

​
사용 가능한 모델(총 41개)

​
비공개 모델(26개) - 완전 비공개, 로깅 없음

모델 ID이름컨텍스트기능
kimi-k2-5Kimi K2.5256k기본값, reasoning, 비전
kimi-k2-thinkingKimi K2 Thinking256kReasoning
llama-3.3-70bLlama 3.3 70B128k일반
llama-3.2-3bLlama 3.2 3B128k일반
hermes-3-llama-3.1-405bHermes 3 Llama 3.1 405B128k일반, 도구 비활성화
qwen3-235b-a22b-thinking-2507Qwen3 235B Thinking128kReasoning
qwen3-235b-a22b-instruct-2507Qwen3 235B Instruct128k일반
qwen3-coder-480b-a35b-instructQwen3 Coder 480B256k코딩
qwen3-coder-480b-a35b-instruct-turboQwen3 Coder 480B Turbo256k코딩
qwen3-5-35b-a3bQwen3.5 35B A3B256kReasoning, 비전
qwen3-next-80bQwen3 Next 80B256k일반
qwen3-vl-235b-a22bQwen3 VL 235B (Vision)256k비전
qwen3-4bVenice Small (Qwen3 4B)32k빠름, reasoning
deepseek-v3.2DeepSeek V3.2160kReasoning, 도구 비활성화
venice-uncensoredVenice Uncensored (Dolphin-Mistral)32k검열 없음, 도구 비활성화
mistral-31-24bVenice Medium (Mistral)128k비전
google-gemma-3-27b-itGoogle Gemma 3 27B Instruct198k비전
openai-gpt-oss-120bOpenAI GPT OSS 120B128k일반
nvidia-nemotron-3-nano-30b-a3bNVIDIA Nemotron 3 Nano 30B128k일반
olafangensan-glm-4.7-flash-hereticGLM 4.7 Flash Heretic128kReasoning
zai-org-glm-4.6GLM 4.6198k일반
zai-org-glm-4.7GLM 4.7198kReasoning
zai-org-glm-4.7-flashGLM 4.7 Flash128kReasoning
zai-org-glm-5GLM 5198kReasoning
minimax-m21MiniMax M2.1198kReasoning
minimax-m25MiniMax M2.5198kReasoning

​
익명화 모델(15개) - Venice 프록시 경유

모델 ID이름컨텍스트기능
claude-opus-4-6Claude Opus 4.6 (via Venice)1MReasoning, 비전
claude-opus-4-5Claude Opus 4.5 (via Venice)198kReasoning, 비전
claude-sonnet-4-6Claude Sonnet 4.6 (via Venice)1MReasoning, 비전
claude-sonnet-4-5Claude Sonnet 4.5 (via Venice)198kReasoning, 비전
openai-gpt-54GPT-5.4 (via Venice)1MReasoning, 비전
openai-gpt-53-codexGPT-5.3 Codex (via Venice)400kReasoning, 비전, 코딩
openai-gpt-52GPT-5.2 (via Venice)256kReasoning
openai-gpt-52-codexGPT-5.2 Codex (via Venice)256kReasoning, 비전, 코딩
openai-gpt-4o-2024-11-20GPT-4o (via Venice)128k비전
openai-gpt-4o-mini-2024-07-18GPT-4o Mini (via Venice)128k비전
gemini-3-1-pro-previewGemini 3.1 Pro (via Venice)1MReasoning, 비전
gemini-3-pro-previewGemini 3 Pro (via Venice)198kReasoning, 비전
gemini-3-flash-previewGemini 3 Flash (via Venice)256kReasoning, 비전
grok-41-fastGrok 4.1 Fast (via Venice)1MReasoning, 비전
grok-code-fast-1Grok Code Fast 1 (via Venice)256kReasoning, 코딩

​
모델 검색

VENICE_API_KEY가 설정되어 있으면 OpenClaw는 Venice API에서 모델을 자동으로 검색합니다. API에 연결할 수 없으면 정적 카탈로그로 대체합니다. /models 엔드포인트는 공개되어 있어 목록 조회에는 인증이 필요 없지만, 추론에는 유효한 API 키가 필요합니다.

​
스트리밍 및 도구 지원

기능지원
스트리밍✅ 모든 모델
함수 호출✅ 대부분의 모델(API에서 supportsFunctionCalling 확인)
비전/이미지✅ “Vision” 기능이 표시된 모델
JSON 모드✅ response_format을 통해 지원

​
가격

Venice는 크레딧 기반 시스템을 사용합니다. 현재 요금은 venice.ai/pricing에서 확인하세요.
  • 비공개 모델: 일반적으로 더 저렴함
  • 익명화 모델: 직접 API 가격과 유사하며 Venice 수수료가 소액 추가됨

​
비교: Venice와 직접 API

항목Venice(익명화)직접 API
개인정보 보호메타데이터 제거, 익명화계정이 연결됨
지연 시간+10-50ms (프록시)직접 연결
기능대부분의 기능 지원전체 기능
청구Venice 크레딧provider 청구

​
사용 예시

# 기본 비공개 모델 사용
openclaw agent --model venice/kimi-k2-5 --message "빠른 상태 확인"

# Venice를 통한 Claude Opus 사용(익명화)
openclaw agent --model venice/claude-opus-4-6 --message "이 작업을 요약해 줘"

# 검열 없는 모델 사용
openclaw agent --model venice/venice-uncensored --message "초안 옵션을 제안해 줘"

# 이미지와 함께 비전 모델 사용
openclaw agent --model venice/qwen3-vl-235b-a22b --message "첨부된 이미지를 검토해 줘"

# 코딩 모델 사용
openclaw agent --model venice/qwen3-coder-480b-a35b-instruct --message "이 함수를 리팩터링해 줘"

​
문제 해결

​
API 키가 인식되지 않음

echo $VENICE_API_KEY
openclaw models list | grep venice
키가 vapi_로 시작하는지 확인하세요.

​
모델을 사용할 수 없음

Venice 모델 카탈로그는 동적으로 업데이트됩니다. 현재 사용 가능한 모델을 보려면 openclaw models list를 실행하세요. 일부 모델은 일시적으로 오프라인일 수 있습니다.

​
연결 문제

Venice API는 https://api.venice.ai/api/v1에 있습니다. 네트워크에서 HTTPS 연결을 허용하는지 확인하세요.

​
구성 파일 예시

{
  env: { VENICE_API_KEY: "vapi_..." },
  agents: { defaults: { model: { primary: "venice/kimi-k2-5" } } },
  models: {
    mode: "merge",
    providers: {
      venice: {
        baseUrl: "https://api.venice.ai/api/v1",
        apiKey: "${VENICE_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "kimi-k2-5",
            name: "Kimi K2.5",
            reasoning: true,
            input: ["text", "image"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 256000,
            maxTokens: 65536,
          },
        ],
      },
    },
  },
}

​
링크