--- read_when: - Memulai sesi agen OpenClaw baru - Mengaktifkan atau mengaudit Skills bawaan summary: Instruksi agen OpenClaw default dan daftar Skills untuk penyiapan asisten pribadi title: AGENTS.md default x-i18n: generated_at: "2026-06-27T18:09:02Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 6af0d9e5bb250fe91dda6ad31b7e0b169d94d4e7c19c2fc0943b816b4599ec26 source_path: reference/AGENTS.default.md workflow: 16 --- ## 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): ```bash mkdir -p ~/.openclaw/workspace ``` 2. Salin template workspace default ke workspace: ```bash cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.md cp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.md cp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md ``` 3. Opsional: jika Anda menginginkan daftar skill asisten pribadi, ganti AGENTS.md dengan file ini: ```bash cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md ``` 4. Opsional: pilih workspace lain dengan mengatur `agents.defaults.workspace` (mendukung `~`): ```json5 { 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. ```bash cd ~/.openclaw/workspace git init git add AGENTS.md git 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:::group:` (ruangan/kanal: `agent:::channel:`); 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:` atau `channel:` (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](/id/concepts/agent-workspace) - [Runtime agent](/id/concepts/agent)