---
read_when:
    - می‌خواهید یک رویداد سیستمی را بدون ایجاد یک کار Cron در صف قرار دهید
    - باید Heartbeatها را فعال یا غیرفعال کنید
    - می‌خواهید ورودی‌های حضور سیستم را بررسی کنید
summary: مرجع CLI برای `openclaw system` (رویدادهای سیستم، Heartbeat، حضور)
title: سامانه
x-i18n:
    generated_at: "2026-05-11T20:29:57Z"
    model: gpt-5.5
    provider: openai
    source_hash: 2810fb064ea4afeac24ca0d71419913a664bbec0721cabdb09196075914f4864
    source_path: cli/system.md
    workflow: 16
---

# `openclaw system`

ابزارهای کمکی سطح سیستم برای Gateway: در صف گذاشتن رویدادهای سیستمی، کنترل Heartbeatها،
و مشاهده حضور.

همه زیر‌فرمان‌های `system` از Gateway RPC استفاده می‌کنند و پرچم‌های مشترک کلاینت را می‌پذیرند:

- `--url <url>`
- `--token <token>`
- `--timeout <ms>`
- `--expect-final`

## فرمان‌های رایج

```bash
openclaw system event --text "Check for urgent follow-ups" --mode now
openclaw system event --text "Check for urgent follow-ups" --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"
openclaw system heartbeat enable
openclaw system heartbeat last
openclaw system presence
```

## `system event`

به‌طور پیش‌فرض، یک رویداد سیستمی را در نشست **اصلی** در صف قرار می‌دهد. Heartbeat بعدی
آن را به‌صورت یک خط `System:` در اعلان تزریق می‌کند. برای اجرای فوری
Heartbeat از `--mode now` استفاده کنید؛ `next-heartbeat` تا تیک زمان‌بندی‌شده بعدی منتظر می‌ماند.

برای هدف گرفتن یک نشست مشخص، `--session-key` را ارسال کنید (برای مثال برای بازگرداندن
تکمیل یک وظیفه ناهمگام به کانالی که آن را شروع کرده است).

> **استثنای زمان‌بندی با `--session-key`:** وقتی `--session-key` ارائه شود،
> `--mode next-heartbeat` به‌جای انتظار برای تیک زمان‌بندی‌شده بعدی، به یک بیدارباش هدفمند فوری
> تبدیل می‌شود. بیدارباش‌های هدفمند از نیت Heartbeat
> `immediate` استفاده می‌کنند تا از دروازه هنوز-موعد-نرسیده اجراکننده عبور کنند؛ در غیر این صورت
> یک بیدارباش با نیت `event` به تعویق می‌افتاد (و عملاً حذف می‌شد). اگر تحویل
> با تأخیر می‌خواهید، `--session-key` را حذف کنید تا رویداد روی نشست اصلی قرار بگیرد و
> با Heartbeat منظم بعدی همراه شود.

پرچم‌ها:

- `--text <text>`: متن رویداد سیستمی الزامی.
- `--mode <mode>`: `now` یا `next-heartbeat` (پیش‌فرض).
- `--session-key <sessionKey>`: اختیاری؛ یک نشست عامل مشخص را
  به‌جای نشست اصلی عامل هدف می‌گیرد. کلیدهایی که متعلق به عامل
  حل‌شده نباشند به نشست اصلی عامل بازمی‌گردند.
- `--json`: خروجی قابل‌خواندن توسط ماشین.
- `--url`، `--token`، `--timeout`، `--expect-final`: پرچم‌های مشترک Gateway RPC.

## `system heartbeat last|enable|disable`

کنترل‌های Heartbeat:

- `last`: آخرین رویداد Heartbeat را نشان می‌دهد.
- `enable`: Heartbeatها را دوباره روشن می‌کند (اگر غیرفعال شده بودند از این استفاده کنید).
- `disable`: Heartbeatها را موقتاً متوقف می‌کند.

پرچم‌ها:

- `--json`: خروجی قابل‌خواندن توسط ماشین.
- `--url`، `--token`، `--timeout`، `--expect-final`: پرچم‌های مشترک Gateway RPC.

## `system presence`

ورودی‌های حضور سیستمی فعلی را که Gateway از آن‌ها آگاه است فهرست می‌کند (گره‌ها،
نمونه‌ها، و خطوط وضعیت مشابه).

پرچم‌ها:

- `--json`: خروجی قابل‌خواندن توسط ماشین.
- `--url`، `--token`، `--timeout`، `--expect-final`: پرچم‌های مشترک Gateway RPC.

## نکته‌ها

- به یک Gateway در حال اجرا نیاز دارد که از طریق پیکربندی فعلی شما قابل دسترسی باشد (محلی یا راه‌دور).
- رویدادهای سیستمی گذرا هستند و در راه‌اندازی‌های مجدد پایدار نمی‌مانند.

## مرتبط

- [مرجع CLI](/fa/cli)