OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Venice AI

Venice AI استنتاج متمرکز بر حریم خصوصی ارائه می‌دهد: مدل‌های باز بدون ثبت گزارش اجرا می‌شوند، به‌علاوه دسترسی پروکسی ناشناس‌شده به Claude، GPT، Gemini و Grok. همه نقاط پایانی با OpenAI سازگارند (/v1).

حالت‌های حریم خصوصی

حالت رفتار مدل‌ها
خصوصی پرامپت‌ها/پاسخ‌ها هرگز ذخیره یا ثبت نمی‌شوند. موقتی است. Llama، Qwen، DeepSeek، Kimi، MiniMax، Venice Uncensored و غیره
ناشناس‌شده پیش از ارسال، از طریق Venice پروکسی می‌شود و فراداده‌ها حذف می‌شوند. Claude، GPT، Gemini، Grok

شروع به کار

  • نصب Plugin

    bash
    openclaw plugins install @openclaw/venice-provider

  • دریافت کلید API

    1. در venice.ai ثبت‌نام کنید
    2. به Settings > API Keys > Create new key بروید
    3. کلید API خود را کپی کنید (قالب: vapi_xxxxxxxxxxxx)

  • پیکربندی OpenClaw

    تعاملی (توصیه‌شده)

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

    کلید API را درخواست می‌کند (یا از VENICE_API_KEY موجود دوباره استفاده می‌کند)، مدل‌های Venice در دسترس را فهرست می‌کند و مدل پیش‌فرض را تنظیم می‌کند.

    متغیر محیطی

    bash
    export VENICE_API_KEY="vapi_xxxxxxxxxxxx"

    غیرتعاملی

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

  • تأیید راه‌اندازی

    bash
    openclaw agent --model venice/kimi-k2-5 --message "سلام، کار می‌کنی؟"

    • انتخاب مدل

    • پیش‌فرض: venice/kimi-k2-5 (خصوصی، استدلال، بینایی).
    • قوی‌ترین گزینه ناشناس‌شده: venice/claude-opus-4-6.
    bash
    openclaw models set venice/kimi-k2-5openclaw models list --all --provider venice

    همچنین می‌توانید openclaw configure را اجرا کنید و ارائه‌دهنده مدل/احراز هویت > Venice AI را انتخاب کنید.

    کاتالوگ داخلی (30 مدل)

    مدل‌های خصوصی (20) — کاملاً خصوصی، بدون ثبت گزارش
    شناسه مدل نام زمینه یادداشت‌ها
    kimi-k2-5 Kimi K2.5 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-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 (Vision) 256k بینایی
    deepseek-v3.2 DeepSeek V3.2 160k استدلال، ابزارها غیرفعال‌اند
    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-m25 MiniMax M2.5 198k استدلال
    مدل‌های ناشناس‌شده (10) — از طریق پروکسی Venice
    شناسه مدل نام زمینه یادداشت‌ها
    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-flash-preview Gemini 3 Flash (از طریق Venice) 256k استدلال، بینایی

    مدل‌های Venice مبتنی بر Grok (grok-4-3 و موارد مشابه) همان وصله سازگاری طرح‌واره ابزار را که ارائه‌دهنده بومی xAI دارد دریافت می‌کنند، زیرا قالب فراخوانی ابزار بالادستی یکسانی دارند.

    کشف مدل

    کاتالوگ همراه بالا، فهرست اولیه‌ای مبتنی بر مانیفست است. OpenClaw هنگام اجرا آن را از API ‏/models متعلق به Venice تازه‌سازی می‌کند و اگر API در دسترس نباشد، به فهرست اولیه بازمی‌گردد. نقطه پایانی /models عمومی است (برای فهرست‌کردن نیازی به احراز هویت نیست)، اما استنتاج به کلید API معتبر نیاز دارد.

    ممکن است Venice همچنان شناسه‌های مدل بازنشسته را به‌عنوان نام‌های مستعار متعلق به ارائه‌دهنده بپذیرد. کاتالوگ OpenClaw فقط شناسه‌های متعارف مدل را که /models برمی‌گرداند، اعلام می‌کند.

    رفتار بازپخش DeepSeek V4

    اگر Venice مدل‌های DeepSeek V4 مانند deepseek-v4-pro یا deepseek-v4-flash را ارائه کند، OpenClaw در صورتی که Venice فیلد بازپخش الزامی reasoning_content را حذف کرده باشد، آن را در پیام‌های دستیار تکمیل می‌کند و thinking/ reasoning/reasoning_effort را از محموله درخواست حذف می‌کند (Venice کنترل بومی thinking متعلق به DeepSeek را در این مدل‌ها رد می‌کند). این اصلاح بازپخش از کنترل‌های تفکر خود ارائه‌دهنده بومی DeepSeek جداست.

    پشتیبانی از جریان و ابزار

    قابلیت پشتیبانی
    جریان همه مدل‌ها
    فراخوانی تابع بیشتر مدل‌ها؛ در موارد اشاره‌شده در بالا، برای هر مدل غیرفعال است
    بینایی/تصاویر مدل‌هایی که در بالا با «بینایی» مشخص شده‌اند
    حالت JSON از طریق response_format

    قیمت‌گذاری

    Venice از سامانه‌ای مبتنی بر اعتبار استفاده می‌کند. هزینه مدل‌های ناشناس‌شده تقریباً برابر با قیمت‌گذاری مستقیم API به‌علاوه کارمزد اندکی برای Venice است. برای نرخ‌های فعلی، venice.ai/pricing را ببینید.

    نمونه‌های استفاده

    bash
    # مدل خصوصی پیش‌فرضopenclaw agent --model venice/kimi-k2-5 --message "بررسی سریع سلامت" # Claude Opus از طریق Venice (ناشناس‌شده)openclaw agent --model venice/claude-opus-4-6 --message "این وظیفه را خلاصه کن" # مدل بدون سانسورopenclaw agent --model venice/venice-uncensored-1-2 --message "گزینه‌ها را پیش‌نویس کن" # مدل بینایی با تصویرopenclaw agent --model venice/qwen3-vl-235b-a22b --message "تصویر پیوست‌شده را بررسی کن" # مدل کدنویسیopenclaw agent --model venice/qwen3-coder-480b-a35b-instruct-turbo --message "این تابع را بازآرایی کن"

    عیب‌یابی

    کلید API شناسایی نمی‌شود
    bash
    echo $VENICE_API_KEYopenclaw models list | grep venice

    تأیید کنید که کلید با vapi_ شروع می‌شود.

    مدل در دسترس نیست

    برای دیدن مدل‌هایی که اکنون در دسترس‌اند، openclaw models list --all --provider venice را اجرا کنید؛ با افزودن یا بازنشسته‌کردن مدل‌ها توسط Venice، کاتالوگ تغییر می‌کند.

    مشکلات اتصال

    API ‏Venice در https://api.venice.ai/api/v1 قرار دارد. تأیید کنید که شبکه شما HTTPS به آن میزبان را مجاز می‌داند.

    پیکربندی پیشرفته

    نمونه فایل پیکربندی
    json5
    {  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,          },        ],      },    },  },}

    مرتبط

    انتخاب مدل

    انتخاب ارائه‌دهندگان، ارجاع‌های مدل و رفتار جایگزینی هنگام خرابی.
    Venice AI

    صفحهٔ اصلی Venice AI و ثبت‌نام حساب.
    مستندات API

    مرجع API و مستندات توسعه‌دهندگان Venice.
    قیمت‌گذاری

    نرخ‌های فعلی اعتبار و طرح‌های Venice.
    Was this useful?
    On this page

    On this page