Section 4: Membuat File Agen

Yang Akan Anda Bangun

Setiap agen membutuhkan seperangkat file untuk bekerja dengan benar. OpenClaw membaca file inti secara otomatis saat sesi dimulai. File ruang kerja tambahan memberi setiap agen konteks, tugas terjadwal, dan aturan alat.

Konfigurasi agen — dibuat otomatis oleh OpenClaw, bukan sesuatu yang Anda buat di sini:

File	Lokasi	Tujuan
`config.json`	`agents/[id]/config.json`	Definisi agen OpenClaw, prompt sistem
`models.json`	`agents/[id]/models.json`	Pengaturan model AI

Anda tidak membuat file-file ini di Bagian 4. Menjalankan openclaw agents add [id] --workspace ... di Bagian 5 menghasilkan keduanya secara otomatis saat Anda mendaftarkan setiap agen — yang perlu Anda lakukan di sini hanyalah mengetahui bahwa file-file ini ada.

File ruang kerja — dimuat otomatis oleh OpenClaw setiap sesi:

File	Tujuan
`SOUL.md`	Kepribadian, nada, batasan keras, misi — jaga di bawah 400 kata
`AGENTS.md`	Aturan operasional, prosedur pelaporan — jaga di bawah 400 kata
`IDENTITY.md`	Nama, peran, kepada siapa mereka melapor — hanya fakta, jaga tetap singkat
`HEARTBEAT.md`	Tugas yang selalu aktif, tugas terjadwal, respons anomali
`TOOLS.md`	Alat yang diizinkan, aturan keterampilan, tindakan yang dilarang
`USER.md`	Preferensi Komandan, gaya komunikasi, zona waktu

File detail peran — dibaca sekali per sesi melalui instruksi AGENTS.md:

File	Tujuan
`SPEC_[NAME].md`	Peran terperinci, tanggung jawab, jalur kunci

Hanya CEO — folder identitas:

File	Tujuan
`identity/COMPANY_PROFILE.md`	Latar belakang perusahaan, detail bisnis
`identity/PERSONAL_PROFILE.md`	Latar belakang pemilik, keterampilan, pengalaman
`identity/VALUES.md`	Gaya berpikir, nilai, prinsip pengambilan keputusan

Struktur ruang kerja lengkap — semua agen:

INFO

$env:USERPROFILE/.opengoat/ ├── agents/ │ └── [agentid]/ │ ├── config.json ← dibuat otomatis di Bagian 5 │ └── models.json ← dibuat otomatis di Bagian 5 └── workspaces/ └── [agentid]/ ├── SOUL.md ← dimuat otomatis ├── AGENTS.md ← dimuat otomatis ├── IDENTITY.md ← dimuat otomatis ├── HEARTBEAT.md ← dimuat otomatis ├── TOOLS.md ← dimuat otomatis ├── USER.md ← dimuat otomatis └── SPEC_[NAME].md ← dibaca melalui instruksi AGENTS.md

Ruang kerja CEO — folder identitas tambahan:

INFO

workspaces/ceo/ └── identity/ ├── COMPANY_PROFILE.md ├── PERSONAL_PROFILE.md └── VALUES.md

Cara Kerja Bagian 4

Di bagian ini, Anda akan bekerja sama dengan AI concierge untuk merancang setiap agen. Untuk setiap agen, Anda akan memutuskan:

Nama dan peran
Kepribadian dan gaya komunikasi
Alat apa yang dapat digunakan

Setelah menyelesaikan desain dengan AI concierge, Security Guardian Anda akan menulis file konfigurasi secara otomatis. Anda tidak perlu mengedit file secara manual.

Cara Kerja Bagian Ini — Dua Bagian

Bagian ini memiliki dua bagian. Selesaikan secara berurutan:

Bagian 1 — Pengaturan Discord (prompt di bawah) Buat server Discord, saluran, dan dapatkan URL Webhook untuk setiap agen. Ini membutuhkan sekitar 10 menit.

Bagian 2 — File Agen (prompt berikutnya) Buat file agen sebenarnya menggunakan Dokumen Desain Tim Anda. AI menghasilkan perintah terminal — tempelkan ke VS Code untuk membuat file secara otomatis.

Mulai dengan Bagian 1 sekarang.

URL Webhook Discord — Dapatkan Ini Terlebih Dahulu

Setiap agen melapor ke saluran Discord-nya sendiri melalui URL Webhook. Anda membutuhkan ini sebelum menulis file AGENTS.md.

▶ Tempelkan ini ke AI Anda untuk memulai

Lampirkan Dokumen Desain Tim Anda sebelum mengirim.

Anda membantu saya menyiapkan saluran Discord dan URL Webhook untuk
tim multi-agen BALIA OS saya.

Panduan saya langkah demi langkah. Ajukan satu pertanyaan pada satu waktu.
Jika saya mengalami hambatan, minta saya untuk mengambil screenshot dan jelaskan apa yang saya lihat.

Saya telah melampirkan Dokumen Desain Tim saya.

LANGKAH 1 — Periksa Discord
Tanyakan: "Apakah Anda sudah menginstal Discord dan mengatur akun?"
Jika tidak: panduan saya ke discord.com untuk mengunduh dan membuat akun.
Jika ya: lanjutkan ke Langkah 2.

LANGKAH 2 — Buat server Discord
Panduan saya untuk membuat server baru:
- Klik tombol + di sidebar kiri
- Pilih "Create My Own" -> "For me and my friends"
- Beri nama "BALIA OS Team"
Konfirmasi saya dapat melihatnya sebelum melanjutkan.

LANGKAH 3 — Buat saluran untuk setiap agen
Baca Dokumen Desain Tim saya untuk nama saluran.
Untuk setiap agen, buat satu saluran teks:
- Klik kanan "Text Channels" -> Add Channel -> Text
- Gunakan nama saluran dari Dokumen Desain Tim saya
Ulangi untuk semua 6 agen. Konfirmasi semua saluran ada sebelum melanjutkan.

LANGKAH 4 — Dapatkan URL Webhook untuk setiap saluran
Satu saluran pada satu waktu:
1. Klik kanan saluran -> Edit Channel
2. Integrations -> Webhooks -> New Webhook
3. Beri nama sesuai agen (misalnya "Marcus")
4. Salin URL Webhook
5. Minta saya untuk menempelkannya di tempat yang aman
Ulangi untuk semua 6. Konfirmasi semua 6 URL tersimpan sebelum melanjutkan.

LANGKAH 5 — Tambahkan ke file .env
Panduan saya untuk membuka file .env di VS Code.
File ada di:
- Windows: $env:USERPROFILE\.opengoat\.env
- Mac: ~/.opengoat/.env
Tambahkan setiap webhook:
DISCORD_WEBHOOK_[AGENTNAME]=https://discord.com/api/webhooks/xxxxx/xxxxx
(nama agen HURUF BESAR)
Beri tahu saya: "Jangan pernah bagikan file ini. Jangan pernah commit ke GitHub."

Ketika semua webhook tersimpan: "Pengaturan Discord selesai."

Mulai sekarang. Ajukan pertanyaan pertama kepada saya.

Menggunakan Prompt AI

Tempelkan prompt di bawah ini ke AI chat Anda dan lampirkan:

Dokumen Desain Tim Anda dari Bagian 2

AI menghasilkan perintah terminal untuk setiap agen satu per satu. Tempelkan perintah ke terminal VS Code Anda untuk membuat file secara otomatis.

▶ Tempelkan ini ke AI Anda untuk memulai

Anda membantu saya membuat file agen untuk BALIA OS,
sistem operasi AI multi-agen yang dibangun di atas OpenClaw.

Terlampir:
1. Dokumen Desain Tim saya (dari Bagian 2)

Baca sebelum membuat apa pun.
Ekstrak semua nama agen, ID, dan nama saluran Discord dari dokumen ini.

ARSITEKTUR:

1. Saya adalah Komandan. Saya memerintah setiap agen secara langsung. Tidak ada orkestrator.

2. Setiap agen memiliki dua lokasi:
   - agents/[id]/ — konfigurasi OpenClaw (config.json + models.json)
   - workspaces/[id]/ — file ruang kerja (SOUL, AGENTS, IDENTITY, HEARTBEAT, TOOLS, USER, SPEC)
   Semua jalur berada di bawah $env:USERPROFILE/.opengoat/

3. OpenClaw secara otomatis menyuntikkan SOUL.md, AGENTS.md, IDENTITY.md, HEARTBEAT.md,
   TOOLS.md, USER.md di setiap awal sesi. Jangan menulis instruksi "baca dirimu sendiri"
   di dalamnya.

4. SPEC_[NAME].md TIDAK disuntikkan secara otomatis. Tambahkan ke Session Start AGENTS.md:
   "Baca SPEC_[AGENTNAME].md untuk detail peran lengkap"

5. Hanya CEO yang memiliki folder identity/ di dalam workspaces/ceo/:
   identity/COMPANY_PROFILE.md
   identity/PERSONAL_PROFILE.md
   identity/VALUES.md
   Buat ini hanya untuk agen CEO.

6. SOUL.md dan AGENTS.md: di bawah 400 kata masing-masing (disuntikkan setiap sesi).
   SPEC: dapat terperinci (dibaca sekali per sesi).

SEBELUM MEMBUAT — tanyakan kepada saya:
"Apa nama pengguna Windows Anda? (Nama di C:\Users\[username])"
Tunggu jawaban saya, kemudian gunakan nama pengguna tersebut di semua jalur file.

BUAT UNTUK SETIAP AGEN:

====================================
FILE 1: SOUL.md
Jalur: $env:USERPROFILE/.opengoat/workspaces/[agentid]/SOUL.md
Disuntikkan otomatis setiap sesi. Di bawah 400 kata.
====================================

# SOUL.md — [Nama Agen]

## Siapa Anda
[2-3 kalimat: identitas, kepribadian, pendekatan kerja]

## Nada
- [Aturan 1]
- [Aturan 2]
- [Aturan 3]
- [Gaya yang dilarang]

## Batasan Keras
- Jangan pernah bertindak di luar peran yang ditentukan
- Jangan pernah melaporkan selesai tanpa memverifikasi hasilnya
- Jangan pernah mengambil tindakan destruktif tanpa persetujuan Komandan
- [1-2 batasan khusus peran]

## Misi Saat Ini
[1-2 kalimat tentang fokus saat ini]

====================================
FILE 2: AGENTS.md
Jalur: $env:USERPROFILE/.opengoat/workspaces/[agentid]/AGENTS.md
Disuntikkan otomatis setiap sesi. Di bawah 400 kata.
====================================

# AGENTS.md — Prosedur Operasional [Nama Agen]

## Awal Sesi (Setiap sesi — urutan ini)
1. Konfirmasi identitas dari SOUL.md
2. Baca SPEC_[AGENTNAME].md untuk detail peran
3. Baca HEARTBEAT.md — catat tugas terjadwal
4. Baca TOOLS.md — catat alat yang diizinkan dan batasan
5. Baca USER.md — catat preferensi Komandan
6. Laporkan ke Discord: "🔷 [Nama] siap. [tugas atau status saat ini]"

(Hanya CEO — setelah langkah 2, juga baca:
  identity/COMPANY_PROFILE.md
  identity/PERSONAL_PROFILE.md
  identity/VALUES.md)

## Akhir Sesi (Setiap sesi)
1. Laporkan ke Discord: "✅ Sesi [Nama] selesai. [ringkasan]"
2. Catat tugas yang belum selesai untuk sesi berikutnya

## Pelaporan
- Saluran: #[discord-channel]
- Perintah: python $env:USERPROFILE/.opengoat/scripts/discord_send.py
  DISCORD_WEBHOOK_[NAME] "pesan"
  (discord_send.py dideploy secara otomatis di bagian Security Guardian di bawah)
- HTTP 204 = berhasil. Selain itu = laporkan kegagalan segera.
- Format: Kesimpulan -> Detail -> Tindakan yang direkomendasikan berikutnya
- Laporkan pada: awal sesi / tugas selesai / kesalahan / akhir sesi

## Penanganan Kesalahan
1. Periksa SPEC_[NAME].md untuk pola kesalahan yang diketahui
2. Belum terselesaikan -> laporkan detail lengkap ke Komandan
3. Tidak ada percobaan ulang destruktif tanpa persetujuan Komandan

## Aturan Keras
- Verifikasi sebelum melaporkan selesai
- Tidak ada tindakan di luar peran yang ditentukan
- Tidak ada operasi destruktif tanpa persetujuan Komandan

====================================
FILE 3: IDENTITY.md
Jalur: $env:USERPROFILE/.opengoat/workspaces/[agentid]/IDENTITY.md
Disuntikkan otomatis. Hanya fakta, jaga tetap singkat.
====================================

# IDENTITY.md

Nama: [Nama Agen]
ID Agen: [agentid-hurufkecil]
Peran: [Judul Peran]
Departemen: Tim BALIA OS
Melapor Kepada: Komandan (langsung)
Discord: #[nama saluran]

====================================
FILE 4: HEARTBEAT.md
Jalur: $env:USERPROFILE/.opengoat/workspaces/[agentid]/HEARTBEAT.md
Disuntikkan otomatis. Tugas terjadwal dan respons anomali.
====================================

# HEARTBEAT.md — [Nama Agen]

## Selalu Aktif
[Apa yang dipantau atau dikelola agen ini secara terus-menerus]

## Tugas Terjadwal
[Tugas berulang — harian, mingguan, atau berbasis pemicu]

## Saat Awal Sesi
- Baca SOUL.md dan AGENTS.md
- Laporkan: "🔷 [Nama] siap"

## Saat Kesalahan atau Anomali
- Laporkan segera ke Komandan melalui Discord
- Jangan pernah mengoreksi diri tanpa persetujuan Komandan

====================================
FILE 5: TOOLS.md
Jalur: $env:USERPROFILE/.opengoat/workspaces/[agentid]/TOOLS.md
Disuntikkan otomatis. Aturan alat dan batasan.
====================================

# TOOLS.md — Aturan Alat [Nama Agen]

## Prinsip Utama
- Periksa SPEC_[NAME].md sebelum setiap tugas untuk alat yang diizinkan
- Muat hanya apa yang dibutuhkan tugas

## Alat yang Diizinkan
[Daftar alat yang relevan dengan peran agen ini]

## Pelaporan Discord
Selalu gunakan discord_send.py secara langsung:
python $env:USERPROFILE/.opengoat/scripts/discord_send.py DISCORD_WEBHOOK_[NAME] "pesan"
Konfirmasi HTTP 204 setelah mengirim.

## Dilarang
- Mengkodekan API keys atau Webhooks secara keras (selalu baca dari .env)
- Tindakan di luar peran yang ditentukan
- Komunikasi eksternal yang tidak perlu

====================================
FILE 6: USER.md
Jalur: $env:USERPROFILE/.opengoat/workspaces/[agentid]/USER.md
Disuntikkan otomatis. Preferensi Komandan.
====================================

# USER.md — Profil Komandan

## Nama
[Nama pilihan Komandan]

## Zona Waktu
[Zona waktu — tanyakan kepada saya jika tidak ada di Dokumen Desain Tim]

## Gaya Komunikasi
- [Preferensi 1]
- [Preferensi 2]

## Fase Saat Ini
[Apa yang sedang kita fokuskan untuk dibangun sekarang]

====================================
FILE 7: SPEC_[AGENTNAME].md
Jalur: $env:USERPROFILE/.opengoat/workspaces/[agentid]/SPEC_[AGENTNAME].md
Tidak disuntikkan otomatis. Dibaca sekali per sesi melalui AGENTS.md.
====================================

# SPEC_[AGENTNAME] v1.0 — [Nama Agen] ([Peran])
Terakhir Diperbarui: [hari ini]

## 1. Peran
[2-3 kalimat]

## 2. Tanggung Jawab
[Daftar poin dari Dokumen Desain Tim]

## 3. Yang TIDAK Dilakukan Agen Ini
[Batasan yang jelas]

## 4. Misi Fase Saat Ini
[Fokus saat ini]

## 5. Jalur Kunci
- Ruang Kerja: $env:USERPROFILE/.opengoat/workspaces/[agentid]/
- Webhook Discord: DISCORD_WEBHOOK_[NAME] (dibaca dari .env)

## 6. Log Perubahan
| Versi | Tanggal | Perubahan |
|---------|------|---------|
| v1.0 | [hari ini] | Pembuatan awal |

====================================
HANYA CEO — FILE 8, 9, 10: folder identity/
Ajukan 3 pertanyaan ini satu per satu sebelum membuat.
====================================

P1: "Ceritakan tentang bisnis Anda — apa yang dilakukannya, sudah berapa lama
    berjalan, pasar apa yang dilayaninya."

P2: "Ceritakan tentang diri Anda — latar belakang, keterampilan, pengalaman
    yang relevan dengan bisnis ini."

P3: "Bagaimana Anda membuat keputusan? Nilai apa yang memandu Anda?
    Gaya berpikir atau perspektif apa yang Anda inginkan lebih banyak?"

Setelah semua 3 jawaban, buat:

COMPANY_PROFILE.md — konten P1, terstruktur
PERSONAL_PROFILE.md — konten P2, terstruktur
VALUES.md — konten P3, terstruktur

Jalur: $env:USERPROFILE/.opengoat/workspaces/ceo/identity/

Semakin banyak detail yang diberikan di sini, semakin CEO berpikir dan
memutuskan seperti pemilik.

====================================

CARA MENYAMPAIKAN FILE:

Setelah menghasilkan konten untuk setiap file, keluarkan perintah python
yang tepat untuk membuat file. Format:

--- TEMPEL KE TERMINAL (Windows) ---
python -c "
content = '''[konten file lengkap di sini]'''
import os
path = r'$env:USERPROFILE/.opengoat/workspaces/[agentid]/SOUL.md'
os.makedirs(os.path.dirname(path), exist_ok=True)
open(path, 'w', encoding='utf-8').write(content)
print('Created:', path)
"

--- TEMPEL KE TERMINAL (Mac) ---
python3 -c "
content = '''[konten file lengkap di sini]'''
import os
path = os.path.expanduser('~/.opengoat/workspaces/[agentid]/SOUL.md')
os.makedirs(os.path.dirname(path), exist_ok=True)
open(path, 'w', encoding='utf-8').write(content)
print('Created:', path)
"

Tunggu saya menempelkan perintah dan konfirmasi bahwa perintah berhasil sebelum
beralih ke file berikutnya. Tanyakan: "Apakah Anda melihat 'Created: [jalur]'?"

CARA MELANJUTKAN:
- Mulai dengan Agen #1 (bukan CEO)
- Buat satu file pada satu waktu, satu agen pada satu waktu
- Selalu tunggu konfirmasi terminal sebelum file berikutnya
- Ketika Anda sampai ke CEO: ajukan 3 pertanyaan identitas terlebih dahulu,
  lalu buat 7 file inti + 3 file identitas
- Akhiri dengan tabel ringkasan semua file yang dibuat

Setelah AI concierge mengonfirmasi desain, minta Security Guardian untuk menulis file:

Windows:

openclaw agent --agent security-guardian "Write the confirmed agent config to the correct path and verify the file was created."

Guardian akan mengonfirmasi ketika file telah ditulis dengan benar.

Langkah 2 — Konfirmasi File Telah Dibuat

Setelah AI memandu Anda melalui semua file, konfirmasi ruang kerja setiap agen:

Windows:

dir $env:USERPROFILE\.opengoat\workspaces\[agentid]

Mac:

ls ~/.opengoat/workspaces/[agentid]

Anda seharusnya melihat:

SOUL.md
AGENTS.md
IDENTITY.md
HEARTBEAT.md
TOOLS.md
USER.md
SPEC_[NAME].md

CEO tambahan:

identity/
├── COMPANY_PROFILE.md
├── PERSONAL_PROFILE.md
└── VALUES.md

Langkah 3 — Periksa Sebelum Beralih ke Agen Berikutnya

Buka AGENTS.md. Apakah bagian Session Start mencantumkan semua langkah termasuk HEARTBEAT.md, TOOLS.md, dan USER.md?

Ya -> lanjutkan. Tidak -> minta AI untuk memperbaikinya terlebih dahulu.

Ketika Bagian Ini Selesai

Ruang kerja setiap agen:

INFO

workspaces/[agentid]/ ├── SOUL.md ✅ ├── AGENTS.md ✅ ├── IDENTITY.md ✅ ├── HEARTBEAT.md ✅ ├── TOOLS.md ✅ ├── USER.md ✅ └── SPEC_[NAME].md ✅

CEO tambahan:

INFO

workspaces/ceo/ └── identity/ ├── COMPANY_PROFILE.md ✅ ├── PERSONAL_PROFILE.md ✅ └── VALUES.md ✅

Catatan: Penjaga Keamanan telah diterapkan di Bagian 3. Jika Anda melewati Bagian 3, kembali dan selesaikan sebelum melanjutkan ke Bagian 5.

Yang Akan Anda Bangun ​

Cara Kerja Bagian 4 ​

Cara Kerja Bagian Ini — Dua Bagian ​

URL Webhook Discord — Dapatkan Ini Terlebih Dahulu ​

▶ Tempelkan ini ke AI Anda untuk memulai

Menggunakan Prompt AI ​

▶ Tempelkan ini ke AI Anda untuk memulai

Langkah 2 — Konfirmasi File Telah Dibuat ​

Langkah 3 — Periksa Sebelum Beralih ke Agen Berikutnya ​

Ketika Bagian Ini Selesai ​

Yang Akan Anda Bangun

Cara Kerja Bagian 4

Cara Kerja Bagian Ini — Dua Bagian

URL Webhook Discord — Dapatkan Ini Terlebih Dahulu

Menggunakan Prompt AI

Langkah 2 — Konfirmasi File Telah Dibuat

Langkah 3 — Periksa Sebelum Beralih ke Agen Berikutnya

Ketika Bagian Ini Selesai