@memtensor/memos-local-openclaw-plugin 0.1.1 → 0.1.2

package/README.md

@@ -26,6 +26,8 @@ openclaw plugins install @memtensor/memos-local-openclaw-plugin
 
 The plugin is installed under `~/.openclaw/extensions/` and registered as `memos-local`. No clone or build required.
 
+> **Important:** Installing the plugin does **not** start the Memory Viewer. The viewer HTTP service is started only when the **OpenClaw gateway** is running. After install, you must **configure** `openclaw.json` (step 2) and **start or restart the gateway** (step 3); then the viewer will be available at `http://127.0.0.1:18799`.
+
 **From source (development):**
 
 ```bash
@@ -103,14 +105,18 @@ Use `${ENV_VAR}` placeholders in config to avoid hardcoding keys:
 }
 ```
 
-### 3. Restart Gateway
+### 3. Start or Restart the Gateway
+
+The Memory Viewer and all plugin features only run when the OpenClaw gateway is running. After installing and configuring the plugin, start (or restart) the gateway:
 
 ```bash
-openclaw gateway stop
-openclaw gateway install
+openclaw gateway stop    # if already running
+openclaw gateway install # ensure LaunchAgent is installed (macOS)
 openclaw gateway start
 ```
 
+Once the gateway is up, the plugin loads and starts the Memory Viewer at `http://127.0.0.1:18799`.
+
 ### 4. Verify Installation
 
 ```bash
@@ -187,6 +193,13 @@ The agent uses these automatically via the SKILL.md prompt guide.
 
 Open `http://127.0.0.1:18799` in your browser:
 
+**Viewer won't open or page not loading?**
+
+- The viewer is started by the plugin when the **gateway** starts. It does **not** run at install time.
+- Ensure the gateway is running: `openclaw gateway start` (or restart with `openclaw gateway stop` then `openclaw gateway start`).
+- Ensure the plugin is enabled in `~/.openclaw/openclaw.json`: `plugins.slots.memory` = `"memos-local"` and `plugins.entries.memos-local.enabled` = `true`.
+- Check the gateway log: `tail -30 ~/.openclaw/logs/gateway.log` — you should see `MemOS Memory Viewer` and `→ http://127.0.0.1:18799`. If the viewer fails to bind (e.g. port in use), the log will show a warning.
+
 - First visit: set a password (min 4 chars)
 - Browse, search, create, edit, delete memories
 - Filter by role (user/assistant/tool), type, time range (down to seconds)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memtensor/memos-local-openclaw-plugin",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "MemOS Local memory plugin for OpenClaw — full-write, hybrid-recall, progressive retrieval",
   "type": "module",
   "main": "index.ts",

package/www/index.html

@@ -396,7 +396,7 @@ body.lang-zh .lang-en{display:none !important}
   <div class="code-section" id="quickstart">
     <div class="code-text">
       <h3><span class="lang-zh">从 npm 安装并配置</span><span class="lang-en">Install from npm &amp; Configure</span></h3>
-      <p><span class="lang-zh">从 npm 安装，无需克隆或构建。在 openclaw.json 中加上插件配置（embedding/summarizer 可选），然后启动 gateway。</span><span class="lang-en">Install from npm — no clone or build. Add OpenClaw config (embedding/summarizer optional), then start the gateway.</span></p>
+      <p><span class="lang-zh">从 npm 安装，无需克隆或构建。在 openclaw.json 中加上插件配置（embedding/summarizer 可选），然后<strong>启动或重启 gateway</strong>。Memory Viewer 只有在网关运行时才会在 http://127.0.0.1:18799 提供。</span><span class="lang-en">Install from npm — no clone or build. Add OpenClaw config (embedding/summarizer optional), then <strong>start or restart the gateway</strong>. The Memory Viewer is only available at http://127.0.0.1:18799 when the gateway is running.</span></p>
       <div>
         <span class="tag t-blue">npm</span>
         <span class="tag t-violet">OpenClaw</span>