Skip to content

Commit e865b7a

Browse files
author
openclaw-docs-i18n[bot]
committed
chore(i18n): refresh id translations
1 parent 84ad3b8 commit e865b7a

File tree

11 files changed

+3359
-1964
lines changed

11 files changed

+3359
-1964
lines changed

docs/id/automation/tasks.md

Lines changed: 99 additions & 110 deletions
Large diffs are not rendered by default.

docs/id/concepts/active-memory.md

Lines changed: 612 additions & 0 deletions
Large diffs are not rendered by default.

docs/id/concepts/agent-loop.md

Lines changed: 63 additions & 63 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,26 @@
11
---
22
read_when:
33
- Anda memerlukan panduan langkah demi langkah yang tepat tentang loop agen atau peristiwa siklus hidup
4-
summary: Siklus hidup loop agen, aliran, dan semantik penantian
4+
summary: Siklus hidup loop agen, aliran, dan semantik menunggu
55
title: Loop Agen
66
x-i18n:
7-
generated_at: "2026-04-09T01:27:55Z"
7+
generated_at: "2026-04-10T09:13:13Z"
88
model: gpt-5.4
99
provider: openai
10-
source_hash: 32d3a73df8dabf449211a6183a70dcfd2a9b6f584dc76d0c4c9147582b2ca6a1
10+
source_hash: b6831a5b11e9100e49f650feca51ab44a2bef242ce1b5db2766d0b3b5c5ba729
1111
source_path: concepts/agent-loop.md
1212
workflow: 15
1313
---
1414

1515
# Loop Agen (OpenClaw)
1616

17-
Loop agentik adalah keseluruhan proses “nyata” agen: intake → perakitan konteks → inferensi model →
17+
Loop agentik adalah keseluruhan proses “nyata” saat agen berjalan: penerimaan → perakitan konteks → inferensi model →
1818
eksekusi alat → balasan streaming → persistensi. Ini adalah jalur otoritatif yang mengubah pesan
1919
menjadi tindakan dan balasan akhir, sambil menjaga status sesi tetap konsisten.
2020

21-
Di OpenClaw, loop adalah satu proses tunggal yang diserialkan per sesi yang memancarkan peristiwa siklus hidup dan stream
22-
saat model berpikir, memanggil alat, dan melakukan streaming output. Dokumen ini menjelaskan bagaimana loop autentik tersebut
23-
dirangkai dari ujung ke ujung.
21+
Di OpenClaw, sebuah loop adalah satu proses tunggal yang diserialkan per sesi yang mengirimkan peristiwa siklus hidup dan stream
22+
saat model berpikir, memanggil alat, dan melakukan streaming output. Dokumen ini menjelaskan bagaimana loop autentik itu
23+
dirangkai secara menyeluruh dari awal hingga akhir.
2424

2525
## Titik masuk
2626

@@ -29,45 +29,45 @@ dirangkai dari ujung ke ujung.
2929

3030
## Cara kerjanya (tingkat tinggi)
3131

32-
1. RPC `agent` memvalidasi parameter, menyelesaikan sesi (sessionKey/sessionId), menyimpan metadata sesi, dan segera mengembalikan `{ runId, acceptedAt }`.
32+
1. RPC `agent` memvalidasi parameter, menyelesaikan sesi (sessionKey/sessionId), menyimpan metadata sesi, dan langsung mengembalikan `{ runId, acceptedAt }`.
3333
2. `agentCommand` menjalankan agen:
3434
- menyelesaikan default model + thinking/verbose
3535
- memuat snapshot Skills
3636
- memanggil `runEmbeddedPiAgent` (runtime pi-agent-core)
37-
- memancarkan **akhir/error siklus hidup** jika loop tersemat tidak memancarkan salah satunya
37+
- mengirim **lifecycle end/error** jika loop tersemat tidak mengirimkannya
3838
3. `runEmbeddedPiAgent`:
3939
- menserialkan proses melalui antrean per sesi + global
40-
- menyelesaikan model + profil auth dan membangun sesi pi
40+
- menyelesaikan profil model + autentikasi dan membangun sesi pi
4141
- berlangganan ke peristiwa pi dan melakukan streaming delta asisten/alat
42-
- menegakkan batas waktu -> membatalkan proses jika terlampaui
42+
- menerapkan timeout -> membatalkan proses jika terlampaui
4343
- mengembalikan payload + metadata penggunaan
4444
4. `subscribeEmbeddedPiSession` menjembatani peristiwa pi-agent-core ke stream `agent` OpenClaw:
4545
- peristiwa alat => `stream: "tool"`
4646
- delta asisten => `stream: "assistant"`
4747
- peristiwa siklus hidup => `stream: "lifecycle"` (`phase: "start" | "end" | "error"`)
4848
5. `agent.wait` menggunakan `waitForAgentRun`:
49-
- menunggu **akhir/error siklus hidup** untuk `runId`
49+
- menunggu **lifecycle end/error** untuk `runId`
5050
- mengembalikan `{ status: ok|error|timeout, startedAt, endedAt, error? }`
5151

5252
## Antrean + konkurensi
5353

54-
- Proses diserialkan per kunci sesi (jalur sesi) dan secara opsional melalui jalur global.
54+
- Proses diserialkan per kunci sesi (lajur sesi) dan secara opsional melalui lajur global.
5555
- Ini mencegah race pada alat/sesi dan menjaga riwayat sesi tetap konsisten.
56-
- Kanal pesan dapat memilih mode antrean (collect/steer/followup) yang masuk ke sistem jalur ini.
57-
Lihat [Antrean Perintah](/id/concepts/queue).
56+
- Channel pesan dapat memilih mode antrean (collect/steer/followup) yang masuk ke sistem lajur ini.
57+
Lihat [Command Queue](/id/concepts/queue).
5858

5959
## Persiapan sesi + workspace
6060

61-
- Workspace diselesaikan dan dibuat; proses tersandbox dapat dialihkan ke root workspace sandbox.
62-
- Skills dimuat (atau digunakan kembali dari snapshot) dan disuntikkan ke env dan prompt.
61+
- Workspace diselesaikan dan dibuat; proses yang disandbox dapat dialihkan ke root workspace sandbox.
62+
- Skills dimuat (atau digunakan ulang dari snapshot) dan disuntikkan ke env dan prompt.
6363
- File bootstrap/konteks diselesaikan dan disuntikkan ke laporan system prompt.
64-
- Kunci tulis sesi diperoleh; `SessionManager` dibuka dan disiapkan sebelum streaming.
64+
- Kunci tulis sesi diambil; `SessionManager` dibuka dan disiapkan sebelum streaming.
6565

6666
## Perakitan prompt + system prompt
6767

6868
- System prompt dibangun dari prompt dasar OpenClaw, prompt Skills, konteks bootstrap, dan override per proses.
69-
- Batas khusus model dan token cadangan compaction diterapkan.
70-
- Lihat [System prompt](/id/concepts/system-prompt) untuk apa yang dilihat model.
69+
- Batas khusus model dan token cadangan untuk pemadatan diterapkan.
70+
- Lihat [System prompt](/id/concepts/system-prompt) untuk mengetahui apa yang dilihat model.
7171

7272
## Titik hook (tempat Anda dapat mencegat)
7373

@@ -78,99 +78,99 @@ OpenClaw memiliki dua sistem hook:
7878

7979
### Hook internal (hook Gateway)
8080

81-
- **`agent:bootstrap`**: berjalan saat membangun file bootstrap sebelum system prompt difinalkan.
81+
- **`agent:bootstrap`**: berjalan saat membangun file bootstrap sebelum system prompt difinalisasi.
8282
Gunakan ini untuk menambah/menghapus file konteks bootstrap.
8383
- **Hook perintah**: `/new`, `/reset`, `/stop`, dan peristiwa perintah lainnya (lihat dokumen Hooks).
8484

8585
Lihat [Hooks](/id/automation/hooks) untuk penyiapan dan contoh.
8686

8787
### Hook plugin (siklus hidup agen + gateway)
8888

89-
Hook ini berjalan di dalam loop agen atau pipeline gateway:
89+
Ini berjalan di dalam loop agen atau pipeline gateway:
9090

91-
- **`before_model_resolve`**: berjalan pra-sesi (tanpa `messages`) untuk mengganti provider/model secara deterministik sebelum resolusi model.
92-
- **`before_prompt_build`**: berjalan setelah sesi dimuat (dengan `messages`) untuk menyuntikkan `prependContext`, `systemPrompt`, `prependSystemContext`, atau `appendSystemContext` sebelum prompt dikirim. Gunakan `prependContext` untuk teks dinamis per giliran dan field konteks sistem untuk panduan stabil yang seharusnya berada di ruang system prompt.
93-
- **`before_agent_start`**: hook kompatibilitas lama yang dapat berjalan pada salah satu fase; gunakan hook eksplisit di atas jika memungkinkan.
94-
- **`before_agent_reply`**: berjalan setelah tindakan inline dan sebelum pemanggilan LLM, memungkinkan plugin mengklaim giliran dan mengembalikan balasan sintetis atau membisukan giliran sepenuhnya.
91+
- **`before_model_resolve`**: berjalan sebelum sesi (tanpa `messages`) untuk menimpa provider/model secara deterministik sebelum resolusi model.
92+
- **`before_prompt_build`**: berjalan setelah sesi dimuat (dengan `messages`) untuk menyuntikkan `prependContext`, `systemPrompt`, `prependSystemContext`, atau `appendSystemContext` sebelum prompt dikirimkan. Gunakan `prependContext` untuk teks dinamis per giliran dan field system-context untuk panduan stabil yang harus berada dalam ruang system prompt.
93+
- **`before_agent_start`**: hook kompatibilitas lama yang dapat berjalan di salah satu fase; lebih baik gunakan hook eksplisit di atas.
94+
- **`before_agent_reply`**: berjalan setelah tindakan inline dan sebelum pemanggilan LLM, memungkinkan plugin mengambil alih giliran dan mengembalikan balasan sintetis atau membungkam giliran sepenuhnya.
9595
- **`agent_end`**: memeriksa daftar pesan akhir dan metadata proses setelah selesai.
96-
- **`before_compaction` / `after_compaction`**: mengamati atau memberi anotasi pada siklus compaction.
96+
- **`before_compaction` / `after_compaction`**: mengamati atau memberi anotasi pada siklus pemadatan.
9797
- **`before_tool_call` / `after_tool_call`**: mencegat parameter/hasil alat.
9898
- **`before_install`**: memeriksa temuan pemindaian bawaan dan secara opsional memblokir instalasi skill atau plugin.
99-
- **`tool_result_persist`**: secara sinkron mengubah hasil alat sebelum ditulis ke transkrip sesi.
99+
- **`tool_result_persist`**: secara sinkron mentransformasi hasil alat sebelum ditulis ke transkrip sesi.
100100
- **`message_received` / `message_sending` / `message_sent`**: hook pesan masuk + keluar.
101101
- **`session_start` / `session_end`**: batas siklus hidup sesi.
102102
- **`gateway_start` / `gateway_stop`**: peristiwa siklus hidup gateway.
103103

104-
Aturan keputusan hook untuk pengaman keluar/alat:
104+
Aturan keputusan hook untuk guard keluar/alat:
105105

106-
- `before_tool_call`: `{ block: true }` bersifat terminal dan menghentikan handler prioritas lebih rendah.
106+
- `before_tool_call`: `{ block: true }` bersifat terminal dan menghentikan handler berprioritas lebih rendah.
107107
- `before_tool_call`: `{ block: false }` adalah no-op dan tidak menghapus blok sebelumnya.
108-
- `before_install`: `{ block: true }` bersifat terminal dan menghentikan handler prioritas lebih rendah.
108+
- `before_install`: `{ block: true }` bersifat terminal dan menghentikan handler berprioritas lebih rendah.
109109
- `before_install`: `{ block: false }` adalah no-op dan tidak menghapus blok sebelumnya.
110-
- `message_sending`: `{ cancel: true }` bersifat terminal dan menghentikan handler prioritas lebih rendah.
111-
- `message_sending`: `{ cancel: false }` adalah no-op dan tidak menghapus cancel sebelumnya.
110+
- `message_sending`: `{ cancel: true }` bersifat terminal dan menghentikan handler berprioritas lebih rendah.
111+
- `message_sending`: `{ cancel: false }` adalah no-op dan tidak menghapus pembatalan sebelumnya.
112112

113-
Lihat [Hook plugin](/id/plugins/architecture#provider-runtime-hooks) untuk API hook dan detail pendaftaran.
113+
Lihat [Plugin hooks](/id/plugins/architecture#provider-runtime-hooks) untuk API hook dan detail pendaftaran.
114114

115115
## Streaming + balasan parsial
116116

117-
- Delta asisten di-stream dari pi-agent-core dan dipancarkan sebagai peristiwa `assistant`.
118-
- Streaming blok dapat memancarkan balasan parsial pada `text_end` atau `message_end`.
119-
- Streaming reasoning dapat dipancarkan sebagai stream terpisah atau sebagai balasan blok.
117+
- Delta asisten di-stream dari pi-agent-core dan dikirim sebagai peristiwa `assistant`.
118+
- Streaming blok dapat mengirim balasan parsial baik pada `text_end` maupun `message_end`.
119+
- Streaming reasoning dapat dikirim sebagai stream terpisah atau sebagai balasan blok.
120120
- Lihat [Streaming](/id/concepts/streaming) untuk perilaku chunking dan balasan blok.
121121

122-
## Eksekusi alat + alat pesan
122+
## Eksekusi alat + alat perpesanan
123123

124-
- Peristiwa mulai/pembaruan/akhir alat dipancarkan pada stream `tool`.
125-
- Hasil alat disanitasi untuk ukuran dan payload gambar sebelum dicatat/dipancarkan.
126-
- Pengiriman alat pesan dilacak untuk menekan konfirmasi asisten duplikat.
124+
- Peristiwa mulai/pembaruan/selesai alat dikirim di stream `tool`.
125+
- Hasil alat disanitasi untuk ukuran dan payload gambar sebelum dicatat/dikirim.
126+
- Pengiriman alat perpesanan dilacak untuk menekan konfirmasi asisten yang duplikat.
127127

128128
## Pembentukan balasan + penekanan
129129

130130
- Payload akhir dirakit dari:
131131
- teks asisten (dan reasoning opsional)
132132
- ringkasan alat inline (saat verbose + diizinkan)
133-
- teks error asisten saat model mengalami error
134-
- Token senyap yang tepat `NO_REPLY` / `no_reply` difilter dari payload
135-
keluar.
136-
- Duplikat alat pesan dihapus dari daftar payload akhir.
137-
- Jika tidak ada payload yang dapat dirender yang tersisa dan alat mengalami error, balasan error alat fallback dipancarkan
138-
(kecuali alat pesan sudah mengirim balasan yang terlihat oleh pengguna).
133+
- teks kesalahan asisten saat model mengalami error
134+
- Token hening yang persis `NO_REPLY` / `no_reply` disaring dari
135+
payload keluar.
136+
- Duplikat alat perpesanan dihapus dari daftar payload akhir.
137+
- Jika tidak ada payload yang dapat dirender dan alat mengalami error, balasan fallback kesalahan alat akan dikirim
138+
(kecuali alat perpesanan sudah mengirim balasan yang terlihat oleh pengguna).
139139

140-
## Compaction + percobaan ulang
140+
## Pemadatan + percobaan ulang
141141

142-
- Auto-compaction memancarkan peristiwa stream `compaction` dan dapat memicu percobaan ulang.
142+
- Pemadatan otomatis mengirim peristiwa stream `compaction` dan dapat memicu percobaan ulang.
143143
- Saat percobaan ulang, buffer dalam memori dan ringkasan alat direset untuk menghindari output duplikat.
144-
- Lihat [Compaction](/id/concepts/compaction) untuk pipeline compaction.
144+
- Lihat [Compaction](/id/concepts/compaction) untuk pipeline pemadatan.
145145

146146
## Stream peristiwa (saat ini)
147147

148-
- `lifecycle`: dipancarkan oleh `subscribeEmbeddedPiSession` (dan sebagai fallback oleh `agentCommand`)
148+
- `lifecycle`: dikirim oleh `subscribeEmbeddedPiSession` (dan sebagai fallback oleh `agentCommand`)
149149
- `assistant`: delta streaming dari pi-agent-core
150150
- `tool`: peristiwa alat streaming dari pi-agent-core
151151

152-
## Penanganan kanal chat
152+
## Penanganan channel chat
153153

154-
- Delta asisten dibuffer ke dalam pesan chat `delta`.
155-
- Chat `final` dipancarkan pada **akhir/error siklus hidup**.
154+
- Delta asisten dibuffer menjadi pesan chat `delta`.
155+
- Chat `final` dikirim pada **lifecycle end/error**.
156156

157-
## Batas waktu
157+
## Timeout
158158

159-
- Default `agent.wait`: 30 detik (hanya penantian). Parameter `timeoutMs` menimpa.
160-
- Runtime agen: default `agents.defaults.timeoutSeconds` adalah 172800 dtk (48 jam); ditegakkan dalam timer abort `runEmbeddedPiAgent`.
161-
- Batas waktu idle LLM: `agents.defaults.llm.idleTimeoutSeconds` membatalkan permintaan model saat tidak ada potongan respons yang tiba sebelum jendela idle berakhir. Tetapkan ini secara eksplisit untuk model lokal lambat atau provider reasoning/pemanggilan alat; tetapkan ke 0 untuk menonaktifkan. Jika tidak ditetapkan, OpenClaw menggunakan `agents.defaults.timeoutSeconds` jika dikonfigurasi, atau 60 dtk jika tidak. Proses yang dipicu cron tanpa batas waktu LLM atau agen eksplisit menonaktifkan watchdog idle dan bergantung pada batas waktu luar cron.
159+
- Default `agent.wait`: 30 dtk (hanya penantian). Parameter `timeoutMs` menimpa nilai ini.
160+
- Runtime agen: default `agents.defaults.timeoutSeconds` adalah 172800 dtk (48 jam); diterapkan di timer pembatalan `runEmbeddedPiAgent`.
161+
- Timeout idle LLM: `agents.defaults.llm.idleTimeoutSeconds` membatalkan permintaan model ketika tidak ada chunk respons yang datang sebelum jendela idle berakhir. Atur secara eksplisit untuk model lokal yang lambat atau provider reasoning/pemanggilan alat; atur ke 0 untuk menonaktifkan. Jika tidak diatur, OpenClaw menggunakan `agents.defaults.timeoutSeconds` bila dikonfigurasi, atau 120 dtk bila tidak. Proses yang dipicu cron tanpa timeout LLM atau agen eksplisit menonaktifkan watchdog idle dan mengandalkan timeout luar cron.
162162

163-
## Tempat proses bisa berakhir lebih awal
163+
## Tempat proses dapat berakhir lebih awal
164164

165-
- Batas waktu agen (abort)
165+
- Timeout agen (abort)
166166
- AbortSignal (batal)
167-
- Gateway terputus atau batas waktu RPC
168-
- Batas waktu `agent.wait` (hanya penantian, tidak menghentikan agen)
167+
- Gateway terputus atau timeout RPC
168+
- Timeout `agent.wait` (hanya penantian, tidak menghentikan agen)
169169

170170
## Terkait
171171

172172
- [Tools](/id/tools) — alat agen yang tersedia
173173
- [Hooks](/id/automation/hooks) — skrip berbasis peristiwa yang dipicu oleh peristiwa siklus hidup agen
174-
- [Compaction](/id/concepts/compaction)cara percakapan panjang diringkas
174+
- [Compaction](/id/concepts/compaction)bagaimana percakapan panjang diringkas
175175
- [Exec Approvals](/id/tools/exec-approvals) — gerbang persetujuan untuk perintah shell
176176
- [Thinking](/id/tools/thinking) — konfigurasi tingkat thinking/reasoning

0 commit comments

Comments
 (0)