خودکارسازی

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) در مقایسه با Heartbeat

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

مفاهیم اصلی

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

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

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

وظایف

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

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

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

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

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

جریان وظیفه

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

جریان وظیفه را ببینید.

دستورهای دائمی

دستورهای دائمی، اختیار عملیاتی همیشگی برای برنامه‌های تعریف‌شده به عامل اعطا می‌کنند. آن‌ها در فایل‌های فضای کاری، معمولاً 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 رد می‌شود. هنگامی که کار Cron فعال یا در صف است، Heartbeat به تعویق می‌افتد و heartbeat.skipWhenBusy نیز می‌تواند اجرای یک عامل را تا زمانی به تعویق بیندازد که مسیرهای زیرعامل مبتنی بر کلید نشست یا مسیرهای تو‌در‌توی همان عامل مشغول باشند.

Heartbeat را ببینید.

نحوه همکاری آن‌ها

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

مطالب مرتبط

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