Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw memberi agen alat untuk bekerja lintas sesi, memeriksa status, dan mengorkestrasi sub-agen.

​
Alat yang tersedia

AlatYang dilakukannya
sessions_listMencantumkan sesi dengan filter opsional (jenis, label, agen, kebaruan, pratinjau)
sessions_historyMembaca transkrip sesi tertentu
sessions_sendMengirim pesan ke sesi lain dan secara opsional menunggu
sessions_spawnMembuat sesi sub-agen terisolasi untuk pekerjaan latar belakang
sessions_yieldMengakhiri giliran saat ini dan menunggu hasil sub-agen lanjutan
subagentsMencantumkan, mengarahkan, atau menghentikan sub-agen yang dibuat untuk sesi ini
session_statusMenampilkan kartu bergaya /status dan secara opsional menetapkan override model per sesi
Alat ini tetap tunduk pada profil alat aktif dan kebijakan izinkan/tolak. tools.profile: "coding" menyertakan set orkestrasi sesi lengkap, termasuk sessions_spawn, sessions_yield, dan subagents. tools.profile: "messaging" menyertakan alat perpesanan lintas sesi (sessions_list, sessions_history, sessions_send, session_status) tetapi tidak menyertakan pembuatan sub-agen. Untuk mempertahankan profil perpesanan dan tetap mengizinkan delegasi native, tambahkan: 
{
  tools: {
    profile: "messaging",
    alsoAllow: ["sessions_spawn", "sessions_yield", "subagents"],
  },
}
Kebijakan grup, penyedia, sandbox, dan per-agen tetap dapat menghapus alat tersebut setelah tahap profil. Gunakan /tools dari sesi yang terdampak untuk memeriksa daftar alat efektif.

​
Mencantumkan dan membaca sesi

sessions_list mengembalikan sesi beserta key, agentId, jenis, channel, model, jumlah token, dan timestamp-nya. Filter menurut jenis (main, group, cron, hook, node), label persis, agentId persis, teks pencarian, atau kebaruan (activeMinutes). Saat Anda memerlukan triase bergaya kotak masuk, alat ini juga dapat meminta judul turunan yang tercakup visibilitas, cuplikan pratinjau pesan terakhir, atau pesan terbaru terbatas pada setiap baris. Judul turunan dan pratinjau hanya dibuat untuk sesi yang sudah dapat dilihat pemanggil berdasarkan kebijakan visibilitas alat sesi yang dikonfigurasi, sehingga sesi yang tidak terkait tetap tersembunyi. sessions_history mengambil transkrip percakapan untuk sesi tertentu. Secara default, hasil alat dikecualikan — teruskan includeTools: true untuk melihatnya. Tampilan yang dikembalikan sengaja dibatasi dan difilter untuk keamanan:
  • teks asisten dinormalisasi sebelum dipanggil kembali:
    • tag berpikir dihapus
    • blok scaffolding <relevant-memories> / <relevant_memories> dihapus
    • blok payload XML panggilan alat teks biasa seperti <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, dan <function_calls>...</function_calls> dihapus, termasuk payload terpotong yang tidak pernah tertutup dengan bersih
    • scaffolding panggilan/hasil alat yang diturunkan seperti [Tool Call: ...], [Tool Result ...], dan [Historical context ...] dihapus
    • token kontrol model yang bocor seperti <|assistant|>, token ASCII <|...|> lainnya, dan varian lebar-penuh <｜...｜> dihapus
    • XML panggilan alat MiniMax yang tidak valid seperti <invoke ...> / </minimax:tool_call> dihapus
  • teks yang menyerupai kredensial/token disunting sebelum dikembalikan
  • blok teks panjang dipotong
  • riwayat yang sangat besar dapat menghapus baris lama atau mengganti baris yang terlalu besar dengan [sessions_history omitted: message too large]
  • alat melaporkan flag ringkasan seperti truncated, droppedMessages, contentTruncated, contentRedacted, dan bytes
Kedua alat menerima key sesi (seperti "main") atau ID sesi dari pemanggilan daftar sebelumnya. Jika Anda memerlukan transkrip yang persis byte demi byte, periksa file transkrip di disk alih-alih memperlakukan sessions_history sebagai dump mentah.

​
Mengirim pesan lintas sesi

sessions_send mengirimkan pesan ke sesi lain dan secara opsional menunggu respons:
  • Kirim-lalu-lupakan: tetapkan timeoutSeconds: 0 untuk mengantrekan dan segera kembali.
  • Tunggu balasan: tetapkan timeout dan dapatkan respons secara inline.
Sesi chat yang tercakup thread, seperti key Slack atau Discord yang diakhiri :thread:<id>, bukan target sessions_send yang valid. Gunakan key sesi channel induk untuk koordinasi antar-agen agar pesan yang dirutekan alat tidak muncul di dalam thread aktif yang menghadap manusia. Pesan dan balasan tindak lanjut A2A ditandai sebagai data antar-sesi dalam prompt penerima ([Inter-session message ... isUser=false]) dan dalam provenance transkrip. Agen penerima harus memperlakukannya sebagai data yang dirutekan alat, bukan sebagai instruksi langsung yang ditulis pengguna akhir. Setelah target merespons, OpenClaw dapat menjalankan loop balas-kembali tempat agen bergantian mengirim pesan (hingga session.agentToAgent.maxPingPongTurns, rentang 0-20, default 5). Agen target dapat membalas REPLY_SKIP untuk berhenti lebih awal.

​
Pembantu status dan orkestrasi

session_status adalah alat ringan yang setara dengan /status untuk sesi saat ini atau sesi lain yang terlihat. Alat ini melaporkan penggunaan, waktu, status model/runtime, dan konteks tugas latar belakang tertaut jika ada. Seperti /status, alat ini dapat mengisi balik penghitung token/cache yang jarang dari entri penggunaan transkrip terbaru, dan model=default menghapus override per sesi. Gunakan sessionKey="current" untuk sesi pemanggil saat ini; label klien yang terlihat seperti openclaw-tui bukan key sesi. sessions_yield sengaja mengakhiri giliran saat ini agar pesan berikutnya dapat menjadi peristiwa lanjutan yang Anda tunggu. Gunakan setelah membuat sub-agen saat Anda ingin hasil penyelesaian tiba sebagai pesan berikutnya alih-alih membuat loop polling. subagents adalah pembantu control plane untuk sub-agen OpenClaw yang sudah dibuat. Alat ini mendukung:
  • action: "list" untuk memeriksa run aktif/terbaru
  • action: "steer" untuk mengirim arahan lanjutan ke child yang sedang berjalan
  • action: "kill" untuk menghentikan satu child atau all

​
Membuat sub-agen

sessions_spawn secara default membuat sesi terisolasi untuk tugas latar belakang. Alat ini selalu non-blocking — langsung kembali dengan runId dan childSessionKey. Opsi utama:
  • runtime: "subagent" (default) atau "acp" untuk agen harness eksternal.
  • Override model dan thinking untuk sesi child.
  • thread: true untuk mengikat spawn ke thread chat (Discord, Slack, dll.).
  • sandbox: "require" untuk memberlakukan sandboxing pada child.
  • context: "fork" untuk sub-agen native saat child memerlukan transkrip peminta saat ini; hilangkan atau gunakan context: "isolated" untuk child bersih. Sub-agen native yang terikat thread default ke context: "fork" kecuali threadBindings.defaultSpawnContext menyatakan sebaliknya.
Sub-agen leaf default tidak mendapatkan alat sesi. Saat maxSpawnDepth >= 2, sub-agen orkestrator depth-1 juga menerima sessions_spawn, subagents, sessions_list, dan sessions_history agar dapat mengelola child mereka sendiri. Run leaf tetap tidak mendapatkan alat orkestrasi rekursif. Setelah selesai, langkah pengumuman memposting hasil ke channel peminta. Pengiriman penyelesaian mempertahankan perutean thread/topik terikat saat tersedia, dan jika origin penyelesaian hanya mengidentifikasi channel, OpenClaw tetap dapat menggunakan kembali rute tersimpan sesi peminta (lastChannel / lastTo) untuk pengiriman langsung. Untuk perilaku khusus ACP, lihat Agen ACP.

​
Visibilitas

Alat sesi dicakup untuk membatasi apa yang dapat dilihat agen:
LevelCakupan
selfHanya sesi saat ini
treeSesi saat ini + sub-agen yang dibuat
agentSemua sesi untuk agen ini
allSemua sesi (lintas-agen jika dikonfigurasi)
Default adalah tree. Sesi dalam sandbox dibatasi ke tree terlepas dari konfigurasi.

​
Bacaan lebih lanjut

​
Terkait