메인 콘텐츠로 건너뛰기

​
Venice AI (Venice highlight)

Venice는 프라이버시 우선 추론을 위해, 그리고 선택적으로 익명화된 방식으로 독점 모델에 접근할 수 있도록 제공하는 대표적인 Venice 설정입니다. Venice AI는 검열되지 않은 모델 지원과, 익명화된 프록시를 통한 주요 독점 모델 접근을 포함한 프라이버시 중심 AI 추론을 제공합니다. 모든 추론은 기본적으로 비공개입니다. 여러분의 데이터로 학습하지 않으며, 로그도 남기지 않습니다.

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

  • 오픈소스 모델에 대한 비공개 추론(로그 없음)
  • 필요할 때 검열되지 않은 모델
  • 품질이 중요할 때, 독점 모델(Opus/GPT/Gemini)에 대한 익명화된 접근
  • OpenAI 호환 /v1 엔드포인트

​
프라이버시 모드

Venice는 두 가지 프라이버시 수준을 제공합니다. 어떤 모델을 선택할지 결정할 때 이를 이해하는 것이 중요합니다.
모드설명Models
Private완전한 비공개. 프롬프트/응답은 절대로 저장되거나 로깅되지 않습니다. 일시적입니다.Llama, Qwen, DeepSeek, Kimi, MiniMax, Venice Uncensored 등
AnonymizedVenice를 통해 프록시되며 메타데이터가 제거됩니다. 기본 프로바이더(OpenAI, Anthropic, Google, xAI)는 익명화된 요청만 보게 됩니다.Claude, GPT, Gemini, Grok

​
기능

  • 프라이버시 중심: “private”(완전 비공개)와 “anonymized”(프록시) 모드 중 선택 가능
  • 검열되지 않은 모델: 콘텐츠 제한 없는 모델 접근 가능
  • 주요 모델 접근: Venice의 익명화 프록시를 통해 Claude, GPT, Gemini, Grok 사용 가능
  • OpenAI 호환 API: 쉬운 통합을 위한 표준 /v1 엔드포인트
  • Streaming: ✅ 모든 모델에서 지원
  • Function calling: ✅ 일부 모델에서 지원(모델 capability 확인 필요)
  • Vision: ✅ vision capability가 있는 모델에서 지원
  • 하드 레이트 리밋 없음: 과도한 사용 시 fair-use throttling이 적용될 수 있음

​
설정

​
1. API Key 받기

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

​
2. OpenClaw 설정

옵션 A: Environment Variable 
export VENICE_API_KEY="vapi_xxxxxxxxxxxx"
옵션 B: Interactive Setup (권장) 
openclaw onboard --auth-choice venice-api-key
이 과정에서 다음이 수행됩니다.
  1. API 키 입력을 요청합니다(또는 기존 VENICE_API_KEY 사용)
  2. 사용 가능한 모든 Venice 모델을 보여줍니다
  3. 기본 모델을 선택하게 합니다
  4. 프로바이더를 자동으로 설정합니다
옵션 C: Non-interactive 
openclaw onboard --non-interactive \
  --auth-choice venice-api-key \
  --venice-api-key "vapi_xxxxxxxxxxxx"

​
3. 설정 확인

openclaw agent --model venice/kimi-k2-5 --message "Hello, are you working?"

​
모델 선택

설정이 끝나면 OpenClaw는 사용 가능한 모든 Venice 모델을 보여줍니다. 필요에 맞게 선택하세요.
  • 기본 모델: 강력한 비공개 추론과 vision을 위해 venice/kimi-k2-5
  • 고성능 옵션: 가장 강력한 익명화 Venice 경로인 venice/claude-opus-4-6
  • Privacy: 완전한 비공개 추론을 원하면 “private” 모델 선택
  • Capability: Venice 프록시를 통해 Claude, GPT, Gemini에 접근하려면 “anonymized” 모델 선택
기본 모델은 언제든 변경할 수 있습니다. 
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를 선택합니다

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

Use CaseRecommended ModelWhy
일반 대화 (기본값)kimi-k2-5강력한 비공개 추론 + vision
전반적으로 최고의 품질claude-opus-4-6가장 강력한 익명화 Venice 옵션
프라이버시 + 코딩qwen3-coder-480b-a35b-instruct큰 컨텍스트를 가진 비공개 코딩 모델
비공개 visionkimi-k2-5private mode를 벗어나지 않는 vision
빠르고 저렴함qwen3-4b가벼운 추론 모델
복잡한 비공개 작업deepseek-v3.2강한 추론, 단 Venice tool 미지원
검열 없음venice-uncensored콘텐츠 제한 없음

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

​
Private Models (26) — 완전 비공개, 로깅 없음

Model IDNameContextFeatures
kimi-k2-5Kimi K2.5256kDefault, reasoning, vision
kimi-k2-thinkingKimi K2 Thinking256kReasoning
llama-3.3-70bLlama 3.3 70B128kGeneral
llama-3.2-3bLlama 3.2 3B128kGeneral
hermes-3-llama-3.1-405bHermes 3 Llama 3.1 405B128kGeneral, tools disabled
qwen3-235b-a22b-thinking-2507Qwen3 235B Thinking128kReasoning
qwen3-235b-a22b-instruct-2507Qwen3 235B Instruct128kGeneral
qwen3-coder-480b-a35b-instructQwen3 Coder 480B256kCoding
qwen3-coder-480b-a35b-instruct-turboQwen3 Coder 480B Turbo256kCoding
qwen3-5-35b-a3bQwen3.5 35B A3B256kReasoning, vision
qwen3-next-80bQwen3 Next 80B256kGeneral
qwen3-vl-235b-a22bQwen3 VL 235B (Vision)256kVision
qwen3-4bVenice Small (Qwen3 4B)32kFast, reasoning
deepseek-v3.2DeepSeek V3.2160kReasoning, tools disabled
venice-uncensoredVenice Uncensored (Dolphin-Mistral)32kUncensored, tools disabled
mistral-31-24bVenice Medium (Mistral)128kVision
google-gemma-3-27b-itGoogle Gemma 3 27B Instruct198kVision
openai-gpt-oss-120bOpenAI GPT OSS 120B128kGeneral
nvidia-nemotron-3-nano-30b-a3bNVIDIA Nemotron 3 Nano 30B128kGeneral
olafangensan-glm-4.7-flash-hereticGLM 4.7 Flash Heretic128kReasoning
zai-org-glm-4.6GLM 4.6198kGeneral
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

​
Anonymized Models (15) — Venice Proxy 경유

Model IDNameContextFeatures
claude-opus-4-6Claude Opus 4.6 (via Venice)1MReasoning, vision
claude-opus-4-5Claude Opus 4.5 (via Venice)198kReasoning, vision
claude-sonnet-4-6Claude Sonnet 4.6 (via Venice)1MReasoning, vision
claude-sonnet-4-5Claude Sonnet 4.5 (via Venice)198kReasoning, vision
openai-gpt-54GPT-5.4 (via Venice)1MReasoning, vision
openai-gpt-53-codexGPT-5.3 Codex (via Venice)400kReasoning, vision, coding
openai-gpt-52GPT-5.2 (via Venice)256kReasoning
openai-gpt-52-codexGPT-5.2 Codex (via Venice)256kReasoning, vision, coding
openai-gpt-4o-2024-11-20GPT-4o (via Venice)128kVision
openai-gpt-4o-mini-2024-07-18GPT-4o Mini (via Venice)128kVision
gemini-3-1-pro-previewGemini 3.1 Pro (via Venice)1MReasoning, vision
gemini-3-pro-previewGemini 3 Pro (via Venice)198kReasoning, vision
gemini-3-flash-previewGemini 3 Flash (via Venice)256kReasoning, vision
grok-41-fastGrok 4.1 Fast (via Venice)1MReasoning, vision
grok-code-fast-1Grok Code Fast 1 (via Venice)256kReasoning, coding

​
모델 탐색

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

​
Streaming 및 Tool 지원

FeatureSupport
Streaming✅ 모든 모델
Function calling✅ 대부분의 모델(API의 supportsFunctionCalling 확인)
Vision/Images✅ “Vision” 기능이 표시된 모델
JSON mode✅ response_format을 통해 지원

​
가격

Venice는 credit 기반 시스템을 사용합니다. 최신 요금은 venice.ai/pricing에서 확인하세요.
  • Private models: 일반적으로 더 저렴함
  • Anonymized models: 직접 API 가격 + 소규모 Venice 수수료와 유사

​
비교: Venice vs Direct API

AspectVenice (Anonymized)Direct API
Privacy메타데이터 제거, 익명화계정이 직접 연결됨
Latency+10-50ms (프록시)직접 연결
Features대부분의 기능 지원전체 기능
BillingVenice creditsProvider billing

​
사용 예시

# Use the default private model
openclaw agent --model venice/kimi-k2-5 --message "Quick health check"

# Use Claude Opus via Venice (anonymized)
openclaw agent --model venice/claude-opus-4-6 --message "Summarize this task"

# Use uncensored model
openclaw agent --model venice/venice-uncensored --message "Draft options"

# Use vision model with image
openclaw agent --model venice/qwen3-vl-235b-a22b --message "Review attached image"

# Use coding model
openclaw agent --model venice/qwen3-coder-480b-a35b-instruct --message "Refactor this function"

​
문제 해결

​
API 키를 인식하지 못함

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

​
모델을 사용할 수 없음

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

​
연결 문제

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

​
config 파일 예시

{
  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,
          },
        ],
      },
    },
  },
}

​
링크