Sessions and memory
Honcho memory
Honcho เพิ่ม memory แบบ AI-native ให้กับ OpenClaw โดยจะเก็บ บทสนทนาไว้ในบริการเฉพาะ และสร้างแบบจำลองผู้ใช้และเอเจนต์ตามเวลา ทำให้เอเจนต์ของคุณมีบริบทข้ามเซสชันที่ไปไกลกว่าไฟล์ Markdown ของ workspace
สิ่งที่มันมีให้
- memory ข้ามเซสชัน -- บทสนทนาจะถูกเก็บหลังจากทุกเทิร์น ดังนั้น บริบทจะคงอยู่ข้ามการรีเซ็ตเซสชัน Compaction และการสลับแชนแนล
- การสร้างแบบจำลองผู้ใช้ -- Honcho ดูแลโปรไฟล์ของผู้ใช้แต่ละคน (ความชอบ ข้อเท็จจริง รูปแบบการสื่อสาร) และของเอเจนต์ (บุคลิก ลักษณะพฤติกรรม ที่เรียนรู้มา)
- semantic search -- ค้นหาจาก observations ของบทสนทนาในอดีต ไม่ใช่ แค่เซสชันปัจจุบัน
- การรับรู้หลายเอเจนต์ -- parent agents จะติดตาม sub-agents ที่ spawn ขึ้นโดยอัตโนมัติ โดย parent จะถูกเพิ่มเป็น observers ใน child sessions
tools ที่มีให้
Honcho ลงทะเบียน tools ที่เอเจนต์สามารถใช้ระหว่างบทสนทนา:
การดึงข้อมูล (เร็ว, ไม่มีการเรียก LLM):
| Tool | สิ่งที่ทำ |
|---|---|
honcho_context |
ตัวแทนผู้ใช้แบบเต็มข้ามเซสชัน |
honcho_search_conclusions |
semantic search บน conclusions ที่เก็บไว้ |
honcho_search_messages |
ค้นหาข้อความข้ามเซสชัน (กรองตามผู้ส่ง วันที่) |
honcho_session |
ประวัติและสรุปของเซสชันปัจจุบัน |
Q&A (ขับเคลื่อนด้วย LLM):
| Tool | สิ่งที่ทำ |
|---|---|
honcho_ask |
ถามเกี่ยวกับผู้ใช้ ใช้ depth='quick' สำหรับข้อเท็จจริง และ 'thorough' สำหรับการสังเคราะห์ |
เริ่มต้นใช้งาน
ติดตั้ง Plugin และรันการตั้งค่า:
openclaw plugins install @honcho-ai/openclaw-honcho
openclaw honcho setup
openclaw gateway --force
คำสั่ง setup จะถามข้อมูลรับรอง API ของคุณ เขียน config และ ย้ายไฟล์ memory ของ workspace ที่มีอยู่เดิมได้ตามตัวเลือก
การกำหนดค่า
การตั้งค่าอยู่ภายใต้ plugins.entries["openclaw-honcho"].config:
{
plugins: {
entries: {
"openclaw-honcho": {
config: {
apiKey: "your-api-key", // ละไว้ได้สำหรับ self-hosted
workspaceId: "openclaw", // การแยก memory
baseUrl: "https://api.honcho.dev",
},
},
},
},
}
สำหรับอินสแตนซ์ self-hosted ให้ชี้ baseUrl ไปยังเซิร์ฟเวอร์ภายในเครื่องของคุณ (เช่น
http://localhost:8000) และไม่ต้องระบุ API key
การย้าย memory ที่มีอยู่เดิม
หากคุณมีไฟล์ memory ของ workspace อยู่แล้ว (USER.md, MEMORY.md,
IDENTITY.md, memory/, canvas/) คำสั่ง openclaw honcho setup จะตรวจพบและ
เสนอให้ย้ายไฟล์เหล่านั้น
การทำงานของมัน
หลังจากแต่ละ AI turn บทสนทนาจะถูกเก็บลงใน Honcho ทั้งข้อความของผู้ใช้และ เอเจนต์จะถูกสังเกต ทำให้ Honcho สามารถสร้างและปรับปรุงแบบจำลองของตนต่อไปได้ ตามเวลา
ระหว่างบทสนทนา tools ของ Honcho จะ query บริการในระยะ before_prompt_build
และแทรกบริบทที่เกี่ยวข้องก่อนที่โมเดลจะเห็น prompt วิธีนี้ช่วยให้
ขอบเขตของเทิร์นแม่นยำและการเรียกคืนมีความเกี่ยวข้อง
Honcho เทียบกับ memory ในตัว
| ในตัว / QMD | Honcho | |
|---|---|---|
| การจัดเก็บ | ไฟล์ Markdown ของ workspace | บริการเฉพาะ (ภายในเครื่องหรือโฮสต์) |
| ข้ามเซสชัน | ผ่านไฟล์ memory | อัตโนมัติ มีในตัว |
| การสร้างแบบจำลองผู้ใช้ | ทำเอง (เขียนลง MEMORY.md) |
โปรไฟล์อัตโนมัติ |
| การค้นหา | Vector + keyword (hybrid) | semantic บน observations |
| หลายเอเจนต์ | ไม่มีการติดตาม | รับรู้ parent/child |
| Dependencies | ไม่มี (ในตัว) หรือ QMD binary | ติดตั้ง Plugin |
Honcho และระบบ memory ในตัวสามารถทำงานร่วมกันได้ เมื่อกำหนดค่า QMD แล้ว จะมี tools เพิ่มเติมสำหรับค้นหาไฟล์ Markdown ภายในเครื่องควบคู่ไปกับ memory ข้ามเซสชันของ Honcho
คำสั่ง CLI
openclaw honcho setup # กำหนดค่า API key และย้ายไฟล์
openclaw honcho status # ตรวจสอบสถานะการเชื่อมต่อ
openclaw honcho ask <question> # query Honcho เกี่ยวกับผู้ใช้
openclaw honcho search <query> [-k N] [-d D] # semantic search บน memory
อ่านเพิ่มเติม
- ซอร์สโค้ดของ Plugin
- เอกสาร Honcho
- คู่มือการผสานรวม Honcho กับ OpenClaw
- Memory -- ภาพรวม memory ของ OpenClaw
- Context Engines -- วิธีทำงานของ Plugin context engines