OpenClaw مع Ollama

تقدّم الوثائق Ollama على أنه أسهل طريق إلى نموذج محلي، وتبدأ صفحته بتحذير لا بترحيب: يتواصل OpenClaw مع واجهة API الأصلية لـ Ollama، وتوجيهه إلى الرابط المتوافق مع OpenAI يعطّل استدعاء الأدوات. هناك ثلاثة أوضاع مدعومة: السحابة مع المحلي عبر مضيف مسجّل الدخول، والسحابة فقط مع خدمة Ollama نفسها، والمحلي فقط. إليك ما يكتشفه الإعداد الأولي وما يرفض افتراضه، وقواعد المصادقة لكل نوع من المضيفات، وقائمة استكشاف الأخطاء، والقاعدة الخاصة بالنماذج الصغيرة التي لا تزول لمجرد أن النموذج مجاني.

لا تستخدم الرابط ⁨/v1⁩ المتوافق مع OpenAI (http://host:11434/v1). فهو يعطّل استدعاء الأدوات، وقد تصدر النماذج JSON استدعاءات الأدوات الخام كنص عادي.

الإعداد

• الإعداد الأولي: اختر Ollama ثم اختر وضعًا. في إعداد موجّه جديد، يفحص OpenClaw المضيف الافتراضي أو المهيأ، ولا يأخذ الاكتشاف التلقائي في الحسبان إلا النماذج المحمّلة بالفعل في الذاكرة، مع تأكيد دعم الأدوات وسياق لا يقل عن 16K؛ فالنموذج المثبت لكن الخامل ليس مرشحًا، والمسار يحتاج إلى إكمال حقيقي قبل حفظه، والاكتشاف لا ينزّل أي شيء ولا يحمّله أبدًا.
• يطلب وضع السحابة فقط مفتاح API ويقترح قيمًا افتراضية مستضافة؛ أما وضعا السحابة مع المحلي والمحلي فقط فيطلبان رابطًا أساسيًا ويفحصان النماذج المثبتة، وإذا لم يُعثر على نموذج يدعم الأدوات، فقد يطلب الإعداد الإذن بتنزيل نموذج موصى به. والنموذج المعلن أنه مخصص للتضمينات (embeddings) فقط لا يمكن أن يصبح النموذج الافتراضي للدردشة.
• يدويًا: ثبّت Ollama، ونزّل نموذجًا، وسجّل الدخول على المضيف نفسه للوصول السحابي الهجين، واضبط بيانات اعتماد (أي قيمة لمضيف محلي أو على شبكة LAN، والمفتاح الحقيقي لخدمة Ollama)، ثم اضبط مرجع النموذج على ollama، ثم شرطة مائلة، ثم اسم النموذج.

قواعد المصادقة

لا تحتاج مضيفات loopback والشبكات الخاصة والنطاقات المنتهية بـ ⁨.local⁩ وأسماء المضيفين المجردة إلى رمز bearer حقيقي؛ إذ يستخدم OpenClaw لها علامة محلية. أما المضيفات البعيدة العامة وخدمة Ollama فتحتاج إلى بيانات اعتماد حقيقية، وتفضّل الوثائق معرّف مزوّد السحابة المخصص للاستخدام المستضاف المباشر حتى يبقى توجيه السحابة منفصلًا عن المزوّد المحلي. ويُعامل مفتاح البيئة المجرد على أنه اصطلاح السحابة ولا يُرسل إلى المضيفات المحلية افتراضيًا، ومصادقة bearer لتضمينات الذاكرة مقصورة على المضيف الذي أُعلنت له.

استكشاف الأخطاء وإصلاحها

• حلقة الانهيار في WSL2: ينشئ مثبّت Linux الرسمي خدمة بإعداد restart always؛ وفي إعداد يستخدم CUDA قد تحمّل الخدمة نموذجًا أثناء الإقلاع، فتثبّت ذاكرة المضيف، فينهي Windows الجهاز الافتراضي، فتعيد التشغيل إلى ما لا نهاية. عطّل الخدمة، أو أوقف الاستعادة التلقائية للذاكرة في إعدادات WSL، أو شغّل Ollama يدويًا مع مدة keep-alive قصيرة.
• غير مكتشف: تأكد من أنه يعمل وأنه ضمن نطاق نماذج الوكيل؛ فالاكتشاف الضمني عبر localhost يحتاج إلى متغير المفتاح أو إلى ملف تعريف مصادقة، وقائمة النماذج اليدوية غير الفارغة تتخطى الاكتشاف كليًا.
• لا توجد نماذج: نزّل نموذجًا أو عرّفه صراحةً. رفض الاتصال: افحص العملية وأعد تشغيلها. طباعة JSON الأدوات كنص: إنه الرابط المتوافق مع OpenAI، الخطأ المذكور في أعلى الصفحة.

يأخذ Ollama مكانه إلى جانب LM Studio وllama.cpp والواجهات الخلفية الأخرى في صفحة النماذج المجانية لـ OpenClaw، ومن صفحة تثبيت OpenClaw على Windows يبدأ إعداد WSL2.

القاعدة التي لا تزال سارية

تقولها الأسئلة الشائعة عن النماذج جنبًا إلى جنب مع دليل البدء السريع لـ Ollama: النماذج الأصغر والمكمّمة بشدة أكثر عرضة لحقن الأوامر (prompt injection)، فاستخدم نماذج كبيرة لأي بوت لديه وصول إلى الأدوات، وإذا استخدمت نماذج صغيرة رغم ذلك، ففعّل البيئة المعزولة وقوائم سماح صارمة للأدوات. تشرح صفحة OpenClaw وحقن الأوامر الهجوم، أما الاحتواء فتشرحه صفحة دليل البيئة المعزولة في OpenClaw.

على Diali

على Diali، لا يوجد Ollama لتثبيته: النماذج موجودة في الكتالوج المدار وتُدفع تكلفتها من الرصيد المضمّن. المساعد هو OpenClaw المستضاف على Diali، وتعرض صفحة نماذج OpenClaw ومزوّديها ما يغطيه الكتالوج.

• واجهة API الأصلية، لا الرابط المتوافق مع OpenAI أبدًا.
• لا يرى الاكتشاف إلا النماذج المحمّلة؛ ولا ينزّل الإعداد شيئًا دون أن يسأل.
• المضيفات المحلية تحتاج إلى علامة، والبعيدة إلى مفتاح، والنماذج الصغيرة إلى بيئة معزولة.