Sessions and memory
Memori Honcho
Honcho menambahkan memori native-AI ke OpenClaw. Plugin ini mempertahankan percakapan ke layanan khusus dan membangun model pengguna serta agen dari waktu ke waktu, memberi agen Anda konteks lintas sesi yang melampaui file Markdown workspace.
Apa yang disediakannya
- Memori lintas sesi -- percakapan dipertahankan setelah setiap giliran, sehingga konteks terbawa melintasi reset sesi, Compaction, dan perpindahan channel.
- Pemodelan pengguna -- Honcho mempertahankan profil untuk setiap pengguna (preferensi, fakta, gaya komunikasi) dan untuk agen (kepribadian, perilaku yang dipelajari).
- Pencarian semantik -- pencarian atas observasi dari percakapan masa lalu, bukan hanya sesi saat ini.
- Kesadaran multi-agen -- agen induk secara otomatis melacak sub-agen yang di-spawn, dengan induk ditambahkan sebagai observer di sesi anak.
Tool yang tersedia
Honcho mendaftarkan tool yang dapat digunakan agen selama percakapan:
Pengambilan data (cepat, tanpa panggilan LLM):
| Tool | Fungsinya |
|---|---|
honcho_context |
Representasi lengkap pengguna di seluruh sesi |
honcho_search_conclusions |
Pencarian semantik atas conclusion yang disimpan |
honcho_search_messages |
Temukan pesan di seluruh sesi (filter menurut pengirim, tanggal) |
honcho_session |
Riwayat dan ringkasan sesi saat ini |
Tanya jawab (didukung LLM):
| Tool | Fungsinya |
|---|---|
honcho_ask |
Ajukan pertanyaan tentang pengguna. depth='quick' untuk fakta, 'thorough' untuk sintesis |
Memulai
Instal Plugin dan jalankan setup:
openclaw plugins install @honcho-ai/openclaw-honcho
openclaw honcho setup
openclaw gateway --force
Perintah setup meminta kredensial API Anda, menulis konfigurasi, dan secara opsional memigrasikan file memori workspace yang ada.
Konfigurasi
Pengaturan berada di bawah plugins.entries["openclaw-honcho"].config:
{
plugins: {
entries: {
"openclaw-honcho": {
config: {
apiKey: "your-api-key", // hilangkan untuk self-hosted
workspaceId: "openclaw", // isolasi memori
baseUrl: "https://api.honcho.dev",
},
},
},
},
}
Untuk instance self-hosted, arahkan baseUrl ke server lokal Anda (misalnya
http://localhost:8000) dan hilangkan API key.
Memigrasikan memori yang ada
Jika Anda memiliki file memori workspace yang sudah ada (USER.md, MEMORY.md,
IDENTITY.md, memory/, canvas/), openclaw honcho setup akan mendeteksinya dan
menawarkan untuk memigrasikannya.
Cara kerjanya
Setelah setiap giliran AI, percakapan dipertahankan ke Honcho. Pesan pengguna dan agen sama-sama diamati, sehingga Honcho dapat membangun dan menyempurnakan modelnya seiring waktu.
Selama percakapan, tool Honcho mengkueri layanan pada fase before_prompt_build,
menyuntikkan konteks yang relevan sebelum model melihat prompt. Ini memastikan
batas giliran yang akurat dan recall yang relevan.
Honcho vs memori bawaan
| Bawaan / QMD | Honcho | |
|---|---|---|
| Penyimpanan | File Markdown workspace | Layanan khusus (lokal atau hosted) |
| Lintas sesi | Melalui file memori | Otomatis, bawaan |
| Pemodelan pengguna | Manual (tulis ke MEMORY.md) | Profil otomatis |
| Pencarian | Vektor + kata kunci (hibrida) | Semantik atas observasi |
| Multi-agen | Tidak dilacak | Kesadaran induk/anak |
| Dependensi | Tidak ada (bawaan) atau biner QMD | Instalasi Plugin |
Honcho dan sistem memori bawaan dapat bekerja bersama. Saat QMD dikonfigurasi, tool tambahan menjadi tersedia untuk mencari file Markdown lokal bersama memori lintas sesi Honcho.
Perintah CLI
openclaw honcho setup # Konfigurasikan API key dan migrasikan file
openclaw honcho status # Periksa status koneksi
openclaw honcho ask <question> # Kueri Honcho tentang pengguna
openclaw honcho search <query> [-k N] [-d D] # Pencarian semantik atas memori
Bacaan lebih lanjut
- Kode sumber Plugin
- Dokumentasi Honcho
- Panduan integrasi Honcho OpenClaw
- Memory -- ikhtisar memori OpenClaw
- Context Engines -- cara kerja context engine Plugin