Providers

Venice AI

Venice AI는 개인정보 보호에 중점을 둔 추론을 제공합니다. 오픈 모델은 로깅 없이 실행되며, Claude, GPT, Gemini, Grok에 대한 익명화 프록시 액세스도 제공합니다. 모든 엔드포인트는 OpenAI와 호환됩니다(/v1).

개인정보 보호 모드

모드 동작 모델
비공개 프롬프트와 응답을 저장하거나 기록하지 않습니다. 일시적으로만 유지됩니다. Llama, Qwen, DeepSeek, Kimi, MiniMax, Venice Uncensored 등
익명화 전달 전에 메타데이터를 제거한 후 Venice를 통해 프록시됩니다. Claude, GPT, Gemini, Grok

시작하기

  • Plugin 설치

    bash
    openclaw plugins install @openclaw/venice-provider
  • API 키 발급

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

    대화형(권장)

    bash
    openclaw onboard --auth-choice venice-api-key

    API 키를 입력하라는 메시지를 표시하거나 기존 VENICE_API_KEY를 재사용하고, 사용 가능한 Venice 모델을 나열한 후 기본 모델을 설정합니다.

    환경 변수

    bash
    export VENICE_API_KEY="vapi_xxxxxxxxxxxx"

    비대화형

    bash
    openclaw onboard --non-interactive \  --auth-choice venice-api-key \  --venice-api-key "vapi_xxxxxxxxxxxx"
  • 설정 확인

    bash
    openclaw agent --model venice/kimi-k2-5 --message "Hello, are you working?"
  • 모델 선택

    • 기본값: venice/kimi-k2-5(비공개, 추론, 비전).
    • 가장 강력한 익명화 옵션: venice/claude-opus-4-6.
    bash
    openclaw models set venice/kimi-k2-5openclaw models list --all --provider venice

    openclaw configure를 실행하고 Model/auth provider > Venice AI를 선택할 수도 있습니다.

    기본 제공 카탈로그(38개 모델)

    비공개 모델(26개) — 완전한 비공개, 로깅 없음
    모델 ID 이름 컨텍스트 참고
    kimi-k2-5 Kimi K2.5 256k 기본값, 추론, 비전
    kimi-k2-thinking Kimi K2 Thinking 256k 추론
    llama-3.3-70b Llama 3.3 70B 128k 범용
    llama-3.2-3b Llama 3.2 3B 128k 범용
    hermes-3-llama-3.1-405b Hermes 3 Llama 3.1 405B 128k 범용, 도구 비활성화
    qwen3-235b-a22b-thinking-2507 Qwen3 235B Thinking 128k 추론
    qwen3-235b-a22b-instruct-2507 Qwen3 235B Instruct 128k 범용
    qwen3-coder-480b-a35b-instruct Qwen3 Coder 480B 256k 코딩
    qwen3-coder-480b-a35b-instruct-turbo Qwen3 Coder 480B Turbo 256k 코딩
    qwen3-5-35b-a3b Qwen3.5 35B A3B 256k 추론, 비전
    qwen3-next-80b Qwen3 Next 80B 256k 범용
    qwen3-vl-235b-a22b Qwen3 VL 235B (Vision) 256k 비전
    qwen3-4b Venice Small (Qwen3 4B) 32k 빠름, 추론
    deepseek-v3.2 DeepSeek V3.2 160k 추론, 도구 비활성화
    venice-uncensored Venice Uncensored (Dolphin-Mistral) 32k 무검열, 도구 비활성화
    mistral-31-24b Venice Medium (Mistral) 128k 비전
    google-gemma-3-27b-it Google Gemma 3 27B Instruct 198k 비전
    openai-gpt-oss-120b OpenAI GPT OSS 120B 128k 범용
    nvidia-nemotron-3-nano-30b-a3b NVIDIA Nemotron 3 Nano 30B 128k 범용
    olafangensan-glm-4.7-flash-heretic GLM 4.7 Flash Heretic 128k 추론
    zai-org-glm-4.6 GLM 4.6 198k 범용
    zai-org-glm-4.7 GLM 4.7 198k 추론
    zai-org-glm-4.7-flash GLM 4.7 Flash 128k 추론
    zai-org-glm-5 GLM 5 198k 추론
    minimax-m21 MiniMax M2.1 198k 추론
    minimax-m25 MiniMax M2.5 198k 추론
    익명화 모델(12개) — Venice 프록시 경유
    모델 ID 이름 컨텍스트 참고
    claude-opus-4-6 Claude Opus 4.6 (Venice 경유) 1M 추론, 비전
    claude-sonnet-4-6 Claude Sonnet 4.6 (Venice 경유) 1M 추론, 비전
    openai-gpt-54 GPT-5.4 (Venice 경유) 1M 추론, 비전
    openai-gpt-53-codex GPT-5.3 Codex (Venice 경유) 400k 추론, 비전, 코딩
    openai-gpt-52 GPT-5.2 (Venice 경유) 256k 추론
    openai-gpt-52-codex GPT-5.2 Codex (Venice 경유) 256k 추론, 비전, 코딩
    openai-gpt-4o-2024-11-20 GPT-4o (Venice 경유) 128k 비전
    openai-gpt-4o-mini-2024-07-18 GPT-4o Mini (Venice 경유) 128k 비전
    gemini-3-1-pro-preview Gemini 3.1 Pro (Venice 경유) 1M 추론, 비전
    gemini-3-pro-preview Gemini 3 Pro (Venice 경유) 198k 추론, 비전
    gemini-3-flash-preview Gemini 3 Flash (Venice 경유) 256k 추론, 비전
    grok-41-fast Grok 4.1 Fast (Venice 경유) 1M 추론, 비전

    Grok 기반 Venice 모델(grok-41-fast 및 유사 모델)에는 네이티브 xAI 제공자와 동일한 도구 스키마 호환성 패치가 적용됩니다. 동일한 업스트림 도구 호출 형식을 공유하기 때문입니다.

    모델 검색

    위의 번들 카탈로그는 매니페스트를 기반으로 하는 초기 목록입니다. 런타임에 OpenClaw는 Venice /models API에서 이를 새로 고치며, API에 연결할 수 없으면 초기 목록으로 대체합니다. /models 엔드포인트는 공개되어 있어 목록 조회에는 인증이 필요하지 않지만, 추론에는 유효한 API 키가 필요합니다.

    DeepSeek V4 재생 동작

    Venice가 deepseek-v4-pro 또는 deepseek-v4-flash와 같은 DeepSeek V4 모델을 제공하는 경우, Venice가 어시스턴트 메시지에서 필수 reasoning_content 재생 필드를 생략하면 OpenClaw가 이를 채우고, 요청 페이로드에서 thinking/ reasoning/reasoning_effort를 제거합니다(Venice는 이러한 모델에서 DeepSeek의 네이티브 thinking 제어를 거부합니다). 이 재생 수정은 네이티브 DeepSeek 제공자 자체의 사고 제어와 별개입니다.

    스트리밍 및 도구 지원

    기능 지원
    스트리밍 모든 모델
    함수 호출 대부분의 모델, 위에 표시된 경우 모델별로 비활성화
    비전/이미지 위에서 "비전"으로 표시된 모델
    JSON 모드 response_format 사용

    요금

    Venice는 크레딧 기반 시스템을 사용합니다. 익명화 모델 비용은 대략 직접 API 요금에 소액의 Venice 수수료를 더한 수준입니다. 현재 요금은 venice.ai/pricing을 참조하세요.

    사용 예시

    bash
    # 기본 비공개 모델openclaw agent --model venice/kimi-k2-5 --message "Quick health check" # Venice를 통한 Claude Opus(익명화)openclaw agent --model venice/claude-opus-4-6 --message "Summarize this task" # 무검열 모델openclaw agent --model venice/venice-uncensored --message "Draft options" # 이미지가 포함된 비전 모델openclaw agent --model venice/qwen3-vl-235b-a22b --message "Review attached image" # 코딩 모델openclaw agent --model venice/qwen3-coder-480b-a35b-instruct --message "Refactor this function"

    문제 해결

    API 키가 인식되지 않음
    bash
    echo $VENICE_API_KEYopenclaw models list | grep venice

    키가 vapi_로 시작하는지 확인하세요.

    모델을 사용할 수 없음

    현재 사용 가능한 모델을 확인하려면 openclaw models list --all --provider venice를 실행하세요. Venice에서 모델을 추가하거나 폐기함에 따라 카탈로그가 변경됩니다.

    연결 문제

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

    고급 구성

    구성 파일 예시
    json5
    {  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,          },        ],      },    },  },}

    관련 항목

    Was this useful?
    On this page

    On this page