跳转至

Venice AI

Venice AI 提供注重隐私的推理服务:开放模型无日志运行,并可通过匿名代理访问 Claude、GPT、Gemini 和 Grok。所有端点均兼容 OpenAI(/v1)。

隐私模式

模式 行为 模型
私有 提示/响应绝不会被存储或记录,具有临时性。 GLM、Gemma、Grok、Qwen、DeepSeek、Kimi、Venice Uncensored 等。
匿名 通过 Venice 代理,并在转发前剥离元数据。 Claude、GPT 及部分 Qwen 模型

Warning

匿名模型并非完全私密。Venice 会在转发前剥离元数据,但底层提供商(OpenAI、Anthropic、Google、xAI)仍会处理请求。如需完全私密,请使用私有模型。

快速开始

1. 安装插件

openclaw plugins install @openclaw/venice-provider

2. 获取你的 API 密钥

  1. 在 venice.ai 注册
  2. 前往 设置 > API 密钥 > 创建新密钥
  3. 复制你的 API 密钥(格式:vapi_xxxxxxxxxxxx)

3. 配置 OpenClaw

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

提示输入 API 密钥(或复用已有的 VENICE_API_KEY),列出可用的 Venice 模型,并设置默认模型。

export VENICE_API_KEY="vapi_xxxxxxxxxxxx"
openclaw onboard --non-interactive --accept-risk --skip-health \
  --auth-choice venice-api-key \
  --venice-api-key "vapi_xxxxxxxxxxxx"

4. 验证设置

openclaw agent --model venice/zai-org-glm-4.7 --message "Hello, are you working?"

模型选择

  • 默认:venice/zai-org-glm-4.7(私有推理)。
  • 最强匿名选项:venice/claude-opus-5。
openclaw models set venice/zai-org-glm-4.7
openclaw models list --all --provider venice

你还可以运行 openclaw configure,然后选择 模型/认证提供商 > Venice AI。

Tip

使用场景 模型 原因
一般聊天(默认) zai-org-glm-4.7 Venice 当前默认特质
最佳整体质量 claude-opus-5 当前主推的匿名 Opus 模型
隐私 + 编程 qwen3-coder-480b-a35b-instruct-turbo 具备大上下文的私有编程模型
快速且经济 google-gemma-4-31b-it 低成本主推私有视觉模型
复杂私有任务 deepseek-v3.2 主推私有推理模型
无审查 venice-uncensored-1-2 当前的 Venice 无审查模型

内置模型目录(16 个可见模型)

私有模型(10 个)——完全私有,无日志
模型 ID 名称 上下文 备注
zai-org-glm-5-2 GLM 5.2 1M 推荐,编程
zai-org-glm-4.7 GLM 4.7 198k 私有推理
venice-uncensored-1-2 Venice Uncensored 1.2 128k 最无审查,视觉
google-gemma-4-31b-it Google Gemma 4 31B Instruct 256k 推荐,视觉
kimi-k2-6 Kimi K2.6 256k 推荐,编程,视觉
deepseek-v3.2 DeepSeek V3.2 160k 推荐,推理
qwen3-235b-a22b-thinking-2507 Qwen3 235B Thinking 128k 默认推理
qwen3-coder-480b-a35b-instruct-turbo Qwen3 Coder 480B Turbo 256k 默认编程
qwen3-vl-235b-a22b Qwen3 VL 235B 128k 默认视觉
grok-4-5 Grok 4.5 500k 推荐,编程,视觉
匿名模型(6 个)——通过 Venice 代理
模型 ID 名称 上下文 备注
qwen-3-7-max Qwen 3.7 Max (via Venice) 1M 推荐,编程,视觉
qwen-3-7-plus Qwen 3.7 Plus (via Venice) 1M 推荐,编程,视觉
claude-fable-5 Claude Fable 5 (via Venice) 1M 推荐,编程,视觉
claude-opus-5 Claude Opus 5 (via Venice) 1M 推荐,编程,视觉
claude-sonnet-4-6 Claude Sonnet 4.6 (via Venice) 1M 推荐,编程,视觉
openai-gpt-56-sol GPT-5.6 Sol (via Venice) 1M 推荐,视觉
已弃用的兼容行(3 个)——从模型选择器中隐藏
模型 ID 替代模型
zai-org-glm-4.6 zai-org-glm-4.7
google-gemma-3-27b-it google-gemma-4-31b-it
模型 ID 替换
kimi-k2-5 kimi-k2-6

由 Grok 支持的 Venice 模型(grok-4-5 及类似模型)会获得与原生 xAI 提供商相同的工具架构兼容补丁,因为它们共享相同的上游工具调用格式。

模型发现

上述内置目录是由清单支持的种子目录。在运行时,OpenClaw 会从 Venice /models API 刷新它,如果 API 不可达,则回退到种子目录。/models 端点是公开的(列出模型无需身份验证),但推理需要有效的 API 密钥。

Venice 可能继续接受已退役的模型 ID,作为提供商拥有的别名。OpenClaw 目录仅展示 /models 返回的规范模型 ID。

DeepSeek V4 重放行为

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

流式与工具支持

功能 支持
流式 所有模型
函数调用 所有可见种子模型;实时行遵循 API 元数据
视觉/图像 上方标记为“Vision”的模型
JSON 模式 通过 response_format

Prompt 缓存

对于原生 https://api.venice.ai/api/v1 端点,OpenClaw 会为相关请求发送稳定的 prompt_cache_key,以提高缓存亲和性。显式请求缓存键优先于会话 ID。设置 cacheRetention: "none" 会抑制此路由提示;它不会禁用 Venice 的自动缓存。自定义端点保留其配置的行为。Venice 管理特定于提供商的缓存,包括 Claude 缓存标记。参见 Venice Prompt 缓存。

定价

Venice 使用基于积分的系统。匿名模型的成本大致与直接 API 定价加上少量 Venice 费用相同。当前费率参见 venice.ai/pricing。

OpenClaw 在模型发现期间从 Venice 公开的 GET /api/v1/models 响应中读取实时价格。同一插件解析器为托管目录发布器提供数据。已知和新发现的模型使用 API 的完整价格表,以每百万 Token 的美元计价;种子目录价格是离线回退。缺失或无效的实时价格会保留已知模型的完整种子目录价格表。没有有效定价的未知模型保留零估算;这并不意味着模型免费。API 中明确的零费率是有效的。

当 API 提供扩展定价时,其费率仅在总 Prompt 输入超过 context_token_threshold 时应用于整个请求。Prompt 输入包括未缓存输入、缓存读取和缓存写入;输出 Token 不选择层级。恰好处于阈值的请求仍使用基础费率。基础费率和扩展费率始终来自同一价格表。无效的扩展价格表不会与种子目录或其他来源的价格组合。

显式的 models.providers.venice.models[].cost 条目会覆盖目录估算,包括零。省略 cost 或 {} 会继承目录价格表。部分固定覆盖会继承缺失的基础费率并移除继承的层级;显式 tieredPricing 优先,而 tieredPricing: [] 选择固定定价。Agent 本地根 models.json 价格保留最高优先级。

在 models.mode: "merge" 下,新的引导流程会将生成的目录行排除在配置之外,因此它们不会成为价格固定项。重新引导会保留现有模型条目、别名和模型选择。在 models.mode: "replace" 下,引导会保留显式种子目录行,因为该模式禁用发现。现有序列化成本永远不会自动移除或迁移,即使它们匹配旧的种子目录条目。启用合并模式时,请备份配置,并仅移除不需要的 cost 字段以恢复目录定价;保留有意设置的覆盖。

发现会重用其已获取的现有行和缓存。用量显示不会发出价格请求,正在运行的 Gateway 也不会立即采用所有上游价格变更。托管目录行和价格会在 Gateway 准备替换版本后一起激活,无需重启;参见 托管模型目录。请在源配置中仅进行容量相关编辑,不要将生成的模型行复制回配置中:从运行时快照替换整个模型数组可能会将继承的成本持久化为显式覆盖。历史记录的成本会被保留;当前定价仅填充缺失的成本或未知价格的零占位符。参见 Token 使用与成本。

使用示例

# Default private model
openclaw agent --model venice/zai-org-glm-4.7 --message "Quick health check"

# Claude Opus via Venice (anonymized)
openclaw agent --model venice/claude-opus-5 --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 密钥未识别
openclaw models list --provider venice

确认 API 密钥已配置并以 vapi_ 开头;不要打印或共享其值。

模型不可用

运行 openclaw models list --all --provider venice 查看当前可用模型;目录会随着 Venice 添加或停用模型而变化。

连接问题

Venice API 位于 https://api.venice.ai/api/v1。请确认您的网络允许向该主机发起 HTTPS 请求。

Note

更多帮助:故障排除 和 常见问题。

高级配置

配置文件示例
{
  env: { vars: { VENICE_API_KEY: "vapi_..." } },
  agents: { defaults: { model: { primary: "venice/zai-org-glm-4.7" } } },
  models: {
    mode: "merge",
    providers: {
      venice: {
        baseUrl: "https://api.venice.ai/api/v1",
        apiKey: "${VENICE_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "zai-org-glm-4.7",
            name: "GLM 4.7",
            reasoning: true,
            input: ["text"],
            contextWindow: 198000,
            maxTokens: 16384,
          },
        ],
      },
    },
  },
}

模型选择

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

Venice AI

Venice AI 主页和账户注册。

API 文档

Venice API 参考和开发者文档。

定价

当前 Venice 积分费率和套餐。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw