CLI صفحهٔ کار

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 استفاده می‌کنند. شناسه‌های کارت می‌توانند به صورت شناسه کامل یا با یک پیشوند بدون ابهام پاس داده شوند، وقتی دستوری شناسه کارت می‌پذیرد.

list

openclaw workboard listopenclaw workboard list --board default --status readyopenclaw workboard list --json

خروجی متنی فشرده است:

7f4a2c10  ready     high    default agent-a  Fix stale worker heartbeat

ستون‌ها شامل پیشوند شناسه، وضعیت، اولویت، شناسه بورد، شناسه اختیاری عامل، و عنوان هستند.

پرچم‌ها:

خروجی متنی فشرده به‌طور پیش‌فرض کارت‌های بایگانی‌شده را پنهان می‌کند تا 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."

پرچم‌ها:

create مستقیماً در وضعیت SQLite مربوط به Workboard می‌نویسد. کارت بلافاصله در زبانه Workboard در Control UI و برای ابزارهای 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 در Gateway در حال اجرا را فراخوانی می‌کند: workboard.cards.dispatch. این مسیر از همان زمان اجرای عامل فرعی استفاده می‌کند که کنش dispatch داشبورد استفاده می‌کند، بنابراین کارت‌های آماده به اجراهای کارگر دارای ردیابی وظیفه با کلیدهای نشست پیوندخورده تبدیل می‌شوند. کارت‌هایی که عامل اختصاص‌یافته دارند از کلیدهای نشست عامل فرعی با دامنه عامل استفاده می‌کنند؛ کارت‌های بدون اختصاص یک کلید عامل فرعی بدون دامنه نگه می‌دارند تا عامل پیش‌فرض پیکربندی‌شده Gateway حفظ شود.

حلقه dispatch:

1. فرزندان آماده از نظر وابستگی را به ready ارتقا می‌دهد.
2. claimهای منقضی‌شده یا اجراهای کارگر زمان‌تمام‌شده را مسدود می‌کند.
3. فراداده dispatch را روی کارت‌های آماده ثبت می‌کند.
4. یک دسته کوچک از کارت‌های آماده و بدون claim را انتخاب می‌کند.
5. هر کارت انتخاب‌شده را برای dispatchکننده یا عامل اختصاص‌یافته claim می‌کند.
6. یک اجرای کارگر عامل فرعی را با زمینه محدود کارت و توکن claim کارت شروع می‌کند.
7. شناسه اجرای کارگر، کلید نشست، پیوند وظیفه وقتی دفترکل وظیفه Gateway آن را گزارش می‌کند، وضعیت اجرا، و لاگ کارگر را روی کارت ذخیره می‌کند.

انتخاب عمداً محافظه‌کارانه است. یک dispatch به‌طور پیش‌فرض حداکثر سه کارگر را شروع می‌کند، کارت‌های بایگانی‌شده یا از قبل claimشده را نادیده می‌گیرد، و در یک گذر فقط یک کارت برای هر مالک یا عامل شروع می‌کند. کارت‌هایی که از قبل متعلق به کار در حال اجرای فعال یا در بازبینی هستند برای dispatch بعدی باقی می‌مانند.

اگر شروع کارگر پس از claim شدن کارت شکست بخورد، Workboard آن کارت را مسدود می‌کند، claim را پاک می‌کند، و شکست را در فراداده اجرای کارت و لاگ کارگر ثبت می‌کند. این کار شروع‌های ناموفق را قابل مشاهده نگه می‌دارد، به‌جای اینکه کارت را بی‌صدا به صف برگرداند.

اگر هدف Gateway صریحی ارائه نشود و Gateway محلی در دسترس نباشد یا هنوز متد dispatch مربوط به Workboard را ارائه نکند، CLI به dispatch فقط-داده روی وضعیت محلی Workboard برمی‌گردد. dispatch فقط-داده همچنان می‌تواند وابستگی‌ها را ارتقا دهد، claimهای کهنه را پاک کند، و اجراهای زمان‌تمام‌شده را مسدود کند، اما کارگرها را شروع نمی‌کند. خطاهای احراز هویت، مجوز، اعتبارسنجی، و خطاهای مربوط به هدف صریح --url یا --token مستقیماً گزارش می‌شوند.

خروجی متنی شروع‌های کارگر را گزارش می‌کند:

dispatch complete: started=2 failures=0

خروجی fallback صریح است:

gateway unavailable; data dispatch only: promoted=1 blocked=0

خروجی JSON شامل نتیجه dispatch است. dispatch مبتنی بر Gateway می‌تواند شامل started و startFailures باشد؛ fallback فقط-داده شامل gatewayUnavailable: true است. توکن‌های claim از خروجی JSON کارت حذف می‌شوند.

در داشبورد، همان نتیجه dispatch به صورت یک خلاصه کوتاه نشان داده می‌شود تا اپراتور بتواند بدون باز کردن جزئیات کارت ببیند چند کارت شروع، ارتقا، مسدود، بازپس‌گیری، یا ناموفق شده‌اند.

هم‌ارزی دستور اسلش

کانال‌های دارای قابلیت دستور می‌توانند از دستور اسلش متناظر استفاده کنند:

/workboard list/workboard show 7f4a2c10/workboard create Fix stale worker heartbeat/workboard dispatch

dispatch با دستور اسلش نیز از زمان اجرای عامل فرعی Gateway استفاده می‌کند، بنابراین از همان رفتار claim، شروع کارگر، و شکست پیروی می‌کند که مسیر Gateway در داشبورد و CLI دارد.

/workboard list و /workboard show دستورهای خواندنی برای فرستندگان دستور مجاز هستند. /workboard create و /workboard dispatch وضعیت بورد را تغییر می‌دهند و روی سطوح چت به وضعیت مالک یا یک کلاینت Gateway با operator.write یا operator.admin نیاز دارند.

مجوزها

مسیر dispatch در CLI، RPC مربوط به Gateway را با scopeهای operator.read و operator.write فراخوانی می‌کند. یک توکن Gateway فقط‌خواندنی می‌تواند داده‌های Workboard را از طریق متدهای خواندنی بررسی کند، اما نمی‌تواند کارت بسازد یا کارگرها را dispatch کند.

دستورهای محلی list، create، و show روی دایرکتوری وضعیت محلی OpenClaw مورد استفاده پروفایل فعلی عمل می‌کنند. وقتی به ریشه وضعیت متفاوتی نیاز دارید، روی دستور سطح بالای openclaw از --dev یا --profile <name> استفاده کنید.

عیب‌یابی

هیچ کارتی ظاهر نمی‌شود

تأیید کنید Plugin برای همان پروفایل و ریشه وضعیت فعال است:

openclaw plugins inspect workboard --runtime --json

اگر داشبورد کارت‌ها را نشان می‌دهد اما CLI نشان نمی‌دهد، بررسی کنید که هر دو دستور از تنظیم یکسان --dev یا --profile استفاده کنند.

Dispatch می‌گوید فقط-داده

Gateway را شروع یا بازراه‌اندازی کنید:

openclaw gateway restartopenclaw gateway status --deep

سپس دوباره openclaw workboard dispatch را امتحان کنید. fallback فقط-داده برای پاک‌سازی وضعیت محلی مفید است، اما اجراهای کارگر به یک Gateway زنده نیاز دارند.

Dispatch چیزی را شروع نمی‌کند

وجود دست‌کم یک کارت ready بدون claim فعال را بررسی کنید:

openclaw workboard list --status ready

کارت‌ها همچنین وقتی همان مالک از قبل کار در حال اجرا یا در بازبینی داشته باشد ممکن است نادیده گرفته شوند. کار تکمیل‌شده را به done منتقل کنید، claimهای کهنه را از طریق ابزارهای Workboard آزاد کنید، یا پس از پایان کارگر فعال دوباره dispatch را اجرا کنید.

مرتبط

• Plugin Workboard
• مرجع CLI
• دستورهای اسلش
• Control UI