Versi lama halaman ini menempatkan SOUL.md, USER.md dan HEARTBEAT.md sebagai tiga file setara. Salah satunya sudah berubah: SOUL.md dan USER.md tetap menjadi context workspace, sedangkan HEARTBEAT.md lama digantikan monitor scratch yang dikelola sistem. Pada instalasi lama, periksa migrasi sebelum menggabungkan contoh.
Daftar isi
- Untuk siapa panduan ini
- Apa tugas dari tiga jenis file
- SOUL.md: tulis red line dulu, baru tugas
- USER.md: ubah preferensi pribadi jadi field
- HEARTBEAT.md: rendah frekuensi, banyak verifikasi
- Tabel field yang disarankan
- Konfigurasi juga perlu versi
Untuk siapa panduan ini
Cocok untuk pengguna yang sudah bisa menjalankan ringkasan read-only dan kini ingin agar konfigurasinya rapi serta mudah dirawat. Tujuannya bukan membuat AI lebih pintar berbicara, melainkan membuat alur kerjanya bisa diprediksi dan diperiksa ulang.
Tidak cocok untuk yang ingin satu file ajaib berisi strategi pasti untung. Konfigurasi yang baik justru menegaskan apa yang tidak boleh dilakukan AI, bukan menjanjikan hasil.
Pilih lokasi berdasarkan fungsi informasi
| Isi | Lokasi saat ini | Yang tepat disimpan |
|---|---|---|
SOUL.md | Context workspace | Persona, nada dan batas |
USER.md | Context workspace | Preferensi stabil dan cara menyapa |
AGENTS.md | Instruksi workspace | Aturan operasi, proyek dan catatan tool |
| Monitor scratch | Cron job yang dikelola sistem | Pemeriksaan berkala, kondisi alert dan perilaku diam |
SOUL.md: tulis red line dulu, baru tugas
SOUL adalah "kepribadian dan hukum" sang Agent. Hal terpenting bagi pengguna biasa bukan membuat AI lebih pandai bicara, melainkan membuatnya tahu apa yang tidak boleh dilakukan. Taruh red line di awal file dan gunakan kalimat larangan yang tegas.
Anda adalah Agent perapi informasi read-only milik ChainSentry.
Dilarang: mengeluarkan saran beli/jual, saran posisi, janji profit, kesimpulan "pasti aman".
Dilarang: meminta seed phrase, kode verifikasi, remote control, atau API Key berizin trading dari pengguna.
Wajib: setiap kesimpulan kunci disertai sumber, waktu, dan pengingat verifikasi manual.
USER.md: ubah preferensi pribadi jadi field
USER bukan buku harian, melainkan tabel preferensi. Disarankan menulis aset yang dipantau, bahasa, jam notifikasi, kata kunci risiko, daftar abaikan, dan panjang output. Dengan begitu, saat Anda menyesuaikan sesuatu, Anda tidak perlu mengubah batas dasar di SOUL.
HEARTBEAT.md lama: migrasikan, jangan terus ditambah
Halaman migrasi saat ini menyatakan workspace baru tidak membuat atau membaca HEARTBEAT.md. Jika file lama masih ada, gunakan openclaw doctor --fix agar isinya diimpor dan diarsipkan. Jangan mempertahankan tugas yang sama di file dan monitor.
Setelah itu, temukan monitor job melalui openclaw automations list --all dan baca instruksinya dengan openclaw automations scratch <jobId>. Ubah hanya setelah job ID dipastikan. openclaw cron … yang muncul di tutorial lama adalah alias untuk perintah yang sama (dokumentasi resmi Automations menyebut cron tetap bisa dipakai), jadi hasil keduanya sama.
Tabel field yang disarankan
| Field | Cara penulisan yang disarankan | Titik pemeriksaan |
|---|---|---|
| sources | Cantumkan pengumuman resmi, API harga, block explorer | Apakah sumber asli bisa dibuka |
| output_format | Tetapkan: ringkasan, anomali, perlu diverifikasi, kesimpulan terlarang | Apakah mengurangi basa-basi |
| red_lines | Larang janji profit dan perintah trading | Apakah ada di 20 baris pertama |
| failure_policy | Saat koneksi gagal, keluarkan "data tidak tersedia" | Apakah mencegah AI mengarang |
Simpan versi yang mudah dipulihkan
Sebelum mengubah file, simpan versi sekarang lalu catat tanggal, tujuan dan hasil yang diharapkan. Uji satu variabel setiap kali; jika hasil memburuk, pulihkan versi sebelumnya dan jangan menumpuk patch baru.
Jika perilaku salah, cari file yang bertanggung jawab
- Nada berubah-ubah: cari aturan yang bertentangan di SOUL.md.
- Preferensi keliru: periksa aturan lama dan baru yang sama-sama aktif di USER.md.
- Pengingat ganda: periksa cron job dan monitor scratch, bukan hanya HEARTBEAT.md.
- Edit seperti tidak aktif: pastikan Gateway memakai agent workspace yang sama dan periksa context yang diinjeksi.
Uji dengan permintaan normal, informasi yang kurang dan permintaan melewati batas. Rujuk Agent workspace, Agent runtime, dan catatan migrasi HEARTBEAT.md.
Diperiksa 2026-09-26. Batas karakter dan interval default yang mudah berubah tidak disalin.