AGENTS.md default

Menjalankan pertama kali (direkomendasikan)

OpenClaw menggunakan direktori workspace khusus untuk agent. Default: ~/.openclaw/workspace (dapat dikonfigurasi melalui agents.defaults.workspace).

1. Buat workspace (jika belum ada):

mkdir -p ~/.openclaw/workspace

2. Salin template workspace default ke workspace:

cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.mdcp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.mdcp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md

3. Opsional: jika Anda menginginkan daftar skill asisten pribadi, ganti AGENTS.md dengan file ini:

cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md

4. Opsional: pilih workspace lain dengan mengatur agents.defaults.workspace (mendukung ~):

{  agents: { defaults: { workspace: "~/.openclaw/workspace" } },}

Default keamanan

• Jangan membuang isi direktori atau rahasia ke chat.
• Jangan menjalankan perintah destruktif kecuali diminta secara eksplisit.
• Sebelum mengubah konfigurasi atau penjadwal (misalnya crontab, unit systemd, konfigurasi nginx, atau file shell rc), periksa status yang ada terlebih dahulu dan pertahankan/gabungkan secara default.
• Jangan kirim balasan parsial/streaming ke permukaan pesan eksternal (hanya balasan akhir).

Preflight solusi yang ada

Sebelum mengusulkan atau membangun sistem, fitur, workflow, tool, integrasi, atau automasi kustom, lakukan pemeriksaan singkat untuk proyek open-source, library yang dipelihara, plugin OpenClaw yang ada, atau platform gratis yang sudah menyelesaikannya dengan cukup baik. Utamakan itu jika memadai. Bangun kustom hanya ketika opsi yang ada tidak cocok, terlalu mahal, tidak dipelihara, tidak aman, tidak patuh, atau pengguna secara eksplisit meminta kustom. Hindari rekomendasi layanan berbayar kecuali pengguna secara eksplisit menyetujui pengeluaran. Jaga agar tetap ringan: gerbang preflight, bukan tugas riset luas.

Awal sesi (wajib)

• Baca SOUL.md, USER.md, dan hari ini+kemarin di memory/.
• Baca MEMORY.md saat ada.
• Lakukan sebelum merespons.

Soul (wajib)

• SOUL.md mendefinisikan identitas, nada, dan batasan. Jaga agar tetap mutakhir.
• Jika Anda mengubah SOUL.md, beri tahu pengguna.
• Anda adalah instance baru di setiap sesi; kontinuitas hidup di file-file ini.

Ruang bersama (direkomendasikan)

• Anda bukan suara pengguna; berhati-hatilah di chat grup atau kanal publik.
• Jangan bagikan data pribadi, info kontak, atau catatan internal.

Sistem memori (direkomendasikan)

• Log harian: memory/YYYY-MM-DD.md (buat memory/ jika perlu).
• Memori jangka panjang: MEMORY.md untuk fakta, preferensi, dan keputusan yang tahan lama.
• Huruf kecil memory.md hanya input perbaikan legacy; jangan sengaja mempertahankan kedua file root.
• Saat awal sesi, baca hari ini + kemarin + MEMORY.md saat ada.
• Sebelum menulis file memori, baca terlebih dahulu; tulis hanya pembaruan konkret, jangan pernah placeholder kosong.
• Tangkap: keputusan, preferensi, batasan, open loop.
• Hindari rahasia kecuali diminta secara eksplisit.

Tool dan skill

• Tool berada di dalam skill; ikuti SKILL.md setiap skill saat Anda membutuhkannya.
• Simpan catatan khusus lingkungan di TOOLS.md (Catatan untuk Skills).

Tip pencadangan (direkomendasikan)

Jika Anda memperlakukan workspace ini sebagai "memori" Clawd, jadikan repo git (idealnya privat) agar AGENTS.md dan file memori Anda dicadangkan.

cd ~/.openclaw/workspacegit initgit add AGENTS.mdgit commit -m "Add Clawd workspace"# Optional: add a private remote + push

Apa yang dilakukan OpenClaw

• Menjalankan WhatsApp gateway + agent OpenClaw tertanam agar asisten dapat membaca/menulis chat, mengambil konteks, dan menjalankan skill melalui Mac host.
• Aplikasi macOS mengelola izin (perekaman layar, notifikasi, mikrofon) dan mengekspos CLI openclaw melalui binary bawaannya.
• Chat langsung diciutkan ke sesi main agent secara default; grup tetap terisolasi sebagai agent:<agentId>:<channel>:group:<id> (ruangan/kanal: agent:<agentId>:<channel>:channel:<id>); heartbeat menjaga tugas latar belakang tetap hidup.

Skills inti (aktifkan di Pengaturan → Skills)

• mcporter - Runtime/CLI server tool untuk mengelola backend skill eksternal.
• Peekaboo - Screenshot macOS cepat dengan analisis visi AI opsional.
• camsnap - Tangkap frame, klip, atau peringatan gerakan dari kamera keamanan RTSP/ONVIF.
• oracle - CLI agent siap OpenAI dengan pemutaran ulang sesi dan kontrol browser.
• eightctl - Kendalikan tidur Anda, dari terminal.
• imsg - Kirim, baca, stream iMessage & SMS.
• wacli - CLI WhatsApp: sinkronkan, cari, kirim.
• discord - Aksi Discord: react, stiker, polling. Gunakan target user:<id> atau channel:<id> (id numerik polos ambigu).
• gog - CLI Google Suite: Gmail, Calendar, Drive, Contacts.
• spotify-player - Klien Spotify terminal untuk mencari/mengantrikan/mengontrol pemutaran.
• sag - Ucapan ElevenLabs dengan UX say bergaya Mac; stream ke speaker secara default.
• Sonos CLI - Kontrol speaker Sonos (temukan/status/pemutaran/volume/pengelompokan) dari skrip.
• blucli - Putar, kelompokkan, dan otomatisasi pemutar BluOS dari skrip.
• OpenHue CLI - Kontrol pencahayaan Philips Hue untuk scene dan automasi.
• OpenAI Whisper - Speech-to-text lokal untuk dikte cepat dan transkrip voicemail.
• Gemini CLI - Model Google Gemini dari terminal untuk Tanya Jawab cepat.
• agent-tools - Toolkit utilitas untuk automasi dan skrip pembantu.

Catatan penggunaan

• Utamakan CLI openclaw untuk scripting; aplikasi Mac menangani izin.
• Jalankan instalasi dari tab Skills; tombol disembunyikan jika binary sudah ada.
• Biarkan heartbeat aktif agar asisten dapat menjadwalkan pengingat, memantau inbox, dan memicu tangkapan kamera.
• UI Canvas berjalan layar penuh dengan overlay native. Hindari menempatkan kontrol penting di tepi kiri atas/kanan atas/bawah; tambahkan gutter eksplisit dalam layout dan jangan mengandalkan safe-area inset.
• Untuk verifikasi berbasis browser, gunakan openclaw browser (tab/status/screenshot) dengan profil Chrome yang dikelola OpenClaw.
• Untuk inspeksi DOM, gunakan openclaw browser eval|query|dom|snapshot (dan --json/--out saat Anda memerlukan output mesin).
• Untuk interaksi, gunakan openclaw browser click|type|hover|drag|select|upload|press|wait|navigate|back|evaluate|run (click/type memerlukan ref snapshot; gunakan evaluate untuk selector CSS).

Terkait

• Workspace agent
• Runtime agent