openclaw tasks flow)؛ ولسجل
نشاط المهام، راجع مهام الخلفية.
لماذا
من دون Lobster، تتطلب المهمة متعددة الخطوات العديد من استدعاءات الأدوات ذهابًا وإيابًا، مع تولّي النموذج تنسيق كل خطوة. ينقل Lobster هذا التنسيق إلى بيئة تشغيل محددة الأنواع:- استدعاء واحد بدلًا من عدة استدعاءات: يعيد استدعاء أداة Lobster واحد نتيجة منظّمة للمسار بأكمله.
- الموافقات مضمّنة: توقف الآثار الجانبية (الإرسال، النشر، الحذف) سير العمل حتى تتم الموافقة عليها صراحةً.
- قابل للاستئناف: يعيد سير العمل المتوقف رمزًا؛ وافق واستأنف من دون إعادة تشغيل الخطوات السابقة.
.lobster من أدوات أخرى إذا كنت
تريد لغة تأليف أكثر ثراءً.
من دون Lobster، تبدو عملية الفرز المتكررة للبريد الإلكتروني كما يلي:
كيفية عمله
يشغّل OpenClaw مسارات عمل Lobster داخل العملية باستخدام حزمة@clawdbot/lobster المضمّنة بوصفها مشغّلًا مضمّنًا. لا تُنشأ عملية فرعية خارجية لـ lobster؛
بل يعيد استدعاء الأداة غلاف JSON مباشرةً. إذا توقف المسار للموافقة،
يحمل الغلاف رمز استئناف (أو معرّف موافقة قصيرًا) حتى تتمكن من المتابعة لاحقًا.
التفعيل
Lobster أداة Plugin اختيارية، ولا تكون مفعّلة افتراضيًا. وهي تأتي مضمّنة، لذلك لا يلزم إجراء تثبيت منفصل — ما عليك سوى السماح بالأداة:تضيف
alsoAllow الأداة lobster فوق ملف تعريف الأدوات النشط من دون
تقييد أدوات النواة الأخرى. استخدم tools.allow فقط إذا كنت تريد وضع
قائمة سماح مقيّدة بدلًا من ذلك.lobster ضمن
PATH.
النمط: CLI صغير + أنابيب JSON + موافقات
أنشئ أوامر صغيرة تتعامل باستخدام JSON، ثم اربطها في استدعاء Lobster واحد. (أسماء الأوامر أدناه أمثلة — استبدلها بأوامرك.)خطوات LLM باستخدام JSON فقط (llm-task)
لإضافة خطوة LLM منظّمة داخل سير عمل، فعّل أداة Plugin الاختياريةllm-task واستدعها من Lobster:
قيد مهم: Lobster المضمّن مقابل openclaw.invoke
يشغّل Plugin المضمّن لـ Lobster مسارات العمل داخل العملية ضمن Gateway.
في هذا الوضع المضمّن، لا يرث openclaw.invoke تلقائيًا
سياق عنوان URL لـ Gateway/المصادقة لاستدعاءات أدوات CLI المتداخلة في OpenClaw.
يعني ذلك أن هذا النمط غير موثوق حاليًا في المشغّل المضمّن:
openclaw.invoke مهيّأ بالفعل باستخدام سياق
Gateway/المصادقة الصحيح.
- استدعاء أداة
llm-taskمباشرةً خارج Lobster، أو - استخدام خطوات لا تعتمد على
openclaw.invokeداخل مسار Lobster حتى تُضاف وصلة مضمّنة مدعومة.
ملفات سير العمل (.lobster)
يمكن لـ Lobster تشغيل ملفات سير عمل YAML/JSON تحتوي على الحقولname وargs وsteps وenv
وcondition وapproval. اضبط pipeline على مسار الملف في استدعاء
الأداة.
- يمرّر
stdin: $step.stdoutوstdin: $step.jsonمخرجات خطوة سابقة. - يمكن لـ
condition(أوwhen) التحكم في تشغيل الخطوات استنادًا إلى$step.approved.
معاملات الأداة
run
resume
resume إما token (رمز الاستئناف الكامل من requiresApproval)
أو approvalId (المعرّف القصير من الكائن نفسه) — استخدم ما أعاده
التشغيل المتوقف. المعامل approve مطلوب.
وضع تدفق المهام المُدار
يؤدي تمريرflowControllerId وflowGoal مع run (أو flowId و
flowExpectedRevision مع resume) إلى توجيه الاستدعاء عبر واجهة API المُدارة لـ
تدفق المهام في بيئة تشغيل Plugin بدلًا من إعادة
غلاف مجرد: ينشئ OpenClaw سجل تدفق دائمًا أو يستأنفه، ويطبّق
غلاف Lobster عليه (waiting عند انتظار الموافقة، وsucceeded/failed عند
الاكتمال)، ويعيد { ok, envelope, flow, mutation }. يتطلب هذا الوضع
بيئة تشغيل مرتبطة لتدفق المهام، وهو مخصص لشيفرة Plugin/وحدة التحكم التي تحتاج
إلى حالة تدفق دائمة عبر عمليات إعادة تشغيل Gateway، وليس للاستخدام العرضي المعتاد من الوكلاء.
غلاف المخرجات
يعيد Lobster غلاف JSON بإحدى ثلاث حالات:ok— اكتمل بنجاحneeds_approval— متوقف مؤقتًا؛ يحملrequiresApprovalرمزresumeTokenو معرّفapprovalIdقصيرًا، ويمكن استخدام أي منهما لاستئناف التشغيلcancelled— رُفض أو أُلغي صراحةً
content (JSON منسّق) وdetails
(الكائن الخام).
الموافقات
إذا كانrequiresApproval موجودًا، فافحص الموجّه وقرّر:
approve: true— الاستئناف ومتابعة الآثار الجانبيةapprove: false— الإلغاء وإنهاء سير العمل
approve --preview-from-stdin --limit N لإرفاق معاينة JSON
بطلبات الموافقة من دون شيفرة jq/heredoc مخصصة. تُخزّن حالة الاستئناف في
ملفات JSON صغيرة ضمن دليل حالة Lobster (~/.lobster/state افتراضيًا،
ويمكن تجاوزه باستخدام LOBSTER_STATE_DIR)؛ ولا يشفّر الرمز نفسه سوى
مؤشر إلى تلك الحالة، وليس حالة المسار كاملةً.
OpenProse
يتكامل OpenProse جيدًا مع Lobster: استخدم/prose لتنسيق التحضير متعدد الوكلاء،
ثم شغّل مسار Lobster للحصول على موافقات حتمية. إذا احتاج برنامج Prose
إلى Lobster، فاسمح بأداة lobster للوكلاء الفرعيين عبر
tools.subagents.tools. راجع OpenProse.
السلامة
- محلي وداخل العملية فقط — تُنفّذ مسارات العمل داخل عملية Gateway؛ ولا يُجري Plugin نفسه أي استدعاءات شبكة.
- من دون أسرار — لا يدير Lobster بروتوكول OAuth؛ بل يستدعي أدوات OpenClaw التي تتولى ذلك.
- مدرك لصندوق العزل — يُعطّل عندما يكون سياق الأداة معزولًا.
- محصّن — يفرض المشغّل المضمّن المهل الزمنية وحدود المخرجات.
استكشاف الأخطاء وإصلاحها
معرفة المزيد
دراسة حالة: مسارات عمل المجتمع
مثال عام: CLI لـ«دماغ ثانٍ» مع مسارات Lobster تدير ثلاثة مستودعات Markdown (شخصي، وللشريك، ومشترك). يُخرج CLI بيانات JSON للإحصاءات، وقوائم صندوق الوارد، وعمليات البحث عن العناصر القديمة؛ ويربط Lobster هذه الأوامر في تدفقات عمل مثلweekly-review وinbox-triage وmemory-consolidation وshared-task-sync، ولكل منها بوابات موافقة. يتولى الذكاء الاصطناعي اتخاذ القرارات (التصنيف) عند توفره، ويعود إلى قواعد حتمية عند عدم توفره.
- سلسلة المنشورات: https://x.com/plattenschieber/status/2014508656335770033
- المستودع: https://github.com/bloomedai/brain-cli
ذو صلة
- الأتمتة - جميع آليات الأتمتة
- نظرة عامة على الأدوات - جميع أدوات الوكيل المتاحة