Venice AI (Venice highlight)

Venice 是我们推荐的 Venice 隐私优先推理设置,可选地通过匿名化访问专有模型。

Venice AI 提供隐私优先的 AI 推理,支持未经审查的模型,并通过其匿名化代理访问主要的专有模型。所有推理默认都是私密的——不用于训练你的数据,不记录日志。

为什么在 OpenClaw 中使用 Venice

• 开源模型的私密推理(无日志记录)。
• 需要时的未经审查模型。
• 当质量重要时,匿名访问专有模型 (Opus/GPT/Gemini)。
• OpenAI 兼容的 /v1 端点。

隐私模式

Venice 提供两个隐私级别——理解这一点是选择模型的关键:

功能

• 隐私优先: 在"private"(完全私密)和"anonymized"(代理)模式之间选择
• 未经审查模型: 访问无内容限制的模型
• 主要模型访问: 通过 Venice 的匿名化代理使用 Claude, GPT-5.2, Gemini, Grok
• OpenAI 兼容 API: 标准 /v1 端点,便于集成
• Streaming (流式传输): ✅ 所有模型支持
• Function calling (函数调用): ✅ 选定模型支持(检查模型能力)
• Vision (视觉): ✅ 具有视觉能力的模型支持
• 无硬速率限制: 极端使用可能应用公平使用节流

设置

1. 获取 API Key

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

2. 配置 OpenClaw

选项 A: 环境变量

export VENICE_API_KEY="vapi_xxxxxxxxxxxx"

选项 B: 交互式设置 (推荐)

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

这将:

1. 提示输入你的 API key (或使用现有的 VENICE_API_KEY)
2. 显示所有可用的 Venice 模型
3. 让你选择默认模型
4. 自动配置 provider

选项 C: 非交互式

openclaw onboard --non-interactive \
  --auth-choice venice-api-key \
  --venice-api-key "vapi_xxxxxxxxxxxx"

3. 验证设置

openclaw chat --model venice/llama-3.3-70b "Hello, are you working?"

模型选择

设置后,OpenClaw 显示所有可用的 Venice 模型。根据你的需求选择:

• 默认(我们的选择): venice/llama-3.3-70b 用于私密、平衡的性能。
• 最佳整体质量: venice/claude-opus-45 用于困难任务(Opus 仍然是最强的)。
• 隐私: 选择"private"模型进行完全私密推理。
• 能力: 选择"anonymized"模型通过 Venice 代理访问 Claude, GPT, Gemini。

随时更改默认模型:

openclaw models set venice/claude-opus-45
openclaw models set venice/llama-3.3-70b

列出所有可用模型:

openclaw models list | grep venice

通过 openclaw configure 配置

1. 运行 openclaw configure
2. 选择 Model/auth
3. 选择 Venice AI

我应该使用哪个模型?

可用模型 (共 25 个)

Private 模型 (15 个) — 完全私密,无日志

Anonymized 模型 (10 个) — 通过 Venice 代理

模型发现

当设置了 VENICE_API_KEY 时,OpenClaw 会自动从 Venice API 发现模型。如果 API 不可达,它会回退到静态目录。

/models 端点是公开的(列出不需要认证),但推理需要有效的 API key。

Streaming (流式传输) 和工具支持

定价

Venice 使用基于积分的系统。查看 venice.ai/pricing 了解当前费率:

• Private 模型: 通常成本较低
• Anonymized 模型: 与直接 API 定价类似 + 小额 Venice 费用

对比: Venice vs 直接 API

使用示例

# 使用默认私密模型
openclaw chat --model venice/llama-3.3-70b

# 通过 Venice 使用 Claude (匿名化)
openclaw chat --model venice/claude-opus-45

# 使用未经审查模型
openclaw chat --model venice/venice-uncensored

# 使用视觉模型处理图像
openclaw chat --model venice/qwen3-vl-235b-a22b

# 使用编码模型
openclaw chat --model venice/qwen3-coder-480b-a35b-instruct

故障排除

API key 未识别

echo $VENICE_API_KEY
openclaw models list | grep venice

确保 key 以 vapi_ 开头。

模型不可用

Venice 模型目录动态更新。运行 openclaw models list 查看当前可用的模型。某些模型可能暂时离线。

连接问题

Venice API 地址是 https://api.venice.ai/api/v1。确保你的网络允许 HTTPS 连接。

配置文件示例

{
  env: { VENICE_API_KEY: "vapi_..." },
  agents: { defaults: { model: { primary: "venice/llama-3.3-70b" } } },
  models: {
    mode: "merge",
    providers: {
      venice: {
        baseUrl: "https://api.venice.ai/api/v1",
        apiKey: "${VENICE_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "llama-3.3-70b",
            name: "Llama 3.3 70B",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 131072,
            maxTokens: 8192
          }
        ]
      }
    }
  }
}

链接

• Venice AI
• API 文档
• 定价
• 状态