From 135041e8b05e61a0980461b689d04fadd1425ff3 Mon Sep 17 00:00:00 2001
From: root <root@minecraft-server>
Date: Thu, 23 Apr 2026 21:34:34 +0800
Subject: [PATCH] fix: update plugin entry to OpenClaw SDK format and improve
 installation docs

- Change plugin-entry.ts export to SDK-compliant object format
- Add explicit id, name, description fields
- Use register(api) method for tool registration
- Update README with correct installation steps
- Document plugin enable and gateway restart commands
---
 README.md              | 54 +++++++++++++++++++++++++++---------------
 ts/package-lock.json   |  4 ++--
 ts/src/plugin-entry.ts | 31 ++++++++++++++----------
 3 files changed, 55 insertions(+), 34 deletions(-)

diff --git a/README.md b/README.md
index 9716871..21fe105 100644
--- a/README.md
+++ b/README.md
@@ -46,23 +46,33 @@ cp -r skills/graph-memory-task ~/.openclaw/skills/graph-memory-task
 
 ### 步骤 4：安装 Plugin（让 OpenClaw 运行时加载 Tool）
 
-将 `ts/` 目录作为 OpenClaw 插件加载。在 `openclaw.json` 中添加：
-
-```json5
-{
-  "plugins": {
-    "allow": ["@trulymem/openclaw-graph-memory"]
-  }
-}
-```
-
-或者直接将编译后的 `ts/dist/` 目录链接到 OpenClaw 的插件目录：
+将编译后的 `ts/` 目录复制到 OpenClaw 的全局扩展目录：
 
 ```bash
-# 将插件目录软链接到 OpenClaw 插件路径
-ln -s <本项目的ts/dist目录> ~/.openclaw/plugins/graph-memory
+# 复制到 OpenClaw extensions 目录
+mkdir -p ~/.openclaw/extensions
+cp -r ts ~/.openclaw/extensions/graph-memory
 ```
 
+然后启用插件：
+
+```bash
+# 启用插件
+openclaw plugins enable graph-memory
+
+# 重启 Gateway（如果使用 systemd 托管）
+systemctl --user restart openclaw-gateway
+```
+
+验证插件已加载：
+
+```bash
+openclaw plugins list
+# 应显示 graph-memory 为 loaded 状态
+```
+
+**注意**：插件启用时会自动切换 `memory` 独占插槽到 `graph-memory`，禁用其他内存插件（如 `memory-core`）。
+
 ### 步骤 5：验证安装
 
 启动 OpenClaw 后，发送以下消息测试：
@@ -178,16 +188,22 @@ skills/                              # 独立 Skill 定义
 
 ### 作为 Plugin
 
-```typescript
-import registerGraphMemoryPlugin from './dist/plugin-entry.js';
+插件入口导出符合 OpenClaw SDK 规范的对象：
 
-registerGraphMemoryPlugin({
-  registerTool(tool) {
-    // OpenClaw 会自动注册工具
+```typescript
+// plugin-entry.ts 导出格式
+export default {
+  id: 'graph-memory',
+  name: 'Graph Memory',
+  description: '让 AI 拥有真正的长期记忆能力',
+  register(api) {
+    api.registerTool(tool);
   }
-});
+};
 ```
 
+OpenClaw 加载后会自动调用 `register(api)` 注册工具。
+
 ### 作为独立模块
 
 ```typescript
diff --git a/ts/package-lock.json b/ts/package-lock.json
index a1905f6..78e4c18 100644
--- a/ts/package-lock.json
+++ b/ts/package-lock.json
@@ -1,11 +1,11 @@
 {
-  "name": "trulymem-waterflow",
+  "name": "@trulymem/openclaw-graph-memory",
   "version": "1.0.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
-      "name": "trulymem-waterflow",
+      "name": "@trulymem/openclaw-graph-memory",
       "version": "1.0.0",
       "dependencies": {
         "@sinclair/typebox": "^0.34.49",
diff --git a/ts/src/plugin-entry.ts b/ts/src/plugin-entry.ts
index d381f42..2402390 100644
--- a/ts/src/plugin-entry.ts
+++ b/ts/src/plugin-entry.ts
@@ -1,15 +1,20 @@
 import { GraphMemoryToolSchema, createGraphMemoryTool } from './runtime/core/tools/builtin/graph_memory_tool.js';
 
-export default function registerGraphMemoryPlugin(api: {
-  registerTool: (tool: {
-    name: string;
-    description: string;
-    parameters: typeof GraphMemoryToolSchema;
-    execute: (id: string, params: Record<string, unknown>) => Promise<{
-      content: Array<{ type: 'text'; text: string }>;
-    }>;
-  }) => void;
-}): void {
-  const tool = createGraphMemoryTool();
-  api.registerTool(tool);
-}
\ No newline at end of file
+export default {
+  id: 'graph-memory',
+  name: 'Graph Memory',
+  description: '让 AI 拥有真正的长期记忆能力 - 基于图数据库的记忆系统',
+  register(api: {
+    registerTool: (tool: {
+      name: string;
+      description: string;
+      parameters: typeof GraphMemoryToolSchema;
+      execute: (id: string, params: Record<string, unknown>) => Promise<{
+        content: Array<{ type: 'text'; text: string }>;
+      }>;
+    }) => void;
+  }): void {
+    const tool = createGraphMemoryTool();
+    api.registerTool(tool);
+  }
+};
\ No newline at end of file