Providers
Venice AI
Venice AI 提供以隱私為重點的推論服務:開放模型執行時
不記錄任何資料,並提供對 Claude、GPT、Gemini 和 Grok 的匿名化代理存取。
所有端點皆與 OpenAI 相容(/v1)。
隱私模式
| 模式 | 行為 | 模型 |
|---|---|---|
| 私密 | 提示與回應永不儲存或記錄,僅短暫存在。 | Llama、Qwen、DeepSeek、Kimi、MiniMax、Venice Uncensored 等。 |
| 匿名化 | 透過 Venice 代理,轉送前會移除中繼資料。 | Claude、GPT、Gemini、Grok |
開始使用
安裝外掛
openclaw plugins install @openclaw/venice-provider取得 API 金鑰
- 在 venice.ai 註冊
- 前往 Settings > API Keys > Create new key
- 複製你的 API 金鑰(格式:
vapi_xxxxxxxxxxxx)
設定 OpenClaw
互動式(建議)
openclaw onboard --auth-choice venice-api-key系統會提示輸入 API 金鑰(或重複使用現有的 VENICE_API_KEY)、列出可用的 Venice 模型,並設定預設模型。
環境變數
export VENICE_API_KEY="vapi_xxxxxxxxxxxx"非互動式
openclaw onboard --non-interactive \ --auth-choice venice-api-key \ --venice-api-key "vapi_xxxxxxxxxxxx"驗證設定
openclaw agent --model venice/kimi-k2-5 --message "Hello, are you working?"模型選擇
- 預設:
venice/kimi-k2-5(私密、推理、視覺)。 - 最強的匿名化選項:
venice/claude-opus-4-6。
openclaw models set venice/kimi-k2-5openclaw models list --all --provider venice你也可以執行 openclaw configure,然後選擇 模型/驗證供應商 > Venice AI。
內建目錄(38 個模型)
私密模型(26 個)— 完全私密、不記錄資料
| 模型 ID | 名稱 | 上下文 | 備註 |
|---|---|---|---|
kimi-k2-5 |
Kimi K2.5 | 256k | 預設、推理、視覺 |
kimi-k2-thinking |
Kimi K2 Thinking | 256k | 推理 |
llama-3.3-70b |
Llama 3.3 70B | 128k | 通用 |
llama-3.2-3b |
Llama 3.2 3B | 128k | 通用 |
hermes-3-llama-3.1-405b |
Hermes 3 Llama 3.1 405B | 128k | 通用、已停用工具 |
qwen3-235b-a22b-thinking-2507 |
Qwen3 235B Thinking | 128k | 推理 |
qwen3-235b-a22b-instruct-2507 |
Qwen3 235B Instruct | 128k | 通用 |
qwen3-coder-480b-a35b-instruct |
Qwen3 Coder 480B | 256k | 程式設計 |
qwen3-coder-480b-a35b-instruct-turbo |
Qwen3 Coder 480B Turbo | 256k | 程式設計 |
qwen3-5-35b-a3b |
Qwen3.5 35B A3B | 256k | 推理、視覺 |
qwen3-next-80b |
Qwen3 Next 80B | 256k | 通用 |
qwen3-vl-235b-a22b |
Qwen3 VL 235B(視覺) | 256k | 視覺 |
qwen3-4b |
Venice Small(Qwen3 4B) | 32k | 快速、推理 |
deepseek-v3.2 |
DeepSeek V3.2 | 160k | 推理、已停用工具 |
venice-uncensored |
Venice Uncensored(Dolphin-Mistral) | 32k | 無內容審查限制、已停用工具 |
mistral-31-24b |
Venice Medium(Mistral) | 128k | 視覺 |
google-gemma-3-27b-it |
Google Gemma 3 27B Instruct | 198k | 視覺 |
openai-gpt-oss-120b |
OpenAI GPT OSS 120B | 128k | 通用 |
nvidia-nemotron-3-nano-30b-a3b |
NVIDIA Nemotron 3 Nano 30B | 128k | 通用 |
olafangensan-glm-4.7-flash-heretic |
GLM 4.7 Flash Heretic | 128k | 推理 |
zai-org-glm-4.6 |
GLM 4.6 | 198k | 通用 |
zai-org-glm-4.7 |
GLM 4.7 | 198k | 推理 |
zai-org-glm-4.7-flash |
GLM 4.7 Flash | 128k | 推理 |
zai-org-glm-5 |
GLM 5 | 198k | 推理 |
minimax-m21 |
MiniMax M2.1 | 198k | 推理 |
minimax-m25 |
MiniMax M2.5 | 198k | 推理 |
匿名化模型(12 個)— 透過 Venice 代理
| 模型 ID | 名稱 | 上下文 | 備註 |
|---|---|---|---|
claude-opus-4-6 |
Claude Opus 4.6(透過 Venice) | 1M | 推理、視覺 |
claude-sonnet-4-6 |
Claude Sonnet 4.6(透過 Venice) | 1M | 推理、視覺 |
openai-gpt-54 |
GPT-5.4(透過 Venice) | 1M | 推理、視覺 |
openai-gpt-53-codex |
GPT-5.3 Codex(透過 Venice) | 400k | 推理、視覺、程式設計 |
openai-gpt-52 |
GPT-5.2(透過 Venice) | 256k | 推理 |
openai-gpt-52-codex |
GPT-5.2 Codex(透過 Venice) | 256k | 推理、視覺、程式設計 |
openai-gpt-4o-2024-11-20 |
GPT-4o(透過 Venice) | 128k | 視覺 |
openai-gpt-4o-mini-2024-07-18 |
GPT-4o Mini(透過 Venice) | 128k | 視覺 |
gemini-3-1-pro-preview |
Gemini 3.1 Pro(透過 Venice) | 1M | 推理、視覺 |
gemini-3-pro-preview |
Gemini 3 Pro(透過 Venice) | 198k | 推理、視覺 |
gemini-3-flash-preview |
Gemini 3 Flash(透過 Venice) | 256k | 推理、視覺 |
grok-41-fast |
Grok 4.1 Fast(透過 Venice) | 1M | 推理、視覺 |
以 Grok 為基礎的 Venice 模型(grok-41-fast 及類似模型)會套用與原生 xAI 供應商相同的工具結構描述
相容性修補,因為它們使用相同的上游
工具呼叫格式。
模型探索
上述內建目錄是由資訊清單支援的初始清單。OpenClaw 在執行階段
會從 Venice /models API 重新整理此清單;若
API 無法連線,則回退至初始清單。/models 端點為公開端點(列出模型
不需要驗證),但推論需要有效的 API 金鑰。
DeepSeek V4 重播行為
如果 Venice 提供 deepseek-v4-pro 或
deepseek-v4-flash 等 DeepSeek V4 模型,當 Venice 省略必要的 reasoning_content 重播
欄位時,OpenClaw 會在助理訊息中補上該欄位,並從請求承載資料中移除 thinking/
reasoning/reasoning_effort(Venice 會拒絕
這些模型使用 DeepSeek 原生的 thinking 控制項)。此重播修正
與原生 DeepSeek 供應商本身的思考控制項互相獨立。
串流與工具支援
| 功能 | 支援 |
|---|---|
| 串流 | 所有模型 |
| 函式呼叫 | 大多數模型;上述註明者會針對個別模型停用 |
| 視覺/圖片 | 上述標記為「視覺」的模型 |
| JSON 模式 | 透過 response_format |
定價
Venice 採用點數制。匿名化模型的費用約等於 直接使用 API 的價格,再加上一小筆 Venice 費用。請參閱 venice.ai/pricing 以取得目前費率。
使用範例
# Default private modelopenclaw agent --model venice/kimi-k2-5 --message "Quick health check" # Claude Opus via Venice (anonymized)openclaw agent --model venice/claude-opus-4-6 --message "Summarize this task" # Uncensored modelopenclaw agent --model venice/venice-uncensored --message "Draft options" # Vision model with imageopenclaw agent --model venice/qwen3-vl-235b-a22b --message "Review attached image" # Coding modelopenclaw agent --model venice/qwen3-coder-480b-a35b-instruct --message "Refactor this function"疑難排解
無法識別 API 金鑰
echo $VENICE_API_KEYopenclaw models list | grep venice確認金鑰以 vapi_ 開頭。
模型無法使用
執行 openclaw models list --all --provider venice 以查看目前
可用的模型;Venice 新增或淘汰模型時,目錄也會隨之變更。
連線問題
Venice API 位於 https://api.venice.ai/api/v1。請確認你的網路允許透過 HTTPS 連線至該主機。
進階設定
設定檔範例
{ env: { VENICE_API_KEY: "vapi_..." }, agents: { defaults: { model: { primary: "venice/kimi-k2-5" } } }, models: { mode: "merge", providers: { venice: { baseUrl: "https://api.venice.ai/api/v1", apiKey: "${VENICE_API_KEY}", api: "openai-completions", models: [ { id: "kimi-k2-5", name: "Kimi K2.5", reasoning: true, input: ["text", "image"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 256000, maxTokens: 65536, }, ], }, }, },}