> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# `openclaw tasks`

افحص مهام الخلفية الدائمة وحالة Task Flow. دون أمر فرعي،
يكون `openclaw tasks` مكافئًا لـ `openclaw tasks list`.

راجع [مهام الخلفية](/ar/automation/tasks) لمعرفة دورة الحياة ونموذج التسليم.

## الاستخدام

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tasks
openclaw tasks list
openclaw tasks list --runtime acp
openclaw tasks list --status running
openclaw tasks show <lookup>
openclaw tasks notify <lookup> state_changes
openclaw tasks cancel <lookup>
openclaw tasks audit
openclaw tasks maintenance
openclaw tasks maintenance --apply
openclaw tasks flow list
openclaw tasks flow show <lookup>
openclaw tasks flow cancel <lookup>
```

## خيارات الجذر

* `--json`: إخراج JSON.
* `--runtime <name>`: التصفية حسب النوع: `subagent` أو `acp` أو `cron` أو `cli`.
* `--status <name>`: التصفية حسب الحالة: `queued` أو `running` أو `succeeded` أو `failed` أو `timed_out` أو `cancelled` أو `lost`.

## الأوامر الفرعية

### `list`

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tasks list [--runtime <name>] [--status <name>] [--json]
```

يسرد مهام الخلفية المتتبعة من الأحدث أولًا.

### `show`

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tasks show <lookup> [--json]
```

يعرض مهمة واحدة بحسب معرف المهمة أو معرف التشغيل أو مفتاح الجلسة.

### `notify`

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tasks notify <lookup> <done_only|state_changes|silent>
```

يغيّر سياسة الإشعارات لمهمة قيد التشغيل.

### `cancel`

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tasks cancel <lookup>
```

يلغي مهمة خلفية قيد التشغيل.

### `audit`

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]
```

يكشف سجلات المهام وTask Flow القديمة أو المفقودة أو التي فشل تسليمها أو غير المتسقة بطريقة أخرى. تُعد المهام المفقودة المحتفَظ بها حتى `cleanupAfter` تحذيرات؛ أما المهام المفقودة المنتهية الصلاحية أو غير المختومة زمنيًا فهي أخطاء.

### `maintenance`

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tasks maintenance [--apply] [--json]
```

يعرض معاينة أو يطبّق تسوية المهام وTask Flow، وختم التنظيف، والتقليم،
وتنظيف سجل جلسات تشغيل Cron القديمة.
بالنسبة إلى مهام Cron، تستخدم التسوية سجلات التشغيل/حالة المهام المستمرة قبل وسم مهمة نشطة قديمة بأنها `lost`، لذلك لا تتحول عمليات Cron المكتملة إلى أخطاء تدقيق زائفة لمجرد أن حالة تشغيل Gateway الموجودة في الذاكرة لم تعد موجودة. لا يُعد تدقيق CLI دون اتصال مصدرًا موثوقًا لمجموعة مهام Cron النشطة المحلية لعملية Gateway. تُوسم مهام CLI التي لها معرف تشغيل/معرف مصدر بأنها `lost` عندما يختفي سياق تشغيل Gateway الحي الخاص بها، حتى إذا بقي صف جلسة فرعية قديم.
عند التطبيق، تقلّم الصيانة أيضًا صفوف سجل الجلسات `cron:<jobId>:run:<uuid>` الأقدم من 7 أيام مع الحفاظ على مهام Cron قيد التشغيل حاليًا وترك صفوف الجلسات غير المرتبطة بـ Cron دون تغيير.

### `flow`

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tasks flow list [--status <name>] [--json]
openclaw tasks flow show <lookup> [--json]
openclaw tasks flow cancel <lookup>
```

يفحص حالة Task Flow الدائمة ضمن سجل المهام أو يلغيها.

## ذات صلة

* [مرجع CLI](/ar/cli)
* [مهام الخلفية](/ar/automation/tasks)