Node.js 18+ (disarankan 20+)
OpenClaw CLI tersedia di PATH (openclaw)
Akses internet ke:
- https://api.aladhan.com/v1/timings
- https://api.aladhan.com/v1/gToH

Konfigurasi

Edit prayer_config.json:

{
  "location": {
    "name": "Cimahi",
    "latitude": -6.8722,
    "longitude": 107.5427,
    "expires": "2026-03-02"
  },
  "settings": {
    "auto_ramadan": true,
    "manual_override": null,
    "method": 11,
    "timezone": "Asia/Jakarta"
  },
  "sources": {
    "quotes_enabled": true,
    "current_day_source": "local"
  }
}

Keterangan penting:

location.name: label lokasi yang tampil di pesan.
latitude / longitude: koordinat lokasi.
settings.method: metode kalkulasi AlAdhan.
settings.timezone: timezone IANA (contoh Asia/Jakarta).
settings.auto_ramadan: deteksi Ramadan otomatis dari tanggal Hijriah.
settings.manual_override: true/false untuk override status Ramadan; null untuk otomatis.

Cara Menjalankan

Dari folder skill:

node engine.js --dry-run

Tidak menulis cron job, hanya simulasi output JSON.

node engine.js

Menambahkan cron one-shot ke OpenClaw untuk waktu shalat hari ini yang belum lewat.

Output

Engine mengeluarkan JSON ringkas, contoh:

status: hasil eksekusi
dryRun: mode simulasi atau real
location, timezone, ramadan
registered: jumlah job yang berhasil dijadwalkan
jobs[]: detail job per waktu shalat

Keamanan & Kepatuhan

Tidak ada hardcoded secret/token/api key.
Tidak ada hardcoded private/public IP.
Eksekusi CLI memakai execFileSync (tanpa shell command interpolation) untuk meminimalkan risiko command injection.
Penjadwalan job memakai openclaw cron add --at ... --system-event ... secara langsung (tanpa nested command / shell-style job string).
Input konfigurasi divalidasi (nama lokasi, koordinat, metode).
Input user location.name sekarang disanitasi untuk keamanan (hanya alphanumeric, spasi, dan -).
Request API dibatasi timeout (AbortSignal.timeout) agar tidak hang.

Catatan Operasional

Engine hanya menjadwalkan reminder hari berjalan; jalankan ulang harian (mis. via scheduler induk) untuk generate jadwal hari berikutnya.
Engine hanya menggunakan mode modern OpenClaw Cron (--at + --system-event) dan tidak lagi menyediakan fallback legacy berbasis --job 'at ...'.

prayer-times-id

prayer-times-id

Struktur File

Dependensi