Automation کی خرابیوں کا ازالہ¶
اس صفحے کو شیڈیولر اور ترسیل سے متعلق مسائل کے لیے استعمال کریں (cron + heartbeat)۔
کمانڈ کی درجہ بندی¶
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
پھر آٹومیشن چیکس چلائیں:
openclaw cron status
openclaw cron list
openclaw system heartbeat last
Cron فائر نہیں ہو رہا¶
openclaw cron status
openclaw cron list
openclaw cron runs --id <jobId> --limit 20
openclaw logs --follow
اچھی آؤٹ پٹ کچھ یوں دکھائی دیتی ہے:
cron statusفعال ہونے اور مستقبل کےnextWakeAtMsکی رپورٹ کرتا ہے۔- جاب فعال ہے اور اس کے پاس درست شیڈول/ٹائم زون ہے۔
cron runsمیںokیا واضح اسکیپ وجہ دکھائی دیتی ہے۔
عام علامات:
cron: scheduler disabled; jobs will not run automatically→ کنفیگ/env میں کرون غیرفعال ہے۔cron: timer tick failed→ شیڈیولر ٹک کریش ہوا؛ قریبی اسٹیک/لاگ سیاق کا معائنہ کریں۔- رن آؤٹ پٹ میں
reason: not-due→ دستی رن--forceکے بغیر کال ہوا اور جاب ابھی واجب الادا نہیں تھا۔
Cron فائر ہوا لیکن ترسیل نہیں ہوئی¶
openclaw cron runs --id <jobId> --limit 20
openclaw cron list
openclaw channels status --probe
openclaw logs --follow
اچھی آؤٹ پٹ کچھ یوں دکھائی دیتی ہے:
- رن اسٹیٹس
okہے۔ - الگ تھلگ جابز کے لیے ترسیلی موڈ/ہدف سیٹ ہیں۔
- چینل پروب ہدف چینل کے کنیکٹ ہونے کی رپورٹ کرتا ہے۔
عام علامات:
- رن کامیاب ہوا لیکن ترسیلی موڈ
noneہے → کسی بیرونی پیغام کی توقع نہیں ہوتی۔ - ترسیلی ہدف غائب/غلط (
channel/to) → رن اندرونی طور پر کامیاب ہو سکتا ہے مگر آؤٹ باؤنڈ اسکیپ ہو جاتا ہے۔ - چینل تصدیقی غلطیاں (
unauthorized,missing_scope,Forbidden) → چینل کی اسناد/اجازتوں کی وجہ سے ترسیل بلاک ہو جاتی ہے۔
Heartbeat دبایا گیا یا اسکیپ ہوا¶
openclaw system heartbeat last
openclaw logs --follow
openclaw config get agents.defaults.heartbeat
openclaw channels status --probe
اچھی آؤٹ پٹ کچھ یوں دکھائی دیتی ہے:
- ہارٹ بیٹ غیر صفر وقفے کے ساتھ فعال ہے۔
- آخری ہارٹ بیٹ نتیجہ
ranہے (یا اسکیپ کی وجہ سمجھ میں آتی ہے)۔
عام علامات:
heartbeat skippedکے ساتھreason=quiet-hours→activeHoursسے باہر۔requests-in-flight→ مین لین مصروف؛ ہارٹ بیٹ مؤخر کر دیا گیا۔empty-heartbeat-file→HEARTBEAT.mdموجود ہے مگر اس میں قابلِ عمل مواد نہیں۔alerts-disabled→ ویژیبلیٹی سیٹنگز آؤٹ باؤنڈ ہارٹ بیٹ پیغامات کو دبا دیتی ہیں۔
Timezone اور activeHours کے مسائل¶
openclaw config get agents.defaults.heartbeat.activeHours
openclaw config get agents.defaults.heartbeat.activeHours.timezone
openclaw config get agents.defaults.userTimezone || echo "agents.defaults.userTimezone not set"
openclaw cron list
openclaw logs --follow
فوری اصول:
Config path not found: agents.defaults.userTimezoneکا مطلب ہے کہ کلید غیر سیٹ ہے؛ ہارٹ بیٹ ہوسٹ ٹائم زون پر واپس چلا جاتا ہے (یا اگر سیٹ ہو توactiveHours.timezone)۔--tzکے بغیر کرون گیٹ وے ہوسٹ ٹائم زون استعمال کرتا ہے۔- ہارٹ بیٹ
activeHoursکنفیگرڈ ٹائم زون ریزولوشن (user,local, یا واضح IANA tz) استعمال کرتا ہے۔ - بغیر ٹائم زون کے ISO ٹائم اسٹیمپس کرون
atشیڈولز کے لیے UTC سمجھے جاتے ہیں۔
عام علامات:
- ہوسٹ ٹائم زون میں تبدیلی کے بعد جابز غلط وال کلاک وقت پر چلتے ہیں۔
- دن کے وقت ہارٹ بیٹ ہمیشہ اسکیپ ہو جاتا ہے کیونکہ
activeHours.timezoneغلط ہے۔
متعلقہ: