Skip to content

Apa Yang Berlaku Dalam Bahagian Ini

Anda akan mendaftarkan setiap ejen dengan OpenClaw dan memberikan arahan pertama mereka. Pada penghujungnya, kesemua 6 ejen akan aktif — melaporkan ke saluran Discord mereka dan bersedia menerima arahan daripada anda.

Dua cara untuk bercakap dengan ejen anda:

KaedahTerbaik untukCara ia berfungsi
OpenGoat UIPemula — antara muka visualPapan pemuka berasaskan pelayar, klik untuk pilih ejen, taip mesej anda
Terminal VS CodeDisyorkan — lebih pantas, lebih kawalanopenclaw agent --agent [id] "your message"

Kedua-dua kaedah berfungsi. Mulakan dengan mana-mana yang anda selesa.

Pendekatan yang disyorkan — hibrid dengan AI: Apabila anda baru bermula, buka AI sembang anda seiring dengan ejen anda. Jika sesuatu arahan tidak berfungsi atau anda tidak pasti apa yang perlu ditaip, huraikan situasinya kepada AI dan minta bantuan. Inilah cara kebanyakan orang — termasuk pasukan BALIA OS — mengendalikan perkara pada awalnya. Anda tidak perlu menguasai terminal pada hari pertama. Tetingkap sembang AI sentiasa ada sebagai rakan sepilot anda.


Cara Bahagian Ini Berfungsi

Tampal arahan di bawah ke dalam AI sembang anda. AI akan membimbing anda mendaftarkan kesemua 6 ejen dan menghantar arahan pertama kepada setiap satu. Lampirkan Dokumen Reka Bentuk Pasukan anda supaya AI mengetahui ID ejen dan laluan workspace anda.

Jika sesuatu tidak berjalan lancar, huraikan ralat tersebut atau ambil tangkapan skrin dan kongsikannya — AI akan membantu anda memperbaikinya.


Salin Arahan Ini dan Tampalkan ke Dalam AI Anda

Lampirkan Dokumen Reka Bentuk Pasukan anda sebelum menghantar.

Anda membantu saya mendaftarkan dan melancarkan pasukan berbilang ejen BALIA OS saya di OpenClaw.

Saya telah melampirkan Dokumen Reka Bentuk Pasukan saya. Baca untuk mendapatkan ID
dan nama ejen saya sebelum memulakan.

Sebelum kita mula, tanya saya:
"Apakah nama pengguna Windows anda? (Nama dalam C:\Users\[namapengguna])"
Gunakan nama pengguna itu dalam semua laluan fail sepanjang sesi ini.
Semua fail ejen saya berada di bawah $env:USERPROFILE/.opengoat/

Pandu saya langkah demi langkah. Satu langkah pada satu masa. Jika ada ralat,
bantu saya membetulkannya sebelum meneruskan. Jika saya tersangkut, minta saya
berkongsi tangkapan skrin atau tampalkan mesej ralat.

Inilah yang perlu kita lakukan:

LANGKAH 1 — Mulakan gateway
Beritahu saya: "Kita akan memulakan gateway OpenClaw dengan arahan yang menapis log latar belakang yang bising supaya terminal kekal mudah dibaca."

Pandu saya membuka tab terminal VS Code baharu dan menjalankan arahan yang betul
untuk OS saya (tanya saya OS yang saya gunakan jika anda belum tahu):

Windows:
  $env:DEBUG="-ciao*"; openclaw gateway --force

Mac:
  DEBUG="-ciao*" openclaw gateway --force

Terangkan apa yang berlaku:
"Bahagian DEBUG='-ciao*' menyembunyikan log penemuan rangkaian latar belakang yang
sebaliknya akan membanjiri terminal. Flag --force mengosongkan sebarang tika gateway
sebelumnya. Terminal anda akan kekal bersih dan mudah dibaca."

Minta saya mengesahkan melihat: "✓ Gateway running on port 18789"
Beritahu saya untuk membiarkan tab terminal ini terbuka — gateway mesti terus berjalan.
Jika ada ralat, bantu saya membetulkannya sebelum meneruskan.

LANGKAH 2 — Daftarkan setiap ejen dengan OpenClaw
Terangkan dahulu:
"Menjalankan arahan ini melakukan dua perkara: ia mendaftarkan ejen dengan
OpenClaw, dan ia menjana config.json serta models.json ejen itu secara automatik
di bawah agents/[agentid]/. Anda tidak perlu mencipta fail-fail itu sendiri."

Untuk setiap daripada 6 ejen saya (baca ID daripada Dokumen Reka Bentuk Pasukan),
pandu saya menjalankan arahan ini dalam terminal VS Code:

Windows:
openclaw agents add [agentid] --workspace $env:USERPROFILE\.opengoat\workspaces\[agentid]

Mac:
openclaw agents add [agentid] --workspace ~/.opengoat/workspaces/[agentid]

Contoh (Windows): openclaw agents add marcus --workspace C:\Users\john\.opengoat\workspaces\marcus
(marcus adalah contoh — gantikan dengan ID ejen sebenar anda daripada Dokumen Reka Bentuk Pasukan anda.)

Tunjukkan semua 6 arahan sekaligus dengan ID ejen sebenar dan nama pengguna saya diisikan.
Minta saya menjalankannya satu demi satu dan mengesahkan setiap satu berjaya sebelum
menunjukkan yang seterusnya.

Selepas kesemua 6 didaftarkan, pandu saya untuk mengesahkan:
openclaw agents list
Minta saya mengesahkan kesemua 6 ejen muncul dalam senarai.

LANGKAH 2b — Sahkan pendaftaran Pengawal Keselamatan
Pengawal Keselamatan telah didaftarkan dengan OpenClaw dalam Bahagian 4.
Pandu saya untuk mengesahkan kehadirannya:

openclaw agents list

Minta saya mengesahkan bahawa security-guardian muncul dalam senarai.
Jika tiada, pandu saya untuk menjalankan:

Windows:
openclaw agents add security-guardian --workspace $env:USERPROFILE\.opengoat\workspaces\security-guardian

Mac:
openclaw agents add security-guardian --workspace ~/.opengoat/workspaces/security-guardian

Kemudian sahkan senarai sekali lagi sebelum meneruskan.

LANGKAH 3 — Mulakan semula gateway
Selepas mendaftarkan ejen, gateway perlu dimulakan semula untuk memuatkannya.
Pandu saya menjalankan:
openclaw gateway restart
Minta saya mengesahkan gateway berjalan semula sebelum meneruskan.

LANGKAH 4 — Mulakan Pengawal Keselamatan (PM2)
Pengawal Keselamatan berjalan secara berterusan di latar belakang menggunakan PM2.
Pandu saya untuk memulakannya:

pm2 start $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\guardian.js --name security-guardian

(Mac: gantikan laluan dengan ~/.opengoat/workspaces/security-guardian/scripts/guardian.js)

Kemudian simpan senarai proses PM2 supaya ia pulih secara automatik selepas but semula:
pm2 save

Minta saya mengesahkan melihat Pengawal Keselamatan dalam senarai PM2:
pm2 list

Kemudian minta saya mengesahkan melihat mesej permulaan dalam saluran Discord #security-channel.

LANGKAH 5 — Hantar arahan pertama melalui terminal VS Code (disyorkan)
Terangkan dahulu:
"Terminal VS Code adalah cara yang disyorkan untuk bercakap dengan ejen anda.
Arahannya ialah:
openclaw agent --agent [agentid] 'mesej anda di sini'

Ini menghantar mesej terus kepada ejen tertentu itu."

Pandu saya menghantar arahan ujian kepada ejen pertama:
openclaw agent --agent [agentid-pertama] 'Sila perkenalkan diri anda dan
sahkan bahawa anda telah membaca SOUL.md, AGENTS.md, IDENTITY.md, HEARTBEAT.md,
TOOLS.md dan USER.md anda.
Kemudian laporkan ke saluran Discord anda bahawa anda dalam talian.'

Tanya saya: "Apakah respons ejen itu?
Adakah anda melihat mesej muncul dalam saluran Discordnya?"
Jika ya: bagus — teruskan ke ejen seterusnya.
Jika tidak: bantu saya menyelesaikan masalah.

Ulangi untuk semua 6 ejen.

LANGKAH 6 — (Pilihan) Persediaan OpenGoat UI
Selepas semua ejen disahkan berfungsi melalui terminal, tawarkan:
"Anda juga boleh bercakap dengan ejen anda melalui OpenGoat UI —
papan pemuka pelayar visual.
Adakah anda mahu menyediakannya juga?
Ia memberikan anda antara muka boleh diklik untuk memilih ejen dan menghantar mesej
tanpa menaip arahan terminal."
Jika ya: pandu saya untuk:
1. Buka tab terminal VS Code baharu
2. Jalankan: opengoat start
3. Pelayar akan terbuka secara automatik dengan OpenGoat UI
Bimbing saya melalui antara muka — cara memilih ejen dan menghantar mesej.
(Jika pelayar tidak terbuka secara automatik: pergi ke http://localhost:19123)
Jika tidak: langkau dan teruskan ke Langkah 7.

LANGKAH 7 — Pengesahan akhir
Jalankan senarai semak ini bersama saya:
□ Semua 6 ejen didaftarkan (openclaw agents list menunjukkan kesemua 6)
□ Pengawal Keselamatan didaftarkan (security-guardian muncul dalam senarai)
□ Pengawal Keselamatan berjalan dalam PM2 (pm2 list menunjukkan online)
□ Gateway berjalan (port 18789)
□ Setiap ejen membalas arahan pertama
□ Setiap ejen menyiarkan ke saluran Discord mereka
□ (Pilihan) OpenGoat UI boleh diakses di localhost:19123

LANGKAH 8 — Jana CLAUDE.md
Setelah kesemua 6 ejen (termasuk Pengawal Keselamatan) disahkan didaftarkan
dan berjalan, pandu saya untuk menjana CLAUDE.md — fail arahan yang dibaca
secara automatik oleh Claude Code pada permulaan setiap sesi:

"Sekarang mari kita jana CLAUDE.md anda. Ia dibina secara automatik daripada
persediaan pasukan yang telah anda selesaikan, jadi anda tidak perlu mengisi
apa-apa secara manual."

Windows:
cd $env:USERPROFILE\.opengoat\workspaces\security-guardian
node generate_claude_md.js

Mac:
cd ~/.opengoat/workspaces/security-guardian
node generate_claude_md.js

Minta saya mengesahkan bahawa saya melihat mesej yang berakhir lebih kurang seperti ini:
[OK] CLAUDE.md generated: (laluan anda)\.opengoat\CLAUDE.md

Jika CLAUDE.md sudah wujud, skrip akan secara automatik membuat sandaran
terlebih dahulu, kemudian bertanya sama ada untuk menulis ganti. "yes" bermaksud
menulis ganti (sandaran telah dibuat); "no" bermaksud kandungan baharu akan
disimpan sebagai CLAUDE_generated_draft.md, dan CLAUDE.md sedia ada akan kekal
sepenuhnya tidak berubah.

Jika ditanya tentang tier yang dibeli (T1 / T2 / T3), pandu saya untuk
memasukkan tier yang sebenarnya dibeli.

Selepas dijana, minta saya membuka
$env:USERPROFILE\.opengoat\CLAUDE.md untuk mengesahkan bahawa nama pasukan
dan peranan dipaparkan dengan betul.

Apabila semua kotak ditanda, katakan:
"Pasukan BALIA OS anda sudah aktif. Semua 6 ejen sedang berjalan dan melaporkan
ke Discord. Anda bersedia untuk Bahagian 6 — Membina Kaset Kemahiran Pertama Anda."

Mulakan sekarang. Tanya saya soalan pertama.

Mengenai CLAUDE.md

Fail CLAUDE.md yang dijana dalam LANGKAH 8 adalah fail arahan yang dibaca secara automatik oleh Claude Code dalam VS Code pada permulaan setiap sesi. Ia dijana pada ketika ini — sejurus selepas semua ejen disahkan didaftarkan dan berjalan — terus di bawah $env:USERPROFILE.opengoat.

Termasuk secara automatik:

  • Jadual komposisi pasukan (nama dan peranan kesemua 6 ejen)
  • Larangan mutlak operasi merosakkan (pengesahan diperlukan sebelum memadam/menulis ganti fail, dan lain-lain)
  • Pengendalian maklumat sensitif (tiada output teks biasa untuk kunci API, webhook, dan lain-lain)
  • Peraturan bahasa output

Menyesuaikannya: Segala sesuatu di bawah bahagian ## Feel free to customize everything below this line di penghujung fail adalah milik anda untuk disunting — tambah peraturan khusus projek, arahan biasa, atau apa-apa sahaja yang berguna.

Dua bahagian berhampiran bahagian atas — ## Absolute Prohibition on Destructive Operations (Critical — Always Follow — Do Not Delete) dan ## Handling of Sensitive Information (Do Not Delete) — adalah peraturan keselamatan teras. Ia dipaparkan dalam bahasa pilihan anda (disokong dalam 20 bahasa). Jangan padam atau ubah kedua-dua bahagian ini.

Jika CLAUDE.md sudah wujud: Menjalankan LANGKAH 8 tidak akan sekali-kali menulis ganti CLAUDE.md sedia ada secara senyap. Skrip akan membuat sandaran secara automatik terlebih dahulu, kemudian bertanya sama ada untuk menulis ganti. Jawab "no" dan fail sedia ada akan kekal sepenuhnya tidak disentuh — kandungan yang baru dijana disimpan secara berasingan sebagai CLAUDE_generated_draft.md.


Bercakap Dengan Ejen Anda Sehari-Hari

Setelah semuanya telah disediakan, inilah cara anda memberikan arahan:

Mulakan gateway (lakukan ini dahulu, setiap sesi):

Windows:

$env:DEBUG="-ciao*"; openclaw gateway --force

Mac:

DEBUG="-ciao*" openclaw gateway --force

Biarkan tab terminal ini terus berjalan. Buka tab baharu untuk arahan lain.

Melalui terminal VS Code:

# Bercakap dengan ejen tertentu
openclaw agent --agent marcus "Summarize what you worked on today"

# Semak senarai ejen
openclaw agents list

# Mulakan semula gateway jika perlu
openclaw gateway restart

marcus adalah contoh — gantikan dengan ID ejen anda sendiri (contoh: --agent ceo atau --agent nova).

Melalui OpenGoat UI:

  1. Buka tab terminal VS Code baharu
  2. Jalankan: opengoat start
  3. Pelayar akan terbuka secara automatik dengan OpenGoat UI
  4. Pilih ejen dari panel kiri
  5. Taip mesej anda dan tekan Enter (Jika pelayar tidak terbuka secara automatik: pergi ke http://localhost:19123)

Melalui Discord (laporan sahaja — bukan untuk arahan): Discord adalah tempat ejen anda menghantar laporan mereka. Anda membaca kemaskini mereka di sini. Menghantar arahan kepada ejen melalui Discord memerlukan Discord Bot — ini adalah persediaan lanjutan yang tidak diliputi dalam T1. Gunakan terminal VS Code atau OpenGoat UI untuk memberikan arahan buat masa ini.


Jika Ejen Tidak Bertindak Balas

Semak perkara-perkara ini mengikut urutan:

  1. Adakah gateway sedang berjalan?

    openclaw gateway restart
  2. Adakah ejen telah didaftarkan?

    openclaw agents list

    Jika ejen anda tidak tersenarai, jalankan semula arahan agents add dari Langkah 2.

  3. Adakah fail workspace berada di tempat yang betul?

    Semak bahawa SOUL.md, AGENTS.md, dan IDENTITY.md wujud di dalam:

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

    Mac: ~/.opengoat/workspaces/[agentid]/

  4. Adakah kunci API ditetapkan dengan betul? Buka .env (dalam folder .opengoat anda) dan sahkan bahawa ANTHROPIC_API_KEY telah diisi.

Jika anda masih tersekat, tampalkan mesej ralat ke dalam AI sembang anda dan minta bantuan.


Sahkan Persediaan Anda

Setelah semua ejen disahkan aktif, jalankan:

Windows:

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

Mac:

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

Ini mengesahkan bahawa kesemua 6 ejen didaftarkan, Pengawal Keselamatan sedang berjalan, dan anda bersedia untuk Bahagian 6.