--- read_when: - Memulai sesi agen OpenClaw baru - Mengaktifkan atau mengaudit Skills bawaan summary: Instruksi agen OpenClaw bawaan dan daftar Skills untuk pengaturan asisten pribadi title: AGENTS.md Bawaan x-i18n: generated_at: "2026-05-06T09:26:29Z" model: gpt-5.5 provider: openai source_hash: 8ecfafd0bee8b18f5787a0b8e273ce281c40c7d2d5754f15daa1f2b7cc7ecad0 source_path: reference/AGENTS.default.md workflow: 16 --- ## Jalankan pertama kali (direkomendasikan) OpenClaw menggunakan direktori workspace khusus untuk agen. Default: `~/.openclaw/workspace` (dapat dikonfigurasi melalui `agents.defaults.workspace`). 1. Buat workspace (jika belum ada): ```bash mkdir -p ~/.openclaw/workspace ``` 2. Salin templat workspace default ke dalam 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 direktori atau rahasia ke chat. - Jangan jalankan perintah destruktif kecuali diminta secara eksplisit. - Jangan kirim balasan parsial/streaming ke permukaan perpesanan eksternal (hanya balasan final). ## Awal sesi (wajib) - Baca `SOUL.md`, `USER.md`, dan hari ini+kemarin di `memory/`. - Baca `MEMORY.md` jika ada. - Lakukan sebelum merespons. ## Soul (wajib) - `SOUL.md` mendefinisikan identitas, nada, dan batasan. Jaga agar tetap terbaru. - Jika Anda mengubah `SOUL.md`, beri tahu pengguna. - Anda adalah instance baru di setiap sesi; kontinuitas berada di file-file ini. ## Ruang bersama (direkomendasikan) - Anda bukan suara pengguna; berhati-hatilah di chat grup atau kanal publik. - Jangan bagikan data pribadi, informasi 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. - `memory.md` huruf kecil adalah input perbaikan lama saja; jangan sengaja menyimpan kedua file root. - Saat awal sesi, baca hari ini + kemarin + `MEMORY.md` jika ada. - Tangkap: keputusan, preferensi, batasan, loop terbuka. - Hindari rahasia kecuali diminta secara eksplisit. ## Alat dan skill - Alat berada di dalam skill; ikuti `SKILL.md` masing-masing skill saat Anda membutuhkannya. - Simpan catatan khusus lingkungan di `TOOLS.md` (Catatan untuk Skills). ## Tips pencadangan (direkomendasikan) Jika Anda memperlakukan workspace ini sebagai "memori" Clawd, jadikan ini 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 Gateway WhatsApp + agen pengodean Pi sehingga asisten dapat membaca/menulis chat, mengambil konteks, dan menjalankan skill melalui host Mac. - Aplikasi macOS mengelola izin (perekaman layar, notifikasi, mikrofon) dan mengekspos CLI `openclaw` melalui biner bawaannya. - Chat langsung secara default digabungkan ke sesi `main` milik agen; grup tetap terisolasi sebagai `agent:::group:` (ruangan/kanal: `agent:::channel:`); heartbeat menjaga tugas latar belakang tetap hidup. ## Skill inti (aktifkan di Pengaturan → Skills) - **mcporter** - Runtime/CLI server alat 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 agen 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: reaksi, stiker, polling. Gunakan target `user:` atau `channel:` (id numerik polos bersifat 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; secara default stream ke speaker. - **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 otomatisasi. - **OpenAI Whisper** - Speech-to-text lokal untuk dikte cepat dan transkrip pesan suara. - **Gemini CLI** - Model Google Gemini dari terminal untuk tanya jawab cepat. - **agent-tools** - Toolkit utilitas untuk otomatisasi dan skrip pembantu. ## Catatan penggunaan - Utamakan CLI `openclaw` untuk scripting; aplikasi Mac menangani izin. - Jalankan instalasi dari tab Skills; tab ini menyembunyikan tombol jika biner sudah ada. - Biarkan heartbeat tetap 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 di layout dan jangan mengandalkan inset safe-area. - 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 membutuhkan output mesin). - Untuk interaksi, gunakan `openclaw browser click|type|hover|drag|select|upload|press|wait|navigate|back|evaluate|run` (click/type memerlukan referensi snapshot; gunakan `evaluate` untuk selector CSS). ## Terkait - [Workspace agen](/id/concepts/agent-workspace) - [Runtime agen](/id/concepts/agent)