وكيل OpenClaw للذكاء الاصطناعي: التثبيت والتأمين والمراقبة

وكيل OpenClaw للذكاء الاصطناعي مفتوح المصدر: التثبيت بحسب README، ومخاطر الصلاحيات والعزل، وتصدير OpenTelemetry، والتدقيق والتكاليف.
OpenClaw agent IA : installer, sécuriser, superviser

وكيل OpenClaw للذكاء الاصطناعي هو اسم مساعد مفتوح المصدر تثبّته على حاسوبك الخاص، فيردّ داخل تطبيقات المراسلة التي تستخدمها أصلًا (WhatsApp وTelegram وSlack وDiscord وTeams وiMessage وأكثر من عشرين تطبيقًا آخر بحسب README). كان مستودع openclaw/openclaw يعرض نحو 392 000 نجمة في منتصف أكتوبر 2026، ما يجعله من أكثر مشاريع GitHub متابعة. ويكفي سطر واحد لوصفه: «The AI that really does things. Any OS. Any Platform.»

الجزء الذي يعنينا هو «يفعل». فالوكيل الذي يقرأ الملفات وينفّذ الأوامر ويكتب في تطبيقات المراسلة خدمة تشغيلية كأي خدمة أخرى: يستهلك الرموز (tokens) ويفشل وله صلاحيات. يعرض هذا المقال المشروع بوقائع مؤرَّخة، ويلخّص التثبيت بحسب README، ثم يفصّل ما يهمّ مهندس SRE: تتبعات OpenTelemetry وسجل التدقيق ومتابعة التكاليف وإعدادات الأمان الواجب ضبطها قبل أي كشف للخدمة.

يعتمد ما يلي على README والوثائق الرسمية للمشروع. لم تثبّت span.observer البرنامج: الصور مأخوذة من وثائق المشروع وأمثلته، وليست من تجربة شخصية.

وكيل OpenClaw للذكاء الاصطناعي: ما يقوله المستودع

  • الترخيص: MIT، مع عبارة «Copyright (c) 2026 OpenClaw Foundation» في ملف LICENSE.
  • الحوكمة: يذكر README أن المشروع تديره مؤسسة OpenClaw Foundation، وهي منظمة من نوع 501(c)(3)، توظّف الفريق الرئيسي وتوقّع الإصدارات. ويوضح أنه لا يوجد عرض مدفوع ولا خدمة مستضافة ولا رمز مميّز (token)، وأن OpenAI جهة مانحة وليست مالكة.
  • التقنية: مشروع Node.js وTypeScript (مساحة عمل pnpm)، ويتطلب التثبيت عبر npm الإصدار Node 24.16 أو أحدث.
  • آخر إصدار: v2026.10.4، نُشر في 16 أكتوبر 2026 بحسب صفحة الإصدارات. وإيقاع النشر سريع جدًا.
  • البنية: يعمل Gateway محلي كمستوى تحكم (الجلسات والأدوات والأحداث والاتصال بتطبيقات المراسلة). وترتبط به واجهة الويب (Control UI) وسطر الأوامر وTUI، إضافة إلى تطبيقات مرافقة لأنظمة macOS وiOS وAndroid وWindows وLinux.
  • النماذج: Claude وCodex والنماذج المحلية إضافات (plugins) قابلة للاستبدال بحسب README.

يتبنى README موقفًا من الخصوصية: تبقى الحالة والذاكرة وبيانات الاعتماد على الجهاز؛ وتنتقل المُوجّهات (prompts) إلى مزوّد النماذج ومنصات الدردشة التي تضبطها؛ وبشكل افتراضي لا يرسل OpenClaw سوى فحص إصدار يومي، ويعطّله الإعداد update.checkOnStart: false.

تثبيت OpenClaw خطوة بخطوة

الأوامر التالية هي أوامر README. اقرأ السكربت قبل تنفيذه: الأمر «curl | bash» يسلّم التحكم لمحتواه.

الخطوة 1 — التثبيت

# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

# إذا كان Node.js مُدارًا مسبقًا (Node 24.16+ أو 26.1+)
npm install -g openclaw@latest --allow-scripts=openclaw

يوضح README أن الخيار --allow-scripts=openclaw صالح مع npm 12 أو npm 11.16 وما بعده؛ أما مع npm 11.15 وما قبله فيجب حذفه.

الخطوة 2 — الإعداد الأولي والتحقق

openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard

يتحقق الإعداد الأولي من الوصول إلى النموذج، وينشئ مساحة العمل، ويضبط Gateway؛ ويفتح الأمر openclaw dashboard واجهة Control UI، حيث تؤكد رسالة اختبار أن المساعد يردّ.

الأمان: وكيل يملك صلاحيات على جهازك

يقولها README بلا مواربة: الرسائل الواردة مدخلات غير موثوقة، وتُنفَّذ الأدوات على المضيف (host) في الجلسة الرئيسية ما لم تضبط العزل (sandboxing). وتقوم الرسائل المباشرة بإقران المرسلين المجهولين افتراضيًا (openclaw pairing approve <channel> <code>). وتضيف وثائق الأمان أنه في تثبيت عادي على المضيف يستمع Gateway على الواجهة المحلية (loopback)، وأن صور الحاويات تكشف المنفذ الافتراضي: عندها تلزم المصادقة.

  • شغّل openclaw security audit (الخيار --deep لفحوص Gateway أثناء تشغيله): تصفه الوثائق بأنه تدقيق لأخطاء الإعداد الشائعة.
  • نموذج الثقة هو «مشغّل واحد لكل Gateway». وللمستخدمين الذين لا يثق بعضهم ببعض، تطلب الوثائق Gateways وبيانات اعتماد منفصلة، ويفضَّل حسابات نظام منفصلة.
  • اعزل التنفيذ: تصف الوثائق OpenShell كواجهة خلفية (backend) مُدارة للعزل، بمتطلبات إصدار محددة؛ راجع مقالنا عن NVIDIA OpenShell.
  • أبقِ الأسرار خارج الجلسة: لا رمز شخصيًا ولا مفتاح إنتاج على المضيف الذي ينفّذ الوكيل.

مراقبة OpenClaw: OpenTelemetry والتدقيق والتكاليف

ضوابط الحماية (guardrails) تُقاس (راجع ضوابط الحماية لوكلاء الذكاء الاصطناعي في الإنتاج)، والتكلفة كذلك (راجع تكلفة وكيل الذكاء الاصطناعي). ويوفّر OpenClaw ما يلزم للأمرين دون برمجة إضافية.

تتبعات ومقاييس وسجلات OTLP

يمرّ تصدير OpenTelemetry عبر إضافة هي diagnostics-otel (openclaw plugins install clawhub:@openclaw/diagnostics-otel). وتعطي الوثائق هذا الإعداد المبدئي:

مقتطف من وثائق OpenClaw: كتلة إعداد diagnostics.otel مع endpoint عنوانه http://otel-collector:4318 وبروتوكول http/protobuf وserviceName بقيمة openclaw-gateway وتفعيل التتبعات والمقاييس والسجلات وsampleRate بقيمة 0.2
  • يُقبل البروتوكول http/protobuf فقط؛ وقد أُزيل gRPC. تُفعَّل التتبعات والمقاييس بمجرد أن تصبح قيمة diagnostics.otel.enabled صحيحة؛ وتبقى السجلات معطّلة ما لم تُضبط logs صراحةً على true.
  • تشمل مقاييس الكتالوج openclaw.tokens (عدّاد لكل قناة ومزوّد ونموذج ووكيل) وopenclaw.cost.usd (عدّاد لكل قناة ومزوّد ونموذج) وopenclaw.run.duration_ms (مخطط تكراري). أما المقياسان القياسيان gen_ai.client.token.usage وgen_ai.client.operation.duration فيحتفظان باسميهما.
  • تغطي التتبعات استخدام النماذج واستدعاءات الأدوات وتنفيذ الأوامر وحلقات الأدوات. أما المحتوى الخام (المُوجّهات والردود ووسائط الأدوات) فلا يُصدَّر افتراضيًا؛ ولا ينبغي ضبط captureContent على true إلا بعد التحقق من سياسة الاحتفاظ بالبيانات (retention) لدى المُجمِّع.
  • لا يُصدّر تنفيذ openclaw agent exec أي قياسات عن بُعد؛ استخدم Gateway أو openclaw agent --local للحصول على التتبعات.

يُضبط Collector والوجهة (Dynatrace SaaS عبر OTLP أو Grafana أو Langfuse) كما يُضبطان لأي خدمة؛ راجع Langfuse وOpenLLMetry. وفي Dynatrace Managed لا يوجد DQL: التزم بمسار Prometheus أو بواجهة خلفية مفتوحة المصدر.

سجل التدقيق: من شغّل ماذا

يحتفظ Gateway بسجل تدقيق مفعّل افتراضيًا، يقتصر على البيانات الوصفية: الهوية والطابع الزمني واسم الأداة والنتيجة الموحّدة، ولا يسجّل أبدًا المُوجّهات أو الوسائط أو النتائج. تنتهي صلاحية السجلات بعد 30 يومًا، ويُحدَّد السجل بسقف 100 000 سطر؛ وتوضح الوثائق أن الكتابة «best-effort» وليست أرشيف امتثال.

أوامر openclaw audit مأخوذة من الوثائق: مرشّحات بحسب الوكيل والحالة والجلسة والتنفيذ والنوع tool_action أو message، مع خرج JSON

كيف تتحقق من أنه يعمل

  • يعرض openclaw doctor وopenclaw status --all حالة تصدير محجوبة البيانات لكل إشارة؛ ولا يعرضان نقطة الاتصال ولا الترويسات.
  • بعد رسالة اختبار يظهر تتبّع في الواجهة الخلفية باسم الخدمة الذي حدّدته، ويزداد العدّاد openclaw.tokens.
  • يسرد openclaw audit --status failed عمليات التنفيذ الفاشلة؛ ويلخّص openclaw gateway usage-cost --days 7 تكلفة آخر سبعة أيام انطلاقًا من سجلات الجلسات (تحذّر الوثائق من أن الإجماليات قد تكون ناقصة إذا تجدد التخزين المؤقت).

الحدود والنقاط المفتوحة

  • نمو سريع جدًا. عدد النجوم يقيس الاهتمام، لا النضج ولا الأمان. تحمل الإصدارات تاريخًا (v2026.10.4) والإعدادات تتغير: تصف عدة صفحات من الوثائق مفاتيح «أُزيلت» أو رُحّلت بواسطة openclaw doctor --fix.
  • نموذج ثقة شخصي. لم يُصمَّم المشروع لمستخدمين متعادين فيما بينهم داخل Gateway واحد.
  • الامتدادات. تضيف Skills والإضافات من سوق ClawHub شيفرة وصلاحيات: اقرأ تدقيقاتها قبل التثبيت.
  • ملفات السجلات. تحتوي الملفات الخام على السجلات دون إخفاء عند القراءة المباشرة؛ وهي بصلاحيات 0600، فاحمها كما تحمي قواعد بيانات الحالة.

أفضل الممارسات

  • ثبّت على حساب مخصص أو جهاز مخصص، وليس أبدًا على الجهاز الذي يحمل مفاتيح الإنتاج.
  • فعّل العزل (sandboxing) قبل ربط تطبيق مراسلة بعدة محاورين.
  • صدّر التتبعات والمقاييس إلى واجهة خلفية منفصلة عن جهاز الوكيل؛ وحدّد sampleRate بحسب الحجم.
  • أنشئ تنبيهات على openclaw.cost.usd وعلى مدة التنفيذ، وعامل الانحراف كحادثة تشغيلية دون البحث عن مُلام.
  • عطّل captureContent ما دامت لا توجد سياسة احتفاظ تسمح به.

الأسئلة الشائعة

هل OpenClaw مجاني؟

الشيفرة بترخيص MIT، ويذكر README عدم وجود عرض مدفوع. لكنك تدفع لمزوّد النماذج بحسب عدد الرموز.

هل يرسل OpenClaw بيانات إلى ناشره؟

بحسب README لا شيء سوى فحص إصدار يومي افتراضيًا؛ أما إحصاءات الاستخدام المجهولة فاختيارية. تذهب مُوجّهاتك إلى مزوّد النماذج وإلى المنصات التي تضبطها.

هل يمكن كشفه على الإنترنت؟

توفر الوثائق دليل فحص مسبق قبل أي كشف يتجاوز الواجهة المحلية. اتبعه، وفعّل المصادقة والعزل، وشغّل openclaw security audit.

الخلاصة

يجمع OpenClaw بين منظومة واسعة من تطبيقات المراسلة وGateway محلي، ويقدّم ما يطلبه التشغيل: تصدير OpenTelemetry ومقاييس التكلفة وسجل التدقيق. ونجاحه لا يعفي من التعامل معه كخدمة ذات امتيازات: عزل وأسرار وتنبيهات تكلفة. لمتابعة السلسلة، راجع Paperclip الذي ينسّق فرق وكلاء قد يكون OpenClaw واحدًا منهم.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة. العلامات التجارية المذكورة ملك لأصحابها. الأدوات تتطور بسرعة: تحقق من الأوامر والخيارات في وثائقها الرسمية (docs.openclaw.ai).

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Selecto AI Windows : une barre d'actions sur le texte sélectionné

Selecto AI Windows: شريط إجراءات فوق أي نص محدد

Next Post
Paperclip orchestration agents IA : installer et superviser

تنسيق وكلاء الذكاء الاصطناعي مع Paperclip: التثبيت والمراقبة

Related Posts