تكامل Libre Claw

يتضمن Libre WebUI تكاملًا أصليًا مع Libre Claw، وهي بيئة الوكلاء المحلية من Kroonen AI. تظهر Libre Claw كسطح وكلاء من الدرجة الأولى داخل Libre WebUI، لا كمكوّن إضافي عام لموفّر الإكمال.

تظل Libre Claw بيئة التشغيل المالكة لسلوك الوكيل القوي:

• عمليات تشغيل دائمة وسجلات أحداث JSONL
• أدوات الملفات وshell وGit والمتصفح وHTTP والبحث على الويب وMCP والجدولة
• طلبات موافقة قبل الآثار الجانبية
• ذاكرة دائمة ومهارات للمشروع أو المستخدم
• وضع الهدف
• مسارات نماذج احتياطية
• تقارير الاستخدام
• أتمتة يملكها daemon وتسليم عبر Telegram
• لوحة المعلومات المحلية المستقلة

يتواصل Libre WebUI مع daemon الخاص بـ Libre Claw عبر HTTP ويعرض تلك الميزات داخل غلاف WebUI المعتاد والمحمي بالمصادقة.

يُسمّى هذا السطح في الواجهة الوكلاء؛ تستخدم الأيقونة في الشريط الجانبي والمسار /agents وإدخال لوحة الأوامر الاسم نفسه. Libre Claw هي بيئة التشغيل خلفه، لذلك يحتفظ daemon وأمره ومتغيرات بيئته باسمها في هذا الدليل.

Libre Claw وWork مختلفتان

تظل Libre Claw بيئة تشغيل خارجية اختيارية. ولا تحتاجها ميزة Work المضمّنة في Libre WebUI.

	Work	Libre Claw
بيئة التشغيل	حلقة نموذج وأدوات أصلية في Libre WebUI مع Docker	daemon منفصل لـ Libre Claw
النطاق الأساسي	مساحة ترميز دائمة ومعزولة واحدة لكل مهمة	عمليات وكلاء أوسع وذاكرة وموافقات وجداول ومتصفح وMCP وأدوات
الاستمرارية	سجل مهمة في SQLite ووحدة Docker مسماة تملكها المهمة	مخازن التشغيل والذاكرة الخاصة بـ Libre Claw
توجيه النماذج	Ollama أو Ollama Cloud أو مكوّن إكمال أو محادثة مضبوط في Libre WebUI	ضبط الموفّر والنموذج والمسارات الاحتياطية في Libre Claw
التوفر من دونها	تستمر Work بصورة طبيعية	ينقطع سطح Libre Claw على /agents وحده

استخدم Work عندما ينبغي لنموذج بناء ملفات أو تعديلها داخل حاوية مقيدة خاصة بالمهمة. واستخدم Libre Claw عندما تحتاج إلى مجموعة أدوات daemon الأوسع أو نظام الموافقة أو الذاكرة أو الأهداف أو الأتمتة.

البنية

لا يشغّل خادم WebUI الخلفي أوامر shell أو أدوات المتصفح مباشرةً لصالح Libre Claw. بل يمرر طلبات المسؤول الموثّقة إلى daemon المحلي ويعرض حالة تشغيله وأحداثه وموافقاته وأتمتته واستخدامه وضبطه.

تشغيل Libre Claw

ثبّت Libre Claw:

git clone https://github.com/kroonen-ai/libre-claw.git
cd libre-claw
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"

شغّل daemon:

libre-claw start

تتوفر لوحة المعلومات وAPI الافتراضيتان على:

http://127.0.0.1:8766/dashboard

ثم افتح Libre WebUI ← Libre Claw.

بيئة الخادم الخلفي

يستخدم Libre WebUI عنوان daemon المحلي افتراضيًا:

LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766
LIBRE_CLAW_TIMEOUT_MS=30000

اضبط LIBRE_CLAW_BASE_URL إذا كان daemon يعمل على مضيف آخر أو عنوان Tailscale أو خدمة محلية خلف reverse proxy.

مسارات WebUI

تتطلب كل مسارات Libre Claw مستخدمًا مسؤولًا موثّقًا لأنها قد تكشف مسارات ملفات محلية وتبدأ عمل الوكيل:

مسار WebUI	ميزة Libre Claw
GET /api/libre-claw/status	صحة daemon وعنوان الأساس ولوحة المعلومات
GET /api/libre-claw/config/model	الموفّر والنموذج الحاليان
PATCH /api/libre-claw/config/model	تحديث الموفّر والنموذج
GET /api/libre-claw/config/fallback	مسار الاحتياط الحالي
PATCH /api/libre-claw/config/fallback	تحديث مسار الاحتياط
PATCH /api/libre-claw/config/theme	تحديث سمة لوحة المعلومات أو TUI
GET /api/libre-claw/runs	سرد عمليات التشغيل الدائمة
POST /api/libre-claw/runs	بدء تشغيل محادثة أو وضع هدف
GET /api/libre-claw/runs/:id	بيانات التشغيل وعناصره
GET /api/libre-claw/runs/:id/events	أحداث التشغيل التزايدية
POST /api/libre-claw/runs/:id/cancel	إلغاء تشغيل
POST /api/libre-claw/runs/:id/permissions/:toolCallId	السماح باستدعاء أداة أو رفضه
GET /api/libre-claw/usage	ملخص وسجلات الاستخدام
GET /api/libre-claw/automations	سرد الأتمتة المجدولة
POST /api/libre-claw/automations	إنشاء أتمتة
PATCH /api/libre-claw/automations/:id	تحديث أتمتة
POST /api/libre-claw/automations/:id/run	تشغيل أتمتة الآن
POST /api/libre-claw/automations/:id/pause	إيقاف أتمتة مؤقتًا
POST /api/libre-claw/automations/:id/resume	استئناف أتمتة
DELETE /api/libre-claw/automations/:id	حذف أتمتة

بدء عمليات التشغيل

يمكن لصفحة WebUI بدء:

• عمليات محادثة — جولات وكلاء Libre Claw المعتادة.
• عمليات هدف — وضع قيادة ذاتية محدود تواصل فيه Libre Claw حتى يعتبر الحكم الهدف مكتملًا أو تبلغ الحد المضبوط.

تُمرر تجاوزات الموفّر أو النموذج الاختيارية إلى Libre Claw لذلك التشغيل. وإذا أُهملت، تستخدم Libre Claw الموفّر والنموذج الافتراضيين في ضبطها.

الموافقات

عندما تطلب Libre Claw إذنًا، يعرض WebUI استدعاء الأداة المنتظر ويسمح للمسؤول باختيار:

• allow_once
• deny
• always_allow_tool

تظل Libre Claw مالكة لنموذج الأذونات وفحوصات الأمان. لا يسجل WebUI سوى اختيار المسؤول عبر API الخاص بـ daemon.

الأتمتة

يستطيع Libre WebUI إنشاء أتمتة daemon الخاصة بـ Libre Claw وإدارتها:

• أتمتة التقارير
• أتمتة موجّهة إلى Telegram
• الإيقاف والاستئناف
• التشغيل الآن
• الحذف

هذه أتمتة Libre Claw، لا مهام cron للمضيف. تظل التقارير وسجل التنفيذ في مخزن تشغيل Libre Claw.

الذاكرة والمهارات وملفات الروح والأدوات

تُضبط الذاكرة والمهارات وملفات الروح وأدوات MCP والمتصفح وSearXNG وPetdex وTelegram داخل Libre Claw نفسها. يعرض WebUI الميزات المواجهة لـ daemon ويتحكم فيها من دون تكرار نظام الضبط الداخلي لـ Libre Claw.

أوامر Libre Claw مفيدة:

/memory status
/skills list
/soul status
/tools list
/workspace status
/telegram
/petdex status

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

يعرض WebUI «daemon الخاص بـ Libre Claw غير متصل»

شغّل daemon:

libre-claw start

أو اضبط عنوان الخادم الخلفي:

LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766

أزرار الأذونات لا تفعل شيئًا

ربما انتهى التشغيل بالفعل، أو حُل الإذن من سطح آخر مثل لوحة Libre Claw أو جسر Telegram. حدّث صفحة WebUI وافحص الخط الزمني للتشغيل.

رُفضت أداة

مدير أذونات Libre Claw هو المرجع. تحقق من ضبط Libre Claw وأحداث التشغيل إذا رُفض الاستدعاء قبل أن يرى WebUI طلب موافقة.

الأتمتة لا تعمل

تحقق من حالة daemon وضبط الأتمتة في Libre Claw:

libre-claw status
libre-claw start

يجب أن يعمل daemon لتنفيذ الأتمتة المجدولة والتسليم عبر Telegram.

مستندات ذات صلة

• Work: مساحات العمل المعزولة
• المصادقة
• متغيرات البيئة