/v1).
Privacy modes
Getting started
1
Install the plugin
2
Get your API key
- Sign up at venice.ai
- Go to Settings > API Keys > Create new key
- Copy your API key (format:
vapi_xxxxxxxxxxxx)
3
Configure OpenClaw
- Interactive (recommended)
- Environment variable
- Non-interactive
VENICE_API_KEY), lists available Venice models, and sets your default model.4
Verify setup
Model selection
- Default:
venice/zai-org-glm-4.7(private reasoning). - Strongest anonymized option:
venice/claude-opus-5.
openclaw configure and pick Model/auth provider > Venice AI.
Built-in catalog (16 visible models)
Private models (10) — fully private, no logging
Private models (10) — fully private, no logging
Anonymized models (6) — via Venice proxy
Anonymized models (6) — via Venice proxy
grok-4-3 and similar) get the same tool-schema
compat patch as the native xAI provider, since they share the same upstream
tool-call format.
Model discovery
The bundled catalog above is a manifest-backed seed list. At runtime OpenClaw refreshes it from the Venice/models API and falls back to the seed list if
the API is unreachable. The /models endpoint is public (no auth needed for
listing), but inference requires a valid API key.
Venice may continue accepting retired model IDs as provider-owned aliases. The
OpenClaw catalog advertises only the canonical model IDs returned by /models.
DeepSeek V4 replay behavior
If Venice exposes DeepSeek V4 models such asdeepseek-v4-pro or
deepseek-v4-flash, OpenClaw fills the required reasoning_content replay
field on assistant messages when Venice omits it, and strips thinking/
reasoning/reasoning_effort from the request payload (Venice rejects
DeepSeek’s native thinking control on these models). This replay fix is
separate from the native DeepSeek provider’s own thinking controls.
Streaming and tool support
Pricing
Venice uses a credit-based system. Anonymized models cost roughly the same as direct API pricing plus a small Venice fee. See venice.ai/pricing for current rates. OpenClaw reads live prices from Venice’s publicGET /api/v1/models
response during model discovery. The same plugin parser supplies the hosted
catalog publisher. Known and newly discovered models use the API’s complete
schedule in USD per million tokens; the manifest prices are an offline seed.
Missing or invalid live prices retain the complete seed schedule for known
models. Unknown models without valid pricing keep zero estimates; that does not
mean the model is free. Explicit API zero rates are valid.
When the API supplies extended pricing, its rates apply to the entire request
only when total prompt input exceeds context_token_threshold. Prompt input
includes uncached input, cache reads, and cache writes; output tokens do not
select the tier. A request exactly at the threshold still uses base rates.
Base and extended rates always come from one schedule. An invalid extended
schedule is not combined with seed or other-source prices.
Explicit models.providers.venice.models[].cost entries override catalog
estimates, including zero. Omitted cost or {} inherits the catalog schedule.
Partial flat overrides inherit missing base rates and remove inherited tiers;
explicit tieredPricing wins, and tieredPricing: [] selects flat pricing.
Agent-local root models.json prices retain highest priority.
New onboarding in models.mode: "merge" leaves generated catalog rows out of the
configuration so they cannot become price pins. Re-onboarding preserves existing
model entries, aliases, and model selection. In models.mode: "replace",
onboarding retains explicit seed rows because that mode disables discovery.
Existing serialized costs are never automatically removed or migrated, even if
they match an old seed. With merge mode enabled, back up your configuration and
remove only unwanted cost fields to resume catalog pricing; keep intentional
overrides.
Discovery reuses its existing fetched rows and cache. Usage display makes no
price requests, and a running Gateway does not immediately adopt every upstream
price change. Hosted catalog updates activate at the existing restart boundary;
see Hosted model catalog.
Make sizing-only edits in your source configuration without copying generated
model rows back into it: replacing an entire model array from a runtime snapshot
can persist inherited costs as explicit overrides. Historical estimated costs
remain subject to the existing repricing policy; provider-billed amounts are
unchanged. See Token use and costs.
Usage examples
Troubleshooting
API key not recognized
API key not recognized
vapi_; do not print or
share its value.Model not available
Model not available
Run
openclaw models list --all --provider venice to see currently
available models; the catalog changes as Venice adds or retires models.Connection issues
Connection issues
Venice API is at
https://api.venice.ai/api/v1. Confirm your network allows HTTPS to that host.More help: Troubleshooting and FAQ.
Advanced configuration
Config file example
Config file example
Related
Model selection
Choosing providers, model refs, and failover behavior.
Venice AI
Venice AI homepage and account signup.
API documentation
Venice API reference and developer docs.
Pricing
Current Venice credit rates and plans.