CLI commands
واجهة سطر أوامر لوحة العمل
openclaw workboard هي واجهة الطرفية الخاصة بـ Plugin Workboard المضمّن. تتيح للمشغّل سرد البطاقات وإنشاء بطاقة وفحص بطاقة واحدة ومطالبة Gateway قيد التشغيل بإسناد العمل الجاهز إلى عمليات عامل لوكلاء فرعيين.
فعّل Plugin قبل استخدام الأمر:
openclaw plugins enable workboardopenclaw gateway restartالاستخدام
openclaw workboard list [--board <id>] [--status <status>] [--include-archived] [--json]openclaw workboard create <title...> [--notes <text>] [--status <status>] [--priority <priority>] [--agent <id>] [--board <id>] [--labels <items>] [--json]openclaw workboard show <id> [--json]openclaw workboard dispatch [--url <url>] [--token <token>] [--timeout <ms>] [--json]يقرأ الأمر ويكتب في قاعدة بيانات SQLite نفسها المملوكة لـ Plugin والتي تستخدمها لوحة المعلومات وأدوات وكيل Workboard. معرّفات البطاقات هي UUID؛ وتقبل الأوامر التي تستقبل معرّف بطاقة أيضًا بادئة معرّف غير ملتبسة (يعرض الإخراج النصي الموجز أول 8 محارف).
قيم status الصالحة: triage وbacklog وtodo وscheduled وready وrunning وreview وblocked وdone. قيم priority الصالحة: low وnormal وhigh وurgent.
list
openclaw workboard listopenclaw workboard list --board default --status readyopenclaw workboard list --jsonالإخراج النصي موجز:
7f4a2c10 ready high default agent-a Fix stale worker heartbeatالأعمدة هي بادئة المعرّف والحالة والأولوية ومعرّف اللوحة ومعرّف الوكيل الاختياري والعنوان.
| الخيار | الغرض |
|---|---|
--board <id> |
حصر النتائج في نطاق لوحة واحد |
--status <status> |
حصر النتائج في حالة واحدة من حالات Workboard |
--include-archived |
تضمين البطاقات المؤرشفة في الإخراج النصي الموجز |
--json |
طباعة قائمة البطاقات الكاملة بصيغة JSON آلية |
يخفي الإخراج النصي الموجز البطاقات المؤرشفة افتراضيًا كي تتطابق CLI مع /workboard list. مرّر --include-archived لإظهارها. يحتفظ إخراج JSON دائمًا بقائمة البطاقات الكاملة، بما فيها البطاقات المؤرشفة، لأغراض الأتمتة الحالية.
create
openclaw workboard create "Fix stale worker heartbeat" --priority high --labels bug,workboardopenclaw workboard create "Write Workboard docs" --status ready --agent docs-agent --board docs --notes "Cover CLI, slash command, dispatch, and SQLite state."| الخيار | الغرض |
|---|---|
--notes <text> |
ملاحظات البطاقة الأولية |
--status <status> |
الحالة الأولية، والقيمة الافتراضية todo |
--priority <priority> |
الأولوية، والقيمة الافتراضية normal |
--agent <id> |
إسناد البطاقة إلى معرّف وكيل أو مالك |
--board <id> |
تخزين البطاقة ضمن نطاق لوحة |
--labels <items> |
تسميات مفصولة بفواصل |
--json |
طباعة البطاقة المنشأة بصيغة JSON آلية |
يكتب create مباشرةً في حالة SQLite الخاصة بـ Workboard. تظهر البطاقة فورًا في علامة تبويب Workboard ضمن واجهة التحكم ولأدوات Workboard.
show
openclaw workboard show 7f4a2c10openclaw workboard show 7f4a2c10 --jsonيطبع الإخراج النصي سطر البطاقة الموجز والملاحظات. يعيد إخراج JSON سجل البطاقة الكامل، بما في ذلك بيانات التنفيذ الوصفية والمحاولات والتعليقات والروابط والإثبات والعناصر الناتجة وسجلات العامل وحالة البروتوكول وبيانات التشخيص وبيانات الأتمتة الوصفية.
dispatch
openclaw workboard dispatchopenclaw workboard dispatch --jsonopenclaw workboard dispatch --url http://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"يستدعي dispatch أولًا أسلوب RPC workboard.cards.dispatch في Gateway قيد التشغيل، والذي يستخدم وقت تشغيل الوكلاء الفرعيين نفسه الذي يستخدمه إجراء الإسناد في لوحة المعلومات، وبذلك تتحول البطاقات الجاهزة إلى عمليات عامل متتبعة كمهام ومقترنة بمفاتيح جلسات. تستخدم البطاقات المسندة إلى وكيل مفاتيح جلسات وكلاء فرعيين ضمن نطاق الوكيل؛ بينما تحتفظ البطاقات غير المسندة بمفتاح وكيل فرعي غير مقيّد بنطاق كي يُحافظ على الوكيل الافتراضي المضبوط في Gateway.
حلقة الإسناد:
- ترقّي العناصر التابعة الجاهزة من ناحية الاعتماديات إلى
ready. - تحظر المطالبات المنتهية الصلاحية أو عمليات العامل التي انتهت مهلتها.
- تسجّل بيانات الإسناد الوصفية في البطاقات الجاهزة.
- تختار دفعة صغيرة من البطاقات الجاهزة غير المُطالب بها.
- تطالب بكل بطاقة محددة لصالح المُسنِد أو الوكيل المعيّن.
- تبدأ عملية عامل لوكيل فرعي بسياق محدود للبطاقة ورمز المطالبة الخاص بها.
- تخزّن معرّف عملية العامل ومفتاح الجلسة والارتباط بالمهمة عندما يبلّغ به سجل مهام Gateway وحالة التنفيذ وسجل العامل في البطاقة.
الاختيار متحفّظ: يبدأ الإسناد الواحد ثلاثة عمال كحد أقصى افتراضيًا، ويتجاوز البطاقات المؤرشفة أو المُطالب بها بالفعل، ويبدأ بطاقة واحدة فقط لكل مالك أو وكيل في كل مرور. تُترك البطاقات المملوكة بالفعل لعمل نشط قيد التشغيل أو المراجعة لإسناد لاحق.
إذا فشل بدء العامل بعد المطالبة ببطاقة، يحظر Workboard تلك البطاقة ويمحو المطالبة ويسجّل الفشل في بيانات تنفيذ البطاقة وبيانات سجل العامل الوصفية، مما يُبقي عمليات البدء الفاشلة ظاهرة بدلًا من إعادة البطاقة إلى قائمة الانتظار بصمت.
إذا لم يُحدَّد هدف Gateway صراحةً وكان Gateway المحلي غير متاح أو لم يكن يوفّر أسلوب إسناد Workboard بعد، تعود CLI إلى الإسناد القائم على البيانات فقط باستخدام حالة Workboard المحلية. لا يزال الإسناد القائم على البيانات فقط قادرًا على ترقية الاعتماديات وتنظيف المطالبات القديمة وحظر العمليات التي انتهت مهلتها، لكنه لا يبدأ عمالًا. يُبلّغ مباشرةً عن حالات فشل المصادقة والأذونات والتحقق، وكذلك حالات الفشل لهدف --url أو --token محدد صراحةً، بدلًا من تشغيل المسار الاحتياطي.
يبلّغ الإخراج النصي عن عمليات بدء العامل:
dispatch complete: started=2 failures=0إخراج المسار الاحتياطي صريح:
gateway unavailable; data dispatch only: promoted=1 blocked=0يتضمن إخراج JSON نتيجة الإسناد. قد يتضمن الإسناد المدعوم من Gateway الحقلين started وstartFailures؛ ويتضمن المسار الاحتياطي القائم على البيانات فقط gatewayUnavailable: true. تُحجب رموز المطالبة من إخراج JSON الخاص بالبطاقات.
تُعرض نتيجة الإسناد نفسها في لوحة المعلومات كملخص قصير، بحيث يمكن للمشغّل معرفة عدد البطاقات التي بدأت أو ترقّت أو حُظرت أو أُعيدت المطالبة بها أو فشلت دون فتح تفاصيل البطاقات.
التكافؤ مع أمر الشرطة المائلة
يمكن للقنوات التي تدعم الأوامر استخدام أمر الشرطة المائلة المطابق:
/workboard list/workboard show 7f4a2c10/workboard create Fix stale worker heartbeat/workboard dispatchيستخدم الإسناد عبر أمر الشرطة المائلة أيضًا وقت تشغيل الوكلاء الفرعيين في Gateway، لذا يتبع سلوك المطالبة وبدء العامل والفشل نفسه المتّبع في لوحة المعلومات ومسار Gateway في CLI.
الأمران /workboard list و/workboard show هما أمرا قراءة لمرسلي الأوامر المصرّح لهم. يغيّر الأمران /workboard create و/workboard dispatch حالة اللوحة ويتطلبان صفة المالك على واجهات الدردشة أو عميل Gateway بصلاحية operator.write أو operator.admin.
الأذونات
يستدعي مسار الإسناد في CLI RPC الخاص بـ Gateway بنطاقي operator.read وoperator.write. يمكن لرمز Gateway المخصص للقراءة فقط فحص بيانات Workboard عبر أساليب القراءة، لكنه لا يستطيع إنشاء بطاقات أو إسناد عمال.
تعمل أوامر list وcreate وshow المحلية على دليل حالة OpenClaw المحلي الذي يستخدمه الملف الشخصي الحالي. استخدم --dev أو --profile <name> مع أمر openclaw ذي المستوى الأعلى عند الحاجة إلى جذر حالة مختلف.
استكشاف الأخطاء وإصلاحها
لا تظهر أي بطاقات
تأكد من تمكين Plugin للملف الشخصي وجذر الحالة نفسيهما:
openclaw plugins inspect workboard --runtime --jsonإذا كانت لوحة المعلومات تعرض البطاقات بينما لا تعرضها CLI، فتحقق من أن كلا الأمرين يستخدم إعداد --dev أو --profile نفسه.
يشير الإسناد إلى أنه قائم على البيانات فقط
ابدأ Gateway أو أعد تشغيله:
openclaw gateway restartopenclaw gateway status --deepثم أعد محاولة openclaw workboard dispatch. يُعد المسار الاحتياطي القائم على البيانات فقط مفيدًا لتنظيف الحالة المحلية، لكن عمليات العامل تحتاج إلى Gateway نشط.
لا يبدأ الإسناد أي شيء
تحقق من وجود بطاقة واحدة على الأقل بحالة ready من دون مطالبة نشطة:
openclaw workboard list --status readyقد تُتجاوز البطاقات أيضًا عندما يكون لدى المالك نفسه عمل قيد التشغيل أو المراجعة. انقل العمل المكتمل إلى done، أو حرّر المطالبات القديمة عبر أدوات Workboard، أو شغّل الإسناد مرة أخرى بعد انتهاء العامل النشط.
