openclaw cron

Gateway zamanlayıcısı için cron işlerini yönetin.

İşleri hızlıca oluşturun

openclaw cron create, openclaw cron add için bir takma addır. Yeni işler için önce zamanlamayı, sonra istemi koyun:

openclaw cron create "0 7 * * *" \  "Summarize overnight updates." \  --name "Morning brief" \  --agent ops

İş, bir sohbet hedefine teslim etmek yerine tamamlanan yükü POST etmeliyse --webhook <url> kullanın:

openclaw cron create "0 18 * * 1-5" \  "Summarize today's deploys as JSON." \  --name "Deploy digest" \  --webhook "https://example.invalid/openclaw/cron"

Yalıtılmış bir ajan/model çalıştırması başlatmadan OpenClaw cron içinde çalışması gereken belirleyici kabuk tarzı işler için --command kullanın:

openclaw cron create "*/15 * * * *" \  --name "Queue depth probe" \  --command "scripts/check-queue.sh" \  --command-cwd "/srv/app" \  --announce \  --channel telegram \  --to "-1001234567890"

--command <shell>, argv: ["sh", "-lc", <shell>] depolar. Tam argv yürütmesi için --command-argv '["node","scripts/report.mjs"]' kullanın. Komut işleri stdout/stderr yakalar, normal cron geçmişini kaydeder ve çıktıyı yalıtılmış işlerle aynı announce, webhook veya none teslim modları üzerinden yönlendirir. Yalnızca NO_REPLY yazdıran bir komut bastırılır.

Oturumlar

--session; main, isolated, current veya session:<id> kabul eder.

Teslim

openclaw cron list ve openclaw cron show <job-id> çözümlenen teslim rotasını önizler. channel: "last" için önizleme, rotanın ana veya geçerli oturumdan çözülüp çözülmediğini ya da kapalı şekilde başarısız olup olmayacağını gösterir.

Sağlayıcı önekli hedefler, çözümlenemeyen duyuru kanallarındaki belirsizliği giderebilir. Örneğin, to: "telegram:123", delivery.channel atlandığında veya last olduğunda Telegram seçer. Yalnızca yüklenen Plugin tarafından duyurulan önekler sağlayıcı seçicileridir. delivery.channel açıkça belirtilmişse önek bu kanalla eşleşmelidir; channel: "whatsapp" ile to: "telegram:123" reddedilir. imessage: ve sms: gibi hizmet önekleri kanalın sahip olduğu hedef söz dizimi olarak kalır.

Teslim sahipliği

Yalıtılmış cron sohbet teslimi ajan ile çalıştırıcı arasında paylaşılır:

• Bir sohbet rotası kullanılabiliyorsa ajan message aracını kullanarak doğrudan gönderebilir.
• announce, yalnızca ajan çözümlenen hedefe doğrudan göndermediyse son yanıtı yedek olarak teslim eder.
• webhook, tamamlanan yükü bir URL'ye gönderir.
• none, çalıştırıcı yedek teslimini devre dışı bırakır.

Webhook teslimini ayarlamak için cron add|create --webhook <url> veya cron edit <job-id> --webhook <url> kullanın. --webhook seçeneğini --announce, --no-deliver, --channel, --to, --thread-id veya --account gibi sohbet teslim bayraklarıyla birleştirmeyin.

cron edit <job-id>, tek tek teslim yönlendirme alanlarını --clear-channel, --clear-to, --clear-thread-id ve --clear-account ile kaldırabilir (her biri eşleşen ayarlama bayrağıyla birleştirildiğinde reddedilir). Yalnızca çalıştırıcı yedek teslimini devre dışı bırakan --no-deliver seçeneğinden farklı olarak bunlar depolanan alanı kaldırır; böylece iş rotasının o bölümünü yeniden varsayılanlardan çözer.

--announce, son yanıt için çalıştırıcı yedek teslimidir. --no-deliver bu yedeği devre dışı bırakır ancak bir sohbet rotası kullanılabiliyorsa ajanın message aracını kaldırmaz.

Etkin bir sohbetten oluşturulan anımsatıcılar, yedek duyuru teslimi için canlı sohbet teslim hedefini korur. Dahili oturum anahtarları küçük harfli olabilir; bunları Matrix oda kimlikleri gibi büyük/küçük harfe duyarlı sağlayıcı kimlikleri için doğruluk kaynağı olarak kullanmayın.

Hata teslimi

Hata bildirimleri şu sırayla çözümlenir:

1. İşteki delivery.failureDestination.
2. Genel cron.failureDestination.
3. İşin birincil duyuru hedefi (açık bir hata hedefi ayarlanmadığında).

Not: Yalıtılmış cron çalıştırmaları, yanıt yükü üretilmese bile çalıştırma düzeyi ajan hatalarını iş hatası olarak ele alır; böylece model/sağlayıcı hataları yine de hata sayaçlarını artırır ve hata bildirimlerini tetikler.

Komut cron işleri yalıtılmış bir ajan turu başlatmaz. Sıfır çıkış kodu ok kaydeder; sıfır olmayan çıkış, sinyal, zaman aşımı veya çıktı yok zaman aşımı error kaydeder ve aynı hata bildirimi yolunu tetikleyebilir.

Yalıtılmış bir çalıştırma ilk model isteğinden önce zaman aşımına uğrarsa openclaw cron show ve openclaw cron runs, setup timed out before runner start veya stalled before first model call (last phase: context-engine) gibi aşamaya özgü bir hata içerir. CLI destekli sağlayıcılar için model öncesi bekçi, harici CLI turu başlayana kadar etkin kalır; böylece oturum arama, hook, kimlik doğrulama, istem ve CLI kurulum takılmaları model öncesi cron hataları olarak bildirilir.

Zamanlama

Tek seferlik işler

--at <datetime> tek seferlik bir çalıştırma zamanlar. Ofsetsiz tarih-saatler, --tz <iana> da geçmezseniz UTC olarak ele alınır; --tz <iana> verilen saat dilimindeki duvar saati zamanını yorumlar.

Yinelenen işler

Yinelenen işler, ardışık hatalardan sonra üstel yeniden deneme geri çekilmesi kullanır: 30s, 1m, 5m, 15m, 60m. Bir sonraki başarılı çalıştırmadan sonra zamanlama normale döner.

Atlanan çalıştırmalar yürütme hatalarından ayrı izlenir. Yeniden deneme geri çekilmesini etkilemezler, ancak openclaw cron edit <job-id> --failure-alert-include-skipped, hata uyarılarını tekrarlanan atlanan çalıştırma bildirimlerine dahil edebilir.

Yerel yapılandırılmış bir model sağlayıcısını hedefleyen yalıtılmış işler için cron, ajan turunu başlatmadan önce hafif bir sağlayıcı ön denetimi çalıştırır. Loopback, özel ağ ve .local api: "ollama" sağlayıcıları /api/tags üzerinde yoklanır; vLLM, SGLang ve LM Studio gibi yerel OpenAI uyumlu sağlayıcılar /models üzerinde yoklanır. Uç noktaya erişilemiyorsa çalıştırma skipped olarak kaydedilir ve daha sonraki bir zamanlamada yeniden denenir; eşleşen ölü uç noktalar, birçok işin aynı yerel sunucuyu zorlamasını önlemek için 5 dakika önbelleğe alınır.

Not: cron işleri, bekleyen çalışma zamanı durumu ve çalıştırma geçmişi paylaşılan SQLite durum veritabanında yaşar. Eski jobs.json, jobs-state.json ve runs/*.jsonl dosyaları bir kez içe aktarılır ve .migrated sonekiyle yeniden adlandırılır. İçe aktarmadan sonra zamanlamaları JSON dosyalarını düzenlemek yerine openclaw cron add|edit|remove ile düzenleyin.

Manuel çalıştırmalar

openclaw cron run <job-id> varsayılan olarak zorla çalıştırır ve manuel çalıştırma kuyruğa alınır alınmaz döner. Başarılı yanıtlar { ok: true, enqueued: true, runId } içerir. Daha sonraki sonucu incelemek için dönen runId değerini kullanın:

openclaw cron run <job-id>openclaw cron runs --id <job-id> --run-id <run-id>

Bir betik, tam olarak o kuyruğa alınmış çalıştırma terminal durumu kaydedene kadar bloklamalıysa --wait ekleyin:

openclaw cron run <job-id> --wait --wait-timeout 10m --poll-interval 2s

--wait ile CLI yine önce cron.run çağırır, ardından dönen runId için cron.runs yoklar. Komut yalnızca çalıştırma ok durumuyla bittiğinde 0 ile çıkar. Çalıştırma error veya skipped ile bittiğinde, Gateway yanıtı bir runId içermediğinde veya --wait-timeout süresi dolduğunda sıfır olmayan değerle çıkar. --poll-interval sıfırdan büyük olmalıdır.

Modeller

cron add|edit --model <ref> iş için izin verilen bir model seçer. cron add|edit --fallbacks <list> iş başına geri dönüş modellerini ayarlar; örneğin --fallbacks openrouter/gpt-4.1-mini,openai/gpt-5; geri dönüşsüz katı bir çalıştırma için --fallbacks "" geçin. cron edit <job-id> --clear-fallbacks iş başına geri dönüş geçersiz kılmasını kaldırır. cron edit <job-id> --clear-model, iş başına model geçersiz kılmasını kaldırır; böylece iş normal cron model seçimi önceliğini izler (varsa depolanan cron oturumu geçersiz kılması, aksi halde ajan/varsayılan model); --model ile birleştirilemez. cron add|edit --thinking <level> iş başına düşünme geçersiz kılması ayarlar; cron edit <job-id> --clear-thinking bunu kaldırır, böylece iş normal cron düşünme önceliğini izler ve --thinking ile birleştirilemez.

Cron --model, bir sohbet oturumu /model geçersiz kılması değil, bir iş birincilidir. Bunun anlamı şudur:

• Seçilen iş modeli başarısız olduğunda yapılandırılmış model geri dönüşleri yine de uygulanır.
• İş başına yük fallbacks mevcut olduğunda yapılandırılmış geri dönüş listesinin yerini alır.
• Boş bir iş başına geri dönüş listesi (iş yükünde/API'de --fallbacks "" veya fallbacks: []) cron çalıştırmasını katı yapar.
• Bir işte --model varsa ancak geri dönüş listesi yapılandırılmamışsa OpenClaw, ajan birincilinin gizli bir yeniden deneme hedefi olarak eklenmemesi için açık bir boş geri dönüş geçersiz kılması geçirir.
• Yerel sağlayıcı ön denetimleri, bir cron çalıştırmasını skipped olarak işaretlemeden önce yapılandırılmış geri dönüşleri dolaşır.

openclaw doctor, sağlayıcı ad alanı sayıları ve agents.defaults.model ile uyumsuzluklar dahil olmak üzere halihazırda payload.model ayarlanmış işleri bildirir. Kimlik doğrulama, sağlayıcı veya faturalandırma davranışı canlı sohbet ile zamanlanmış işler arasında farklı göründüğünde bu denetimi kullanın.

Yalıtılmış cron model önceliği

Yalıtılmış cron etkin modeli şu sırayla çözer:

1. Gmail-hook geçersiz kılması.
2. İş başına --model.
3. Depolanan cron oturumu model geçersiz kılması (kullanıcı birini seçtiğinde).
4. Ajan veya varsayılan model seçimi.

Hızlı mod

Yalıtılmış cron hızlı modu, çözümlenen canlı model seçimini izler. Model yapılandırması params.fastMode varsayılan olarak uygulanır, ancak depolanan oturum fastMode geçersiz kılması yine de yapılandırmaya üstün gelir. Çözümlenen mod auto olduğunda eşik, seçilen modelin params.fastAutoOnSeconds değerini kullanır ve varsayılan olarak 60 saniyedir.

Canlı model değiştirme yeniden denemeleri

Yalıtılmış bir çalıştırma LiveSessionModelSwitchError fırlatırsa cron, yeniden denemeden önce etkin çalıştırma için değiştirilen sağlayıcıyı ve modeli (ve mevcut olduğunda değiştirilen kimlik doğrulama profili geçersiz kılmasını) kalıcı hale getirir. Dış yeniden deneme döngüsü, ilk denemeden sonra iki değiştirme yeniden denemesiyle sınırlıdır; ardından sonsuza kadar döngüye girmek yerine iptal eder.

Çalıştırma çıktısı ve reddetmeler

Eski onay bastırma

Yalıtılmış cron turları eski, yalnızca onay niteliğindeki yanıtları bastırır. İlk sonuç yalnızca ara durum güncellemesiyse ve nihai yanıttan hiçbir alt ajan çalıştırması sorumlu değilse cron, teslimden önce gerçek sonuç için bir kez yeniden ister.

Sessiz belirteç bastırma

Yalıtılmış bir Cron çalıştırması yalnızca sessiz belirteci (NO_REPLY veya no_reply) döndürürse Cron, hem doğrudan giden teslimi hem de yedek kuyruğa alınmış özet yolunu bastırır; bu nedenle sohbete hiçbir şey geri gönderilmez.

Yapılandırılmış retler

Yalıtılmış Cron çalıştırmaları, yerleşik çalıştırmadan gelen yapılandırılmış yürütme reddi meta verilerini yetkili ret sinyali olarak kullanır. Ayrıca iç içe yapılandırılmış hata iletisi SYSTEM_RUN_DENIED veya INVALID_REQUEST ile başladığında node-host UNAVAILABLE sarmalayıcılarını da dikkate alırlar.

Cron, yerleşik çalıştırma yapılandırılmış ret meta verileri de sağlamadıkça nihai çıktı düzyazısını veya onay benzeri ret ifadelerini ret olarak sınıflandırmaz; bu nedenle sıradan asistan metni engellenmiş bir komut olarak ele alınmaz.

cron list ve çalıştırma geçmişi, engellenmiş bir komutu ok olarak raporlamak yerine ret nedenini gösterir.

Saklama

Saklama ve budama config içinde denetlenir:

• cron.sessionRetention (varsayılan 24h) tamamlanmış yalıtılmış çalıştırma oturumlarını budar.
• cron.runLog.keepLines iş başına saklanan SQLite çalıştırma geçmişi satırlarını budar. cron.runLog.maxBytes, eski dosya destekli çalıştırma günlükleriyle uyumluluk için kabul edilmeye devam eder.

Eski işleri taşıma

Yaygın düzenlemeler

İletiyi değiştirmeden teslim ayarlarını güncelleyin:

openclaw cron edit <job-id> --announce --channel telegram --to "123456789"

Yalıtılmış bir iş için teslimi devre dışı bırakın:

openclaw cron edit <job-id> --no-deliver

Yalıtılmış bir iş için hafif bootstrap bağlamını etkinleştirin:

openclaw cron edit <job-id> --light-context

Belirli bir kanala duyurun:

openclaw cron edit <job-id> --announce --channel slack --to "channel:C1234567890"

Bir Telegram forum konusuna duyurun:

openclaw cron edit <job-id> --announce --channel telegram --to "-1001234567890" --thread-id 42

Hafif bootstrap bağlamıyla yalıtılmış bir iş oluşturun:

openclaw cron create "0 7 * * *" \  "Summarize overnight updates." \  --name "Lightweight morning brief" \  --session isolated \  --light-context \  --no-deliver

--light-context yalnızca yalıtılmış ajan dönüşü işleri için geçerlidir. Cron çalıştırmalarında hafif mod, tam çalışma alanı bootstrap kümesini enjekte etmek yerine bootstrap bağlamını boş tutar.

Tam argv, cwd, env, stdin ve çıktı sınırlarıyla bir komut işi oluşturun:

openclaw cron create "*/30 * * * *" \  --name "Position export" \  --command-argv '["node","scripts/export-position.mjs"]' \  --command-cwd "/srv/app" \  --command-env "NODE_ENV=production" \  --command-input '{"mode":"summary"}' \  --timeout-seconds 120 \  --no-output-timeout-seconds 30 \  --output-max-bytes 65536 \  --webhook "https://example.invalid/openclaw/cron"

Yaygın yönetici komutları

Elle çalıştırma ve inceleme:

openclaw cron listopenclaw cron list --agent opsopenclaw cron get <job-id>openclaw cron show <job-id>openclaw cron run <job-id>openclaw cron run <job-id> --dueopenclaw cron run <job-id> --wait --wait-timeout 10mopenclaw cron run <job-id> --wait --wait-timeout 10m --poll-interval 2sopenclaw cron runs --id <job-id> --limit 50openclaw cron runs --id <job-id> --run-id <run-id>

openclaw cron list varsayılan olarak eşleşen tüm işleri gösterir. Yalnızca etkili normalleştirilmiş ajan kimliği eşleşen işleri göstermek için --agent <id> iletin; saklanan ajan kimliği olmayan işler yapılandırılmış varsayılan ajan olarak sayılır.

openclaw cron get <job-id> saklanan iş JSON'unu doğrudan döndürür. Teslim rotası önizlemesiyle insan tarafından okunabilir görünümü istediğinizde cron show <job-id> kullanın.

cron list --json ve cron show <job-id> --json, her işte enabled, state.runningAtMs ve state.lastRunStatus değerlerinden hesaplanan üst düzey bir status alanı içerir. Değerler: disabled, running, ok, error, skipped veya idle. Bu, insan tarafından okunabilir durum sütununu yansıtır; böylece harici araçlar iş durumunu yeniden türetmeden okuyabilir.

cron runs girdileri, amaçlanan Cron hedefi, çözümlenen hedef, mesaj aracı gönderimleri, yedek kullanım ve teslim edilmiş durumuyla birlikte teslim tanılamalarını içerir.

Ajan ve oturum yeniden hedefleme:

openclaw cron edit <job-id> --agent opsopenclaw cron edit <job-id> --clear-agentopenclaw cron edit <job-id> --session currentopenclaw cron edit <job-id> --session "session:daily-brief"

openclaw cron add, ajan dönüşü işlerinde --agent atlandığında uyarır ve varsayılan ajana (main) geri döner. Belirli bir ajanı sabitlemek için oluşturma sırasında --agent <id> iletin.

Teslim ayarlamaları:

openclaw cron edit <job-id> --announce --channel slack --to "channel:C1234567890"openclaw cron edit <job-id> --webhook "https://example.invalid/openclaw/cron"openclaw cron edit <job-id> --best-effort-deliveropenclaw cron edit <job-id> --no-best-effort-deliveropenclaw cron edit <job-id> --no-deliver

İlgili

• CLI başvurusu
• Zamanlanmış görevler