venice-router

name	venice-router
version	1.5.0
description	Supreme model router for Venice.ai — the privacy-first, uncensored AI platform. Automatically classifies query complexity and routes to the cheapest adequate model. Supports web search, uncensored mode, private-only mode (zero data retention), conversation-aware routing, cost budgets, function calling, thinking/reasoning mode, and 35+ Venice.ai text models. Use when the user wants to chat via Venice.ai, send prompts through Venice, or needs smart model selection to minimize API costs while keeping data private from Big Tech.
homepage	https://venice.ai
source	https://github.com/PlusOne/venice.ai-router-openclaw
user-invocable	true
metadata	{"openclaw":{"emoji":"🦞🚀","homepage":"https://github.com/PlusOne/venice.ai-router-openclaw","os":["linux","macos"],"requires":{"bins":"[Truncated]","env":"[Truncated]"},"primaryEnv":"VENICE_API_KEY","optionalEnv":["VENICE_DEFAULT_TIER","VENICE_MAX_TIER","VENICE_TEMPERATURE","VENICE_MAX_TOKENS","VENICE_STREAM","VENICE_UNCENSORED","VENICE_PRIVATE_ONLY","VENICE_WEB_SEARCH","VENICE_THINKING","VENICE_DAILY_BUDGET","VENICE_SESSION_BUDGET"],"notes":"Python 3.8+ (stdlib only, no pip dependencies). All scripts bundled under scripts/. Source: https://github.com/PlusOne/venice.ai-router-openclaw","cliHelp":"python3 venice-router.py --help\nusage: venice-router.py [-h] [--prompt PROMPT] [--tier {cheap,budget,budget-medium,mid,high,premium}] [--model MODEL] [--classify CLASSIFY] [--list-models] [--stream] [--temperature TEMPERATURE] [--max-tokens MAX_TOKENS] [--system SYSTEM] [--prefer-anon] [--uncensored] [--private-only] [--web-search] [--character CHARACTER] [--json] [--thinking] [--conversation CONVERSATION] [--tools TOOLS] [--tool-choice TOOL_CHOICE] [--budget-status] [--session-id SESSION_ID]\nExamples: --prompt \"What is 2+2?\" | --tier mid --prompt \"Explain recursion\" | --stream --prompt \"Write a haiku\" | --web-search --prompt \"Latest AI news\" | --uncensored --prompt \"Creative fiction\" | --private-only --prompt \"Sensitive data\" | --thinking --prompt \"Prove the halting problem\" | --conversation history.json --prompt \"continue\" | --tools tools.json --prompt \"Get weather\" | --budget-status | --classify \"Design a microservices architecture\" | --list-models","install":["[Truncated]"]}}

Venice.ai Supreme Router

Smart, cost-optimized model routing for Venice.ai — the AI platform for people who don't want Big Tech watching over their shoulder.

Unlike OpenAI, Anthropic, and Google — where every prompt is logged, analyzed, and potentially used to train future models — Venice offers true privacy with zero data retention on private models. Your conversations stay yours. Venice is also uncensored: no content filters, no refusals, no "I can't help with that."

Setup

1. Get a Venice.ai API key from venice.ai/settings/api
2. Set the environment variable:

export VENICE_API_KEY="your-key-here"

Or configure in ~/.openclaw/openclaw.json:

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

Usage

Route a prompt (auto-selects model)

python3 {baseDir}/scripts/venice-router.py --prompt "What is 2+2?"

Force a specific tier

python3 {baseDir}/scripts/venice-router.py --tier cheap --prompt "Tell me a joke"
python3 {baseDir}/scripts/venice-router.py --tier budget-medium --prompt "Write a Python function"
python3 {baseDir}/scripts/venice-router.py --tier mid --prompt "Explain quantum computing"
python3 {baseDir}/scripts/venice-router.py --tier premium --prompt