> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Venice AI Venice AI는 검열되지 않은 모델 지원과 익명화 프록시를 통한 주요 독점 모델 접근을 포함하는 **개인정보 보호 중심 AI 추론**을 제공합니다. 모든 추론은 기본적으로 비공개입니다. 즉, 사용자 데이터로 학습하지 않고 로깅하지 않습니다. ## OpenClaw에서 Venice를 사용하는 이유 * 오픈 소스 모델을 위한 **비공개 추론**(로깅 없음). * 필요할 때 사용할 수 있는 **검열되지 않은 모델**. * 품질이 중요할 때 독점 모델(Opus/GPT/Gemini)에 대한 **익명화된 접근**. * OpenAI 호환 `/v1` 엔드포인트. ## 개인정보 보호 모드 Venice는 두 가지 개인정보 보호 수준을 제공합니다. 이를 이해하는 것이 모델 선택의 핵심입니다. | 모드 | 설명 | 모델 | | ------- | --------------------------------------------------------------------------------------- | --------------------------------------------------------- | | **비공개** | 완전 비공개입니다. 프롬프트/응답은 **절대 저장되거나 로깅되지 않습니다**. 임시 처리됩니다. | Llama, Qwen, DeepSeek, Kimi, MiniMax, Venice Uncensored 등 | | **익명화** | 메타데이터가 제거된 상태로 Venice를 통해 프록시됩니다. 기본 제공자(OpenAI, Anthropic, Google, xAI)는 익명화된 요청을 봅니다. | Claude, GPT, Gemini, Grok | 익명화 모델은 완전한 비공개가 **아닙니다**. Venice는 전달 전에 메타데이터를 제거하지만, 기본 제공자(OpenAI, Anthropic, Google, xAI)가 여전히 요청을 처리합니다. 완전한 개인정보 보호가 필요하면 **비공개** 모델을 선택하세요. ## 기능 * **개인정보 보호 중심**: "비공개"(완전 비공개) 모드와 "익명화"(프록시) 모드 중 선택 * **검열되지 않은 모델**: 콘텐츠 제한이 없는 모델에 접근 * **주요 모델 접근**: Venice의 익명화 프록시를 통해 Claude, GPT, Gemini, Grok 사용 * **OpenAI 호환 API**: 쉬운 통합을 위한 표준 `/v1` 엔드포인트 * **스트리밍**: 모든 모델에서 지원 * **함수 호출**: 일부 모델에서 지원(모델 기능 확인) * **비전**: 비전 기능이 있는 모델에서 지원 * **강제 속도 제한 없음**: 극단적인 사용량에는 공정 사용 제한이 적용될 수 있음 ## 시작하기 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw plugins install @openclaw/venice-provider ``` 1. [venice.ai](https://venice.ai)에서 가입합니다 2. **Settings > API Keys > Create new key**로 이동합니다 3. API 키를 복사합니다(형식: `vapi_xxxxxxxxxxxx`) 선호하는 설정 방법을 선택하세요. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --auth-choice venice-api-key ``` 이 작업은 다음을 수행합니다. 1. API 키를 입력하라는 메시지를 표시합니다(또는 기존 `VENICE_API_KEY` 사용) 2. 사용 가능한 모든 Venice 모델을 표시합니다 3. 기본 모델을 선택하게 합니다 4. 제공자를 자동으로 구성합니다 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} export VENICE_API_KEY="vapi_xxxxxxxxxxxx" ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --non-interactive \ --auth-choice venice-api-key \ --venice-api-key "vapi_xxxxxxxxxxxx" ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw agent --model venice/kimi-k2-5 --message "Hello, are you working?" ``` ## 모델 선택 설정 후 OpenClaw는 사용 가능한 모든 Venice 모델을 표시합니다. 필요에 따라 선택하세요. * **기본 모델**: 강력한 비공개 추론과 비전을 위해 `venice/kimi-k2-5`. * **고성능 옵션**: 가장 강력한 익명화 Venice 경로를 위해 `venice/claude-opus-4-6`. * **개인정보 보호**: 완전한 비공개 추론에는 "비공개" 모델을 선택하세요. * **기능**: Venice 프록시를 통해 Claude, GPT, Gemini에 접근하려면 "익명화" 모델을 선택하세요. 기본 모델은 언제든 변경할 수 있습니다. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw models set venice/kimi-k2-5 openclaw models set venice/claude-opus-4-6 ``` 사용 가능한 모든 모델을 나열합니다. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw models list --all --provider venice ``` `openclaw configure`를 실행하고 **Model/auth**를 선택한 다음 **Venice AI**를 선택할 수도 있습니다. 아래 표를 사용해 사용 사례에 맞는 모델을 선택하세요. | 사용 사례 | 권장 모델 | 이유 | | ---------------- | -------------------------------- | --------------------------- | | **일반 채팅(기본값)** | `kimi-k2-5` | 강력한 비공개 추론과 비전 | | **최고의 전반적 품질** | `claude-opus-4-6` | 가장 강력한 익명화 Venice 옵션 | | **개인정보 보호 + 코딩** | `qwen3-coder-480b-a35b-instruct` | 큰 컨텍스트를 갖춘 비공개 코딩 모델 | | **비공개 비전** | `kimi-k2-5` | 비공개 모드를 벗어나지 않는 비전 지원 | | **빠르고 저렴함** | `qwen3-4b` | 가벼운 추론 모델 | | **복잡한 비공개 작업** | `deepseek-v3.2` | 강력한 추론, 하지만 Venice 도구 지원 없음 | | **검열되지 않음** | `venice-uncensored` | 콘텐츠 제한 없음 | ## DeepSeek V4 재생 동작 Venice가 `venice/deepseek-v4-pro` 또는 `venice/deepseek-v4-flash` 같은 DeepSeek V4 모델을 노출하는 경우, 프록시가 이를 생략하면 OpenClaw는 어시스턴트 메시지에 필요한 DeepSeek V4 `reasoning_content` 재생 자리표시자를 채웁니다. Venice는 DeepSeek의 기본 최상위 `thinking` 제어를 거부하므로, OpenClaw는 이 제공자별 재생 수정을 기본 DeepSeek 제공자의 thinking 제어와 분리해 둡니다. ## 내장 카탈로그(총 41개) | 모델 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 | 추론 | | 모델 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 | 추론, 비전 | ## 모델 탐색 OpenClaw는 읽기 전용 모델 목록을 위해 매니페스트 기반 Venice 시드 카탈로그를 제공합니다. 런타임 새로고침은 여전히 Venice API에서 모델을 탐색할 수 있으며, API에 연결할 수 없으면 매니페스트 카탈로그로 대체됩니다. `/models` 엔드포인트는 공개되어 있지만(목록 조회에는 인증 불필요), 추론에는 유효한 API 키가 필요합니다. ## 스트리밍 및 도구 지원 | 기능 | 지원 | | ----------- | ------------------------------------------- | | **스트리밍** | 모든 모델 | | **함수 호출** | 대부분의 모델(API에서 `supportsFunctionCalling` 확인) | | **비전/이미지** | "Vision" 기능으로 표시된 모델 | | **JSON 모드** | `response_format`을 통해 지원 | ## 가격 Venice는 크레딧 기반 시스템을 사용합니다. 현재 요율은 [venice.ai/pricing](https://venice.ai/pricing)에서 확인하세요. * **비공개 모델**: 일반적으로 더 낮은 비용 * **익명화된 모델**: 직접 API 가격 + 소액의 Venice 수수료와 유사 ### Venice(익명화)와 직접 API 비교 | 항목 | Venice(익명화) | 직접 API | | ----------- | -------------- | ------- | | **개인정보 보호** | 메타데이터 제거 및 익명화 | 계정이 연결됨 | | **지연 시간** | +10-50ms(프록시) | 직접 연결 | | **기능** | 대부분의 기능 지원 | 전체 기능 | | **청구** | Venice 크레딧 | 제공자 청구 | ## 사용 예시 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # 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" ``` ## 문제 해결 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} echo $VENICE_API_KEY openclaw models list | grep venice ``` 키가 `vapi_`로 시작하는지 확인하세요. Venice 모델 카탈로그는 동적으로 업데이트됩니다. 현재 사용 가능한 모델을 보려면 `openclaw models list`를 실행하세요. 일부 모델은 일시적으로 오프라인일 수 있습니다. Venice API는 `https://api.venice.ai/api/v1`에 있습니다. 네트워크에서 HTTPS 연결을 허용하는지 확인하세요. 추가 도움말: [문제 해결](/ko/help/troubleshooting) 및 [FAQ](/ko/help/faq). ## 고급 구성 ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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, }, ], }, }, }, } ``` ## 관련 항목 제공자, 모델 참조, 장애 조치 동작 선택. Venice AI 홈페이지 및 계정 가입. Venice API 참조 및 개발자 문서. 현재 Venice 크레딧 요율 및 플랜.