Draf kemajuan - OpenClaw

Draf progres membuat giliran agen yang berjalan lama terasa hidup di chat tanpa mengubah percakapan menjadi tumpukan balasan status sementara. Saat draf progres diaktifkan, OpenClaw membuat satu pesan pekerjaan-sedang-berjalan yang terlihat hanya setelah giliran tersebut terbukti melakukan pekerjaan nyata, memperbaruinya saat agen membaca, merencanakan, memanggil alat, atau menunggu persetujuan, lalu mengubah draf itu menjadi jawaban akhir saat saluran dapat melakukannya dengan aman.

Shelling...
📖 from docs/concepts/progress-drafts.md
🔎 Web Search: for "discord edit message"
🛠️ Bash: run tests

Gunakan draf progres saat Anda menginginkan satu pesan status yang rapi selama pekerjaan yang banyak memakai alat dan jawaban akhir saat giliran selesai.

Mulai cepat

Aktifkan draf progres per saluran dengan streaming.mode: "progress":

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
      },
    },
  },
}

Itu biasanya sudah cukup. OpenClaw akan memilih label satu kata otomatis, menunggu hingga pekerjaan berlangsung setidaknya lima detik atau memancarkan peristiwa kerja kedua, menambahkan baris progres ringkas saat pekerjaan yang berguna berlangsung, dan menekan obrolan progres mandiri duplikat untuk giliran tersebut.

Yang dilihat pengguna

Draf progres memiliki dua bagian:

Bagian	Tujuan
Label	Baris awal/status singkat seperti `Thinking...` atau `Shelling...`.
Baris progres	Pembaruan proses yang ringkas menggunakan ikon alat dan pemformat detail yang sama seperti keluaran verbose.

Label muncul setelah agen memulai pekerjaan bermakna dan tetap sibuk selama lima detik atau memancarkan peristiwa kerja kedua. Label merupakan bagian dari daftar baris progres bergulir, sehingga status awal akan tergulir keluar setelah cukup banyak pekerjaan konkret muncul. Balasan teks saja tidak menampilkan draf progres. Baris progres ditambahkan hanya saat agen memancarkan pembaruan kerja yang berguna, misalnya 🛠️ Bash: run tests, 🔎 Web Search: for "discord edit message", atau ✍️ Write: to /tmp/file. Secara default, baris tersebut menggunakan mode penjelasan ringkas yang sama seperti /verbose; atur agents.defaults.toolProgressDetail: "raw" saat debugging dan Anda juga ingin perintah/detail mentah ditambahkan. Jawaban akhir menggantikan draf jika memungkinkan; jika tidak, OpenClaw mengirim jawaban akhir seperti biasa dan membersihkan atau berhenti memperbarui draf sesuai transport saluran.

Pilih mode

channels.<channel>.streaming.mode mengontrol perilaku sedang-berjalan yang terlihat:

Mode	Paling cocok untuk	Yang muncul di chat
`off`	Saluran yang tenang	Hanya jawaban akhir.
`partial`	Melihat teks jawaban muncul	Satu draf diedit dengan teks jawaban terbaru.
`block`	Potongan pratinjau jawaban lebih besar	Satu pratinjau diperbarui atau ditambahkan dalam potongan lebih besar.
`progress`	Giliran yang banyak memakai alat atau berjalan lama	Satu draf status, lalu jawaban akhir.

Pilih progress saat pengguna lebih peduli dengan “apa yang sedang terjadi” daripada melihat teks jawaban mengalir token demi token. Pilih partial saat jawaban itu sendiri adalah sinyal progres. Pilih block saat Anda menginginkan pembaruan pratinjau draf dalam potongan teks yang lebih besar. Di Discord dan Telegram, streaming.mode: "block" tetap berupa streaming pratinjau, bukan pengiriman blok normal. Gunakan streaming.block.enabled atau blockStreaming lama saat Anda menginginkan balasan blok normal.

Konfigurasikan label

Label progres berada di bawah channels.<channel>.streaming.progress. Label default adalah auto, yang memilih dari kumpulan label bawaan OpenClaw satu-kata-dengan-elipsis:

Thinking...
Shelling...
Scuttling...
Clawing...
Pinching...
Molting...
Bubbling...
Tiding...
Reefing...
Cracking...
Sifting...
Brining...
Nautiling...
Krilling...
Barnacling...
Lobstering...
Tidepooling...
Pearling...
Snapping...
Surfacing...

Gunakan label tetap:

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: "Investigating",
        },
      },
    },
  },
}

Gunakan kumpulan label otomatis Anda sendiri:

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: "auto",
          labels: ["Checking", "Reading", "Testing", "Finishing"],
        },
      },
    },
  },
}

Sembunyikan label dan tampilkan hanya baris progres:

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: false,
        },
      },
    },
  },
}

Kontrol baris progres

Baris progres diaktifkan secara default dalam mode progres. Baris tersebut berasal dari peristiwa proses nyata: awal alat, pembaruan item, rencana tugas, persetujuan, keluaran perintah, ringkasan patch, dan aktivitas agen serupa. OpenClaw menggunakan pemformat yang sama untuk draf progres dan /verbose:

{
  agents: {
    defaults: {
      toolProgressDetail: "explain", // explain | raw
    },
  },
}

"explain" adalah default dan menjaga draf tetap stabil dengan label ringkas seperti 🛠️ check JS syntax for /tmp/app.js. "raw" menambahkan perintah/detail yang mendasarinya saat tersedia, yang berguna saat debugging tetapi lebih ramai di chat. Misalnya, perintah yang sama muncul berbeda tergantung mode detail:

Mode	Baris progres
`explain`	`🛠️ check JS syntax for /tmp/app.js`
`raw`	`🛠️ check JS syntax for /tmp/app.js, node --check /tmp/app.js`

Batasi jumlah baris yang tetap terlihat:

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          maxLines: 4,
        },
      },
    },
  },
}

Baris progres dipadatkan secara otomatis untuk mengurangi perubahan tata letak gelembung chat saat draf diedit. OpenClaw memotong baris progres yang panjang secara default agar pengeditan draf berulang tidak membungkus secara berbeda di setiap pembaruan. Awalan tetap mudah dibaca, dan detail panjang seperti path atau perintah mentah dipendekkan dengan elipsis. Slack dapat merender baris progres sebagai field Block Kit terstruktur alih-alih satu isi teks:

{
  channels: {
    slack: {
      streaming: {
        mode: "progress",
        progress: {
          render: "rich",
        },
      },
    },
  },
}

Rendering kaya mempertahankan fallback teks biasa yang sama sehingga saluran dan klien yang tidak mendukung bentuk yang lebih kaya tetap dapat menampilkan teks progres ringkas. Pertahankan satu draf progres tetapi sembunyikan baris alat dan tugas:

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          toolProgress: false,
        },
      },
    },
  },
}

Dengan toolProgress: false, OpenClaw tetap menekan pesan progres-alat mandiri lama untuk giliran tersebut. Saluran tetap tenang secara visual hingga jawaban akhir, kecuali label jika dikonfigurasi.

Perilaku saluran

Setiap saluran menggunakan transport paling bersih yang didukungnya:

Saluran	Transport progres	Catatan
Discord	Kirim satu pesan, lalu edit pesan itu.	Teks akhir diedit di tempat saat muat dalam satu pesan pratinjau aman.
Matrix	Kirim satu peristiwa, lalu edit peristiwa itu.	Konfigurasi streaming tingkat akun mengontrol draf tingkat akun.
Microsoft Teams	Stream Teams native di chat personal.	`streaming.mode: "block"` dipetakan ke pengiriman blok Teams.
Slack	Stream native atau kiriman draf yang dapat diedit.	Ketersediaan thread memengaruhi apakah streaming native dapat digunakan.
Telegram	Kirim satu pesan, lalu edit pesan itu.	Draf lama yang terlihat dapat diganti agar timestamp akhir tetap berguna.
Mattermost	Kiriman draf yang dapat diedit.	Aktivitas alat digabungkan ke dalam kiriman bergaya draf yang sama.

Saluran tanpa dukungan edit yang aman biasanya fallback ke indikator mengetik atau pengiriman hanya-akhir.

Finalisasi

Saat jawaban akhir siap, OpenClaw mencoba menjaga chat tetap bersih:

Jika draf dapat dengan aman menjadi jawaban akhir, OpenClaw mengeditnya di tempat.
Jika saluran menggunakan streaming progres native, OpenClaw memfinalisasi stream tersebut saat transport native menerima teks akhir.
Jika jawaban akhir memiliki media, prompt persetujuan, target balasan eksplisit, terlalu banyak potongan, atau edit/kirim gagal, OpenClaw mengirim jawaban akhir melalui jalur pengiriman saluran normal.

Jalur fallback ini disengaja. Lebih baik mengirim jawaban akhir baru daripada kehilangan teks, salah menempatkan thread balasan, atau menimpa draf dengan payload yang tidak dapat direpresentasikan saluran dengan aman.

Pemecahan masalah

Saya hanya melihat jawaban akhir. Periksa bahwa channels.<channel>.streaming.mode diatur ke progress untuk akun atau saluran yang menangani pesan. Beberapa jalur grup atau balasan-kutipan dapat menonaktifkan pratinjau draf untuk suatu giliran saat saluran tidak dapat mengedit pesan yang tepat dengan aman. Saya melihat label tetapi tidak ada baris alat. Periksa streaming.progress.toolProgress. Jika nilainya false, OpenClaw mempertahankan perilaku satu draf tetapi menyembunyikan baris progres alat dan tugas. Saya melihat pesan akhir baru alih-alih draf yang diedit. Itu adalah fallback keamanan. Ini dapat terjadi untuk balasan media, jawaban panjang, target balasan eksplisit, draf Telegram lama, target thread Slack yang hilang, pesan pratinjau yang dihapus, atau finalisasi stream native yang gagal. Saya masih melihat pesan progres mandiri. Mode progres menekan pesan progres-alat mandiri default saat sebuah draf aktif. Jika pesan mandiri masih muncul, pastikan giliran tersebut benar-benar menggunakan mode progres dan bukan streaming.mode: "off" atau jalur saluran yang tidak dapat membuat draf untuk pesan tersebut. Teams berperilaku berbeda dari Discord atau Telegram. Microsoft Teams menggunakan stream native di chat personal, bukan transport pratinjau kirim-dan-edit generik. Teams juga memperlakukan streaming.mode: "block" sebagai pengiriman blok Teams karena tidak memiliki mode blok pratinjau-draf yang sama seperti yang digunakan Discord dan Telegram.

Documentation Index

​Mulai cepat

​Yang dilihat pengguna

​Pilih mode

​Konfigurasikan label

​Kontrol baris progres

​Perilaku saluran

​Finalisasi

​Pemecahan masalah

​Terkait