Voice

Memory Tencentdb

Name: Memory Tencentdb
Rating: 3.5 (1 reviews)
Author: biteno

By biteno 👁 14 views ▲ 0 votes

Remote TencentDB Agent Memory Plugin for OpenClaw — bidirectional prefetch recall & asynchronous turn sync for central TencentDB clusters

GitHub

Install

npm install
npm

Configuration Example

{
  "plugins": {
    "openclaw-memory-tencentdb": {
      "enabled": true,
      "coreUrl": "http://tencentdb.itsc.local:8420",
      "importUrl": "http://tencentdb.itsc.local:8125",
      "knowledgeUrl": "http://tencentdb.itsc.local:8424",
      "userKey": "sk-mem-YOUR_TENCENTDB_API_KEY",
      "teamId": "team-thpa5ncu0p",
      "agentId": "<DEINE_AGENT_ID>",
      "autoRecall": true,
      "autoCapture": true,
      "scoreThreshold": 0.5,
      "maxRecallResults": 3
    }
  }
}

README

# @biteno/openclaw-memory-tencentdb

> **Remote TencentDB Agent Memory Plugin for OpenClaw** — Bidirektionale Anbindung an zentrale TencentDB Memory-Cluster (`tencentdb.itsc.local`).

[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)
[![OpenClaw](https://img.shields.io/badge/OpenClaw-%3E=2026.1.0-orange)](https://github.com/openclaw/openclaw)
[![Node](https://img.shields.io/badge/node-%3E=20.0-brightgreen)](https://nodejs.org/)

---

## 🎯 Übersicht

Dieses Plugin verbindet **OpenClaw** nativ mit einem zentralen **TencentDB Agent Memory Cluster** (`http://tencentdb.itsc.local`). 

Im Gegensatz zum offiziellen lokalen NPM-Paket (das eine isolierte SQLite-Datenbank auf der lokalen Maschine betreibt) und im Gegensatz zum transparenten Proxy (der individuelle API-Keys und Token-Budgets im LiteLLM-Proxy verliert), arbeitet dieses Plugin als **schlanker, nativer HTTP-Client**:

- 🔍 **Automatischer Prefetch (`before_agent_start`):** Durchsucht vor jedem Turn das zentrale Gedächtnis (`/v2/conversation/search` & `/v3/skill/search` auf Port `8420`) und injiziert relevante Erinnerungen in `<tencentdb-memory>`.
- ⚡ **Asynchroner Turn-Sync (`agent_end`):** Überträgt abgeschlossene Nutzer- und Assistenten-Nachrichten nicht-blockierend an die zentrale Turn-Import-API (`/api/v1/chat-memory/import` auf Port `8125`).
- 🛠️ **Integrierte On-Demand Werkzeuge:** Stellt OpenClaw die Tools `tdai_conversation_search`, `tdai_skill_search`, `tdai_wiki_search` und `tdai_codegraph_search` bereit.
- 🏢 **Zentrales Flottengedächtnis:** OpenClaw teilt das Wissen in Echtzeit mit anderen Agenten (Hermes, Claude Code, etc.) im selben Team-Namespace.

---

## 🏗️ Architektur & Microservices

```
┌─────────────────────────────────────────────────────────────────────────────┐
│                            OpenClaw Instanz                                 │
│                                                                             │
│  [before_agent_start] ──(1. Prefetch)──┐   ▲──(3. Context Injection)──┐     │
│  [agent_end]          ──(4. Sync Turn)─┼─┐ │                          │     │
│  [Tools]              ──(5. Search)────┼─┼─┼────────────────────────┐ │     │
└────────────────────────────────────────┼─┼─┼────────────────────────┼─┼─────┘
                                         │ │ │                        │ │
             ┌───────────────────────────┘ │ └──────────────┐         │ │
             ▼                             ▼                │         ▼ ▼
┌─────────────────────────┐   ┌──────────────────────────┐  │  ┌─────────────────────────┐
│       MemoryCore        │   │       MemoryPanel        │  │  │     MemoryKnowledge     │
│       Port :8420        │   │        Port :8125        │  │  │       Port :8424        │
│  • L0–L3 Hybrid Search  │   │  • /api/v1/chat-memory/  │  │  │  • Team Wiki Search     │
│  • Skill & Fact Recall  │   │    import (L0 Ingest)    │  │  │  • CodeGraph Impact     │
└─────────────────────────┘   └──────────────────────────┘  │  └─────────────────────────┘
                                                            │
                                         ┌──────────────────┘
                                         ▼
                             ┌───────────────────────┐
                             │  Biteno AI Hub / LLM  │
                             │  (aihubtest.biteno)   │
                             └───────────────────────┘
```

---

## 📦 1. Installation

### Option A: Über Git in das OpenClaw Extensions-Verzeichnis klonen (Empfohlen)

```bash
# In das OpenClaw Extensions-Verzeichnis wechseln
cd ~/.openclaw/extensions/
git clone https://github.com/biteno/openclaw-memory-tencentdb.git

# Abhängigkeiten installieren & bauen
cd openclaw-memory-tencentdb
npm install
npm run build
```

### Option B: Über den OpenClaw Plugin Manager

```bash
openclaw plugins install biteno/openclaw-memory-tencentdb
```

---

## ⚙️ 2. Konfiguration (`openclaw.json`)

Füge die Konfiguration in deine OpenClaw-Konfigurationsdatei (z. B. `~/.openclaw/openclaw.json`) ein:

```jsonc
{
  "plugins": {
    "openclaw-memory-tencentdb": {
      "enabled": true,
      "coreUrl": "http://tencentdb.itsc.local:8420",
      "importUrl": "http://tencentdb.itsc.local:8125",
      "knowledgeUrl": "http://tencentdb.itsc.local:8424",
      "userKey": "sk-mem-YOUR_TENCENTDB_API_KEY",
      "teamId": "team-thpa5ncu0p",
      "agentId": "<DEINE_AGENT_ID>",
      "autoRecall": true,
      "autoCapture": true,
      "scoreThreshold": 0.5,
      "maxRecallResults": 3
    }
  }
}
```

> ⚠️ **Wichtig:** Verwende unter `agentId` immer die für dein OpenClaw-Profil vorgesehene Container-ID (z. B. aus der [Team-IDs & Agent-IDs Übersicht](https://wiki.biteno.com/books/agent-konfiguration/page/tencentdb-agent-memory-team-ids-agent-ids-ubersicht-docker13-tencentdbitsclocal)).

### Parameter-Referenz:

| Parameter | Typ | Standardwert | Beschreibung |
| :--- | :--- | :--- | :--- |
| `coreUrl` | String | `http://tencentdb.itsc.local:8420` | URL des TencentDB MemoryCore (:8420) für semantische L0–L3 Suche. |
| `importUrl` | String | `http://tencentdb.itsc.local:8125` | URL des MemoryPanel (:8125) für den asynchronen Turn-Import. |
| `knowledgeUrl` | String | `http://tencentdb.itsc.local:8424` | URL des MemoryKnowledge (:8424) für Wiki- und CodeGraph-Suche. |
| `userKey` | String | `sk-mem-...` | Persönlicher TencentDB Access Key aus `.admin-key`. |
| `teamId` | String | `team-thpa5ncu0p` | Team-Identifier / Mandant in TencentDB. |
| `agentId` | String | `agt-...` | Eindeutige Kennung dieser OpenClaw-Instanz. |
| `autoRecall` | Boolean | `true` | Automatischer Wissensabruf vor jeder Nutzeranfrage. |
| `autoCapture` | Boolean | `true` | Automatischer asynchroner Turn-Import nach jeder Antwort. |
| `scoreThreshold` | Number | `0.5` | Mindest-Ähnlichkeitsscore (0.0 – 1.0) für injizierte Erinnerungen. |
| `maxRecallResults` | Number | `3` | Maximale Anzahl an Konversationserinnerungen im Prompt. |

---

## 🛠️ 3. Bereitgestellte Werkzeuge (Tools)

Dem Agenten stehen automatisch folgende Werkzeuge für gezielte Abfragen zur Verfügung:

1. **`tdai_conversation_search`**:
   * Durchsucht frühere Konversationen und gelöste Problemstellungen semantisch.
   * Parameter: `query` (String), `limit` (optional, Default: 5).
2. **`tdai_skill_search`**:
   * Durchsucht hinterlegte SOPs, Workflows und Best Practices.
   * Parameter: `query` (String), `limit` (optional, Default: 5).
3. **`tdai_wiki_search`**:
   * Durchsucht das zentrale Team-Wiki auf Port 8424.
   * Parameter: `query` (String), `wiki_id` (optional), `limit` (optional, Default: 5).
4. **`tdai_codegraph_search`**:
   * Durchsucht den Code-Graph nach Symbolen, Funktionen und Abhängigkeiten.
   * Parameter: `query` (String), `limit` (optional, Default: 5).

---

## 🔄 4. Neustart & Verifikation

Nach dem Anpassen der Konfiguration den OpenClaw Gateway Dienst neu starten:

```bash
openclaw gateway restart
```

In den Logs erscheint die erfolgreiche Initialisierung:
```text
[openclaw-memory-tencentdb] Loaded plugin (team: team-thpa5ncu0p, agent: agt-..., autoRecall: true, autoCapture: true)
```

---

## 📄 Lizenz

MIT License — Copyright (c) 2026 Biteno GmbH

voice