Ollama Cloud

Ollama Cloud، API میزبانی‌شدهٔ مدل‌های Ollama است. ارائه‌دهندهٔ ollama-cloud آن را مستقیماً در https://ollama.com و از طریق API بومی /api/chat متعلق به Ollama فراخوانی می‌کند، بدون سرور محلی Ollama و بدون برنامهٔ محلی Ollama که به حالت ابری وارد شده باشد. از ارجاع‌های مدل مانند ollama-cloud/kimi-k2.6 استفاده کنید.

OpenClaw، ollama-cloud را به‌عنوان شناسهٔ ارائه‌دهندهٔ مستقل خود ثبت می‌کند تا اعتبارنامه‌های مختص فضای ابری، کشف زندهٔ کاتالوگ و انتخاب مدل با میزبان محلی ollama آمیخته نشوند. برای Ollama محلی، مسیریابی ترکیبی ابری و محلی، تعبیه‌ها و جزئیات میزبان سفارشی، به Ollama مراجعه کنید.

راه‌اندازی

یک کلید API برای Ollama Cloud در ollama.com/settings/keys ایجاد کنید، سپس دستور زیر را اجرا کنید:

openclaw onboard --auth-choice ollama-cloud

یا تنظیم کنید:

export OLLAMA_API_KEY="<your-ollama-cloud-api-key>" # pragma: allowlist secret

راه‌اندازی غیرتعاملی کلید را مستقیماً می‌پذیرد:

openclaw onboard --auth-choice ollama-cloud --ollama-cloud-api-key "<key>"

راه‌اندازی، مدل پیش‌فرض را روی ollama-cloud/kimi-k2.5:cloud تنظیم می‌کند.

پیش‌فرض‌ها

• ارائه‌دهنده: ollama-cloud
• نشانی پایه: https://ollama.com
• متغیر محیطی: OLLAMA_API_KEY
• سبک API: API بومی /api/chat متعلق به Ollama
• مدل پیش‌فرض راه‌اندازی: ollama-cloud/kimi-k2.5:cloud

چه زمانی Ollama Cloud را انتخاب کنید

• مدل‌های میزبانی‌شدهٔ Ollama را بدون اجرای محلی ollama serve می‌خواهید.
• همان ساختار API بومی گفت‌وگوی Ollama را می‌خواهید که OpenClaw برای Ollama محلی استفاده می‌کند، اما به https://ollama.com اشاره داشته باشد.
• برای مدل‌هایی که از قبل در کاتالوگ میزبانی‌شدهٔ Ollama قرار دارند، یک مسیر ابری ساده می‌خواهید.
• به دریافت محلی مدل، کنترل GPU محلی یا استنتاج فقط در LAN نیاز ندارید.

وقتی مسیریابی فقط محلی یا ترکیبی ابری و محلی را از طریق یک میزبان Ollama واردشده می‌خواهید، به‌جای آن از Ollama استفاده کنید. وقتی به معناشناسی /v1/chat/completions یا قابلیت‌های مختص ارائه‌دهنده به سبک OpenAI نیاز دارید، از یک ارائه‌دهندهٔ سازگار با OpenAI استفاده کنید.

مدل‌ها

ارائه‌دهنده به یک کلید API نیاز دارد؛ بدون آن غیرفعال می‌ماند. در صورت وجود کلید، OpenClaw مدل‌های Ollama Cloud را به‌صورت زنده از کاتالوگ میزبانی‌شده کشف می‌کند:

openclaw models list --provider ollama-cloudopenclaw models set ollama-cloud/kimi-k2.6

شناسه‌های میزبانی‌شده در کاتالوگ زنده شامل deepseek-v4-flash، glm-5، gpt-oss:20b، kimi-k2.6 و minimax-m2.7 هستند. وقتی کشف زنده چیزی برنگرداند، OpenClaw به ردیف‌های همراه kimi-k2.5:cloud، minimax-m2.7:cloud، glm-5.1:cloud و glm-5.2:cloud بازمی‌گردد.

شناسه‌های مدل، شناسه‌های کاتالوگ ابری هستند، نه نام‌های دریافت محلی. اگر نام مدلی در یک میزبان محلی Ollama کار می‌کند اما در کاتالوگ میزبانی‌شده وجود ندارد، به‌جای آن از ارائه‌دهندهٔ ollama با همان میزبان محلی استفاده کنید.

آزمون زنده

برای آزمون‌های دود کلید API مربوط به Ollama Cloud، آزمون زندهٔ Ollama را به نقطهٔ پایانی میزبانی‌شده هدایت کنید و مدلی را از کاتالوگ فعلی خود انتخاب کنید:

export OLLAMA_API_KEY="<your-ollama-cloud-api-key>" # pragma: allowlist secret OPENCLAW_LIVE_TEST=1 \OPENCLAW_LIVE_OLLAMA=1 \OPENCLAW_LIVE_OLLAMA_BASE_URL=https://ollama.com \OPENCLAW_LIVE_OLLAMA_MODEL=kimi-k2.6 \pnpm test:live -- extensions/ollama/ollama.live.test.ts

آزمون دود ابری، متن، جریان بومی و جست‌وجوی وب را اجرا می‌کند؛ برای نادیده‌گرفتن جست‌وجوی وب، OPENCLAW_LIVE_OLLAMA_WEB_SEARCH=0 را تنظیم کنید. این آزمون به‌طور پیش‌فرض تعبیه‌ها را برای https://ollama.com نادیده می‌گیرد، زیرا ممکن است کلیدهای API مربوط به Ollama Cloud مجوز /api/embed را نداشته باشند؛ برای اجرای اجباری آن‌ها، OPENCLAW_LIVE_OLLAMA_EMBEDDINGS=1 را تنظیم کنید.

عیب‌یابی

• خطاهای Ollama Cloud requires an API key / Set OLLAMA_API_KEY: یک کلید API واقعی فضای ابری ارائه کنید. نشانگر محلی ollama-local فقط برای میزبان‌های محلی یا خصوصی Ollama است.
• خطاهای مدل ناشناخته: openclaw models list --provider ollama-cloud را اجرا کنید و شناسهٔ مدل میزبانی‌شده را دقیقاً کپی کنید.
• مشکلات فراخوانی ابزار یا JSON خام در میزبان‌های سفارشی Ollama: بررسی کنید که آیا تصادفاً از نشانی /v1 سازگار با OpenAI استفاده می‌کنید. مسیرهای Ollama باید از نشانی پایهٔ بومی و بدون پسوند /v1 استفاده کنند.

مرتبط

• Ollama
• ارائه‌دهندگان مدل
• همهٔ ارائه‌دهندگان