Bootstrap agen

Bootstrapping adalah ritual pertama kali dijalankan yang menyiapkan ruang kerja agen baru dan memandu agen dalam memilih identitas. Proses ini berjalan sekali, tepat setelah onboarding, pada giliran nyata pertama agen.

Yang terjadi

Pada proses pertama terhadap ruang kerja yang benar-benar baru (default ~/.openclaw/workspace), OpenClaw:

• Menyiapkan AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md, dan BOOTSTRAP.md.
• Meminta agen mengikuti rangkaian kelahiran tiga tahap yang dibatasi: agen menanyakan nama yang ingin Anda berikan kepadanya, membagikan satu kalimat singkat tentang jiwa/nuansanya, dan menanyakan apakah Anda menginginkan set plugin minimal yang direkomendasikan atau kemudahan maksimal.
• Menyimpan identitas yang disepakati dua kali: ke dalam IDENTITY.md dan SOUL.md (yang dibaca agen tentang dirinya sendiri) serta melalui openclaw agents set-identity (yang ditampilkan oleh channel dan UI).
• Membaca rekomendasi aplikasi yang telah disimpan selama onboarding tanpa memindai ulang. Plugin resmi menggunakan openclaw plugins install <id>; skills ClawHub pihak ketiga tetap memerlukan persetujuan eksplisit. Setelah pilihan ditangani, agen mengonfirmasi penawaran yang tersimpan agar tidak pernah menanyakannya lagi.
• Menghapus BOOTSTRAP.md setelah ruang kerja tampak terkonfigurasi, sehingga ritual hanya berjalan sekali.

Ruang kerja dianggap terkonfigurasi setelah SOUL.md, IDENTITY.md, atau USER.md berbeda dari templat awalnya, atau terdapat folder memory/.

Proses model tertanam dan lokal

Untuk proses model tertanam atau lokal, OpenClaw menjaga BOOTSTRAP.md agar tidak masuk ke konteks sistem dengan hak istimewa. Pada proses interaktif utama yang pertama, OpenClaw tetap meneruskan isi file melalui prompt pengguna, sehingga model yang tidak memanggil alat read secara andal tetap dapat menyelesaikan ritual. Jika proses saat ini tidak dapat mengakses ruang kerja dengan aman, agen menerima catatan bootstrap terbatas yang singkat sebagai pengganti sapaan umum.

Melewati bootstrapping

Untuk melewati proses ini pada ruang kerja yang telah disiapkan sebelumnya, jalankan:

openclaw onboard --skip-bootstrap

Tempat proses berjalan

Bootstrapping selalu berjalan pada host gateway. Jika aplikasi macOS terhubung ke Gateway jarak jauh, ruang kerja dan file bootstrap-nya berada di mesin jarak jauh tersebut, bukan di Mac.

Dokumentasi terkait

• Onboarding aplikasi macOS: Onboarding
• Tata letak ruang kerja: Ruang kerja agen
• Isi templat: templat BOOTSTRAP.md