Venice AI Provider

기준일: 2026-07-26
난이도: 중급
공식 기준: Venice AI

개요

이 페이지는 OpenClaw Venice AI provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.

공식 요약: Use Venice AI privacy-focused models in OpenClaw

model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.

빠른 참조

Mode	Behavior	Models
Private	Prompts/responses are never stored or logged. Ephemeral.	Llama, Qwen, DeepSeek, Kimi, MiniMax, Venice Uncensored, etc.
Anonymized	Proxied through Venice with metadata stripped before forwarding.	Claude, GPT, Gemini, Grok

공식 문서 기반 상세

아래는 공식 providers/venice 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.

Venice AI provides privacy-focused inference: open models run with no logging, plus anonymized proxy access to Claude, GPT, Gemini, and Grok. All endpoints are OpenAI-compatible (/v1).

Privacy modes

Mode	Behavior	Models
Private	Prompts/responses are never stored or logged. Ephemeral.	Llama, Qwen, DeepSeek, Kimi, MiniMax, Venice Uncensored, etc.
Anonymized	Proxied through Venice with metadata stripped before forwarding.	Claude, GPT, Gemini, Grok

Anonymized models are not fully private. Venice strips metadata before forwarding, but the underlying provider (OpenAI, Anthropic, Google, xAI) still processes the request. Use Private models when full privacy is required.

시작하기

Install the plugin

```bash
openclaw plugins install @openclaw/venice-provider
```

Get your API key

1. Sign up at [venice.ai](https://venice.ai)
2. Go to **Settings > API Keys > Create new key**
3. Copy your API key (format: `vapi_xxxxxxxxxxxx`)

Configure OpenClaw

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

    Prompts for the API key (or reuses an existing `VENICE_API_KEY`), lists available Venice models, and sets your default model.
  
  
    ```bash
    export VENICE_API_KEY="vapi_xxxxxxxxxxxx"
    ```
  
  
    ```bash
    openclaw onboard --non-interactive \
      --auth-choice venice-api-key \
      --venice-api-key "vapi_xxxxxxxxxxxx"
    ```

Verify setup

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

모델 선택

Default: venice/kimi-k2-5 (private, reasoning, vision).
Strongest anonymized option: venice/claude-opus-4.

openclaw models set venice/kimi-k2-5
openclaw models list --all --provider venice

You can also run openclaw configure and pick Model/auth provider > Venice AI.

Use case Model Why

General chat (default) kimi-k2-5 Strong private reasoning plus vision

Best overall quality claude-opus-4 Strongest anonymized Venice option

Privacy + coding qwen3-coder-480b-a35b-instruct-turbo Private coding model with large context

Fast + cheap llama-3.2-3b Compact private model

Complex private tasks deepseek-v3.2 Strong reasoning; tool calling disabled

Uncensored venice-uncensored-1-2 Current uncensored Venice model

Use case	Model	Why
General chat (default)	`kimi-k2-5`	Strong private reasoning plus vision
Best overall quality	`claude-opus-4`	Strongest anonymized Venice option
Privacy + coding	`qwen3-coder-480b-a35b-instruct-turbo`	Private coding model with large context
Fast + cheap	`llama-3.2-3b`	Compact private model
Complex private tasks	`deepseek-v3.2`	Strong reasoning; tool calling disabled
Uncensored	`venice-uncensored-1-2`	Current uncensored Venice model

Built-in catalog (30 models)

Private models (20) — fully private, no logging

| Model ID                               | Name                                 | Context | Notes                      |
| -------------------------------------- | ------------------------------------- | ------- | --------------------------- |
| `kimi-k2-5`                            | Kimi K2.5                             | 256k    | Default, reasoning, vision  |
| `llama-3.3-70b`                        | Llama 3.3 70B                         | 128k    | General                     |
| `llama-3.2-3b`                         | Llama 3.2 3B                          | 128k    | General                     |
| `hermes-3-llama-3.1-405b`              | Hermes 3 Llama 3.1 405B               | 128k    | General, tools disabled     |
| `qwen3-235b-a22b-thinking-2507`        | Qwen3 235B Thinking                   | 128k    | Reasoning                   |
| `qwen3-235b-a22b-instruct-2507`        | Qwen3 235B Instruct                   | 128k    | General                     |
| `qwen3-coder-480b-a35b-instruct-turbo` | Qwen3 Coder 480B Turbo                | 256k    | Coding                      |
| `qwen3-5-35b-a3b`                      | Qwen3.5 35B A3B                       | 256k    | Reasoning, vision           |
| `qwen3-next-80b`                       | Qwen3 Next 80B                        | 256k    | General                     |
| `qwen3-vl-235b-a22b`                   | Qwen3 VL 235B (Vision)                | 256k    | Vision                      |
| `deepseek-v3.2`                        | DeepSeek V3.2                         | 160k    | Reasoning, tools disabled    |
| `google-gemma-3-27b-it`                | Google Gemma 3 27B Instruct           | 198k    | Vision                       |
| `openai-gpt-oss-120b`                  | OpenAI GPT OSS 120B                   | 128k    | General                      |
| `nvidia-nemotron-3-nano-30b-a3b`       | NVIDIA Nemotron 3 Nano 30B            | 128k    | General                      |
| `olafangensan-glm-4.7-flash-heretic`   | GLM 4.7 Flash Heretic                 | 128k    | Reasoning                    |
| `zai-org-glm-4.6`                      | GLM 4.6                               | 198k    | General                      |
| `zai-org-glm-4.7`                      | GLM 4.7                               | 198k    | Reasoning                    |
| `zai-org-glm-4.7-flash`                | GLM 4.7 Flash                         | 128k    | Reasoning                    |
| `zai-org-glm-5`                        | GLM 5                                 | 198k    | Reasoning                    |
| `minimax-m25`                          | MiniMax M2.5                          | 198k    | Reasoning                    |

Anonymized models (10) — via Venice proxy

| Model ID                        | Name                           | Context | Notes                      |
| -------------------------------- | -------------------------------- | ------- | ---------------------------- |
| `claude-opus-4`               | Claude Opus 4.6 (via Venice)    | 1M      | Reasoning, vision            |
| `claude-sonnet-4-6`             | Claude Sonnet 4.6 (via Venice)  | 1M      | Reasoning, vision            |
| `openai-gpt-54`                 | GPT-5.4 (via Venice)            | 1M      | Reasoning, vision            |
| `openai-gpt-53-codex`           | GPT-5.3 Codex (via Venice)      | 400k    | Reasoning, vision, coding     |
| `openai-gpt-52`                 | GPT-5.2 (via Venice)            | 256k    | Reasoning                    |
| `openai-gpt-52-codex`           | GPT-5.2 Codex (via Venice)      | 256k    | Reasoning, vision, coding     |
| `openai-gpt-4o-2024-11-20`      | GPT-4o (via Venice)             | 128k    | Vision                        |
| `openai-gpt-4o-mini-2024-07-18` | GPT-4o Mini (via Venice)        | 128k    | Vision                        |
| `gemini-3-1-pro-preview`        | Gemini 3.1 Pro (via Venice)     | 1M      | Reasoning, vision             |
| `gemini-3-flash-preview`        | Gemini 3 Flash (via Venice)     | 256k    | Reasoning, vision             |

Grok-backed Venice models (grok-4-3 and similar) get the same tool-schema compat patch as the native xAI provider, since they share the same upstream tool-call format.

Model discovery

The bundled catalog above is a manifest-backed seed list. At runtime OpenClaw refreshes it from the Venice /models API and falls back to the seed list if the API is unreachable. The /models endpoint is public (no auth needed for listing), but inference requires a valid API key.

Venice may continue accepting retired model IDs as provider-owned aliases. The OpenClaw catalog advertises only the canonical model IDs returned by /models.

DeepSeek V4 replay behavior

If Venice exposes DeepSeek V4 models such as deepseek-v4-pro or deepseek-v4-flash, OpenClaw fills the required reasoning_content replay field on assistant messages when Venice omits it, and strips thinking/ reasoning/reasoning_effort from the request payload (Venice rejects DeepSeek's native thinking control on these models). This replay fix is separate from the native DeepSeek provider's own thinking controls.

Streaming and tool support

Feature	Support
Streaming	All models
Function calling	Most models; disabled per-model where noted above
Vision/Images	Models marked "Vision" above
JSON mode	Via `response_format`

Pricing

Venice uses a credit-based system. Anonymized models cost roughly the same as direct API pricing plus a small Venice fee. See venice.ai/pricing for current rates.

Usage examples

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

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

# Uncensored model
openclaw agent --model venice/venice-uncensored-1-2 --message "Draft options"

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

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

문제 해결

API key not recognized

```bash
echo $VENICE_API_KEY
openclaw models list | grep venice
```

Confirm the key starts with `vapi_`.

Model not available

Run `openclaw models list --all --provider venice` to see currently
available models; the catalog changes as Venice adds or retires models.

Connection issues

Venice API is at `https://api.venice.ai/api/v1`. Confirm your network allows HTTPS to that host.

More help: Troubleshooting and FAQ.

고급 설정

Config file example

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

검증 체크리스트

openclaw models list --provider venice 로 모델이 보이는지 확인
기본 model alias를 agents.defaults.model.primary에 설정했는지 확인
API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
failover 시 데이터가 다른 provider로 이동할 수 있는지 검토

Venice AI Provider

기준일: 2026-07-26
난이도: 중급
공식 기준: Venice AI

개요

이 페이지는 OpenClaw Venice AI provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.

공식 요약: Use Venice AI privacy-focused models in OpenClaw

model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.

빠른 참조

Mode	Behavior	Models
Private	Prompts/responses are never stored or logged. Ephemeral.	Llama, Qwen, DeepSeek, Kimi, MiniMax, Venice Uncensored, etc.
Anonymized	Proxied through Venice with metadata stripped before forwarding.	Claude, GPT, Gemini, Grok

공식 문서 기반 상세

Venice AI provides privacy-focused inference: open models run with no logging, plus anonymized proxy access to Claude, GPT, Gemini, and Grok. All endpoints are OpenAI-compatible (/v1).

Privacy modes

Mode	Behavior	Models
Private	Prompts/responses are never stored or logged. Ephemeral.	Llama, Qwen, DeepSeek, Kimi, MiniMax, Venice Uncensored, etc.
Anonymized	Proxied through Venice with metadata stripped before forwarding.	Claude, GPT, Gemini, Grok

Anonymized models are not fully private. Venice strips metadata before forwarding, but the underlying provider (OpenAI, Anthropic, Google, xAI) still processes the request. Use Private models when full privacy is required.

시작하기

Install the plugin

```bash
openclaw plugins install @openclaw/venice-provider
```

Get your API key

1. Sign up at [venice.ai](https://venice.ai)
2. Go to **Settings > API Keys > Create new key**
3. Copy your API key (format: `vapi_xxxxxxxxxxxx`)

Configure OpenClaw

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

    Prompts for the API key (or reuses an existing `VENICE_API_KEY`), lists available Venice models, and sets your default model.
  
  
    ```bash
    export VENICE_API_KEY="vapi_xxxxxxxxxxxx"
    ```
  
  
    ```bash
    openclaw onboard --non-interactive \
      --auth-choice venice-api-key \
      --venice-api-key "vapi_xxxxxxxxxxxx"
    ```

Verify setup

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

모델 선택

Default: venice/kimi-k2-5 (private, reasoning, vision).
Strongest anonymized option: venice/claude-opus-4.

openclaw models set venice/kimi-k2-5
openclaw models list --all --provider venice

You can also run openclaw configure and pick Model/auth provider > Venice AI.

Use case Model Why

General chat (default) kimi-k2-5 Strong private reasoning plus vision

Best overall quality claude-opus-4 Strongest anonymized Venice option

Privacy + coding qwen3-coder-480b-a35b-instruct-turbo Private coding model with large context

Fast + cheap llama-3.2-3b Compact private model

Complex private tasks deepseek-v3.2 Strong reasoning; tool calling disabled

Uncensored venice-uncensored-1-2 Current uncensored Venice model

Use case	Model	Why
General chat (default)	`kimi-k2-5`	Strong private reasoning plus vision
Best overall quality	`claude-opus-4`	Strongest anonymized Venice option
Privacy + coding	`qwen3-coder-480b-a35b-instruct-turbo`	Private coding model with large context
Fast + cheap	`llama-3.2-3b`	Compact private model
Complex private tasks	`deepseek-v3.2`	Strong reasoning; tool calling disabled
Uncensored	`venice-uncensored-1-2`	Current uncensored Venice model

Built-in catalog (30 models)

Private models (20) — fully private, no logging

| Model ID                               | Name                                 | Context | Notes                      |
| -------------------------------------- | ------------------------------------- | ------- | --------------------------- |
| `kimi-k2-5`                            | Kimi K2.5                             | 256k    | Default, reasoning, vision  |
| `llama-3.3-70b`                        | Llama 3.3 70B                         | 128k    | General                     |
| `llama-3.2-3b`                         | Llama 3.2 3B                          | 128k    | General                     |
| `hermes-3-llama-3.1-405b`              | Hermes 3 Llama 3.1 405B               | 128k    | General, tools disabled     |
| `qwen3-235b-a22b-thinking-2507`        | Qwen3 235B Thinking                   | 128k    | Reasoning                   |
| `qwen3-235b-a22b-instruct-2507`        | Qwen3 235B Instruct                   | 128k    | General                     |
| `qwen3-coder-480b-a35b-instruct-turbo` | Qwen3 Coder 480B Turbo                | 256k    | Coding                      |
| `qwen3-5-35b-a3b`                      | Qwen3.5 35B A3B                       | 256k    | Reasoning, vision           |
| `qwen3-next-80b`                       | Qwen3 Next 80B                        | 256k    | General                     |
| `qwen3-vl-235b-a22b`                   | Qwen3 VL 235B (Vision)                | 256k    | Vision                      |
| `deepseek-v3.2`                        | DeepSeek V3.2                         | 160k    | Reasoning, tools disabled    |
| `google-gemma-3-27b-it`                | Google Gemma 3 27B Instruct           | 198k    | Vision                       |
| `openai-gpt-oss-120b`                  | OpenAI GPT OSS 120B                   | 128k    | General                      |
| `nvidia-nemotron-3-nano-30b-a3b`       | NVIDIA Nemotron 3 Nano 30B            | 128k    | General                      |
| `olafangensan-glm-4.7-flash-heretic`   | GLM 4.7 Flash Heretic                 | 128k    | Reasoning                    |
| `zai-org-glm-4.6`                      | GLM 4.6                               | 198k    | General                      |
| `zai-org-glm-4.7`                      | GLM 4.7                               | 198k    | Reasoning                    |
| `zai-org-glm-4.7-flash`                | GLM 4.7 Flash                         | 128k    | Reasoning                    |
| `zai-org-glm-5`                        | GLM 5                                 | 198k    | Reasoning                    |
| `minimax-m25`                          | MiniMax M2.5                          | 198k    | Reasoning                    |

Anonymized models (10) — via Venice proxy

| Model ID                        | Name                           | Context | Notes                      |
| -------------------------------- | -------------------------------- | ------- | ---------------------------- |
| `claude-opus-4`               | Claude Opus 4.6 (via Venice)    | 1M      | Reasoning, vision            |
| `claude-sonnet-4-6`             | Claude Sonnet 4.6 (via Venice)  | 1M      | Reasoning, vision            |
| `openai-gpt-54`                 | GPT-5.4 (via Venice)            | 1M      | Reasoning, vision            |
| `openai-gpt-53-codex`           | GPT-5.3 Codex (via Venice)      | 400k    | Reasoning, vision, coding     |
| `openai-gpt-52`                 | GPT-5.2 (via Venice)            | 256k    | Reasoning                    |
| `openai-gpt-52-codex`           | GPT-5.2 Codex (via Venice)      | 256k    | Reasoning, vision, coding     |
| `openai-gpt-4o-2024-11-20`      | GPT-4o (via Venice)             | 128k    | Vision                        |
| `openai-gpt-4o-mini-2024-07-18` | GPT-4o Mini (via Venice)        | 128k    | Vision                        |
| `gemini-3-1-pro-preview`        | Gemini 3.1 Pro (via Venice)     | 1M      | Reasoning, vision             |
| `gemini-3-flash-preview`        | Gemini 3 Flash (via Venice)     | 256k    | Reasoning, vision             |

Grok-backed Venice models (grok-4-3 and similar) get the same tool-schema compat patch as the native xAI provider, since they share the same upstream tool-call format.

Model discovery

Venice may continue accepting retired model IDs as provider-owned aliases. The OpenClaw catalog advertises only the canonical model IDs returned by /models.

DeepSeek V4 replay behavior

Streaming and tool support

Feature	Support
Streaming	All models
Function calling	Most models; disabled per-model where noted above
Vision/Images	Models marked "Vision" above
JSON mode	Via `response_format`

Pricing

Venice uses a credit-based system. Anonymized models cost roughly the same as direct API pricing plus a small Venice fee. See venice.ai/pricing for current rates.

Usage examples

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

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

# Uncensored model
openclaw agent --model venice/venice-uncensored-1-2 --message "Draft options"

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

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

문제 해결

API key not recognized

```bash
echo $VENICE_API_KEY
openclaw models list | grep venice
```

Confirm the key starts with `vapi_`.

Model not available

Run `openclaw models list --all --provider venice` to see currently
available models; the catalog changes as Venice adds or retires models.

Connection issues

Venice API is at `https://api.venice.ai/api/v1`. Confirm your network allows HTTPS to that host.

More help: Troubleshooting and FAQ.

고급 설정

Config file example

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

검증 체크리스트

openclaw models list --provider venice 로 모델이 보이는지 확인
기본 model alias를 agents.defaults.model.primary에 설정했는지 확인
API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
failover 시 데이터가 다른 provider로 이동할 수 있는지 검토

Venice AI Provider

개요

빠른 참조

공식 문서 기반 상세

Privacy modes

시작하기

Install the plugin

Get your API key

Configure OpenClaw

Verify setup

모델 선택

Built-in catalog (30 models)

Private models (20) — fully private, no logging

Anonymized models (10) — via Venice proxy

Model discovery

DeepSeek V4 replay behavior

Streaming and tool support

Pricing

Usage examples

문제 해결

API key not recognized

Model not available

Connection issues

고급 설정

Config file example

관련 문서

검증 체크리스트

관련

관련 가이드

Venice AI Provider

개요

빠른 참조

공식 문서 기반 상세

Privacy modes

시작하기

Install the plugin

Get your API key

Configure OpenClaw

Verify setup

모델 선택

Built-in catalog (30 models)

Private models (20) — fully private, no logging

Anonymized models (10) — via Venice proxy

Model discovery

DeepSeek V4 replay behavior

Streaming and tool support

Pricing

Usage examples

문제 해결

API key not recognized

Model not available

Connection issues

고급 설정

Config file example

관련 문서

검증 체크리스트

관련

관련 가이드