Venice.ai Supreme Router

面向 Venice.ai 的智能、成本优化模型路由方案 —— 专为拒绝 Big Tech 在身后窥探的用户打造的人工智能平台。

与 OpenAI、Anthropic 和 Google 不同（在这些平台中，每条提示词均会被记录、分析，并可能用于训练后续模型），Venice 提供真正的隐私保护：私有模型零数据留存。您的对话完全属于您自己。Venice 同样是无审查的：不设内容过滤器、不拒绝请求、不会回复“我无法协助该请求”。

安装配置

1. 前往 venice.ai/settings/api 获取 Venice.ai API 密钥
2. 设置环境变量：

export VENICE_API_KEY="your-key-here"

或在 ~/.openclaw/openclaw.json 中配置：

{
  "skills": {
    "entries": {
      "venice-router": {
        "enabled": true,
        "apiKey": "YOUR_VENICE_API_KEY"
      }
    }
  }
}

使用方法

路由提示词（自动选择模型）

python3 {baseDir}/scripts/venice-router.py --prompt "2+2 等于多少？"

强制指定层级

python3 {baseDir}/scripts/venice-router.py --tier cheap --prompt "讲个笑话"
python3 {baseDir}/scripts/venice-router.py --tier budget-medium --prompt "写一个 Python 函数"
python3 {baseDir}/scripts/venice-router.py --tier mid --prompt "解释量子计算"
python3 {baseDir}/scripts/venice-router.py --tier premium --prompt "设计一套分布式系统架构"

流式输出

python3 {baseDir}/scripts/venice-router.py --stream --prompt "写一首关于龙虾的诗"

网络搜索（LLM 自动联网检索并标注引用来源）

python3 {baseDir}/scripts/venice-router.py --web-search --prompt "人工智能监管最新进展"

无审查模式（优先选用无内容过滤器的模型）

python3 {baseDir}/scripts/venice-router.py --uncensored --prompt "创作一篇风格尖锐的创意小说"

仅私有模型模式（零数据留存，不通过任何 Big Tech 代理）

python3 {baseDir}/scripts/venice-router.py --private-only --prompt "分析这份保密合同"

上下文感知路由（支持多轮对话上下文）

# 将对话历史保存为 JSON 文件，随后带上下文执行后续请求
python3 {baseDir}/scripts/venice-router.py --conversation history.json --prompt "你也能一并加上测试用例吗？"

路由器会分析完整对话历史以维持上下文：简单跟进（如“谢谢”）自动降级至低成本层级；而在复杂代码讨论中的跟进请求则保持在合适层级。

函数调用（工具调用）

# 在 JSON 文件中定义工具（采用 OpenAI 工具格式）
python3 {baseDir}/scripts/venice-router.py --tools tools.json --prompt "纽约市当前天气如何？"
python3 {baseDir}/scripts/venice-router.py --tools tools.json --tool-choice auto --prompt "搜索最新的人工智能新闻"

工具定义采用标准 OpenAI 格式。由于函数调用需依赖能力更强的模型，路由器将自动将层级提升至最低 mid 级别。

成本预算追踪

# 查看当前支出情况
python3 {baseDir}/scripts/venice-router.py --budget-status

# 追踪单次会话开销
python3 {baseDir}/scripts/venice-router.py --session-id my-project --prompt "帮我写代码"

设置 VENICE_DAILY_BUDGET 和/或 VENICE_SESSION_BUDGET 可强制执行支出限额。当接近预算上限时，路由器将自动降级所选模型层级。

仅分类（不发起 API 调用）

python3 {baseDir}/scripts/venice-router.py --classify "解释黎曼猜想"

列出可用模型及对应层级

python3 {baseDir}/scripts/venice-router.py --list-models

直接覆盖模型选择

python3 {baseDir}/scripts/venice-router.py --model deepseek-v3.2 --prompt "你好"

层级说明

路由策略

路由器通过关键词 + 启发式分析对每条提示词进行分类：

1. 长度 — 更长的提示词往往意味着更复杂的任务
2. 关键词 — 领域专用术语（例如“architecture”、“optimize”、“prove”）指示任务复杂度
3. 代码标记 — 是否包含代码块、函数名或技术语法
4. 指令深度 — 多步骤指令、对比要求或“详细解释”类措辞将提升层级
5. 对话简洁性 — 问候语、是非问答、闲聊类内容始终保留在最廉价层级
6. 对话历史 — 当提供 --conversation 参数时，路由器分析完整聊天上下文：历史中若含代码，则提升层级；简单跟进（如“thanks”）则降级；历史中存在工具调用则视为高复杂度信号
7. 函数调用 — 使用 --tools 参数时，自动将层级提升至至少 mid（因需具备相应能力的模型）
8. 思维/推理模式 — --thinking 参数优先选用链式思维（chain-of-thought）推理模型（如 Qwen3 Thinking、Kimi K2），并至少升至 mid 层级
9. 预算约束 — 随着支出逼近日/会话限额，逐级降级（95% → cheap，80% → budget，60% → mid，40% → high）

分类器默认倾向更低成本模型 —— 仅在存在明确复杂度信号时才主动升级。

环境变量

为何选择 Venice.ai？

• 🔒 私有推理 —— 标注为“Private”的模型实行零数据留存。您的数据绝不会用于训练任何人的模型。
• 🔓 无审查 —— 不设护栏限制合理使用场景。不拒绝请求、不启用过滤器。
• 🔌 兼容 OpenAI 接口 —— 使用相同 API 格式，仅需更改 base URL 即可无缝替换。
• 📦 支持 30+ 模型 —— 覆盖轻量高效模型（$0.05/M token）至 Claude Opus 4.6 与 GPT-5.2。
• 🌐 内置网络搜索 —— LLM 可通过单次 API 调用完成网络检索并标注引用来源。

使用建议

• 使用 --classify 在实际消耗 token 前预览提示词将匹配的层级
• 设置 VENICE_MAX_TIER=mid 以控制成本，避免调用 premium 级模型
• 使用 --uncensored 处理创意写作、安全研究或其他主流 AI 拒绝处理的内容
• 处理敏感/机密数据时启用 --private-only —— 零数据留存得到保障
• 需要获取时效性强且附带引用的信息时，使用 --web-search
• 配合 JSON 格式消息历史文件使用 --conversation，实现更智能的多轮对话路由
• 使用 --tools 启用函数调用功能 —— 路由器将自动切换至具备能力的模型
• 设置 VENICE_DAILY_BUDGET=1.00 将日支出上限设为 1 美元 —— 接近限额时路由器自动降级模型层级
• 使用 --budget-status 查看按层级划分的详细支出明细
• 使用 --thinking 处理数学证明、逻辑谜题及多步推理任务 —— 自动路由至 Qwen3 Thinking 或 Kimi K2 模型
• 在相同层级下，路由器优先选用私有（自托管）Venice 模型，而非匿名化模型
• 启用 --uncensored 后，路由器将自动升至最近支持无审查模型的层级
• 结合 OpenClaw WebChat 使用，获得通过 Venice.ai 路由的无缝聊天体验