Backup Validator
Validates OpenClaw backup artifacts before push by checking skill structure, secret leaks, Termux compatibility, and repository status.
OPENCLAW BACKUP VALIDATOR
When to Use
Gunakan skill ini ketika:
- akan menjalankan backup sebelum push ke GitHub;
- baru menambahkan/mengubah skill di workspace;
- ingin memastikan tidak ada secret bocor;
- ingin memastikan struktur skill/workspace valid;
- ingin memastikan kompatibilitas Termux/Android sebelum deploy.
PURPOSE
Memvalidasi seluruh artefak backup OpenClaw sebelum di-push ke repo remote. Mencegah:
- secret leakage
- skill tidak valid
- struktur rusak
- asumsi Linux desktop palsu di Termux/Android
TRIGGER
Gunakan skill ini saat:
backup.shakan dijalankan- ada perubahan di
workspace/,skills/, atauskill-workshop/ - sebelum commit/push repo
openclaw-settings - setelah menambah skill baru
Jangan gunakan untuk:
- validasi Git log (gunakan Git tools)
- recovery data yang sudah terhapus permanen
- pengganti backup script yang ada
PRECONDITIONS
- Script backup
~/openclaw-backup/backup.shada dan dapat dieksekusi - Repo Git
~/openclaw-backupterinisialisasi python3tersedia untuk redactiongrep,find,gittersedia di PATH
Jika salah satu tidak ada, laporkan dan berikan fallback.
INPUT
BACKUP_DIRdefault:~/openclaw-backupWORKSPACE_DIRdefault:~/.openclaw/workspace- Optional:
EXTRA_PATHStambahan path untuk divalidasi
WORKFLOW
PHASE 1 — REQUIREMENT ANALYSIS ↓ Tentukan tujuan validasi.
PHASE 2 — ENVIRONMENT ANALYSIS ↓ Deteksi platform: Linux desktop / Termux / Android.
PHASE 3 — ARCHITECTURE ↓ Siapkan daftar cek: structure, secret, skill, compatibility.
PHASE 4 — IMPLEMENTATION ↓ Jalankan setiap validator.
PHASE 5 — VALIDATION ↓ Kumpulkan hasil dan klasifikasi.
PHASE 6 — HARDENING ↓ Tambahkan fallback jika tool/command gagal.
PHASE 7 — SELF-TEST ↓ Simulasikan kasus normal, failure, dan edge case.
PHASE 8 — FINALIZATION ↓ Laporkan status: PASS / FAIL / WARNING.
EXECUTION
Jalankan validator dalam urutan ini:
1. Platform Detection
Deteksi environment sebelum memilih strategi validasi.
IF $PREFIX contains com.termux OR $HOME contains com.termux:
PLATFORM = TERMUX
ELSE IF uname -s = Linux AND uname -m = x86_64:
PLATFORM = LINUX_DESKTOP
ELSE:
PLATFORM = UNKNOWN
Catat platform di laporan.
2. Structure Validation
Validasi struktur direktori backup.
Cek:
workspace/adaskills/adaworkspace-attestations/adaskill-workshop/adaagents/adatui/adaconfig/adametadata/ada
Jika ada direktori wajib yang hilang:
- laporkan ERROR
- berikan nama direktori yang hilang
- berikan recovery action: jalankan
backup.sh
3. Skill File Validation
Untuk setiap SKILL.md di workspace/skills/:
Cek:
- file ada dan bukan direktori
- ada frontmatter
name - ada
description - minimal satu bagian konten
Jika SKILL.md rusak:
- laporkan ERROR
- sebutkan path dan masalahnya
- berikan fallback: perbaiki manual atau restore dari Git
4. Secret Leak Detection
Gunakan dua lapisan validasi:
4a. Pattern Scan
Cari pola sensitif:
- Telegram bot token:
[0-9]{8,10}:[A-Za-z0-9_-]{35,} - OpenAI key:
sk-[A-Za-z0-9]{20,} - GitHub token:
ghp_[A-Za-z0-9]{30,}ataugithub_pat_[A-Za-z0-9_]{20,} - NVIDIA key:
nvapi-[A-Za-z0-9_-]{16,} - AWS key:
AKIA[0-9A-Z]{16} - Private key header:
-----BEGIN [A-Z ]*PRIVATE KEY-----
Jika ditemukan:
- laporkan ERROR
- sebutkan file dan pola yang terdeteksi
- berikan recovery: redact menggunakan script backup atau hapus/ubah file
4b. Redaction Verification
Jika backup sudah di-redact oleh backup.sh:
- pastikan file redacted tidak mengandung pola sensitif asli
- pastikan
agents/*/models.jsontidak berisiapi_key,token,secret,password
Jika redaction kurang:
- laporkan WARNING
- sarankan jalankan ulang
backup.sh
5. Git Status Validation
Cek repo backup:
git status --porcelainharus kosong setelah commit- Jika ada modified tetapi belum di-commit:
- laporkan WARNING
- minta commit atau
git reset --hardjika aman
- Jika ada untracked file penting:
- laporkan WARNING
- minta
git addatau sesuaikan.gitignore
6. Remote Sync Validation
Cek apakah branch main di remote up-to-date:
git rev-parse HEADgit rev-parse origin/main
Jika berbeda:
- laporkan INFO bahwa push diperlukan
- Jika berbeda jauh, laporkan WARNING untuk potential conflict
7. Skill Compatibility Check
Untuk setiap skill baru/diubah:
Cek:
- tidak ada tool/command fiktif
- tidak ada dependency yang tidak terdokumentasi
- path yang digunakan sesuai platform
IF PLATFORM = TERMUX:
- pastikan tidak mengasumsikan systemd
- pastikan tidak mengasumsikan path
/usr/local/... - pastikan tidak memanggil service desktop-only
- pastikan binary yang dibutuhkan tersedia atau punya fallback
Jika ketidakcocokan ditemukan:
- laporkan WARNING atau ERROR
- berikan alternatif Termux-realistik
8. Metadata Consistency
Cek:
metadata/system.txtberisi backup date validmetadata/skills-list.txtkonsisten denganworkspace/skills/metadata/workspace-skill-files.txtkonsisten dengan file yang ada
Jika inkonsistensi:
- laporkan WARNING
- berikan recovery: jalankan ulang backup atau perbaiki metadata manual
OUTPUT FORMAT
Berikan laporan dalam bentuk:
VALIDASI BACKUP — PASS / FAIL / WARNING
Platform: TERMUX / LINUX_DESKTOP / UNKNOWN
Summary
- Total skills checked: X
- Total files checked: Y
- Secret leaks: Z
- Structural issues: W
- Compatibility issues: V
Details
Structural
- [OK]
workspace/ - [FAIL]
agents/missing
Skills
- [OK]
aurum-brain/SKILL.md - [WARN]
new-skill/SKILL.mdmissing description
Secrets
- [OK] No Telegram token leak
- [FAIL]
path/to/filecontains possible API key pattern
Git
- [OK] Clean working tree
- [WARN] Uncommitted changes detected
Compatibility
- [OK] No Linux desktop-only assumptions in Termux
- [FAIL]
skill-xreferences/usr/local/bin/run.shon Termux
Recovery Actions
- Jalankan ulang
backup.sh - Redact file yang bocor
- Perbaiki
SKILL.mdyang rusak - ...
ERROR HANDLING
INPUT ERROR → Jelaskan path/format yang salah → Berikan contoh input yang benar → Jangan lanjut validasi parsial tanpa konfirmasi
DEPENDENCY ERROR
→ python3 tidak ada: gunakan grep + sed sebagai fallback parsial
→ git tidak ada: laporkan ERROR dan minta install
TOOL ERROR
→ grep/find gagal: laporkan ERROR dengan pesan dari tool
→ Jangan lanjut validator berikutnya jika struktur tidak bisa dibaca
NETWORK ERROR → Tidak mempengaruhi validasi offline → Skip remote sync check, laporkan INFO
AUTH ERROR → Tidak relevan untuk validator lokal → Skip
TIMEOUT → Batasi durasi scan direktori → Jika timeout, laporki sebagian hasil dan minta retry
PERMISSION ERROR
→ Laporkan file/directory yang tidak bisa dibaca
→ Berikan recovery: chmod atau jalankan dengan permission yang sesuai
ENVIRONMENT ERROR → Jika platform tidak terdeteksi, set UNKNOWN dan lanjut dengan asumsi konservatif
OUTPUT ERROR → Jika laporan tidak bisa ditulis, gunakan stdout sebagai fallback
UNKNOWN ERROR → Tangkap exception → Laporkan ERROR → Jangan redact otomatis tanpa tahu konteks
RETRY & FALLBACK
PRIMARY VALIDATOR ↓ FAILED? ↓ SAFE RETRY max 2x ↓ FAILED? ↓ FALLBACK validator subset ↓ FAILED? ↓ STOP REPORT ERROR
Aturan:
- Jangan retry tanpa batas
- Jangan retry setelah operasi destruktif
- Jangan lanjut push jika validator gagal dengan ERROR kritis
SECURITY
- Jangan cetak isi file sensitif
- Jangan simpan hasil scan secret ke file yang tidak dilindungi
- Jangan kirim laporan lengkap ke channel publik
- Jangan jalankan command berbahaya untuk validasi
- Jangan hapus file selama validasi; hanya laporkan
SELF-CHECK
Sebelum menyatakan validator selesai, pastikan:
[ ] Tujuan validator jelas [ ] Setiap cek memiliki kriteria pass/fail/warning [ ] Error handling tersedia untuk setiap kategori [ ] Fallback untuk tool yang tidak tersedia [ ] Platform detection berjalan [ ] Tidak ada command fiktif [ ] Tidak ada asumsi Linux desktop [ ] Output mudah dibaca agent [ ] Recovery action jelas untuk setiap masalah [ ] Tidak ada side effect destruktif
QUALITY GATE
Nilai validator:
Architecture: apakah alur validasi logis dan tidak terputus? Reliability: apakah tetap berjalan jika sebagian tool gagal? Clarity: apakah laporan mudah dipahami agent/user? Tool Usage: apakah hanya pakai tool yang tersedia? Error Handling: apakah semua error tercover? Security: apakah aman dari secret exposure? Compatibility: apakah aman di Termux/Android/desktop? Maintainability: apakah mudah diperbarui jika pola secret berubah? Extensibility: apakah mudah menambah cek baru? Verification: apakah agent bisa mempercayai hasil laporan?
Target: minimal 90 untuk production-ready.
Jika di bawah 90: perbaiki validator sebelum menganggap siap.
FINAL RESPONSE FORMAT
Setelah menjalankan validasi, berikan:
STATUS: PASS / FAIL / NEEDS IMPROVEMENT PLATFORM: TERMUX / LINUX_DESKTOP / UNKNOWN SCORE: 0-100
SUMMARY:
- Ringkasan hasil utama
DETAILS:
- Daftar cek dengan status
RECOVERY:
- Langkah perbaikan yang perlu dilakukan
Jika PASS:
- aman untuk lanjut backup/push
Jika FAIL:
- jangan push sampai diperbaiki
Jika NEEDS IMPROVEMENT:
- perbaiki sesuai rekomendasi, lalu validasi ulang
GOLDEN RULE
Jangan pernah memaksa laporan PASS jika ada ERROR kritis. Lebih baik validator menolak push daripada secret bocor atau skill rusak.
Target akhirnya:
RELIABLE + SECURE + PLATFORM-AWARE + ACTIONABLE + PRODUCTION-READY
Common Mistakes
| Mistake | Fix |
|---|---|
| Validating presence only | Check integrity, not just existence |
| No hash verification | Compare hashes for consistency |
| Ignoring permissions | Validate file permissions |
| Missing restore test | Verify backup can be restored |
Red Flags
- Claiming valid without integrity check
- No restore verification
- Missing permission checks
- Ignoring corruption signs
Rationalization Prevention
| Excuse | Reality |
|---|---|
| "The files are there" | Existence ≠ integrity. |
| "It worked before" | Verify current backup. |
| "Hashes take too long" | Integrity matters. |
Quick Reference
| Situasi | Aksi |
|---|---|
| Validasi backup | Jalankan checker |
| Backup rusak | Diagnosa & repair |
| Cek integritas | Hash + struktur |
| Restore | Verifikasi hasil |
| Rutin | Jadwalkan validasi |
- Downloads
- Security audit
- Pass
- Last updated
- 2mo ago
- Current version
- v1.0.0
- License
- MIT-0
