Sasaran

Sasaran adalah satu tujuan tetap yang dilampirkan ke sesi OpenClaw saat ini. Sasaran memberi agen dan operator target bersama untuk pekerjaan jangka panjang, tanpa mengubah target tersebut menjadi tugas latar belakang, pengingat, tugas Cron, atau perintah tetap.

Sasaran merupakan status sesi: sasaran mengikuti kunci sesi, tetap tersedia setelah proses dimulai ulang, dan muncul di /goal, alat sasaran yang diakses model, serta bagian bawah TUI.

Mulai cepat

/goal start get CI green for PR 87469 and push the fix/goal/goal edit get CI green for PR 87469, push the fix, and update docs/goal pause waiting for CI/goal resume/goal complete pushed and verified/goal clear

start bersifat opsional: /goal get CI green for PR 87469 juga membuat sasaran, karena teks apa pun setelah /goal yang bukan kata tindakan yang dikenal akan dianggap sebagai tujuan baru.

Kegunaan sasaran

Gunakan sasaran ketika sesi memiliki hasil konkret yang harus tetap terlihat selama banyak giliran:

• Penyelesaian PR: perbaiki, verifikasi, lakukan peninjauan otomatis, dorong perubahan, lalu buka atau perbarui PR.
• Proses pengawakutuan: reproduksi bug, identifikasi permukaan pemiliknya, tambal, lalu buktikan perbaikannya.
• Peninjauan dokumentasi: baca dokumentasi yang relevan, tulis halaman baru, tambahkan tautan silang, lalu verifikasi pembangunan dokumentasi.
• Tugas pemeliharaan: periksa status saat ini, buat perubahan terbatas, jalankan pemeriksaan yang tepat, lalu laporkan perubahan yang dibuat.

Sasaran bukan antrean tugas. Gunakan Alur Tugas, tugas, tugas Cron, atau perintah tetap ketika pekerjaan harus berjalan secara terpisah, berulang sesuai jadwal, dikembangkan menjadi subpekerjaan terkelola, atau dipertahankan sebagai kebijakan.

Referensi perintah

/goal tanpa argumen menampilkan ringkasan sasaran saat ini:

GoalStatus: activeObjective: get CI green for PR 87469 and push the fixTokens used: 12kToken budget: 12k/50k Commands: /goal edit <objective>, /goal pause, /goal complete, /goal clear

Hanya satu sasaran yang dapat ada dalam satu sesi pada suatu waktu. Memulai sasaran kedua akan gagal dengan Goal error: goal already exists sampai sasaran saat ini dihapus.

/goal start tidak menerima flag anggaran token; anggaran hanya dapat ditetapkan melalui alat create_goal yang diakses model.

Status

• active: sesi sedang mengupayakan sasaran.
• paused: operator menjeda sasaran; /goal resume membuatnya aktif kembali.
• blocked: agen atau operator melaporkan penghambat nyata; /goal resume membuatnya aktif kembali saat informasi atau status baru tersedia.
• budget_limited: anggaran token yang dikonfigurasi telah tercapai; /goal resume memulai ulang upaya untuk tujuan yang sama dengan jendela anggaran baru.
• usage_limited: disediakan untuk status penghentian karena batas penggunaan di masa mendatang; /goal resume memulai ulang upaya dengan cara yang sama.
• complete: sasaran telah tercapai. Sasaran yang selesai bersifat terminal; gunakan /goal clear sebelum memulai sasaran lain.

/new dan /reset menghapus sasaran sesi saat ini karena keduanya memang memulai konteks sesi baru.

Anggaran token

Sasaran dapat memiliki anggaran token positif opsional yang ditetapkan melalui parameter token_budget pada alat create_goal. Anggaran diukur dari jumlah token baru sesi pada saat sasaran dibuat. Jika sesi hanya memiliki rekam cuplikan token yang usang atau tidak diketahui saat sasaran dimulai, OpenClaw menunggu rekam cuplikan baru berikutnya dan menggunakannya sebagai nilai dasar, sehingga token yang digunakan sebelum sasaran dibuat tidak dibebankan kepadanya.

Ketika penggunaan mencapai anggaran, sasaran berpindah ke budget_limited. Hal ini tidak menghapus sasaran atau tujuan; status ini memberi tahu operator dan agen bahwa sasaran tidak lagi diupayakan secara aktif sampai dilanjutkan atau dihapus. Melanjutkannya akan memulai jendela anggaran baru berdasarkan jumlah token baru saat ini.

Anggaran token adalah batas pengaman sasaran sesi, bukan batas penagihan. Kuota penyedia, pelaporan biaya, dan perilaku jendela konteks tetap menggunakan kontrol penggunaan dan model OpenClaw yang normal.

Alat model

OpenClaw menyediakan tiga alat sasaran untuk kerangka agen:

Model tidak dapat secara diam-diam menjeda, melanjutkan, menghapus, atau mengganti sasaran. Tindakan tersebut tetap menjadi kontrol operator/sesi melalui /goal dan perintah pengaturan ulang, sehingga agen dapat melaporkan pencapaian atau penghambat nyata tanpa diam-diam mengubah target.

update_goal hanya boleh menandai sasaran sebagai complete ketika tujuan benar-benar tercapai. Alat ini hanya boleh menandai sasaran sebagai blocked setelah kondisi penghambat yang sama berulang selama setidaknya tiga giliran sasaran berturut-turut, bukan karena kesulitan biasa atau penyempurnaan yang belum selesai.

Konteks sasaran pada setiap giliran

Setiap giliran pengguna/obrolan dengan sasaran aktif menyertakan baris konteks peran pengguna berikut:

Active goal: <objective> — advance it or update its status (get_goal/update_goal).

OpenClaw menjaga baris tetap ringkas dengan memotong tujuan yang panjang. Sasaran yang dijeda, terblokir, dibatasi anggaran, dibatasi penggunaan, dan selesai tidak disisipkan, sehingga penghentian oleh operator tetap berlaku sampai sasaran dilanjutkan.

UI Kontrol

UI Kontrol web menampilkan sasaran sebagai pil ringkas di atas penyusun obrolan: ikon status, label status (misalnya Pursuing goal), tujuan yang dipotong, dan pengatur waktu berjalan langsung.

Pil tersebut memiliki kontrol sebaris:

• Pensil mengisi penyusun terlebih dahulu dengan /goal edit <objective> agar tujuan dapat dirumuskan ulang dan dikirim.
• Jeda / lanjutkan beralih antara /goal pause dan /goal resume berdasarkan status saat ini.
• Tempat sampah mengirim /goal clear.
• Chevron memperluas pil untuk menampilkan tujuan lengkap, catatan status terbaru, penggunaan token, dan waktu yang telah berlalu.

Tombol tindakan disembunyikan saat penyusun tidak dapat mengirim (misalnya ketika koneksi Gateway terputus); chevron perluasan tetap berfungsi.

TUI

Bagian bawah TUI menjaga sasaran sesi aktif tetap terlihat di samping bidang agen, sesi, dan model, sebelum indikator token/mode.

Contoh bagian bawah:

• Pursuing goal (12k/50k) untuk sasaran aktif dengan anggaran token.
• Goal paused (/goal resume) untuk sasaran yang dijeda.
• Goal blocked (/goal resume) untuk sasaran yang terblokir.
• Goal hit usage limits (/goal resume) untuk sasaran yang dibatasi penggunaan.
• Goal unmet (50k/50k) untuk sasaran yang dibatasi anggaran.
• Goal achieved (42k) untuk sasaran yang selesai.

Bagian bawah sengaja dibuat ringkas. Gunakan /goal untuk melihat tujuan lengkap, catatan, anggaran token, dan perintah yang tersedia.

Perilaku kanal

/goal berfungsi dalam sesi OpenClaw yang mendukung perintah, termasuk TUI dan permukaan obrolan yang mengizinkan perintah teks. Status sasaran dilampirkan ke kunci sesi, bukan transportasi, sehingga dua permukaan yang menggunakan kunci sesi yang sama akan melihat sasaran yang sama.

Status sasaran bukan arahan pengiriman: status tersebut tidak memaksa balasan melalui kanal, mengubah perilaku antrean, menyetujui alat, atau menjadwalkan pekerjaan.

Pemecahan masalah

Jika penggunaan token menampilkan 0 atau terlihat usang, sesi aktif mungkin belum memiliki rekam cuplikan token baru. Penggunaan diperbarui saat OpenClaw mencatat penggunaan sesi dan total yang berasal dari transkrip.

Terkait

• Perintah garis miring
• TUI
• Alat sesi
• Compaction
• Alur Tugas
• Perintah tetap