Langsung ke konten
Panduan

Utas dan sesi Matrix di OpenClaw

Scope sesi DM, mode utas balasan, pewarisan utas, binding percakapan ACP, kebijakan binding utas, dan riwayat room yang hanya berisi pesan tertunda

5 menit baca

Matrix mendukung utas native, dan OpenClaw memperlakukan pengutasan dan perutean sesi sebagai dua keputusan yang independen: di mana balasan diposting, dan ke sesi mana sebuah percakapan termasuk. Tambahkan binding ACP yang mengubah room atau utas menjadi ruang kerja coding yang persisten, serta jendela riwayat room yang hanya membawa apa yang belum dilihat agen, dan Anda mendapatkan gambaran lengkapnya. Berikut dua pengaturannya, pewarisan dan perintah, binding ACP beserta konfigurasinya, dan aturan riwayat.

Dua pengaturan

  • Scope sesi DM menentukan cara room DM dipetakan ke sesi: per pengguna, yang merupakan default, berbagi satu sesi di semua room DM dengan peer terutekan yang sama, sedangkan per room memberi setiap room DM Matrix kunci sesinya sendiri, bahkan untuk peer yang sama.
  • Utas balasan menentukan di mana bot memposting: off menjaga balasan tetap di tingkat atas dan pesan berutas yang masuk tetap di sesi induk, inbound membalas di dalam utas hanya jika pesan masuk sudah berada di utas tersebut, dan always membalas di dalam utas yang berakar pada pesan pemicu dan merutekan percakapan itu melalui sesi berlingkup utas sejak pemicu pertama; override khusus DM dapat menjaga DM tetap datar sementara utas room tetap terisolasi.
  • Memilih target balasan di dalam utas mempertahankan utas sekaligus pesan yang dipilih, dan metadata balasan yang diterima klien lama pada pesan berutas tidak diperlakukan sebagai pesan kutipan dalam konteks agen.
  • Pesan berutas yang masuk menyertakan akar utas sebagai konteks tambahan, pengiriman lewat alat pesan otomatis mewarisi utas saat ini ketika menargetkan room yang sama atau pengguna DM yang sama kecuali id utas diberikan, penggunaan ulang target pengguna DM hanya berlaku jika metadata sesi membuktikan peer yang sama di akun yang sama, dan perintah sesi unbind, agents, idle, dan max-age serta spawn ACP yang terikat utas semuanya berfungsi di room dan DM Matrix.
Binding percakapan yang eksplisit selalu menang atas sessionScope; room dan utas yang terikat mempertahankan sesi target pilihannya.

Binding ACP

Room, DM, dan utas yang sudah ada di Matrix dapat menjadi ruang kerja ACP yang persisten tanpa mengubah permukaan chat. Alur operatornya hanya satu perintah: spawn ACP dengan flag bind-here di dalam DM, room, atau utas yang ingin terus digunakan; di DM atau room tingkat atas, permukaan saat ini tetap menjadi chat dan pesan berikutnya dirutekan ke sesi ACP yang di-spawn, di dalam utas yang sudah ada flag tersebut mengikat utas itu di tempat, perintah new-session dan reset mereset sesi terikat yang sama di tempat, dan perintah close ACP mengakhiri sesi serta menghapus binding-nya. Bind-here tidak pernah membuat utas anak; membuat atau mengikat utas anak melalui opsi thread pada perintah spawn dikendalikan oleh pengaturan spawn-sessions. Saat OpenClaw mendeteksi room DM yang bertabrakan dengan room lain pada sesi bersama yang sama, OpenClaw memposting pemberitahuan satu kali yang menyarankan scope per room, hanya selama binding utas diaktifkan.

Konfigurasi dan riwayat

  • Matrix mewarisi default binding utas global dengan override per saluran: enabled, jam idle, usia maksimum, flag spawn-sessions yang mengendalikan spawn utas sub-agen maupun ACP dan aktif secara default, serta konteks spawn default; kunci spawn per jenis yang sudah usang dimigrasikan oleh perbaikan doctor, dan konteks spawn yang terisolasi mencegah spawn utas sub-agen native mem-fork transkrip induk.
  • Batas riwayat menentukan berapa banyak pesan room terbaru yang disertakan sebagai riwayat masuk saat pesan room memicu agen, dengan fallback ke batas chat grup global dan default nol (nonaktif) jika keduanya tidak diatur; riwayat room hanya untuk room, sedangkan DM tetap menggunakan riwayat sesi biasa.
  • Riwayat room hanya berisi pesan tertunda: OpenClaw menampung pesan room yang tidak memicu balasan, mengambil snapshot jendela tersebut saat mention atau pemicu lain tiba, mengeluarkan pemicu saat ini dari blok riwayat karena pemicu itu adalah isi pesan masuk, dan menggunakan ulang snapshot asli saat mencoba ulang peristiwa yang sama alih-alih bergeser maju.

OpenClaw di Matrix adalah artikel saluran yang diperdalam oleh artikel ini, dan panduan sesi OpenClaw menjelaskan kunci dan reset yang menjadi dasar pemetaan ini.

Bentuk yang sama di Discord

Binding utas, kontrol idle dan max-age, serta binding ACP adalah kebijakan bersama di semua saluran, sehingga alur kerja yang dipelajari di satu saluran dapat dibawa ke saluran lain. Utas dan sesi Discord di OpenClaw adalah versi Discord dari halaman yang sama, dan panduan sub-agen OpenClaw membahas spawn yang mendapatkan sesi terikat utas.

Di Diali

Matrix ada dalam daftar saluran yang dapat dihubungkan di Diali, bersama WhatsApp, Telegram, Discord, Slack, Mattermost, SMS, dan suara: akun homeserver dan daftar izin room adalah milik Anda, Gateway adalah urusan kami. OpenClaw yang di-hosting di Diali adalah asistennya, dan panduan menghubungkan saluran pertama Anda dalam lima menit menjelaskan cara saluran-saluran tersebut dihubungkan.

  • Scope menentukan sesi; pengutasan menentukan balasan.
  • Binding menang; bind-here tidak pernah membuat utas.
  • Riwayat hanya berisi pesan tertunda dan snapshot-nya stabil saat percobaan ulang.
Mulai sekarang

Berhenti membaca, buat agen Anda sendiri

Siapkan agen, pilih saluran, dan biarkan ia bekerja di dalam aplikasi yang sudah selalu Anda buka.