> ## 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](https://venice.ai) предоставляет ориентированный на конфиденциальность инференс: открытые модели работают
без ведения журналов, а также доступен анонимизированный прокси-доступ к Claude, GPT, Gemini и Grok.
Все конечные точки совместимы с OpenAI (`/v1`).

## Режимы конфиденциальности

| Режим | Поведение | Модели |
| - | - | - |
| **Приватный** | Запросы и ответы никогда не сохраняются и не журналируются. Эфемерный. | Llama, Qwen, DeepSeek, Kimi, MiniMax, Venice Uncensored и др. |
| **Анонимизированный** | Перед перенаправлением проходят через прокси Venice с удалением метаданных. | Claude, GPT, Gemini, Grok |

> [!WARNING]
>
> Анонимизированные модели не обеспечивают полную конфиденциальность. Venice удаляет метаданные перед перенаправлением, но базовый провайдер (OpenAI, Anthropic, Google, xAI) по-прежнему обрабатывает запрос. Используйте приватные модели, когда требуется полная конфиденциальность.

## Начало работы

**1. Установите плагин**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/venice-provider
```

**2. Получите ключ API**

1. Зарегистрируйтесь на [venice.ai](https://venice.ai)
2. Перейдите в **Settings > API Keys > Create new key**
3. Скопируйте ключ API (формат: `vapi_xxxxxxxxxxxx`)

**3. Настройте OpenClaw**

> [tab] Интерактивно (рекомендуется)
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw onboard --auth-choice venice-api-key
> ```
>
> Запрашивает ключ API (или повторно использует существующий `VENICE_API_KEY`), выводит список доступных моделей Venice и задаёт модель по умолчанию.

> [tab] Переменная окружения
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> export VENICE_API_KEY="vapi_xxxxxxxxxxxx"
> ```

> [tab] Неинтерактивно
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw onboard --non-interactive \
>   --auth-choice venice-api-key \
>   --venice-api-key "vapi_xxxxxxxxxxxx"
> ```

**4. Проверьте настройку**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw agent --model venice/kimi-k2-5 --message "Привет, ты работаешь?"
```

## Выбор модели

* **По умолчанию**: `venice/kimi-k2-5` (приватная, логическое рассуждение, зрение).
* **Самый мощный анонимизированный вариант**: `venice/claude-opus-4-6`.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models set venice/kimi-k2-5
openclaw models list --all --provider venice
```

Также можно запустить `openclaw configure` и выбрать **Провайдер модели/аутентификации > Venice AI**.

> [!TIP]
>
> | Сценарий использования | Модель | Почему |
> | - | - | - |
> | Общение общего назначения (по умолчанию) | `kimi-k2-5` | Мощное приватное логическое рассуждение и зрение |
> | Лучшее общее качество | `claude-opus-4-6` | Самый мощный анонимизированный вариант Venice |
> | Конфиденциальность + программирование | `qwen3-coder-480b-a35b-instruct` | Приватная модель для программирования с большим контекстом |
> | Быстро и недорого | `qwen3-4b` | Облегчённая модель логического рассуждения |
> | Сложные приватные задачи | `deepseek-v3.2` | Мощное логическое рассуждение; вызов инструментов отключён |
> | Без цензуры | `venice-uncensored` | Без ограничений на содержимое |

## Встроенный каталог (38 моделей)

> [accordion] Приватные модели (26) — полная конфиденциальность, без журналирования
>
> | Идентификатор модели | Название | Контекст | Примечания |
> | - | - | - | - |
> | `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 | Рассуждение |

> [accordion] Анонимизированные модели (12) — через прокси Venice
>
> | Идентификатор модели | Название | Контекст | Примечания |
> | - | - | - | - |
> | `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 | Рассуждение, зрение |

Модели Venice на базе Grok (`grok-41-fast` и аналогичные) получают тот же патч
совместимости схемы инструментов, что и нативный провайдер xAI, поскольку они используют
одинаковый вышестоящий формат вызова инструментов.

## Обнаружение моделей

Приведённый выше встроенный каталог представляет собой начальный список на основе манифеста. Во время выполнения OpenClaw
обновляет его через API Venice `/models` и возвращается к начальному списку, если
API недоступен. Конечная точка `/models` общедоступна (для получения списка
аутентификация не требуется), но для инференса необходим действительный ключ API.

## Поведение воспроизведения DeepSeek V4

Если Venice предоставляет модели DeepSeek V4, такие как `deepseek-v4-pro` или
`deepseek-v4-flash`, OpenClaw заполняет обязательное поле воспроизведения
`reasoning_content` в сообщениях ассистента, когда Venice его пропускает, и удаляет
`thinking`/`reasoning`/`reasoning_effort` из полезной нагрузки запроса (Venice отклоняет
собственный элемент управления DeepSeek `thinking` для этих моделей). Это исправление
воспроизведения не связано с собственными элементами управления рассуждением нативного провайдера DeepSeek.

## Поддержка потоковой передачи и инструментов

| Возможность | Поддержка |
| - | - |
| Потоковая передача | Все модели |
| Вызов функций | Большинство моделей; для отдельных моделей отключён, как указано выше |
| Зрение/изображения | Модели с пометкой «Зрение» выше |
| Режим JSON | Через `response_format` |

## Цены

Venice использует систему на основе кредитов. Анонимизированные модели стоят примерно столько же,
сколько прямой доступ к API, плюс небольшая комиссия Venice. Актуальные тарифы см. на странице
[venice.ai/pricing](https://venice.ai/pricing).

## Примеры использования

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# Приватная модель по умолчанию
openclaw agent --model venice/kimi-k2-5 --message "Быстрая проверка работоспособности"

# Claude Opus через Venice (анонимизировано)
openclaw agent --model venice/claude-opus-4-6 --message "Кратко изложи эту задачу"

# Модель без цензуры
openclaw agent --model venice/venice-uncensored --message "Подготовь варианты"

# Модель с поддержкой зрения и изображением
openclaw agent --model venice/qwen3-vl-235b-a22b --message "Проверь прикреплённое изображение"

# Модель для программирования
openclaw agent --model venice/qwen3-coder-480b-a35b-instruct --message "Выполни рефакторинг этой функции"
```

## Устранение неполадок

> [accordion] Ключ API не распознан
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> echo $VENICE_API_KEY
> openclaw models list | grep venice
> ```
>
> Убедитесь, что ключ начинается с `vapi_`.

> [accordion] Модель недоступна
>
> Выполните `openclaw models list --all --provider venice`, чтобы просмотреть доступные в данный момент
> модели; каталог меняется по мере добавления и вывода моделей из эксплуатации Venice.

> [accordion] Проблемы с подключением
>
> API Venice доступен по адресу `https://api.venice.ai/api/v1`. Убедитесь, что ваша сеть разрешает HTTPS-подключения к этому узлу.

> [!NOTE]
>
> Дополнительная помощь: [Устранение неполадок](https://docs2.openclaw.ai/ru/help/troubleshooting.md) и [Часто задаваемые вопросы](https://docs2.openclaw.ai/ru/help/faq.md).

## Расширенная конфигурация

> [accordion] Пример файла конфигурации
>
> ```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,
>           },
>         ],
>       },
>     },
>   },
> }
> ```

## Связанные материалы

> [card] [Выбор модели](https://docs2.openclaw.ai/ru/concepts/model-providers.md)
>
> Выбор провайдеров, ссылок на модели и поведения при переключении после сбоя.

> [card] [Venice AI](https://venice.ai)
>
> Главная страница Venice AI и регистрация учётной записи.

> [card] [Документация API](https://docs.venice.ai)
>
> Справочник по API Venice и документация для разработчиков.

> [card] [Тарифы](https://venice.ai/pricing)
>
> Текущие расценки на кредиты Venice и тарифные планы.
