Integrasikan Memory Service dengan plugin agen: OpenClaw dan Hermes - Tablestore

Integrasikan dengan Memory Service menggunakan plugin resmi untuk OpenClaw dan Hermes. Plugin ini secara otomatis mengambil memori jangka panjang yang relevan dan menyuntikkannya ke dalam konteks sebelum percakapan dimulai, lalu menuliskannya kembali setelah percakapan berakhir.

Plugin OpenClaw

openclaw-tablestore-memory adalah plugin memori untuk OpenClaw yang menggunakan Tablestore Node.js SDK untuk memanggil Memory Service.

Instalasi

openclaw plugins install @tablestore/openclaw-tablestore-memory

Konfigurasi

Konfigurasi minimal adalah sebagai berikut:

{
  "plugins": {
    "slots": {
      "memory": "tablestore-mem"
    },
    "entries": {
      "tablestore-mem": {
        "enabled": true,
        "config": {
          "endpoint": "https://<instance>.cn-beijing.ots.aliyuncs.com",
          "otsInstanceName": "<instance-name>",
          "accessKeyId": "<AccessKey ID>",
          "accessKeySecret": "<AccessKey Secret>"
        }
      }
    }
  }
}

Konfigurasi opsional

Parameter	Default	Deskripsi
`appId`	`openclaw`	Identifier aplikasi.
`tenantId`	Diturunkan dari informasi pengguna session	Identifier penyewa atau pengguna.
`memoryStoreName`	`openclaw_mem`	Nama memory store.
`autoCreateMemoryStore`	`true`	Membuat memory store secara otomatis jika belum ada.
`writebackEnabled`	`true`	Mengaktifkan atau menonaktifkan penulisan balik memori setelah percakapan berakhir.
`searchTopK`	`5`	Jumlah hasil pencarian yang dikembalikan.
`enableRerank`	`true`	Mengaktifkan atau menonaktifkan Rerank.

Pemetaan cakupan

Plugin OpenClaw menggunakan identitas waktu proses saat ini untuk operasi tulis:

{
  "appId": "openclaw",
  "tenantId": "<current-user>",
  "agentId": "<runtime-agent>",
  "runId": "<runtime-session>"
}

Untuk operasi pencarian, plugin ini menggunakan cakupan yang mencakup semua agen dan sesi dalam satu penyewa. Parameter agentId dan runId diatur ke karakter wildcard *:

{
  "appId": "openclaw",
  "tenantId": "<current-user>",
  "agentId": "*",
  "runId": "*"
}

Perilaku waktu proses

Mengambil memori jangka panjang yang relevan selama fase before_prompt_build.
Menyuntikkan memori yang diambil ke dalam konteks tersembunyi, bukan menuliskannya langsung ke riwayat sesi yang terlihat.
Mengumpulkan pesan pengguna dan asisten untuk giliran saat ini selama fase agent_end.
Memanggil AddMemories secara asinkron secara default untuk menuliskan kembali ke memory store.

Perintah CLI dan slash

Plugin OpenClaw menyediakan perintah debugging berikut:

openclaw tablestore-mem add "Alice likes jasmine tea" --uid alice
openclaw tablestore-mem search "what does Alice like" --uid alice

Dalam sesi OpenClaw, Anda dapat menggunakan perintah berikut:

/tablestore-mem-add Alice likes jasmine tea
/tablestore-mem-search jasmine tea

Plugin Hermes

hermes-tablestore-memory adalah penyedia memori eksternal untuk agen Hermes yang menggunakan Tablestore Python SDK untuk memanggil Memory Service.

Instalasi

hermes plugins install https://github.com/aliyun/hermes-tablestore-memory
hermes memory setup

Selama proses hermes memory setup, pilih tablestore-mem.

Plugin ini memerlukan tablestore>=6.4.5. Jika dependensi ini belum terinstal di lingkungan Python yang digunakan oleh Hermes, Anda harus menginstal SDK tersebut di lingkungan tersebut.

Konfigurasi kunci rahasia

Kami menyarankan menuliskan kunci rahasia ke ~/.hermes/.env:

TABLESTORE_MEMORY_AK=<AccessKey ID>
TABLESTORE_MEMORY_SK=<AccessKey Secret>

Konfigurasi Memory Service

Tuliskan konfigurasi non-sensitif ke $HERMES_HOME/tablestore_memory.json:

{
  "endpoint": "https://<instance>.cn-beijing.ots.aliyuncs.com",
  "instance_name": "<instance-name>",
  "memory_store_name": "hermes_mem",
  "description": "",
  "app_id": "hermes",
  "tenant_id": "",
  "enable_rerank": true,
  "auto_create_store": true,
  "timeout": 30
}

Nilai default

Parameter	Default	Deskripsi
`memory_store_name`	`hermes_mem`	Nama memory store.
`app_id`	`hermes`	Identifier aplikasi.
`tenant_id`	String kosong	Jika kosong, nilai ini diinferensi dari konteks sesi atau menggunakan default `__default__`.
`enable_rerank`	`true`	Mengaktifkan atau menonaktifkan Rerank.
`auto_create_store`	`true`	Membuat memory store secara otomatis jika belum ada.
`timeout`	`30`	Timeout permintaan dalam detik.

Pemetaan cakupan

Plugin Hermes mengisi Scope empat bagian sesuai aturan berikut:

Bidang	Sumber
`appId`	`app_id` dari `tablestore_memory.json`, yang default-nya adalah `hermes`.
`tenantId`	Menggunakan `user_id` dari sesi Hermes. Jika tidak tersedia, menggunakan `tenant_id` dari konfigurasi, dengan fallback akhir `__default__`.
`agentId`	Identitas sesi Hermes, yang default-nya adalah `hermes`.
`runId`	Menggunakan `gateway_session_key`, `session_title`, atau `session_id` berdasarkan prioritas, dengan fallback akhir `__default__`.

Operasi tulis menggunakan Scope tepat dari sesi saat ini. Operasi pencarian menggunakan cakupan tingkat penyewa yang mencakup semua agen dan sesi, dengan agentId dan runId diatur ke "".

Alat

Alat	Deskripsi
`tablestore_profile`	Menampilkan memori dalam Scope saat ini.
`tablestore_search`	Mencari memori jangka panjang.
`tablestore_remember`	Menulis entri baru ke memori jangka panjang.
`tablestore_forget`	Menghapus entri dari memori jangka panjang.

Plugin ini juga secara otomatis menyinkronkan pesan pengguna dan asisten setelah setiap giliran percakapan serta melakukan pra-ambil memori yang relevan sebelum giliran berikutnya dimulai.

Perintah CLI Hermes

Setelah Anda mengatur memory.provider ke tablestore-mem, Anda dapat menggunakan perintah berikut:

hermes tablestore-mem add "User prefers concise answers"
hermes tablestore-mem add "User likes Rust" --metadata source=manual --metadata topic=preferences
hermes tablestore-mem add "Write this memory synchronously" --sync
hermes tablestore-mem search "concise answers"
hermes tablestore-mem search "Rust" --top-k 10

Rekomendasi integrasi

Jika aplikasi Anda sudah menggunakan OpenClaw atau Hermes, kami merekomendasikan menggunakan plugin resmi yang sesuai.
Jika Anda perlu menyesuaikan strategi penulisan memori, strategi pencarian, atau cara merakit konteks, gunakan SDK secara langsung. Untuk detailnya, lihat Panduan Penggunaan SDK Python atau Panduan Penggunaan SDK Node.js.
Secara default, plugin melakukan pencarian memori jangka panjang di seluruh agen dan sesi dalam penyewa yang sama. Hal ini cocok untuk sebagian besar skenario asisten pribadi dan bisnis.
Jika bisnis Anda mengharuskan pencarian benar-benar terisolasi berdasarkan sesi, gunakan SDK untuk menentukan Scope lengkap. Untuk semantik bidang, lihat Referensi API.
Ketika dua agen berbagi memori, keduanya menggunakan instans Tablestore yang sama. appId, tenantId, dan memoryStoreName harus identik untuk kedua agen tersebut. agentId ditentukan oleh waktu proses masing-masing agen dan menggunakan wildcard * selama pengambilan.