خودکارسازی و وظایف

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

# راهنمای سریع تصمیم‌گیری

flowchart TD
    START([What do you need?]) --> Q1{Schedule work?}
    START --> Q2{Track detached work?}
    START --> Q3{Orchestrate multi-step flows?}
    START --> Q4{React to lifecycle events?}
    START --> Q5{Give the agent persistent instructions?}
    START --> Q6{Remember a natural follow-up?}

    Q1 -->|Yes| Q1a{Exact timing or flexible?}
    Q1a -->|Exact| CRON["Scheduled Tasks (Cron)"]
    Q1a -->|Flexible| HEARTBEAT[Heartbeat]

    Q2 -->|Yes| TASKS[Background Tasks]
    Q3 -->|Yes| FLOW[Task Flow]
    Q4 -->|Yes| HOOKS[Hooks]
    Q5 -->|Yes| SO[Standing Orders]
    Q6 -->|Yes| COMMITMENTS[Inferred Commitments]

مورد استفاده	پیشنهادشده	دلیل
ارسال گزارش روزانه دقیقاً ساعت ۹ صبح	وظایف زمان‌بندی‌شده (Cron)	زمان‌بندی دقیق، اجرای ایزوله
۲۰ دقیقه دیگر به من یادآوری کن	وظایف زمان‌بندی‌شده (Cron)	یک‌باره با زمان‌بندی دقیق (--at)
اجرای تحلیل عمیق هفتگی	وظایف زمان‌بندی‌شده (Cron)	وظیفه مستقل، می‌تواند از مدل متفاوتی استفاده کند
بررسی صندوق ورودی هر ۳۰ دقیقه	Heartbeat	همراه با بررسی‌های دیگر دسته‌بندی می‌شود و از زمینه آگاه است
پایش تقویم برای رویدادهای پیش‌رو	Heartbeat	مناسب طبیعی برای آگاهی دوره‌ای
پیگیری پس از مصاحبه‌ای که ذکر شده	تعهدات استنباط‌شده	پیگیری شبیه حافظه، بدون درخواست یادآوری دقیق
بررسی ملایم وضعیت مراقبتی پس از زمینه کاربر	تعهدات استنباط‌شده	محدود به همان عامل و کانال
بررسی وضعیت یک زیرعامل یا اجرای ACP	وظایف پس‌زمینه	دفترکل وظایف همه کارهای جداشده را ردیابی می‌کند
حسابرسی اینکه چه چیزی و چه زمانی اجرا شد	وظایف پس‌زمینه	openclaw tasks list و openclaw tasks audit
پژوهش چندمرحله‌ای و سپس خلاصه‌سازی	TaskFlow	هماهنگ‌سازی پایدار با ردیابی بازبینی
اجرای یک اسکریپت هنگام بازنشانی نشست	قلاب‌ها	رویدادمحور، هنگام رویدادهای چرخه عمر فعال می‌شود
اجرای کد در هر فراخوانی ابزار	قلاب‌های Plugin	قلاب‌های درون‌فرآیندی می‌توانند فراخوانی‌های ابزار را رهگیری کنند
همیشه پیش از پاسخ‌دادن انطباق را بررسی کن	دستورهای پایدار	به‌صورت خودکار به هر نشست تزریق می‌شود

# وظایف زمان‌بندی‌شده (Cron) در برابر Heartbeat

بُعد	وظایف زمان‌بندی‌شده (Cron)	Heartbeat
زمان‌بندی	دقیق (عبارت‌های cron، یک‌باره)	تقریبی (پیش‌فرض هر ۳۰ دقیقه)
زمینه نشست	تازه (ایزوله) یا مشترک	زمینه کامل نشست اصلی
سوابق وظیفه	همیشه ایجاد می‌شود	هرگز ایجاد نمی‌شود
تحویل	کانال، webhook یا بی‌صدا	درون‌خطی در نشست اصلی
بهترین کاربرد برای	گزارش‌ها، یادآورها، کارهای پس‌زمینه	بررسی صندوق ورودی، تقویم، اعلان‌ها

وقتی به زمان‌بندی دقیق یا اجرای ایزوله نیاز دارید، از وظایف زمان‌بندی‌شده (Cron) استفاده کنید. وقتی کار از زمینه کامل نشست سود می‌برد و زمان‌بندی تقریبی کافی است، از Heartbeat استفاده کنید.

# مفاهیم اصلی

# وظایف زمان‌بندی‌شده (cron)

Cron زمان‌بند داخلی Gateway برای زمان‌بندی دقیق است. کارها را پایدار نگه می‌دارد، عامل را در زمان درست بیدار می‌کند و می‌تواند خروجی را به یک کانال گفتگو یا نقطه پایانی webhook تحویل دهد. از یادآورهای یک‌باره، عبارت‌های تکرارشونده و محرک‌های webhook ورودی پشتیبانی می‌کند.

وظایف زمان‌بندی‌شده را ببینید.

# وظایف

دفترکل وظایف پس‌زمینه همه کارهای جداشده را ردیابی می‌کند: اجراهای ACP، ایجاد زیرعامل‌ها، اجراهای cron ایزوله و عملیات CLI. وظایف رکورد هستند، نه زمان‌بند. برای بررسی آن‌ها از openclaw tasks list و openclaw tasks audit استفاده کنید.

وظایف پس‌زمینه را ببینید.

# تعهدات استنباط‌شده

تعهدات حافظه‌های پیگیری کوتاه‌مدت و اختیاری هستند. OpenClaw آن‌ها را از گفت‌وگوهای عادی استنباط می‌کند، به همان عامل و کانال محدودشان می‌کند و بررسی‌های موعددار را از طریق heartbeat تحویل می‌دهد. یادآورهای دقیقی که کاربر درخواست می‌کند همچنان به cron تعلق دارند.

تعهدات استنباط‌شده را ببینید.

# TaskFlow

TaskFlow زیرلایه هماهنگ‌سازی جریان روی وظایف پس‌زمینه است. جریان‌های چندمرحله‌ای پایدار را با حالت‌های همگام‌سازی مدیریت‌شده و آینه‌ای، ردیابی بازبینی و openclaw tasks flow list|show|cancel برای بررسی مدیریت می‌کند.

TaskFlow را ببینید.

# دستورهای پایدار

دستورهای پایدار به عامل اختیار عملیاتی دائمی برای برنامه‌های تعریف‌شده می‌دهند. آن‌ها در فایل‌های workspace زندگی می‌کنند (معمولاً AGENTS.md) و به هر نشست تزریق می‌شوند. برای اعمال مبتنی بر زمان، آن‌ها را با cron ترکیب کنید.

دستورهای پایدار را ببینید.

# قلاب‌ها

قلاب‌های داخلی اسکریپت‌های رویدادمحوری هستند که با رویدادهای چرخه عمر عامل (/new، /reset، /stop)، Compaction نشست، راه‌اندازی Gateway و جریان پیام فعال می‌شوند. آن‌ها به‌صورت خودکار از دایرکتوری‌ها کشف می‌شوند و می‌توان آن‌ها را با openclaw hooks مدیریت کرد. برای رهگیری درون‌فرآیندی فراخوانی ابزار، از قلاب‌های Plugin استفاده کنید.

قلاب‌ها را ببینید.

# Heartbeat

Heartbeat یک نوبت دوره‌ای نشست اصلی است (پیش‌فرض هر ۳۰ دقیقه). چندین بررسی (صندوق ورودی، تقویم، اعلان‌ها) را در یک نوبت عامل با زمینه کامل نشست دسته‌بندی می‌کند. نوبت‌های Heartbeat رکورد وظیفه ایجاد نمی‌کنند و تازگی بازنشانی روزانه/بی‌کار نشست را تمدید نمی‌کنند. برای یک چک‌لیست کوچک از HEARTBEAT.md استفاده کنید، یا وقتی بررسی‌های دوره‌ای فقط-موعددار را درون خود heartbeat می‌خواهید، از یک بلوک tasks: استفاده کنید. فایل‌های heartbeat خالی با empty-heartbeat-file رد می‌شوند؛ حالت وظیفه فقط-موعددار با no-tasks-due رد می‌شود. Heartbeatها وقتی کار cron فعال یا در صف است به تعویق می‌افتند، و heartbeat.skipWhenBusy نیز می‌تواند وقتی زیرعامل یا مسیرهای تو‌در‌تو مشغول‌اند آن‌ها را به تعویق بیندازد.

Heartbeat را ببینید.

# این‌ها چگونه با هم کار می‌کنند

• Cron زمان‌بندی‌های دقیق (گزارش‌های روزانه، مرورهای هفتگی) و یادآورهای یک‌باره را مدیریت می‌کند. همه اجراهای cron رکورد وظیفه ایجاد می‌کنند.
• Heartbeat پایش‌های معمول (صندوق ورودی، تقویم، اعلان‌ها) را هر ۳۰ دقیقه در یک نوبت دسته‌بندی‌شده مدیریت می‌کند.
• قلاب‌ها با اسکریپت‌های سفارشی به رویدادهای مشخص (بازنشانی نشست، Compaction، جریان پیام) واکنش نشان می‌دهند. قلاب‌های Plugin فراخوانی‌های ابزار را پوشش می‌دهند.
• دستورهای پایدار به عامل زمینه پایدار و مرزهای اختیار می‌دهند.
• TaskFlow جریان‌های چندمرحله‌ای را روی وظایف منفرد هماهنگ می‌کند.
• وظایف همه کارهای جداشده را به‌صورت خودکار ردیابی می‌کنند تا بتوانید آن‌ها را بررسی و حسابرسی کنید.

# مرتبط

• وظایف زمان‌بندی‌شده — زمان‌بندی دقیق و یادآورهای یک‌باره
• تعهدات استنباط‌شده — بررسی‌های پیگیری شبیه حافظه
• وظایف پس‌زمینه — دفترکل وظایف برای همه کارهای جداشده
• TaskFlow — هماهنگ‌سازی پایدار جریان چندمرحله‌ای
• قلاب‌ها — اسکریپت‌های چرخه عمر رویدادمحور
• قلاب‌های Plugin — قلاب‌های درون‌فرآیندی ابزار، پرامپت، پیام و چرخه عمر
• دستورهای پایدار — دستورالعمل‌های پایدار عامل
• Heartbeat — نوبت‌های دوره‌ای نشست اصلی
• مرجع پیکربندی — همه کلیدهای پیکربندی