Skip to main content

Documentation Index

Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt

Use this file to discover all available pages before exploring further.

Venice AI 提供隐私优先的 AI 推理,支持无审查模型,并可通过其匿名代理访问主流专有模型。所有推理默认都是私密的——不会对你的数据进行训练,也不会记录日志。

为什么在 OpenClaw 中使用 Venice

  • 私密推理:适用于开源模型(不记录日志)。
  • 无审查模型:当你需要时可使用。
  • 匿名访问:通过 Venice 的匿名代理访问专有模型(Opus/GPT/Gemini),在质量更重要时使用。
  • 与 OpenAI 兼容的 /v1 端点。

隐私模式

Venice 提供两种隐私级别——理解这一点是选择模型的关键:
ModeDescriptionModels
Private完全私密。提示词/响应绝不会被存储或记录。临时性的。Llama, Qwen, DeepSeek, Kimi, MiniMax, Venice Uncensored, etc.
Anonymized通过 Venice 代理并去除元数据后转发。底层提供商(OpenAI、Anthropic、Google、xAI)会看到匿名化请求。Claude, GPT, Gemini, Grok
匿名化模型不是完全私密的。Venice 在转发前会去除元数据,但底层提供商(OpenAI、Anthropic、Google、xAI)仍然会处理该请求。在需要完全隐私时,请选择Private模型。

功能

  • 隐私优先:可在“private”(完全私密)和“anonymized”(经代理)模式之间选择
  • 无审查模型:可访问没有内容限制的模型
  • 主流模型访问:通过 Venice 的匿名代理使用 Claude、GPT、Gemini 和 Grok
  • OpenAI 兼容 API:标准 /v1 端点,便于集成
  • 流式输出:所有模型均支持
  • 函数调用:部分模型支持(请查看模型能力)
  • 视觉:支持具备视觉能力的模型
  • 无硬性速率限制:在极端使用情况下可能会有公平使用限流

开始使用

1

获取你的 API 密钥

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

配置 OpenClaw

选择你偏好的设置方式:
openclaw onboard --auth-choice venice-api-key
这将会:
  1. 提示输入你的 API 密钥(或使用已有的 VENICE_API_KEY
  2. 显示所有可用的 Venice 模型
  3. 让你选择默认模型
  4. 自动配置提供商
3

验证设置

openclaw agent --model venice/kimi-k2-5 --message "你好,你在工作吗?"

模型选择

设置完成后,OpenClaw 会显示所有可用的 Venice 模型。请根据你的需求选择:
  • 默认模型venice/kimi-k2-5,适合强大的私密推理并支持视觉。
  • 高能力选项venice/claude-opus-4-6,这是 Venice 上最强的匿名化路径。
  • 隐私:选择“private”模型以获得完全私密的推理。
  • 能力:选择“anonymized”模型,通过 Venice 的代理访问 Claude、GPT、Gemini。
你可以随时更改默认模型:
openclaw models set venice/kimi-k2-5
openclaw models set venice/claude-opus-4-6
列出所有可用模型:
openclaw models list --all --provider venice
你也可以运行 openclaw configure,选择 Model/auth,然后选择 Venice AI
使用下表为你的使用场景选择合适的模型。
Use CaseRecommended ModelWhy
General chat (default)kimi-k2-5强大的私密推理并支持视觉
Best overall qualityclaude-opus-4-6Venice 中最强的匿名化选项
Privacy + codingqwen3-coder-480b-a35b-instruct具有大上下文的私密编程模型
Private visionkimi-k2-5在不离开私密模式的情况下支持视觉
Fast + cheapqwen3-4b轻量级推理模型
Complex private tasksdeepseek-v3.2强大的推理,但不支持 Venice 工具
Uncensoredvenice-uncensored无内容限制

DeepSeek V4 回放行为

如果 Venice 暴露了 DeepSeek V4 模型,例如 venice/deepseek-v4-provenice/deepseek-v4-flash,当代理省略时,OpenClaw 会在 assistant 消息上填充所需的 DeepSeek V4 reasoning_content 回放占位符。Venice 会拒绝 DeepSeek 原生的顶层 thinking 控制,因此 OpenClaw 会将该提供商特定的回放修复与原生 DeepSeek 提供商的 thinking 控制分开处理。

内置目录(共 41 个)

Model IDNameContextFeatures
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 (Vision)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推理
Model IDNameContextFeatures
claude-opus-4-6Claude Opus 4.6 (via Venice)1M推理、视觉
claude-opus-4-5Claude Opus 4.5 (via Venice)198k推理、视觉
claude-sonnet-4-6Claude Sonnet 4.6 (via Venice)1M推理、视觉
claude-sonnet-4-5Claude Sonnet 4.5 (via Venice)198k推理、视觉
openai-gpt-54GPT-5.4 (via Venice)1M推理、视觉
openai-gpt-53-codexGPT-5.3 Codex (via Venice)400k推理、视觉、编程
openai-gpt-52GPT-5.2 (via Venice)256k推理
openai-gpt-52-codexGPT-5.2 Codex (via Venice)256k推理、视觉、编程
openai-gpt-4o-2024-11-20GPT-4o (via Venice)128k视觉
openai-gpt-4o-mini-2024-07-18GPT-4o Mini (via Venice)128k视觉
gemini-3-1-pro-previewGemini 3.1 Pro (via Venice)1M推理、视觉
gemini-3-pro-previewGemini 3 Pro (via Venice)198k推理、视觉
gemini-3-flash-previewGemini 3 Flash (via Venice)256k推理、视觉
grok-41-fastGrok 4.1 Fast (via Venice)1M推理、视觉
grok-code-fast-1Grok Code Fast 1 (via Venice)256k推理、编程

模型发现

OpenClaw 提供了一个基于清单的 Venice 种子目录,用于只读模型列表。运行时刷新仍然可以从 Venice API 发现模型,如果 API 不可达,则回退到清单目录。 /models 端点是公开的(列出时不需要认证),但推理需要有效的 API 密钥。

流式传输与工具支持

功能支持
流式传输所有模型
函数调用大多数模型(请在 API 中检查 supportsFunctionCalling
视觉/图像标记了“Vision”功能的模型
JSON 模式通过 response_format 支持

定价

Venice 使用基于 credit 的系统。请查看 venice.ai/pricing 了解当前费率:
  • 私有模型:通常成本更低
  • 匿名模型:与直接 API 定价相近 + 少量 Venice 费用

Venice(匿名) vs 直接 API

方面Venice(匿名)直接 API
隐私元数据已剥离,已匿名化你的账号会关联
延迟+10-50ms(代理)直接
功能支持大多数功能完整功能
计费Venice credits提供方计费

使用示例

# 使用默认私有模型
openclaw agent --model venice/kimi-k2-5 --message "快速健康检查"

# 通过 Venice 使用 Claude Opus(匿名)
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 "重构这个函数"

故障排查

echo $VENICE_API_KEY
openclaw models list | grep venice
请确保密钥以 vapi_ 开头。
Venice 模型目录会动态更新。运行 openclaw models list 查看当前可用的模型。某些模型可能会暂时离线。
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,
          },
        ],
      },
    },
  },
}

相关内容

模型选择

选择提供方、模型引用和故障切换行为。

Venice AI

Venice AI 主页和账号注册。

API 文档

Venice API 参考与开发者文档。

定价

当前 Venice credit 费率和计划。