سحابة Ollama

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
• عنوان URL الأساسي: https://ollama.com
• متغير البيئة: OLLAMA_API_KEY
• نمط API: واجهة Ollama الأصلية /api/chat
• نموذج الإعداد الأولي الافتراضي: ollama-cloud/kimi-k2.5:cloud

متى تختار Ollama Cloud

• تريد نماذج Ollama مستضافة من دون تشغيل ollama serve محليًا.
• تريد بنية واجهة API الأصلية نفسها لمحادثة Ollama التي يستخدمها OpenClaw مع Ollama المحلي، ولكن موجّهة إلى https://ollama.com.
• تريد مسارًا سحابيًا بسيطًا للنماذج الموجودة بالفعل في كتالوج Ollama المستضاف.
• لا تحتاج إلى تنزيل النماذج محليًا، أو التحكم في وحدة معالجة الرسومات المحلية، أو الاستدلال المحصور في الشبكة المحلية.

استخدم Ollama بدلًا من ذلك عندما تريد توجيهًا محليًا فقط أو هجينًا بين السحابة والمحلي عبر مضيف Ollama مسجّل الدخول. استخدم مزوّدًا متوافقًا مع OpenAI بدلًا من ذلك عندما تحتاج إلى دلالات /v1/chat/completions أو ميزات خاصة بالمزوّد على نمط 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 المخصّصين: تحقّق مما إذا كنت تستخدم عن طريق الخطأ عنوان URL متوافقًا مع OpenAI يتضمن /v1. يجب أن تستخدم مسارات Ollama عنوان URL الأساسي الأصلي من دون اللاحقة /v1.

ذو صلة

• Ollama
• مزوّدو النماذج
• جميع المزوّدين