rol-websocket-channel 1.4.2 → 1.4.9

package/{MQTT-API /346/226/260/345/242/236/346/226/207/344/273/266/345/212/237/350/203/275.md" → MQTT-API 5-6.md }

@@ -85,6 +85,71 @@
 
 ---
 
+### openclawUpdate - 升级 OpenClaw
+
+**说明**
+- 固定执行 `openclaw update`。
+- 用于 App 上的“升级 OpenClaw”按钮。
+- 返回 `stdout` / `stderr`，失败时外层 `ok` 为 `false`。
+
+**请求**
+```json
+{
+  "type": "openclawUpdate",
+  "trace_id": "openclaw-update-001",
+  "data": {}
+}
+```
+
+**成功返回 data.result 示例**
+```json
+{
+  "ok": true,
+  "action": "openclawUpdate",
+  "restartRecommended": true,
+  "command": "openclaw",
+  "args": ["update"],
+  "cwd": "/home/user/.openclaw",
+  "stdout": "",
+  "stderr": ""
+}
+```
+
+---
+
+### pluginSelfUpdate - 升级 rol-websocket-channel 插件
+
+**说明**
+- 固定执行 `openclaw plugins install clawhub:rol-websocket-channel`。
+- 用于 App 上的“升级插件”按钮。
+- 命令执行成功后，新的插件代码通常需要 OpenClaw/插件进程重新加载后才会生效。
+
+**请求**
+```json
+{
+  "type": "pluginSelfUpdate",
+  "trace_id": "plugin-self-update-001",
+  "data": {}
+}
+```
+
+**成功返回 data.result 示例**
+```json
+{
+  "ok": true,
+  "action": "pluginSelfUpdate",
+  "plugin": "clawhub:rol-websocket-channel",
+  "restartRecommended": true,
+  "command": "openclaw",
+  "args": ["plugins", "install", "clawhub:rol-websocket-channel"],
+  "cwd": "/home/user/.openclaw",
+  "stdout": "",
+  "stderr": ""
+}
+```
+
+---
+
 ## 代理管理 (Agents)
 
 ### agentsGet - 获取代理配置
@@ -1077,6 +1142,8 @@
 - `systemStop`
 - `systemDoctorFix`
 - `systemLogs`
+- `openclawUpdate`
+- `pluginSelfUpdate`
 - `ping`
 - `status`
 - `echo`
@@ -1639,6 +1706,12 @@ openclaw admin-bridge pair <key> --endpoint https://api.deotaland.ai
 
 如果文件之前已经上传过，则不会重复上传，而是直接复用已有 `fileUrl`。
 
+### Markdown 文件规则
+
+- 第一次扫描时，已有 `.md` 文件会作为基线记录，不会展示在 artifacts 列表里。
+- 后续新生成的 `.md` 文件会进入 artifacts 列表。
+- `MEMORY.md`、`SoUL.md`、`AGENTS.md`、`HEARTBEAT.md`、`IDENTITY.md`、`TooLS.md`、`USER.md` 等记忆/身份文件永远不会展示。
+
 
 
 
@@ -1658,9 +1731,18 @@ MQTT 请求示例：
 
 典型顺序：
 
-1. `artifactsList`
+1. `artifactsList`    
+
+   {
+     "type": "artifactsList",
+     "trace_id": "artifact-list-before-download-001",
+     "data": {}
+   }
+
 2. 用户选择某个文件
+
 3. `artifactsEnsureUploaded`
+
 4. 使用返回的 `downloadUrl`
 
 
@@ -1709,3 +1791,9 @@ MQTT 请求示例：
 3. 直接使用返回的 `data.downloadUrl`
 4. 如果返回 `uploaded: false`，表示这次没有重新上传，而是复用了历史上传结果
 
+展示建议：
+
+- `category === "image"` 时，可以作为图片预览/展示。
+- `category === "document"` 时，可以作为文档展示或下载。
+- `storageStatus === "local_only"` 时，先调 `artifactsEnsureUploaded` 获取可访问的 `downloadUrl`。
+- `storageStatus === "uploaded"` 且 `fileUrl` 存在时，可以直接使用 `fileUrl` 展示或下载。

package/dist/index.js

@@ -512,6 +512,7 @@ function registerAdminBridgeCli(api) {
     api.registerCli(({ program }) => {
         const root = program
             .command("admin-bridge")
+            .alias("rol-websocket-channel")
             .description("OpenClaw admin bridge utilities")
             .addHelpText("after", () => "\nCommands return JSON to stdout for Python or shell orchestration.\n");
         // 这里可以添加 CLI 命令，但现在先保持简单
@@ -612,6 +613,11 @@ function registerAdminBridgeCli(api) {
                 description: "OpenClaw admin bridge commands",
                 hasSubcommands: true,
             },
+            {
+                name: "rol-websocket-channel",
+                description: "OpenClaw admin bridge commands",
+                hasSubcommands: true,
+            },
         ],
     });
 }

package/dist/message-handler.js

@@ -18,7 +18,7 @@ import { uninstallSkill } from './src/admin/methods/skills-extended.js';
 import { toggleSkill } from './src/admin/methods/skills-toggle.js';
 import { listMemoryFiles, getMemoryFile, backupMemory, exportMemoryZip, getMemoryPresignedPost, createMemoryBackupRecord, importMemoryZip, } from './src/admin/methods/memory.js';
 import { getMem9Config, installMem9, reconnectMem9 } from './src/admin/methods/mem9.js';
-import { restart, stop, doctorFix, logs } from './src/admin/methods/system.js';
+import { doctorFix, logs, openclawUpdate, pluginSelfUpdate, restart, stop } from './src/admin/methods/system.js';
 export class MessageHandler {
     /**
      * 示例方法：处理 ping 类型的消息
@@ -479,6 +479,18 @@ export class MessageHandler {
             return await logs(data, context);
         });
     }
+    async openclawUpdate(data) {
+        return wrapAdminCall(async () => {
+            const context = getContext();
+            return await openclawUpdate(data, context);
+        });
+    }
+    async pluginSelfUpdate(data) {
+        return wrapAdminCall(async () => {
+            const context = getContext();
+            return await pluginSelfUpdate(data, context);
+        });
+    }
     /**
      * 示例方法：处理 status 类型的消息
      */

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

@@ -0,0 +1,62 @@
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+import test from 'node:test';
+import register 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']);
+    assert.deepEqual(manifest.commandAliases, [
+        { name: 'admin-bridge' },
+        { name: 'rol-websocket-channel' }
+    ]);
+});
+test('runtime CLI registrar exposes admin-bridge and rol-websocket-channel command roots', () => {
+    const descriptors = [];
+    const commands = [];
+    const aliases = [];
+    const commandNode = {
+        alias(name) {
+            aliases.push(name);
+            return commandNode;
+        },
+        description() {
+            return commandNode;
+        },
+        addHelpText() {
+            return commandNode;
+        },
+        option() {
+            return commandNode;
+        },
+        action() {
+            return commandNode;
+        },
+        command(name) {
+            commands.push(name);
+            return commandNode;
+        }
+    };
+    const api = {
+        runtime: {},
+        registerChannel() { },
+        registerCli(callback, options) {
+            descriptors.push(...options.descriptors);
+            callback({ program: commandNode });
+        }
+    };
+    register(api);
+    assert.deepEqual(descriptors, [
+        {
+            name: 'admin-bridge',
+            description: 'OpenClaw admin bridge commands',
+            hasSubcommands: true
+        },
+        {
+            name: 'rol-websocket-channel',
+            description: 'OpenClaw admin bridge commands',
+            hasSubcommands: true
+        }
+    ]);
+    assert.equal(commands[0], 'admin-bridge');
+    assert.equal(aliases[0], 'rol-websocket-channel');
+});

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

@@ -7,8 +7,19 @@ import { JsonRpcException, JSON_RPC_ERRORS } from '../jsonrpc.js';
 const INLINE_CONTENT_LIMIT_BYTES = 10 * 1024 * 1024;
 const MIN_ARTIFACT_SIZE_BYTES = 1;
 const ARTIFACT_MANIFEST_FILE = 'artifacts.json';
+const MARKDOWN_SCAN_STATE_FILE = 'md-scan-state.json';
+const PLUGIN_WORKSPACE_STATE_DIR = path.join('.openclaw', 'rol-websocket-channel');
 const IGNORE_EXTENSIONS = new Set(['.tmp', '.part', '.crdownload']);
 const IGNORE_FILE_NAMES = new Set(['.ds_store', 'thumbs.db', ARTIFACT_MANIFEST_FILE]);
+const IGNORE_MARKDOWN_FILE_NAMES = new Set([
+    'agents.md',
+    'heartbeat.md',
+    'identity.md',
+    'memory.md',
+    'soul.md',
+    'tools.md',
+    'user.md'
+]);
 const IGNORE_DIRECTORY_NAMES = new Set([
     '.git',
     '.cache',
@@ -39,6 +50,7 @@ const CATEGORY_BY_EXTENSION = {
     '.pdf': 'document',
     '.doc': 'document',
     '.docx': 'document',
+    '.md': 'document',
     '.zip': 'archive',
     '.7z': 'archive',
     '.tar': 'archive',
@@ -61,6 +73,7 @@ const MIME_BY_EXTENSION = {
     '.pdf': 'application/pdf',
     '.doc': 'application/msword',
     '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    '.md': 'text/markdown',
     '.zip': 'application/zip',
     '.7z': 'application/x-7z-compressed',
     '.tar': 'application/x-tar',
@@ -238,6 +251,9 @@ async function refreshArtifactManifest(context) {
     const { workspaceRoot, manifestPath } = workspacePaths;
     const existing = await readExistingManifest(manifestPath);
     const existingByPath = new Map(existing.map((item) => [item.relativePath, item]));
+    const loadedMarkdownScanState = await readMarkdownScanState(workspacePaths.markdownScanStatePath);
+    const hadMarkdownScanState = loadedMarkdownScanState !== null;
+    const markdownScanState = loadedMarkdownScanState ?? createMarkdownScanState();
     const files = await collectArtifactFiles(workspaceRoot);
     const items = [];
     for (const fullPath of files) {
@@ -248,7 +264,13 @@ async function refreshArtifactManifest(context) {
         const relativePath = path.relative(workspaceRoot, fullPath).replace(/\\/g, '/');
         const existingItem = existingByPath.get(relativePath);
         const fileName = path.basename(fullPath);
-        if (!shouldIncludeArtifactFile(fileName)) {
+        const isMarkdown = isMarkdownArtifactFile(fileName);
+        if (isMarkdown) {
+            if (!shouldIncludeMarkdownArtifactFile(relativePath, fileName, stat, markdownScanState, hadMarkdownScanState)) {
+                continue;
+            }
+        }
+        else if (!shouldIncludeArtifactFile(fileName)) {
             continue;
         }
         const ext = normalizeExtension(fileName);
@@ -275,6 +297,8 @@ async function refreshArtifactManifest(context) {
         });
     }
     items.sort((a, b) => a.fileName.localeCompare(b.fileName));
+    markdownScanState.lastScanAt = new Date().toISOString();
+    await writeMarkdownScanState(workspacePaths.markdownScanStatePath, markdownScanState);
     await writeArtifactManifest(manifestPath, items);
     return { manifestPath, items, workspacePaths };
 }
@@ -306,6 +330,32 @@ async function readExistingManifest(manifestPath) {
 async function writeArtifactManifest(manifestPath, items) {
     await fs.writeFile(manifestPath, JSON.stringify(items.map((item) => artifactToJsonValue(item)), null, 2), 'utf8');
 }
+async function readMarkdownScanState(statePath) {
+    if (!(await pathExists(statePath))) {
+        return null;
+    }
+    const parsed = await readJsonFile(statePath);
+    if (!isObject(parsed)) {
+        return null;
+    }
+    const files = {};
+    if (isObject(parsed.files)) {
+        for (const [relativePath, value] of Object.entries(parsed.files)) {
+            if (isMarkdownScanStateFile(value)) {
+                files[relativePath] = value;
+            }
+        }
+    }
+    return {
+        initializedAt: typeof parsed.initializedAt === 'string' ? parsed.initializedAt : new Date().toISOString(),
+        lastScanAt: typeof parsed.lastScanAt === 'string' ? parsed.lastScanAt : new Date().toISOString(),
+        files
+    };
+}
+async function writeMarkdownScanState(statePath, state) {
+    await ensureDir(path.dirname(statePath));
+    await fs.writeFile(statePath, JSON.stringify(state, null, 2), 'utf8');
+}
 async function persistUploadedArtifact(manifestPath, items, artifactId, updates) {
     const now = new Date().toISOString();
     let updatedArtifact = null;
@@ -393,10 +443,20 @@ function resolveWorkspaceRoot(openclawRoot) {
 async function ensureWorkspacePaths(openclawRoot) {
     const workspaceRoot = resolveWorkspaceRoot(openclawRoot);
     const manifestPath = ensureInside(workspaceRoot, path.join(workspaceRoot, ARTIFACT_MANIFEST_FILE));
+    const markdownScanStatePath = ensureInside(workspaceRoot, path.join(workspaceRoot, PLUGIN_WORKSPACE_STATE_DIR, MARKDOWN_SCAN_STATE_FILE));
     await ensureDir(workspaceRoot);
     return {
         workspaceRoot,
-        manifestPath
+        manifestPath,
+        markdownScanStatePath
+    };
+}
+function createMarkdownScanState() {
+    const now = new Date().toISOString();
+    return {
+        initializedAt: now,
+        lastScanAt: now,
+        files: {}
     };
 }
 function buildArtifactId(relativePath) {
@@ -406,6 +466,9 @@ function normalizeExtension(fileName) {
     const ext = path.extname(fileName).toLowerCase();
     return ext || null;
 }
+function isMarkdownArtifactFile(fileName) {
+    return path.extname(fileName).toLowerCase() === '.md';
+}
 function normalizeRelativePath(value) {
     if (!value) {
         return null;
@@ -437,6 +500,37 @@ function shouldIncludeArtifactFile(fileName) {
     }
     return classifyArtifactCategory(fileName) !== 'other';
 }
+function shouldIncludeMarkdownArtifactFile(relativePath, fileName, stat, state, hadState) {
+    if (shouldIgnoreArtifactFile(fileName)) {
+        return false;
+    }
+    if (IGNORE_MARKDOWN_FILE_NAMES.has(fileName.trim().toLowerCase())) {
+        return false;
+    }
+    const existing = state.files[relativePath];
+    if (existing) {
+        existing.sizeBytes = stat.size;
+        existing.mtimeMs = stat.mtimeMs;
+        return !existing.baseline;
+    }
+    state.files[relativePath] = {
+        sizeBytes: stat.size,
+        mtimeMs: stat.mtimeMs,
+        firstSeenAt: new Date().toISOString(),
+        baseline: !hadState
+    };
+    return hadState;
+}
+function isMarkdownScanStateFile(value) {
+    if (!value || Array.isArray(value) || typeof value !== 'object') {
+        return false;
+    }
+    const objectValue = value;
+    return (typeof objectValue.sizeBytes === 'number' &&
+        typeof objectValue.mtimeMs === 'number' &&
+        typeof objectValue.firstSeenAt === 'string' &&
+        typeof objectValue.baseline === 'boolean');
+}
 function isArtifactRecord(value) {
     if (!value || Array.isArray(value) || typeof value !== 'object') {
         return false;

package/dist/src/admin/methods/artifacts.test.js

@@ -45,6 +45,25 @@ describe('artifacts workspace scope', () => {
         assert.equal(result.workspaceRoot, workspaceRoot);
         assert.equal(result.manifestPath, path.join(workspaceRoot, 'artifacts.json'));
     });
+    test('indexes only markdown files added after the initial baseline', async () => {
+        const context = await createMethodContext();
+        const workspaceRoot = path.join(context.openclawRoot, 'workspace');
+        await fs.mkdir(path.join(workspaceRoot, 'docs'), { recursive: true });
+        await fs.writeFile(path.join(workspaceRoot, 'docs', 'existing.md'), '# existing\n', 'utf8');
+        await fs.writeFile(path.join(workspaceRoot, 'MEMORY.md'), '# memory\n', 'utf8');
+        await fs.writeFile(path.join(workspaceRoot, 'SoUL.md'), '# soul\n', 'utf8');
+        const baseline = await refreshArtifacts({}, context);
+        assert.equal(baseline.count, 0);
+        assert.deepEqual(baseline.items, []);
+        await fs.writeFile(path.join(workspaceRoot, 'docs', 'existing.md'), '# changed\n', 'utf8');
+        await fs.writeFile(path.join(workspaceRoot, 'MEMORY.md'), '# changed memory\n', 'utf8');
+        await fs.writeFile(path.join(workspaceRoot, 'docs', 'generated.md'), '# generated\n', 'utf8');
+        const refreshed = await refreshArtifacts({}, context);
+        assert.equal(refreshed.count, 1);
+        assert.deepEqual(refreshed.items.map((item) => item.relativePath), ['docs/generated.md']);
+        assert.equal(refreshed.items[0]?.category, 'document');
+        assert.equal(refreshed.items[0]?.mimeType, 'text/markdown');
+    });
     test('list reads workspace manifest without taskId', async () => {
         const context = await createMethodContext();
         const workspaceRoot = path.join(context.openclawRoot, 'workspace');

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

@@ -11,7 +11,7 @@ import { listSessions } from './sessions.js';
 import { getSession, prepareMessage, attachSkill } from './sessions-extended.js';
 import { installSkillFromClawHub, installSkillFromNpm, listInstalledSkills, searchClawHubSkills, updateSkillFromClawHub } from './skills.js';
 import { getInstalledSkill, uninstallSkill } from './skills-extended.js';
-import { ping, restart, stop, doctorFix, logs } from './system.js';
+import { doctorFix, logs, openclawUpdate, ping, pluginSelfUpdate, restart, stop } from './system.js';
 import { getUsageBreakdown, getUsagePageSummary, getUsageSummary, getUsageTimeseries } from './usage.js';
 const methods = new Map([
     // System
@@ -20,6 +20,8 @@ const methods = new Map([
     ['system.stop', stop],
     ['system.doctorFix', doctorFix],
     ['system.logs', logs],
+    ['system.openclawUpdate', openclawUpdate],
+    ['system.pluginSelfUpdate', pluginSelfUpdate],
     // Agents
     ['agents.get', getAgents],
     ['agents.list', listAgents],

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

@@ -9,14 +9,28 @@ const MEM9_PLUGIN_ID = 'mem9';
 const MEM9_API_URL = 'https://api.mem9.ai';
 const MEM9_CREATE_URL = `${MEM9_API_URL}/v1alpha1/mem9s`;
 const GATEWAY_SERVICE = 'openclaw-gateway.service';
+const MEM9_PACKAGE_ROOTS = [
+    path.join('npm', 'node_modules', '@mem9', 'mem9'),
+    path.join('npm', 'node_modules', 'mem9')
+];
+const RUNTIME_ENTRYPOINTS = [
+    path.join('dist', 'index.js'),
+    path.join('dist', 'index.mjs'),
+    path.join('dist', 'index.cjs'),
+    'index.js',
+    'index.mjs',
+    'index.cjs'
+];
 export async function installMem9(context) {
     const config = await ensureOpenClawConfigExists(context.openclawRoot);
     await ensureOpenClawCli();
     await ensureNodeRuntime();
     const currentState = readMem9State(config);
-    const installResult = currentState.installed
+    const currentEntrypoint = await findMem9RuntimeEntrypoint(context.openclawRoot);
+    const installResult = currentState.installed && currentEntrypoint
         ? { attempted: false, installed: true }
         : await installMem9Plugin(context.projectRoot);
+    const runtimeEntrypoint = await ensureMem9RuntimeEntrypoint(context.openclawRoot);
     if (currentState.configured && currentState.apiKey) {
         const updated = await ensureMem9SlotConfig(context.openclawRoot, currentState.apiKey);
         const restart = await restartGateway(context.projectRoot);
@@ -28,6 +42,7 @@ export async function installMem9(context) {
             createdNewKey: false,
             reusedExistingKey: true,
             plugin: MEM9_PLUGIN_ID,
+            runtimeEntrypoint,
             apiUrl: MEM9_API_URL,
             apiKey: currentState.apiKey,
             updated,
@@ -45,6 +60,7 @@ export async function installMem9(context) {
         createdNewKey: true,
         reusedExistingKey: false,
         plugin: MEM9_PLUGIN_ID,
+        runtimeEntrypoint,
         apiUrl: MEM9_API_URL,
         apiKey,
         updated,
@@ -58,6 +74,7 @@ export async function reconnectMem9(key, context) {
     }
     const config = await ensureOpenClawConfigExists(context.openclawRoot);
     const previousState = readMem9State(config);
+    const runtimeEntrypoint = await ensureMem9RuntimeEntrypoint(context.openclawRoot);
     const updated = await writeMem9Config(context.openclawRoot, apiKey);
     const restart = await restartGateway(context.projectRoot);
     return {
@@ -65,6 +82,7 @@ export async function reconnectMem9(key, context) {
         reconnected: true,
         replacedExistingKey: Boolean(previousState.apiKey && previousState.apiKey !== apiKey),
         plugin: MEM9_PLUGIN_ID,
+        runtimeEntrypoint,
         apiUrl: MEM9_API_URL,
         apiKey,
         updated: ['plugins.entries.mem9.config.apiKey', ...updated.filter((item) => item !== 'plugins.entries.mem9' && item !== 'plugins.slots.memory')],
@@ -130,6 +148,27 @@ async function installMem9Plugin(cwd) {
         installed: true
     };
 }
+export async function findMem9RuntimeEntrypoint(openclawRoot) {
+    for (const packageRoot of MEM9_PACKAGE_ROOTS.map((item) => path.join(openclawRoot, item))) {
+        for (const entrypoint of RUNTIME_ENTRYPOINTS.map((item) => path.join(packageRoot, item))) {
+            if (await pathExists(entrypoint)) {
+                return entrypoint;
+            }
+        }
+    }
+    return null;
+}
+async function ensureMem9RuntimeEntrypoint(openclawRoot) {
+    const entrypoint = await findMem9RuntimeEntrypoint(openclawRoot);
+    if (entrypoint) {
+        return entrypoint;
+    }
+    throw new JsonRpcException(JSON_RPC_ERRORS.internalError, 'mem9 plugin is installed but missing compiled runtime output required by OpenClaw 2026.5.6', {
+        code: 'MEM9_RUNTIME_OUTPUT_MISSING',
+        expected: RUNTIME_ENTRYPOINTS.map((item) => `./${item.replace(/\\/g, '/')}`),
+        packageRoots: MEM9_PACKAGE_ROOTS.map((item) => path.join(openclawRoot, item))
+    });
+}
 async function createMem9Key() {
     const response = await fetch(MEM9_CREATE_URL, {
         method: 'POST',

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

@@ -0,0 +1,34 @@
+import { describe, test } from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { findMem9RuntimeEntrypoint } from './mem9.js';
+describe('mem9 runtime compatibility', () => {
+    test('accepts compiled runtime output under the installed package', async () => {
+        const root = await fs.mkdtemp(path.join(os.tmpdir(), 'mem9-runtime-'));
+        try {
+            const packageRoot = path.join(root, '.openclaw', 'npm', 'node_modules', '@mem9', 'mem9');
+            await fs.mkdir(path.join(packageRoot, 'dist'), { recursive: true });
+            await fs.writeFile(path.join(packageRoot, 'dist', 'index.js'), 'export default {};\n', 'utf8');
+            const entrypoint = await findMem9RuntimeEntrypoint(path.join(root, '.openclaw'));
+            assert.equal(entrypoint, path.join(packageRoot, 'dist', 'index.js'));
+        }
+        finally {
+            await fs.rm(root, { recursive: true, force: true });
+        }
+    });
+    test('rejects TypeScript-only mem9 packages before writing memory slot', async () => {
+        const root = await fs.mkdtemp(path.join(os.tmpdir(), 'mem9-runtime-'));
+        try {
+            const packageRoot = path.join(root, '.openclaw', 'npm', 'node_modules', '@mem9', 'mem9');
+            await fs.mkdir(packageRoot, { recursive: true });
+            await fs.writeFile(path.join(packageRoot, 'index.ts'), 'export default {};\n', 'utf8');
+            const entrypoint = await findMem9RuntimeEntrypoint(path.join(root, '.openclaw'));
+            assert.equal(entrypoint, null);
+        }
+        finally {
+            await fs.rm(root, { recursive: true, force: true });
+        }
+    });
+});

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

@@ -1,8 +1,12 @@
-import { exec } from 'node:child_process';
+import { exec, execFile } from 'node:child_process';
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { promisify } from 'node:util';
+import { JsonRpcException, JSON_RPC_ERRORS } from '../jsonrpc.js';
 const execAsync = promisify(exec);
+const execFileAsync = promisify(execFile);
+const UPDATE_COMMAND_TIMEOUT_MS = 10 * 60 * 1000;
+const UPDATE_COMMAND_MAX_BUFFER = 10 * 1024 * 1024;
 export const ping = async () => {
     return {
         ok: true,
@@ -67,6 +71,25 @@ export const doctorFix = async (_params, context) => {
         };
     }
 };
+export const openclawUpdate = async (_params, context) => {
+    const result = await runOpenClawCommand(['update'], context, 'openclawUpdate');
+    return {
+        ok: true,
+        action: 'openclawUpdate',
+        restartRecommended: true,
+        ...result
+    };
+};
+export const pluginSelfUpdate = async (_params, context) => {
+    const result = await runOpenClawCommand(['plugins', 'install', 'clawhub:rol-websocket-channel'], context, 'pluginSelfUpdate');
+    return {
+        ok: true,
+        action: 'pluginSelfUpdate',
+        plugin: 'clawhub:rol-websocket-channel',
+        restartRecommended: true,
+        ...result
+    };
+};
 export const logs = async (params, context) => {
     try {
         // 根据实际情况可能需要调整，这里默认尝试 project root 或 user home 下的 .openclaw/logs
@@ -178,3 +201,71 @@ export const logs = async (params, context) => {
         };
     }
 };
+async function runOpenClawCommand(args, context, action) {
+    const command = process.env.OPENCLAW_BIN || 'openclaw';
+    const options = buildOpenClawExecOptions(context.openclawRoot, context.openclawRoot);
+    const openclawBin = process.env.OPENCLAW_BIN || '';
+    const openclawHome = options.env?.OPENCLAW_HOME || '';
+    const home = options.env?.HOME || '';
+    console.log(`[system] exec start: action=${action}, command=${command}, args=${JSON.stringify(args)}, cwd=${options.cwd}, OPENCLAW_BIN=${openclawBin}, OPENCLAW_HOME=${openclawHome}, HOME=${home}`);
+    try {
+        const { stdout, stderr } = await execFileAsync(command, args, {
+            ...options,
+            timeout: UPDATE_COMMAND_TIMEOUT_MS,
+            maxBuffer: UPDATE_COMMAND_MAX_BUFFER
+        });
+        console.log(`[system] exec success: action=${action}, command=${command}, args=${JSON.stringify(args)}, stdoutLength=${stdout.length}, stderrLength=${stderr.length}`);
+        return {
+            command,
+            args,
+            cwd: options.cwd,
+            stdout,
+            stderr
+        };
+    }
+    catch (err) {
+        const stdout = typeof err?.stdout === 'string' ? err.stdout : '';
+        const stderr = typeof err?.stderr === 'string' ? err.stderr : '';
+        console.error(`[system] exec failed: action=${action}, command=${command}, args=${JSON.stringify(args)}, cwd=${options.cwd}, OPENCLAW_BIN=${openclawBin}, OPENCLAW_HOME=${openclawHome}, HOME=${home}, stdout=${JSON.stringify(stdout)}, stderr=${JSON.stringify(stderr)}`);
+        throw new JsonRpcException(JSON_RPC_ERRORS.internalError, `OpenClaw system command failed: ${err instanceof Error ? err.message : String(err)}`, {
+            action,
+            command,
+            args,
+            cwd: options.cwd,
+            stdout,
+            stderr
+        });
+    }
+}
+function buildOpenClawExecOptions(cwd, openclawRoot) {
+    const env = { ...process.env };
+    const openclawHome = resolveOpenClawHomeForCli(openclawRoot);
+    if (openclawHome) {
+        env.OPENCLAW_HOME = openclawHome;
+    }
+    if (openclawRoot && path.basename(path.resolve(openclawRoot)) === '.openclaw') {
+        const home = path.dirname(path.resolve(openclawRoot));
+        env.HOME = home;
+        if (process.platform === 'win32') {
+            env.USERPROFILE = home;
+        }
+    }
+    if (process.platform === 'win32') {
+        return {
+            cwd,
+            shell: true,
+            env
+        };
+    }
+    return { cwd, env };
+}
+function resolveOpenClawHomeForCli(openclawRoot) {
+    if (!openclawRoot) {
+        return process.env.OPENCLAW_HOME;
+    }
+    const resolvedRoot = path.resolve(openclawRoot);
+    if (path.basename(resolvedRoot) === '.openclaw') {
+        return path.dirname(resolvedRoot);
+    }
+    return process.env.OPENCLAW_HOME;
+}