--- read_when: - Zamanlanmış işler ve uyandırmalar istiyorsunuz - Cron yürütmesini ve günlükleri hata ayıklıyorsunuz summary: '`openclaw cron` için CLI referansı (arka plan işlerini zamanlama ve çalıştırma)' title: Cron x-i18n: generated_at: "2026-07-01T08:27:11Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: aed39843e183b3d441908ad4ac0578d44b6f0d482905871efc3421fd9820a1cc source_path: cli/cron.md workflow: 16 --- # `openclaw cron` Gateway zamanlayıcısı için cron işlerini yönetin. Tam komut yüzeyi için `openclaw cron --help` çalıştırın. Kavramsal kılavuz için [Cron işleri](/tr/automation/cron-jobs) bölümüne bakın. ## İş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: ```bash 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 ` kullanın: ```bash 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: Komut cron işleri, yönetici tarafından yazılan Gateway otomasyonudur. Bunları oluşturmak, düzenlemek, kaldırmak veya elle çalıştırmak `operator.admin` gerektirir; zamanlanmış çalıştırma daha sonra bir ajan `tools.exec` araç çağrısı olarak değil, Gateway sürecinde yürütülür. `tools.exec.*` ve exec onayları model tarafından görülebilen exec araçlarını yönetmeye devam eder. ```bash openclaw cron create "*/15 * * * *" \ --name "Queue depth probe" \ --command "scripts/check-queue.sh" \ --command-cwd "/srv/app" \ --announce \ --channel telegram \ --to "-1001234567890" ``` `--command `, `argv: ["sh", "-lc", ]` 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:` kabul eder. - `main`, ajanın ana oturumuna bağlanır. - `isolated`, her çalıştırma için yeni bir döküm ve oturum kimliği oluşturur. - `current`, oluşturma anındaki etkin oturuma bağlanır. - `session:`, açık bir kalıcı oturum anahtarına sabitler. Yalıtılmış çalıştırmalar ortam konuşma bağlamını sıfırlar. Kanal ve grup yönlendirmesi, gönderme/kuyruk 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ı tarafından açıkça seçilen model veya kimlik doğrulama geçersiz kılmaları çalıştırmalar arasında taşınabilir. ## Teslim `openclaw cron list` ve `openclaw cron show ` çö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. 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 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 ` veya `cron edit --webhook ` kullanın. `--webhook` seçeneğini `--announce`, `--no-deliver`, `--channel`, `--to`, `--thread-id` veya `--account` gibi sohbet teslim bayraklarıyla birleştirmeyin. `cron edit `, 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). Ana oturum işleri, `delivery.failureDestination` seçeneğini yalnızca birincil teslim modu `webhook` olduğunda kullanabilir. Yalıtılmış işler bunu tüm modlarda kabul eder. 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 ` tek seferlik bir çalıştırma zamanlar. Ofsetsiz tarih-saatler, `--tz ` da geçmezseniz UTC olarak ele alınır; `--tz ` verilen saat dilimindeki duvar saati zamanını yorumlar. Tek seferlik işler varsayılan olarak başarılı olduktan sonra silinir. Bunları korumak için `--keep-after-run` kullanın. ### 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 --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 ` 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: ```bash openclaw cron run openclaw cron runs --id --run-id ``` Bir betik, tam olarak o kuyruğa alınmış çalıştırma terminal durumu kaydedene kadar bloklamalıysa `--wait` ekleyin: ```bash openclaw cron run --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. Manuel komutun yalnızca iş şu anda süresi geldiyse çalışmasını istediğinizde `--due` kullanın. `--due --wait` bir çalıştırmayı kuyruğa almazsa komut yoklama yapmak yerine normal çalıştırma olmayan yanıtı döndürür. ## Modeller `cron add|edit --model ` iş için izin verilen bir model seçer. `cron add|edit --fallbacks ` 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 --clear-fallbacks` iş başına geri dönüş geçersiz kılmasını kaldırır. `cron edit --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 ` iş başına düşünme geçersiz kılması ayarlar; `cron edit --clear-thinking` bunu kaldırır, böylece iş normal cron düşünme önceliğini izler ve `--thinking` ile birleştirilemez. Model izinli değilse veya çözümlenemiyorsa cron, işin ajanına ya da varsayılan model seçimine geri dönmek yerine çalıştırmayı açık bir doğrulama hatasıyla başarısız yapar. 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 Geçerli teslim ve saklama biçiminden önce oluşturulmuş 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 `notify: true` Webhook yedek işlerini `cron.webhook` içinden açık Webhook teslimine taşır. Zaten bir sohbete duyuru yapan işler bu teslimi korur ve bir tamamlama Webhook hedefi alır. `cron.webhook` ayarlanmamış olduğunda, taşıma hedefi olmayan işler için etkisiz üst düzey `notify` işareti kaldırılır (mevcut teslim değişmeden korunur), bu nedenle `doctor --fix` artık bunlar hakkında tekrar tekrar uyarı vermez. ## Yaygın düzenlemeler İletiyi değiştirmeden teslim ayarlarını güncelleyin: ```bash openclaw cron edit --announce --channel telegram --to "123456789" ``` Yalıtılmış bir iş için teslimi devre dışı bırakın: ```bash openclaw cron edit --no-deliver ``` Yalıtılmış bir iş için hafif bootstrap bağlamını etkinleştirin: ```bash openclaw cron edit --light-context ``` Belirli bir kanala duyurun: ```bash openclaw cron edit --announce --channel slack --to "channel:C1234567890" ``` Bir Telegram forum konusuna duyurun: ```bash openclaw cron edit --announce --channel telegram --to "-1001234567890" --thread-id 42 ``` Hafif bootstrap bağlamıyla yalıtılmış bir iş oluşturun: ```bash 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: ```bash 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: ```bash openclaw cron list openclaw cron list --agent ops openclaw cron get openclaw cron show openclaw cron run openclaw cron run --due openclaw cron run --wait --wait-timeout 10m openclaw cron run --wait --wait-timeout 10m --poll-interval 2s openclaw cron runs --id --limit 50 openclaw cron runs --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 ` iletin; saklanan ajan kimliği olmayan işler yapılandırılmış varsayılan ajan olarak sayılır. `openclaw cron get ` 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 ` kullanın. `cron list --json` ve `cron show --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: ```bash openclaw cron edit --agent ops openclaw cron edit --clear-agent openclaw cron edit --session current openclaw cron edit --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 ` iletin. Teslim ayarlamaları: ```bash openclaw cron edit --announce --channel slack --to "channel:C1234567890" openclaw cron edit --webhook "https://example.invalid/openclaw/cron" openclaw cron edit --best-effort-deliver openclaw cron edit --no-best-effort-deliver openclaw cron edit --no-deliver ``` ## İlgili - [CLI başvurusu](/tr/cli) - [Zamanlanmış görevler](/tr/automation/cron-jobs)