跳转到主要内容
Venice AI 提供注重隐私的推理服务:开放模型运行时 不记录日志,并且提供对 Claude、GPT、Gemini 和 Grok 的匿名化代理访问。 所有端点都兼容 OpenAI(/v1)。

隐私模式

模式行为Models
私有提示词/响应永不存储或记录。临时存在。Llama, Qwen, DeepSeek, Kimi, MiniMax, Venice Uncensored 等。
匿名化通过 Venice 代理转发,并在转发前移除元数据。Claude, GPT, Gemini, Grok
匿名化模型并非完全私有。Venice 会在转发前移除元数据,但底层提供商(OpenAI、Anthropic、Google、xAI)仍会处理请求。需要完整隐私时,请使用私有模型。

入门指南

1

安装插件

openclaw plugins install @openclaw/venice-provider
2

获取你的 API key

  1. venice.ai 注册
  2. 前往 Settings > API Keys > Create new key
  3. 复制你的 API key(格式:vapi_xxxxxxxxxxxx
3

配置 OpenClaw

openclaw onboard --auth-choice venice-api-key
提示输入 API key(或复用现有的 VENICE_API_KEY),列出可用的 Venice 模型,并设置你的默认模型。
4

验证设置

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-5
openclaw models list --all --provider venice
你也可以运行 openclaw configure,并选择 Model/auth provider > Venice AI
用例模型原因
通用聊天(默认)kimi-k2-5强大的私有推理能力,并支持视觉
最佳整体质量claude-opus-4-6Venice 最强的匿名化选项
隐私 + 编码qwen3-coder-480b-a35b-instruct具备大上下文的私有编码模型
快速 + 低成本qwen3-4b轻量推理模型
复杂私有任务deepseek-v3.2强推理能力;工具调用已禁用
无内容限制venice-uncensored无内容限制

内置目录(38 个模型)

模型 ID名称上下文说明
kimi-k2-5Kimi K2.5256k默认、推理、视觉
kimi-k2-thinkingKimi K2 Thinking256k推理
llama-3.3-70bLlama 3.3 70B128k通用
llama-3.2-3bLlama 3.2 3B128k通用
hermes-3-llama-3.1-405bHermes 3 Llama 3.1 405B128k通用,工具已禁用
qwen3-235b-a22b-thinking-2507Qwen3 235B Thinking128k推理
qwen3-235b-a22b-instruct-2507Qwen3 235B Instruct128k通用
qwen3-coder-480b-a35b-instructQwen3 Coder 480B256k编码
qwen3-coder-480b-a35b-instruct-turboQwen3 Coder 480B Turbo256k编码
qwen3-5-35b-a3bQwen3.5 35B A3B256k推理、视觉
qwen3-next-80bQwen3 Next 80B256k通用
qwen3-vl-235b-a22bQwen3 VL 235B(视觉)256k视觉
qwen3-4bVenice Small (Qwen3 4B)32k快速、推理
deepseek-v3.2DeepSeek V3.2160k推理,工具已禁用
venice-uncensoredVenice Uncensored (Dolphin-Mistral)32k无内容限制,工具已禁用
mistral-31-24bVenice Medium (Mistral)128k视觉
google-gemma-3-27b-itGoogle Gemma 3 27B Instruct198k视觉
openai-gpt-oss-120bOpenAI GPT OSS 120B128k通用
nvidia-nemotron-3-nano-30b-a3bNVIDIA Nemotron 3 Nano 30B128k通用
olafangensan-glm-4.7-flash-hereticGLM 4.7 Flash Heretic128k推理
zai-org-glm-4.6GLM 4.6198k通用
zai-org-glm-4.7GLM 4.7198k推理
zai-org-glm-4.7-flashGLM 4.7 Flash128k推理
zai-org-glm-5GLM 5198k推理
minimax-m21MiniMax M2.1198k推理
minimax-m25MiniMax M2.5198k推理
模型 ID名称上下文说明
claude-opus-4-6Claude Opus 4.6(通过 Venice)1M推理、视觉
claude-sonnet-4-6Claude Sonnet 4.6(通过 Venice)1M推理、视觉
openai-gpt-54GPT-5.4(通过 Venice)1M推理、视觉
openai-gpt-53-codexGPT-5.3 Codex(通过 Venice)400k推理、视觉、编码
openai-gpt-52GPT-5.2(通过 Venice)256k推理
openai-gpt-52-codexGPT-5.2 Codex(通过 Venice)256k推理、视觉、编码
openai-gpt-4o-2024-11-20GPT-4o(通过 Venice)128k视觉
openai-gpt-4o-mini-2024-07-18GPT-4o Mini(通过 Venice)128k视觉
gemini-3-1-pro-previewGemini 3.1 Pro(通过 Venice)1M推理、视觉
gemini-3-pro-previewGemini 3 Pro(通过 Venice)198k推理、视觉
gemini-3-flash-previewGemini 3 Flash(通过 Venice)256k推理、视觉
grok-41-fastGrok 4.1 Fast(通过 Venice)1M推理、视觉
由 Grok 支持的 Venice 模型(grok-41-fast 和类似模型)会获得与原生 xAI provider 相同的工具 schema 兼容补丁,因为它们共享相同的上游 工具调用格式。

模型发现

上面的内置目录是一个由清单支持的种子列表。运行时,OpenClaw 会从 Venice /models API 刷新它;如果 API 不可访问,则回退到种子列表。/models 端点是公开的(列出模型不需要认证),但推理需要有效的 API key。

DeepSeek V4 重放行为

如果 Venice 暴露了 DeepSeek V4 模型,例如 deepseek-v4-prodeepseek-v4-flash,当 Venice 省略助手消息中必需的 reasoning_content 重放 字段时,OpenClaw 会填充该字段,并从请求载荷中移除 thinking/ reasoning/reasoning_effort(Venice 会拒绝这些模型上的 DeepSeek 原生 thinking 控制)。此重放修复 独立于原生 DeepSeek provider 自身的 thinking 控制。

流式传输和工具支持

功能支持
流式传输所有模型
函数调用大多数模型;按模型在上文标注处禁用
视觉/图像上文标记为“视觉”的模型
JSON 模式通过 response_format

定价

Venice 使用基于积分的系统。匿名化模型的成本大致等同于 直接 API 定价加上一小笔 Venice 费用。请参阅 venice.ai/pricing 了解当前价格。

使用示例

# 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-6 --message "Summarize this task"

# Uncensored model
openclaw agent --model venice/venice-uncensored --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 --message "Refactor this function"

故障排查

echo $VENICE_API_KEY
openclaw models list | grep venice
确认 key 以 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,
          },
        ],
      },
    },
  },
}

相关内容

Model selection

选择提供商、模型引用和故障转移行为。

Venice AI

Venice AI 主页和账户注册。

API documentation

Venice API 参考和开发者文档。

Pricing

当前 Venice 积分费率和套餐。