Providers
Venice AI
Venice AI는 개인정보 보호에 중점을 둔 추론을 제공합니다. 오픈 모델은
로깅 없이 실행되며, Claude, GPT, Gemini, Grok에 대한 익명화 프록시 액세스도 제공합니다.
모든 엔드포인트는 OpenAI와 호환됩니다(/v1).
개인정보 보호 모드
| 모드 | 동작 | 모델 |
|---|---|---|
| 비공개 | 프롬프트와 응답을 저장하거나 기록하지 않습니다. 일시적으로만 유지됩니다. | Llama, Qwen, DeepSeek, Kimi, MiniMax, Venice Uncensored 등 |
| 익명화 | 전달 전에 메타데이터를 제거한 후 Venice를 통해 프록시됩니다. | Claude, GPT, Gemini, Grok |
시작하기
Plugin 설치
openclaw plugins install @openclaw/venice-providerAPI 키 발급
- venice.ai에서 가입합니다
- Settings > API Keys > Create new key로 이동합니다
- API 키를 복사합니다(형식:
vapi_xxxxxxxxxxxx)
OpenClaw 구성
대화형(권장)
openclaw onboard --auth-choice venice-api-keyAPI 키를 입력하라는 메시지를 표시하거나 기존 VENICE_API_KEY를 재사용하고, 사용 가능한 Venice 모델을 나열한 후 기본 모델을 설정합니다.
환경 변수
export VENICE_API_KEY="vapi_xxxxxxxxxxxx"비대화형
openclaw onboard --non-interactive \ --auth-choice venice-api-key \ --venice-api-key "vapi_xxxxxxxxxxxx"설정 확인
openclaw agent --model venice/kimi-k2-5 --message "Hello, are you working?"모델 선택
- 기본값:
venice/kimi-k2-5(비공개, 추론, 비전). - 가장 강력한 익명화 옵션:
venice/claude-opus-4-6.
openclaw models set venice/kimi-k2-5openclaw models list --all --provider veniceopenclaw 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을 참조하세요.
사용 예시
# 기본 비공개 모델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 키가 인식되지 않음
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 연결을 허용하는지 확인하세요.
고급 구성
구성 파일 예시
{ 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, }, ], }, }, },}