Skip to main content

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 เพิ่ม 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_conclusionssemantic 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 ที่มีอยู่เดิมได้ตามตัวเลือก
Honcho สามารถรันแบบภายในเครื่องทั้งหมดได้ (self-hosted) หรือผ่าน managed API ที่ api.honcho.dev สำหรับตัวเลือก self-hosted ไม่ต้องมี dependencies ภายนอก เพิ่มเติม

​
การกำหนดค่า

การตั้งค่าอยู่ภายใต้ 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 จะตรวจพบและ เสนอให้ย้ายไฟล์เหล่านั้น
การย้ายเป็นแบบไม่ทำลายข้อมูล — ไฟล์จะถูกอัปโหลดไปยัง Honcho โดยไฟล์ต้นฉบับ จะไม่ถูกลบหรือย้ายออกเด็ดขาด

​
การทำงานของมัน

หลังจากแต่ละ AI turn บทสนทนาจะถูกเก็บลงใน Honcho ทั้งข้อความของผู้ใช้และ เอเจนต์จะถูกสังเกต ทำให้ Honcho สามารถสร้างและปรับปรุงแบบจำลองของตนต่อไปได้ ตามเวลา ระหว่างบทสนทนา tools ของ Honcho จะ query บริการในระยะ before_prompt_build และแทรกบริบทที่เกี่ยวข้องก่อนที่โมเดลจะเห็น prompt วิธีนี้ช่วยให้ ขอบเขตของเทิร์นแม่นยำและการเรียกคืนมีความเกี่ยวข้อง

​
Honcho เทียบกับ memory ในตัว

ในตัว / QMDHoncho
การจัดเก็บไฟล์ 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

​
อ่านเพิ่มเติม

​
ที่เกี่ยวข้อง