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.

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):
ToolFungsinya
honcho_contextRepresentasi lengkap pengguna di seluruh sesi
honcho_search_conclusionsPencarian semantik atas conclusion yang disimpan
honcho_search_messagesTemukan pesan di seluruh sesi (filter menurut pengirim, tanggal)
honcho_sessionRiwayat dan ringkasan sesi saat ini
Tanya jawab (didukung LLM):
ToolFungsinya
honcho_askAjukan 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.
Honcho dapat berjalan sepenuhnya secara lokal (self-hosted) atau melalui API terkelola di api.honcho.dev. Tidak diperlukan dependensi eksternal untuk opsi self-hosted.

​
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.
Migrasi tidak merusak — file diunggah ke Honcho. File asli tidak pernah dihapus atau dipindahkan.

​
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 / QMDHoncho
PenyimpananFile Markdown workspaceLayanan khusus (lokal atau hosted)
Lintas sesiMelalui file memoriOtomatis, bawaan
Pemodelan penggunaManual (tulis ke MEMORY.md)Profil otomatis
PencarianVektor + kata kunci (hibrida)Semantik atas observasi
Multi-agenTidak dilacakKesadaran induk/anak
DependensiTidak ada (bawaan) atau biner QMDInstalasi 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

​
Terkait