rol-websocket-channel 1.5.1 → 1.5.3

package/{MQTT-API 5-6.md → MQTT-API System.md }

@@ -1,4 +1,4 @@
-# OpenClaw MQTT API 文档 （新增文件功能）
+# OpenClaw MQTT API 文档 （System 更新接口）
 
 ## 消息格式
 
@@ -1797,3 +1797,114 @@ MQTT 请求示例：
 - `category === "document"` 时，可以作为文档展示或下载。
 - `storageStatus === "local_only"` 时，先调 `artifactsEnsureUploaded` 获取可访问的 `downloadUrl`。
 - `storageStatus === "uploaded"` 且 `fileUrl` 存在时，可以直接使用 `fileUrl` 展示或下载。
+
+---
+
+## System 更新接口
+
+这两个接口用于 App 按钮触发本机 OpenClaw 或当前插件更新。请求通过 MQTT 发送到当前已配对设备，插件会在本机执行对应的 `openclaw` 命令。
+
+### openclawUpdate
+
+作用：升级本机 OpenClaw。
+
+实际执行命令：
+
+```bash
+openclaw update
+```
+
+MQTT 请求示例：
+
+```json
+{
+  "type": "openclawUpdate",
+  "trace_id": "openclaw-update-001",
+  "data": {}
+}
+```
+
+成功返回示例：
+
+```json
+{
+  "type": "receiver",
+  "trace_id": "openclaw-update-001",
+  "source": "system",
+  "success": true,
+  "data": {
+    "ok": true,
+    "action": "openclawUpdate",
+    "restartRecommended": true,
+    "command": "openclaw",
+    "args": ["update"],
+    "cwd": "/home/woowonjae/.openclaw",
+    "stdout": "...",
+    "stderr": ""
+  }
+}
+```
+
+### pluginSelfUpdate
+
+作用：升级当前 `rol-websocket-channel` 插件。
+
+实际执行命令：
+
+```bash
+openclaw plugins update rol-websocket-channel
+```
+
+MQTT 请求示例：
+
+```json
+{
+  "type": "pluginSelfUpdate",
+  "trace_id": "plugin-self-update-001",
+  "data": {}
+}
+```
+
+成功返回示例：
+
+```json
+{
+  "type": "receiver",
+  "trace_id": "plugin-self-update-001",
+  "source": "system",
+  "success": true,
+  "data": {
+    "ok": true,
+    "action": "pluginSelfUpdate",
+    "plugin": "rol-websocket-channel",
+    "restartRecommended": true,
+    "command": "openclaw",
+    "args": ["plugins", "update", "rol-websocket-channel"],
+    "cwd": "/home/woowonjae/.openclaw",
+    "stdout": "...",
+    "stderr": ""
+  }
+}
+```
+
+### 失败返回
+
+如果本机命令执行失败，`success` 会是 `false`，错误信息里会带上实际执行的命令、参数、工作目录、`stdout` 和 `stderr`，前端可以直接展示 `error.message` 或 `error.stderr`。
+
+```json
+{
+  "type": "receiver",
+  "trace_id": "plugin-self-update-001",
+  "source": "system",
+  "success": false,
+  "error": {
+    "message": "OpenClaw system command failed: Command failed: openclaw plugins update rol-websocket-channel",
+    "action": "pluginSelfUpdate",
+    "command": "openclaw",
+    "args": ["plugins", "update", "rol-websocket-channel"],
+    "cwd": "/home/woowonjae/.openclaw",
+    "stdout": "...",
+    "stderr": "..."
+  }
+}
+```

package/dist/index.js

@@ -12,6 +12,21 @@ let pluginRuntime = null;
 export function getPluginRuntime() {
     return pluginRuntime;
 }
+export function formatCliErrorPayload(error) {
+    const data = error?.data;
+    const dataObject = data && typeof data === "object" && !Array.isArray(data)
+        ? data
+        : {};
+    const code = dataObject.code ?? error?.code;
+    return {
+        ok: false,
+        error: {
+            message: error instanceof Error ? error.message : String(error),
+            ...dataObject,
+            ...(code === undefined ? {} : { code }),
+        },
+    };
+}
 // ============================================
 // 4. 插件主体定义
 // ============================================
@@ -554,13 +569,7 @@ function registerAdminBridgeCli(api) {
             }
             catch (error) {
                 process.exitCode = 1;
-                process.stderr.write(JSON.stringify({
-                    ok: false,
-                    error: {
-                        message: error instanceof Error ? error.message : String(error),
-                        code: error?.data?.code,
-                    },
-                }, null, 2) + "\n");
+                process.stderr.write(JSON.stringify(formatCliErrorPayload(error), null, 2) + "\n");
             }
         });
         const mem9 = root

package/dist/src/admin/cli-manifest.test.js

@@ -1,7 +1,7 @@
 import assert from 'node:assert/strict';
 import { readFileSync } from 'node:fs';
 import test from 'node:test';
-import register from '../../index.js';
+import register, { formatCliErrorPayload } from '../../index.js';
 const manifest = JSON.parse(readFileSync(new URL('../../openclaw.plugin.json', import.meta.url), 'utf8'));
 test('manifest declares OpenClaw 2026 command ownership for admin bridge CLI', () => {
     assert.deepEqual(manifest.activation?.onCommands, ['admin-bridge', 'rol-websocket-channel']);
@@ -60,3 +60,26 @@ test('runtime CLI registrar exposes admin-bridge and rol-websocket-channel comma
     assert.equal(commands[0], 'admin-bridge');
     assert.equal(aliases[0], 'rol-websocket-channel');
 });
+test('CLI error formatter preserves diagnostic data for pairing failures', () => {
+    const error = new Error('mqttUrl is missing from pairing payload');
+    error.data = {
+        code: 'PAIR_CHANNEL_CONFIG_INVALID',
+        debug: {
+            rootKeys: ['channel'],
+            channelConfigKeys: ['mqtt_topic'],
+            hasExistingMqttUrl: false
+        }
+    };
+    assert.deepEqual(formatCliErrorPayload(error), {
+        ok: false,
+        error: {
+            message: 'mqttUrl is missing from pairing payload',
+            code: 'PAIR_CHANNEL_CONFIG_INVALID',
+            debug: {
+                rootKeys: ['channel'],
+                channelConfigKeys: ['mqtt_topic'],
+                hasExistingMqttUrl: false
+            }
+        }
+    });
+});

package/dist/src/admin/methods/mem9.js

@@ -211,6 +211,10 @@ async function writeMem9Config(openclawRoot, apiKey) {
     config.plugins.entries[MEM9_PLUGIN_ID] = {
         ...existingEntry,
         enabled: true,
+        hooks: {
+            ...(isRecord(existingEntry.hooks) ? existingEntry.hooks : {}),
+            allowConversationAccess: true
+        },
         config: {
             ...existingPluginConfig,
             apiUrl: MEM9_API_URL,
@@ -221,6 +225,7 @@ async function writeMem9Config(openclawRoot, apiKey) {
     await writeJsonFile(configPath, config);
     return [
         hadExistingKey ? 'plugins.entries.mem9.config.apiKey (replaced)' : 'plugins.entries.mem9',
+        'plugins.entries.mem9.hooks.allowConversationAccess',
         'plugins.slots.memory'
     ];
 }
@@ -240,6 +245,10 @@ async function ensureMem9SlotConfig(openclawRoot, apiKey) {
     config.plugins.entries[MEM9_PLUGIN_ID] = {
         ...existingEntry,
         enabled: true,
+        hooks: {
+            ...(isRecord(existingEntry.hooks) ? existingEntry.hooks : {}),
+            allowConversationAccess: true
+        },
         config: {
             ...existingPluginConfig,
             apiUrl: MEM9_API_URL,
@@ -250,6 +259,7 @@ async function ensureMem9SlotConfig(openclawRoot, apiKey) {
     await writeJsonFile(configPath, config);
     return [
         'plugins.entries.mem9',
+        'plugins.entries.mem9.hooks.allowConversationAccess',
         'plugins.slots.memory'
     ];
 }

package/dist/src/admin/methods/system.js

@@ -81,11 +81,11 @@ export const openclawUpdate = async (_params, context) => {
     };
 };
 export const pluginSelfUpdate = async (_params, context) => {
-    const result = await runOpenClawCommand(['plugins', 'install', 'clawhub:rol-websocket-channel'], context, 'pluginSelfUpdate');
+    const result = await runOpenClawCommand(['plugins', 'update', 'rol-websocket-channel'], context, 'pluginSelfUpdate');
     return {
         ok: true,
         action: 'pluginSelfUpdate',
-        plugin: 'clawhub:rol-websocket-channel',
+        plugin: 'rol-websocket-channel',
         restartRecommended: true,
         ...result
     };

package/index.ts

@@ -38,6 +38,28 @@ export function getPluginRuntime(): any {
   return pluginRuntime;
 }
 
+export function formatCliErrorPayload(error: unknown): {
+  ok: false;
+  error: Record<string, unknown>;
+} {
+  const data = (error as { data?: unknown } | null | undefined)?.data;
+  const dataObject =
+    data && typeof data === "object" && !Array.isArray(data)
+      ? (data as Record<string, unknown>)
+      : {};
+  const code =
+    dataObject.code ?? (error as { code?: unknown } | null | undefined)?.code;
+
+  return {
+    ok: false,
+    error: {
+      message: error instanceof Error ? error.message : String(error),
+      ...dataObject,
+      ...(code === undefined ? {} : { code }),
+    },
+  };
+}
+
 // ============================================
 // 4. 插件主体定义
 // ============================================
@@ -725,18 +747,7 @@ function registerAdminBridgeCli(api: any) {
             } catch (error) {
               process.exitCode = 1;
               process.stderr.write(
-                JSON.stringify(
-                  {
-                    ok: false,
-                    error: {
-                      message:
-                        error instanceof Error ? error.message : String(error),
-                      code: (error as any)?.data?.code,
-                    },
-                  },
-                  null,
-                  2,
-                ) + "\n",
+                JSON.stringify(formatCliErrorPayload(error), null, 2) + "\n",
               );
             }
           },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rol-websocket-channel",
-  "version": "1.5.1",
+  "version": "1.5.3",
   "description": "Unified OpenClaw plugin: MQTT Channel + Admin Bridge for remote management",
   "license": "MIT",
   "author": "nixgnehc",

package/src/admin/cli-manifest.test.ts

@@ -1,7 +1,7 @@
 import assert from 'node:assert/strict';
 import { readFileSync } from 'node:fs';
 import test from 'node:test';
-import register from '../../index.js';
+import register, { formatCliErrorPayload } from '../../index.js';
 
 const manifest = JSON.parse(readFileSync(new URL('../../openclaw.plugin.json', import.meta.url), 'utf8'));
 
@@ -65,3 +65,30 @@ test('runtime CLI registrar exposes admin-bridge and rol-websocket-channel comma
   assert.equal(commands[0], 'admin-bridge');
   assert.equal(aliases[0], 'rol-websocket-channel');
 });
+
+test('CLI error formatter preserves diagnostic data for pairing failures', () => {
+  const error = new Error('mqttUrl is missing from pairing payload') as Error & {
+    data: Record<string, unknown>;
+  };
+  error.data = {
+    code: 'PAIR_CHANNEL_CONFIG_INVALID',
+    debug: {
+      rootKeys: ['channel'],
+      channelConfigKeys: ['mqtt_topic'],
+      hasExistingMqttUrl: false
+    }
+  };
+
+  assert.deepEqual(formatCliErrorPayload(error), {
+    ok: false,
+    error: {
+      message: 'mqttUrl is missing from pairing payload',
+      code: 'PAIR_CHANNEL_CONFIG_INVALID',
+      debug: {
+        rootKeys: ['channel'],
+        channelConfigKeys: ['mqtt_topic'],
+        hasExistingMqttUrl: false
+      }
+    }
+  });
+});

package/src/admin/methods/mem9.ts

@@ -270,6 +270,10 @@ async function writeMem9Config(openclawRoot: string, apiKey: string): Promise<st
   config.plugins.entries[MEM9_PLUGIN_ID] = {
     ...existingEntry,
     enabled: true,
+    hooks: {
+      ...(isRecord(existingEntry.hooks) ? existingEntry.hooks : {}),
+      allowConversationAccess: true
+    },
     config: {
       ...existingPluginConfig,
       apiUrl: MEM9_API_URL,
@@ -282,6 +286,7 @@ async function writeMem9Config(openclawRoot: string, apiKey: string): Promise<st
 
   return [
     hadExistingKey ? 'plugins.entries.mem9.config.apiKey (replaced)' : 'plugins.entries.mem9',
+    'plugins.entries.mem9.hooks.allowConversationAccess',
     'plugins.slots.memory'
   ];
 }
@@ -304,6 +309,10 @@ async function ensureMem9SlotConfig(openclawRoot: string, apiKey: string): Promi
   config.plugins.entries[MEM9_PLUGIN_ID] = {
     ...existingEntry,
     enabled: true,
+    hooks: {
+      ...(isRecord(existingEntry.hooks) ? existingEntry.hooks : {}),
+      allowConversationAccess: true
+    },
     config: {
       ...existingPluginConfig,
       apiUrl: MEM9_API_URL,
@@ -316,6 +325,7 @@ async function ensureMem9SlotConfig(openclawRoot: string, apiKey: string): Promi
 
   return [
     'plugins.entries.mem9',
+    'plugins.entries.mem9.hooks.allowConversationAccess',
     'plugins.slots.memory'
   ];
 }

package/src/admin/methods/system.ts

@@ -91,7 +91,7 @@ export const openclawUpdate: MethodHandler = async (_params, context: MethodCont
 
 export const pluginSelfUpdate: MethodHandler = async (_params, context: MethodContext): Promise<JsonValue> => {
   const result = await runOpenClawCommand(
-    ['plugins', 'install', 'clawhub:rol-websocket-channel'],
+    ['plugins', 'update', 'rol-websocket-channel'],
     context,
     'pluginSelfUpdate'
   );
@@ -99,7 +99,7 @@ export const pluginSelfUpdate: MethodHandler = async (_params, context: MethodCo
   return {
     ok: true,
     action: 'pluginSelfUpdate',
-    plugin: 'clawhub:rol-websocket-channel',
+    plugin: 'rol-websocket-channel',
     restartRecommended: true,
     ...result
   };