Voice
Memory Tencentdb
By Remote TencentDB Agent Memory Plugin for OpenClaw — bidirectional prefetch recall & asynchronous turn sync for central TencentDB clusters
Install
npm install
npmConfiguration 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)
[](https://github.com/openclaw/openclaw)
[](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
Comments
Sign in to leave a comment