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.

Kenali generasi workspace
Ikuti dokumentasi saat ini untuk workspace baru. Pada workspace lama, jalankan Doctor resmi. Jika hasil pencarian memperlihatkan dua pola, gunakan output Doctor dari instalasi Anda.

Daftar isi

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

IsiLokasi saat iniYang tepat disimpan
SOUL.mdContext workspacePersona, nada dan batas
USER.mdContext workspacePreferensi stabil dan cara menyapa
AGENTS.mdInstruksi workspaceAturan operasi, proyek dan catatan tool
Monitor scratchCron job yang dikelola sistemPemeriksaan 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

FieldCara penulisan yang disarankanTitik pemeriksaan
sourcesCantumkan pengumuman resmi, API harga, block explorerApakah sumber asli bisa dibuka
output_formatTetapkan: ringkasan, anomali, perlu diverifikasi, kesimpulan terlarangApakah mengurangi basa-basi
red_linesLarang janji profit dan perintah tradingApakah ada di 20 baris pertama
failure_policySaat 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.