architecture

OpenClaw Plugin Entry Point for TencentDB Agent Memory: Location and Architecture

August 28, 2026 TencentCloud/TencentDB-Agent-Memory ↗

The OpenClaw plugin entry point for TencentDB Agent Memory is located at MemoryCore/openclaw-plugin/index.ts, which serves as the main module loaded by the OpenClaw runtime to initialize the memory client, register capture/recall hooks, and expose memory management tools.

The TencentCloud/TencentDB-Agent-Memory repository provides a persistent memory layer for AI agents, and its OpenClaw integration allows seamless memory access via a dedicated plugin entry point. Understanding the exact file locations and initialization sequence is essential for developers extending, debugging, or manually installing the memory plugin.

Where to Find the OpenClaw Plugin Entry Point

Main Entry Point: MemoryCore/openclaw-plugin/index.ts

This TypeScript file is the primary module that OpenClaw executes when loading the plugin. It instantiates the MemoryClient from the @tencentdb-agent-memory/memory-sdk-ts-v2 SDK and wires the capture/recall lifecycle hooks that enable automatic memory persistence and retrieval.

Plugin Manifest: MemoryCore/openclaw-plugin/openclaw.plugin.json

Located in the same directory, this JSON manifest declares the plugin ID (memory-tencentdb-client), specifies the entry point path, and defines default configuration parameters. OpenClaw reads this manifest to determine how to bootstrap the plugin and what default settings to write to ~/.openclaw/openclaw.json during installation.

Installation Script: MemoryCore/scripts/install-openclaw-plugin.sh

This shell script automates the build and registration process. It executes npm install, compiles the TypeScript sources, and runs openclaw plugins install -l . to register the plugin with the local OpenClaw CLI, ensuring the entry point is properly linked to the runtime.

Architectural Flow: How the Plugin Integrates with OpenClaw

The integration follows a four-stage initialization sequence defined in the source code:

  1. Plugin Loading: OpenClaw reads the manifest at [openclaw.plugin.json](https://github.com/TencentCloud/TencentDB-Agent-Memory/blob/feat/server_team/MemoryCore/openclaw-plugin/openclaw.plugin.json) and executes [index.ts](https://github.com/TencentCloud/TencentDB-Agent-Memory/blob/feat/server_team/MemoryCore/openclaw-plugin/index.ts).

  2. Client Initialization: The script creates a MemoryClient pointing to the MemoryCore gateway at http://127.0.0.1:8420 by default.

  3. Hook Registration: The plugin registers two critical hooks:

  4. Tool Exposure: Three built-in tools become available to the LLM:

Key Source Files and Implementation Details

The complete plugin architecture is distributed across the following modules:

Configuration and Usage Examples

To install the plugin using the automated script:

cd MemoryCore
bash scripts/install-openclaw-plugin.sh

This script compiles the TypeScript sources and registers the plugin with your local OpenClaw installation.

For manual configuration without the script, add the following configuration object to your ~/.openclaw/openclaw.json:

{
  "plugins": {
    "slots": { "memory": "memory-tencentdb-client" },
    "entries": {
      "memory-tencentdb-client": {
        "enabled": true,
        "hooks": {
          "allowPromptInjection": true,
          "allowConversationAccess": true
        },
        "config": {
          "server": {
            "url": "http://127.0.0.1:8420",
            "apiKey": "local",
            "instanceId": "default",
            "teamId": "default",
            "agentId": "default",
            "userId": "default"
          }
        }
      }
    }
  }
}

When interacting with the LLM, invoke memory tools using the following JSON structure:

{
  "type": "toolCall",
  "id": "tool-01",
  "name": "tdai_memory_search",
  "arguments": {
    "query": "project status update",
    "limit": 3,
    "type": "episodic"
  }
}

Summary

Frequently Asked Questions

What is the exact file path for the OpenClaw plugin entry point in TencentDB Agent Memory?

The entry point is located at [MemoryCore/openclaw-plugin/index.ts](https://github.com/TencentCloud/TencentDB-Agent-Memory/blob/feat/server_team/MemoryCore/openclaw-plugin/index.ts) in the TencentCloud/TencentDB-Agent-Memory repository. This file exports the plugin initialization logic that OpenClaw executes when loading the memory-tencentdb-client plugin.

How does the OpenClaw plugin connect to the TencentDB Agent Memory gateway?

The plugin creates a MemoryClient instance from the @tencentdb-agent-memory/memory-sdk-ts-v2 SDK during initialization in index.ts. This client is configured to communicate with the MemoryCore gateway at http://127.0.0.1:8420 by default, handling all subsequent memory operations.

Which hooks does the OpenClaw plugin register for memory management?

The plugin registers two primary hooks. The capture hook calls addConversation() after each dialogue turn to write to L0 storage, while the recall hook executes searchAtomic() and readCore() before prompt generation to inject relevant historical context into the conversation.

Can I install the OpenClaw plugin without using the provided shell script?

Yes, you can manually install the plugin by running npm install and npm run build in the MemoryCore/openclaw-plugin directory, then executing openclaw plugins install -l . to register it locally. You must also manually add the plugin configuration to your ~/.openclaw/openclaw.json file following the schema shown in the configuration example.

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"
Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →