Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw cron
Gateway zamanlayıcısı için Cron işlerini yönetin.
Oturumlar
--session, main, isolated, current veya session:<id> kabul eder.
Oturum anahtarları
Oturum anahtarları
main, aracının ana oturumuna bağlanır.isolated, her çalıştırma için yeni bir transcript ve oturum kimliği oluşturur.current, oluşturma anındaki etkin oturuma bağlanır.session:<id>, açık bir kalıcı oturum anahtarına sabitler.
Yalıtılmış oturum semantiği
Yalıtılmış oturum semantiği
Yalıtılmış çalıştırmalar ortam konuşma bağlamını sıfırlar. Kanal ve grup yönlendirmesi, gönderme/kuyruğa alma ilkesi, yükseltme, kaynak ve ACP çalışma zamanı bağlaması yeni çalıştırma için sıfırlanır. Güvenli tercihler ve kullanıcının açıkça seçtiği model veya auth geçersiz kılmaları çalıştırmalar arasında taşınabilir.
Teslim
openclaw cron list ve openclaw cron show <job-id> çözümlenen teslim rotasının önizlemesini gösterir. channel: "last" için önizleme, rotanın ana oturumdan mı yoksa geçerli oturumdan mı çözümlendiğini ya da kapalı şekilde başarısız olacağını gösterir.
Provider önekli hedefler, çözümlenmemiş 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 ilan edilen önekler provider seçicileridir. delivery.channel açıkça belirtilmişse, önek o kanalla eşleşmelidir; channel: "whatsapp" ile to: "telegram:123" reddedilir. imessage: ve sms: gibi servis önekleri kanalın sahip olduğu hedef sözdizimi olarak kalır.
Yalıtılmış
cron add işleri varsayılan olarak --announce teslimini kullanır. Çıktıyı dahili tutmak için --no-deliver kullanın. --deliver, --announce için kullanımdan kaldırılmış bir takma ad olarak kalır.Teslim sahipliği
Yalıtılmış Cron sohbet teslimi aracı ile runner arasında paylaşılır:- Aracı, bir sohbet rotası kullanılabilir olduğunda
messagearacını kullanarak doğrudan gönderebilir. announce, yalnızca aracı çözümlenen hedefe doğrudan göndermediyse son yanıtı yedek olarak teslim eder.webhook, tamamlanan payload’u bir URL’ye gönderir.none, runner yedek teslimini devre dışı bırakır.
--announce, son yanıt için runner yedek teslimidir. --no-deliver, bu yedeği devre dışı bırakır ancak bir sohbet rotası kullanılabilir olduğunda aracının message aracını kaldırmaz.
Etkin bir sohbetten oluşturulan hatırlatıcılar, yedek duyuru teslimi için canlı sohbet teslim hedefini korur. Dahili oturum anahtarları küçük harf olabilir; bunları Matrix oda kimlikleri gibi büyük/küçük harfe duyarlı provider kimlikleri için doğruluk kaynağı olarak kullanmayın.
Hata teslimi
Hata bildirimleri şu sırayla çözümlenir:- İşteki
delivery.failureDestination. - Genel
cron.failureDestination. - İşin birincil duyuru hedefi (açık bir hata hedefi ayarlanmadığında).
Ana oturum işleri,
delivery.failureDestination öğesini yalnızca birincil teslim modu webhook olduğunda kullanabilir. Yalıtılmış işler bunu tüm modlarda kabul eder.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 provider’lar için, model öncesi watchdog dış CLI turu başlayana kadar etkin kalır; bu nedenle oturum arama, hook, auth, prompt ve CLI kurulum takılmaları model öncesi Cron hataları olarak raporlanır.
Zamanlama
Tek seferlik işler
--at <datetime>, tek seferlik bir çalıştırma zamanlar. Offset içermeyen datetime değerleri, --tz <iana> da geçmediğiniz sürece UTC olarak ele alınır; bu seçenek, duvar saati zamanını verilen saat diliminde yorumlar.
Tek seferlik işler varsayılan olarak başarıdan sonra silinir. Bunları korumak için
--keep-after-run kullanın.Yinelenen işler
Yinelenen işler, ardışık hatalardan sonra üstel yeniden deneme backoff’u 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 backoff’unu etkilemezler, ancakopenclaw cron edit <job-id> --failure-alert-include-skipped, hata uyarılarını yinelenen atlanmış çalıştırma bildirimlerine dahil edebilir.
Yerel yapılandırılmış bir model provider’ı hedefleyen yalıtılmış işler için Cron, aracı turunu başlatmadan önce hafif bir provider preflight çalıştırır. Loopback, private-network ve .local api: "ollama" provider’ları /api/tags üzerinde yoklanır; vLLM, SGLang ve LM Studio gibi yerel OpenAI uyumlu provider’lar /models üzerinde yoklanır. Endpoint erişilemezse, çalıştırma skipped olarak kaydedilir ve daha sonraki bir zamanlamada yeniden denenir; eşleşen ölü endpoint’ler, birçok işin aynı yerel sunucuya yük bindirmesini önlemek için 5 dakika önbelleğe alınır.
Not: Cron iş tanımları jobs.json içinde yaşarken, bekleyen çalışma zamanı durumu jobs-state.json içinde yaşar. jobs.json harici olarak düzenlenirse, Gateway değişen zamanlamaları yeniden yükler ve eski bekleyen slotları temizler; yalnızca biçimlendirme amaçlı yeniden yazımlar bekleyen slotu temizlemez.
Manuel çalıştırmalar
openclaw cron run, 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. Sonucu izlemek için openclaw cron runs --id <job-id> kullanın.
openclaw cron run <job-id> varsayılan olarak zorla çalıştırır. Daha eski “yalnızca zamanı geldiyse çalıştır” davranışını korumak için --due kullanın.Modeller
cron add|edit --model <ref>, iş için izin verilen bir model seçer.
Cron --model, bir sohbet oturumu /model geçersiz kılması değil, iş birinciliğidir. Bunun anlamı:
- Seçilen iş modeli başarısız olduğunda yapılandırılmış model fallback’leri hâlâ uygulanır.
- İş başına payload
fallbacksmevcut olduğunda yapılandırılmış fallback listesinin yerini alır. - Boş bir iş başına fallback listesi (iş payload/API içinde
fallbacks: []), Cron çalıştırmasını katı hale getirir. - Bir işte
--modelvarsa ancak fallback listesi yapılandırılmamışsa, OpenClaw açık bir boş fallback geçersiz kılması geçirir; böylece aracı birinciliği gizli yeniden deneme hedefi olarak eklenmez.
Yalıtılmış Cron model önceliği
Yalıtılmış Cron etkin modeli şu sırayla çözümler:- Gmail-hook geçersiz kılması.
- İş başına
--model. - Saklanan Cron oturumu model geçersiz kılması (kullanıcı bir tane seçtiğinde).
- Aracı 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 saklanan oturum fastMode geçersiz kılması yapılandırmaya göre yine önceliklidir.
Canlı model değiştirme yeniden denemeleri
Yalıtılmış bir çalıştırmaLiveSessionModelSwitchError fırlatırsa, Cron yeniden denemeden önce etkin çalıştırma için değiştirilen provider ve modeli (ve mevcut olduğunda değiştirilen auth profil geçersiz kılmasını) kalıcı hale getirir. Dış yeniden deneme döngüsü, ilk denemeden sonra iki switch yeniden denemesiyle sınırlıdır; ardından sonsuza kadar döngüye girmek yerine iptal eder.
Çalıştırma çıktısı ve retler
Eski onay bastırma
Yalıtılmış Cron turları, eski yalnızca onay niteliğindeki yanıtları bastırır. İlk sonuç yalnızca geçici bir durum güncellemesiyse ve nihai yanıttan sorumlu bir alt aracı çalıştırması yoksa, Cron teslimden önce gerçek sonuç için bir kez yeniden prompt gönderir.Sessiz token bastırma
Yalıtılmış bir Cron çalıştırması yalnızca sessiz token (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; böylece sohbete hiçbir şey gönderilmez.
Yapılandırılmış retler
Yalıtılmış Cron çalıştırmaları, gömülü çalıştırmadan gelen yapılandırılmış yürütme reddi metadata’sını tercih eder; ardındanSYSTEM_RUN_DENIED, INVALID_REQUEST ve onay bağlama reddi ifadeleri gibi son çıktıda bilinen ret işaretçilerine geri döner.
cron list ve çalıştırma geçmişi, engellenen bir komutu ok olarak bildirmek yerine ret nedenini gösterir.
Saklama
Saklama ve budama yapılandırmada kontrol edilir:cron.sessionRetention(varsayılan24h), tamamlanmış yalıtılmış çalıştırma oturumlarını budar.cron.runLog.maxBytesvecron.runLog.keepLines,~/.openclaw/cron/runs/<jobId>.jsonldosyasını budar.
Eski işleri taşıma
Geçerli teslim ve depolama biçiminden önceki Cron işleriniz varsa,
openclaw doctor --fix çalıştırın. Doctor, eski Cron alanlarını (jobId, schedule.cron, eski threadId dahil üst düzey teslim alanları, payload provider teslim takma adları) normalleştirir ve cron.webhook yapılandırıldığında basit notify: true webhook fallback işlerini açık webhook teslimine taşır.Yaygın düzenlemeler
Mesajı değiştirmeden teslim ayarlarını güncelleyin:--light-context, yalnızca yalıtılmış aracı turu işlerine uygulanır. Cron çalıştırmaları için hafif mod, tam workspace bootstrap kümesini enjekte etmek yerine bootstrap bağlamını boş tutar.
Yaygın yönetici komutları
Manuel çalıştırma ve inceleme:openclaw cron list, varsayılan olarak eşleşen tüm işleri gösterir. Yalnızca etkili normalleştirilmiş aracı kimliği eşleşen işleri göstermek için --agent <id> geçin; saklanan aracı kimliği olmayan işler yapılandırılmış varsayılan aracı 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 üst düzey bir status alanı içerir; bu alan enabled, state.runningAtMs ve state.lastRunStatus üzerinden hesaplanır. 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, hedeflenen Cron hedefi, çözümlenen hedef, message-tool gönderimleri, fallback kullanımı ve teslim edilmiş durumla birlikte teslim tanılamalarını içerir.
Aracı ve oturum yeniden hedefleme:
openclaw cron add, aracı turu işlerinde --agent atlandığında uyarır ve varsayılan aracıya (main) geri döner. Belirli bir aracı sabitlemek için oluşturma sırasında --agent <id> geçin.
Teslim ayarlamaları: