Bahagian 4: Mencipta Fail-Fail Ejen Anda

Apa Yang Anda Bina

Setiap ejen memerlukan satu set fail untuk berfungsi dengan betul. OpenClaw membaca fail-fail teras secara automatik pada permulaan sesi. Fail-fail workspace tambahan memberikan setiap ejen konteks, tugasan berjadual, dan peraturan alat.

Konfigurasi ejen — dijana secara automatik oleh OpenClaw, bukan sesuatu yang anda cipta di sini:

Fail	Lokasi	Tujuan
`config.json`	`agents/[id]/config.json`	Definisi ejen OpenClaw, prompt sistem
`models.json`	`agents/[id]/models.json`	Tetapan model AI

Anda tidak mencipta fail-fail ini dalam Bahagian 4. Menjalankan openclaw agents add [id] --workspace ... dalam Bahagian 5 menjana kedua-duanya secara automatik apabila anda mendaftarkan setiap ejen — tiada apa-apa yang perlu dilakukan di sini selain mengetahui ia wujud.

Fail workspace — dimuatkan secara automatik oleh OpenClaw pada setiap sesi:

Fail	Tujuan
`SOUL.md`	Personaliti, nada, had mutlak, misi — pastikan di bawah 400 patah perkataan
`AGENTS.md`	Peraturan operasi, prosedur pelaporan — pastikan di bawah 400 patah perkataan
`IDENTITY.md`	Nama, peranan, kepada siapa mereka melapor — fakta sahaja, pastikan ringkas
`HEARTBEAT.md`	Tugasan sentiasa aktif, tugas berjadual, respons anomali
`TOOLS.md`	Alat yang dibenarkan, peraturan kaset, tindakan yang dilarang
`USER.md`	Keutamaan Komander, gaya komunikasi, zon waktu

Fail butiran peranan — dibaca sekali setiap sesi melalui arahan AGENTS.md:

Fail	Tujuan
`SPEC_[NAME].md`	Peranan terperinci, tanggungjawab, laluan utama

CEO sahaja — folder identiti:

Fail	Tujuan
`identity/COMPANY_PROFILE.md`	Latar belakang syarikat, butiran perniagaan
`identity/PERSONAL_PROFILE.md`	Latar belakang pemilik, kemahiran, pengalaman
`identity/VALUES.md`	Gaya berfikir, nilai, prinsip membuat keputusan

Struktur workspace penuh — semua ejen:

INFO

$env:USERPROFILE/.opengoat/ ├── agents/ │ └── [agentid]/ │ ├── config.json ← dijana secara automatik dalam Bahagian 5 │ └── models.json ← dijana secara automatik dalam Bahagian 5 └── workspaces/ └── [agentid]/ ├── SOUL.md ← dimuatkan automatik ├── AGENTS.md ← dimuatkan automatik ├── IDENTITY.md ← dimuatkan automatik ├── HEARTBEAT.md ← dimuatkan automatik ├── TOOLS.md ← dimuatkan automatik ├── USER.md ← dimuatkan automatik └── SPEC_[NAME].md ← dibaca melalui arahan AGENTS.md

Workspace CEO — folder identiti tambahan:

INFO

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

Cara Bahagian 4 Berfungsi

Dalam bahagian ini, anda akan bekerja dengan AI concierge anda untuk mereka bentuk setiap ejen. Untuk setiap ejen, anda akan putuskan:

Nama dan peranan
Personaliti dan gaya komunikasi
Alat apa yang boleh digunakan

Setelah menyelesaikan reka bentuk dengan AI concierge anda, Pengawal Keselamatan anda akan menulis fail konfigurasi secara automatik. Anda tidak perlu mengedit sebarang fail secara manual.

Cara Bahagian Ini Berfungsi — Dua Bahagian

Bahagian ini mempunyai dua bahagian. Selesaikan mengikut urutan:

Bahagian 1 — Persediaan Discord (prompt di bawah) Cipta pelayan Discord, saluran, dan dapatkan URL Webhook untuk setiap ejen. Ini mengambil masa lebih kurang 10 minit.

Bahagian 2 — Fail Ejen (prompt seterusnya) Jana fail ejen sebenar menggunakan Dokumen Reka Bentuk Pasukan anda. AI menjana arahan terminal — tampalkannya ke dalam terminal VS Code untuk mencipta fail secara automatik.

Mulakan dengan Bahagian 1 sekarang.

URL Webhook Discord — Dapatkan Ini Dahulu

Setiap ejen melapor ke saluran Discord masing-masing melalui URL Webhook. Anda perlu mendapatkan ini sebelum menulis fail AGENTS.md.

▶ Tampalkan ini ke dalam AI anda untuk memulakan

Lampirkan Dokumen Reka Bentuk Pasukan anda sebelum menghantar.

Anda membantu saya menyediakan saluran Discord dan URL Webhook untuk
pasukan berbilang ejen BALIA OS saya.

Pandu saya langkah demi langkah. Tanya satu soalan pada satu masa.
Jika saya tersangkut, minta saya mengambil tangkap layar dan menerangkan apa yang saya lihat.

Saya telah melampirkan Dokumen Reka Bentuk Pasukan saya.

LANGKAH 1 — Semak Discord
Tanya: "Adakah anda sudah memasang Discord dan menyediakan akaun?"
Jika tidak: pandu saya ke discord.com untuk memuat turun dan membuat akaun.
Jika ya: pergi ke Langkah 2.

LANGKAH 2 — Buat pelayan Discord
Pandu saya membuat pelayan baharu:
- Klik butang + di bar sisi kiri
- Pilih "Cipta Sendiri" -> "Untuk saya dan rakan-rakan"
- Namakannya "BALIA OS Team"
Sahkan saya dapat melihatnya sebelum meneruskan.

LANGKAH 3 — Buat saluran untuk setiap ejen
Baca Dokumen Reka Bentuk Pasukan saya untuk nama saluran.
Untuk setiap ejen, buat satu saluran teks:
- Klik kanan "Saluran Teks" -> Tambah Saluran -> Teks
- Gunakan nama saluran dari Dokumen Reka Bentuk Pasukan saya
Ulangi untuk semua 6 ejen. Sahkan semua saluran wujud sebelum meneruskan.

LANGKAH 4 — Dapatkan URL Webhook untuk setiap saluran
Satu saluran pada satu masa:
1. Klik kanan saluran -> Edit Saluran
2. Integrasi -> Webhook -> Webhook Baharu
3. Namakannya mengikut nama ejen (contoh: "Marcus")
4. Salin URL Webhook
5. Minta saya menampalnya di tempat yang selamat
Ulangi untuk semua 6. Sahkan kesemua 6 URL disimpan sebelum meneruskan.

LANGKAH 5 — Tambah ke fail .env
Pandu saya membuka fail .env dalam VS Code.
Fail ini berada di:
- Windows: $env:USERPROFILE\.opengoat\.env
- Mac: ~/.opengoat/.env
Tambah setiap webhook:
DISCORD_WEBHOOK_[NAMAAGEN]=https://discord.com/api/webhooks/xxxxx/xxxxx
(nama ejen menggunakan HURUF BESAR)
Beritahu saya: "Jangan sekali-kali kongsikan fail ini. Jangan sekali-kali commit ke GitHub."

Apabila semua webhook disimpan: "Tetapan Discord selesai."

Mulakan sekarang. Tanya saya soalan pertama.

Menggunakan Prompt AI

Tampal prompt di bawah ke dalam AI sembang anda dan lampirkan:

Dokumen Reka Bentuk Pasukan anda dari Bahagian 2

AI menjana arahan terminal untuk setiap ejen satu demi satu. Tampalkan arahan itu ke dalam terminal VS Code anda untuk mencipta fail secara automatik.

▶ Tampalkan ini ke dalam AI anda untuk memulakan

Anda membantu saya mencipta fail ejen untuk BALIA OS,
OS AI berbilang ejen yang dibina di atas OpenClaw.

Dilampirkan:
1. Dokumen Reka Bentuk Pasukan saya (dari Bahagian 2)

Baca sebelum menjana apa-apa.
Ekstrak semua nama ejen, ID dan nama saluran Discord daripada dokumen ini.

SENI BINA:

1. Saya adalah Komander. Saya mengarahkan setiap ejen secara langsung. Tiada pengatur.

2. Setiap ejen mempunyai dua lokasi:
   - agents/[id]/ — konfigurasi OpenClaw (config.json + models.json)
   - workspaces/[id]/ — fail workspace (SOUL, AGENTS, IDENTITY, HEARTBEAT, TOOLS, USER, SPEC)
   Semua laluan berada di bawah $env:USERPROFILE/.opengoat/

3. OpenClaw menyuntik SOUL.md, AGENTS.md, IDENTITY.md, HEARTBEAT.md,
   TOOLS.md, USER.md secara automatik pada setiap permulaan sesi. Jangan tulis
   arahan "baca diri sendiri" di dalamnya.

4. SPEC_[NAMA].md TIDAK disuntik secara automatik. Tambah ke Permulaan Sesi AGENTS.md:
   "Baca SPEC_[NAMAAGEN].md untuk butiran peranan penuh"

5. CEO sahaja mempunyai folder identity/ di dalam workspaces/ceo/:
   identity/COMPANY_PROFILE.md
   identity/PERSONAL_PROFILE.md
   identity/VALUES.md
   Jana ini hanya untuk ejen CEO.

6. SOUL.md dan AGENTS.md: masing-masing kurang daripada 400 patah perkataan (disuntik setiap sesi).
   SPEC: boleh terperinci (dibaca sekali setiap sesi).

SEBELUM MENJANA — tanya saya:
"Apakah nama pengguna Windows anda? (Nama dalam C:\Users\[namapengguna])"
Tunggu jawapan saya, kemudian gunakan nama pengguna itu dalam semua laluan fail.

JANA UNTUK SETIAP AGEN:

====================================
FAIL 1: SOUL.md
Laluan: $env:USERPROFILE/.opengoat/workspaces/[agentid]/SOUL.md
Disuntik secara automatik setiap sesi. Kurang daripada 400 patah perkataan.
====================================

# SOUL.md — [Nama Ejen]

## Siapa Anda
[2-3 ayat: identiti, personaliti, pendekatan kerja]

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

## Had Keras
- Tidak pernah bertindak di luar peranan yang ditentukan
- Tidak pernah melaporkan selesai tanpa mengesahkan hasilnya
- Tidak pernah mengambil tindakan merosakkan tanpa kelulusan Komander
- [1-2 had khusus peranan]

## Misi Semasa
[1-2 ayat tentang fokus semasa]

====================================
FAIL 2: AGENTS.md
Laluan: $env:USERPROFILE/.opengoat/workspaces/[agentid]/AGENTS.md
Disuntik secara automatik setiap sesi. Kurang daripada 400 patah perkataan.
====================================

# AGENTS.md — Prosedur Operasi [Nama Ejen]

## Permulaan Sesi (Setiap sesi — tertib ini)
1. Sahkan identiti daripada SOUL.md
2. Baca SPEC_[NAMAAGEN].md untuk butiran peranan
3. Baca HEARTBEAT.md — catat tugas berjadual
4. Baca TOOLS.md — catat alat yang dibenarkan dan sekatan
5. Baca USER.md — catat keutamaan Komander
6. Laporkan ke Discord: "🔷 [Nama] bersedia. [tugas atau status semasa]"

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

## Penghujung Sesi (Setiap sesi)
1. Laporkan ke Discord: "✅ [Nama] sesi selesai. [ringkasan]"
2. Catat sebarang tugasan belum selesai untuk sesi seterusnya

## Pelaporan
- Saluran: #[saluran-discord]
- Perintah: python $env:USERPROFILE/.opengoat/scripts/discord_send.py
  DISCORD_WEBHOOK_[NAMA] "mesej"
  (discord_send.py disebarkan secara automatik dalam bahagian Pengawal Keselamatan di bawah)
- HTTP 204 = berjaya. Lain = laporkan kegagalan serta-merta.
- Format: Kesimpulan -> Butiran -> Tindakan seterusnya yang disyorkan
- Laporkan pada: permulaan sesi / tugas selesai / ralat / penghujung sesi

## Pengendalian Ralat
1. Semak SPEC_[NAMA].md untuk corak ralat yang diketahui
2. Tidak selesai -> laporkan butiran penuh kepada Komander
3. Tiada cubaan semula merosakkan tanpa kelulusan Komander

## Peraturan Keras
- Sahkan sebelum melaporkan selesai
- Tiada tindakan di luar peranan yang ditentukan
- Tiada operasi merosakkan tanpa kelulusan Komander

====================================
FAIL 3: IDENTITY.md
Laluan: $env:USERPROFILE/.opengoat/workspaces/[agentid]/IDENTITY.md
Disuntik secara automatik. Fakta sahaja, kekal pendek.
====================================

# IDENTITY.md

Name: [Nama Ejen]
Agent ID: [agentid-hurufkecil]
Role: [Tajuk Peranan]
Department: BALIA OS Team
Reports To: Commander (directly)
Discord: #[nama saluran]

====================================
FAIL 4: HEARTBEAT.md
Laluan: $env:USERPROFILE/.opengoat/workspaces/[agentid]/HEARTBEAT.md
Disuntik secara automatik. Tugas berjadual dan respons anomali.
====================================

# HEARTBEAT.md — [Nama Ejen]

## Sentiasa Aktif
[Apa yang ejen ini pantau atau selenggara secara berterusan]

## Tugas Berjadual
[Tugasan berulang — harian, mingguan, atau berdasarkan pencetus]

## Pada Permulaan Sesi
- Baca SOUL.md dan AGENTS.md
- Laporkan: "🔷 [Nama] bersedia"

## Apabila Berlaku Ralat atau Anomali
- Laporkan segera kepada Komander melalui Discord
- Tidak pernah membetulkan sendiri tanpa kelulusan Komander

====================================
FAIL 5: TOOLS.md
Laluan: $env:USERPROFILE/.opengoat/workspaces/[agentid]/TOOLS.md
Disuntik secara automatik. Peraturan dan sekatan alat.
====================================

# TOOLS.md — Peraturan Alat [Nama Ejen]

## Prinsip Teras
- Semak SPEC_[NAMA].md sebelum setiap tugas untuk alat yang dibenarkan
- Muatkan hanya apa yang diperlukan oleh tugas itu

## Alat Yang Dibenarkan
[Senarai alat yang berkaitan dengan peranan ejen ini]

## Pelaporan Discord
Sentiasa gunakan discord_send.py secara terus:
python $env:USERPROFILE/.opengoat/scripts/discord_send.py DISCORD_WEBHOOK_[NAMA] "mesej"
Sahkan HTTP 204 selepas menghantar.

## Dilarang
- Menetapkan kunci API atau Webhook secara terus dalam kod (sentiasa baca daripada .env)
- Tindakan di luar peranan yang ditentukan
- Komunikasi luaran yang tidak perlu

====================================
FAIL 6: USER.md
Laluan: $env:USERPROFILE/.opengoat/workspaces/[agentid]/USER.md
Disuntik secara automatik. Keutamaan Komander.
====================================

# USER.md — Profil Komander

## Nama
[Nama panggilan Komander]

## Zon Waktu
[Zon waktu — tanya saya jika tiada dalam Dokumen Reka Bentuk Pasukan]

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

## Fasa Semasa
[Apa yang sedang kita fokus untuk dibina sekarang]

====================================
FAIL 7: SPEC_[NAMAAGEN].md
Laluan: $env:USERPROFILE/.opengoat/workspaces/[agentid]/SPEC_[NAMAAGEN].md
Tidak disuntik secara automatik. Dibaca sekali setiap sesi melalui AGENTS.md.
====================================

# SPEC_[NAMAAGEN] v1.0 — [Nama Ejen] ([Peranan])
Dikemas kini terakhir: [hari ini]

## 1. Peranan
[2-3 ayat]

## 2. Tanggungjawab
[Senarai titik daripada Dokumen Reka Bentuk Pasukan]

## 3. Apa yang Ejen Ini TIDAK Lakukan
[Sempadan yang jelas]

## 4. Misi Fasa Semasa
[Fokus semasa]

## 5. Laluan Utama
- Workspace: $env:USERPROFILE/.opengoat/workspaces/[agentid]/
- Discord webhook: DISCORD_WEBHOOK_[NAMA] (dibaca daripada .env)

## 6. Log Perubahan
| Versi | Tarikh | Perubahan |
|-------|--------|-----------|
| v1.0 | [hari ini] | Penciptaan awal |

====================================
HANYA CEO — FAIL 8, 9, 10: folder identity/
Tanya soalan 3 ini satu demi satu sebelum menjana.
====================================

S1: "Ceritakan tentang perniagaan anda — apa yang dilakukannya, sudah berapa lama
    beroperasi, pasaran apa yang dilayaninya."

S2: "Ceritakan tentang diri anda — latar belakang, kemahiran, pengalaman
    yang berkaitan dengan perniagaan ini."

S3: "Bagaimana anda membuat keputusan? Nilai-nilai apa yang membimbing anda?
    Gaya pemikiran atau perspektif apa yang anda ingin ada lebih?"

Selepas kesemua 3 jawapan, jana:

COMPANY_PROFILE.md — kandungan S1, berstruktur
PERSONAL_PROFILE.md — kandungan S2, berstruktur
VALUES.md — kandungan S3, berstruktur

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

Lebih banyak butiran yang diberikan di sini, lebih banyak CEO berfikir dan
membuat keputusan seperti pemilik.

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

CARA MENGHANTAR FAIL:

Selepas menjana kandungan untuk setiap fail, output arahan python yang
tepat untuk mencipta fail tersebut. Format:

--- TAMPAL KE DALAM TERMINAL (Windows) ---
python -c "
content = '''[kandungan fail penuh 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)
"

--- TAMPAL KE DALAM TERMINAL (Mac) ---
python3 -c "
content = '''[kandungan fail penuh 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 menampalkan arahan itu dan mengesahkan ia berjaya sebelum
beralih ke fail seterusnya. Tanya: "Adakah anda nampak 'Created: [path]'?"

CARA MENERUSKAN:
- Mulakan dengan Agen #1 (bukan CEO)
- Jana satu fail pada satu masa, satu ejen pada satu masa
- Sentiasa tunggu pengesahan terminal sebelum fail seterusnya
- Apabila mencapai CEO: tanya 3 soalan identiti terlebih dahulu,
  kemudian jana 7 fail teras + 3 fail identiti
- Akhiri dengan jadual ringkasan semua fail yang dicipta

Setelah AI concierge mengesahkan reka bentuk, minta Pengawal Keselamatan menulis fail:

Windows:

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

Guardian akan mengesahkan apabila fail telah ditulis dengan betul.

Langkah 2 — Sahkan Fail Telah Dicipta

Selepas AI membimbing anda melalui semua fail, sahkan workspace setiap ejen:

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 — Semak Sebelum Berpindah ke Ejen Seterusnya

Buka AGENTS.md. Adakah bahagian Permulaan Sesi menyenaraikan kesemua langkah termasuk HEARTBEAT.md, TOOLS.md, dan USER.md?

Ya -> teruskan. Tidak -> minta AI membetulkannya dahulu.

Apabila Bahagian Ini Selesai

Workspace setiap ejen:

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 ✅

Nota: Pengawal Keselamatan telah disebarkan dalam Bahagian 3. Jika anda melangkau Bahagian 3, kembali dan selesaikan sebelum meneruskan ke Bahagian 5.

Sahkan Persediaan Anda

Setelah anda menyelesaikan semua fail ejen, jalankan:

Windows:

node $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\verify_setup.js --section 4

Mac:

node ~/.opengoat/workspaces/security-guardian/scripts/verify_setup.js --section 4

Ini mengesahkan semua fail ejen berada di tempat yang betul sebelum anda melancarkan pasukan anda dalam Bahagian 5.

Apa Yang Anda Bina ​

Cara Bahagian 4 Berfungsi ​

Cara Bahagian Ini Berfungsi — Dua Bahagian ​

URL Webhook Discord — Dapatkan Ini Dahulu ​

▶ Tampalkan ini ke dalam AI anda untuk memulakan

Menggunakan Prompt AI ​

▶ Tampalkan ini ke dalam AI anda untuk memulakan

Langkah 2 — Sahkan Fail Telah Dicipta ​

Langkah 3 — Semak Sebelum Berpindah ke Ejen Seterusnya ​

Apabila Bahagian Ini Selesai ​

Sahkan Persediaan Anda ​

Apa Yang Anda Bina

Cara Bahagian 4 Berfungsi

Cara Bahagian Ini Berfungsi — Dua Bahagian

URL Webhook Discord — Dapatkan Ini Dahulu

Menggunakan Prompt AI

Langkah 2 — Sahkan Fail Telah Dicipta

Langkah 3 — Semak Sebelum Berpindah ke Ejen Seterusnya

Apabila Bahagian Ini Selesai

Sahkan Persediaan Anda