@okclaw-build/cli 1.0.0-beta.4 → 1.0.0-beta.41

package/dist/commands/service.js

@@ -1,23 +1,76 @@
 import { shell, shellCapture } from '../utils/shell.js';
 import { info, success } from '../utils/logger.js';
-import { OPENVIKING_ENV } from '../utils/constants.js';
+import { NdjsonEmitter, registerExitHandlers } from '../output/ndjson.js';
+import { isNdjson } from '../output/mode.js';
+async function runSimpleOp(op, step, humanVerb, action) {
+    const emitter = new NdjsonEmitter(op);
+    registerExitHandlers(emitter);
+    emitter.start(`${humanVerb} gateway`);
+    info(`${humanVerb} openclaw gateway...`);
+    try {
+        emitter.stepStart(step, `${humanVerb} gateway`);
+        await action();
+        emitter.stepDone(step, 'done');
+        success(`Gateway ${step}ed.`);
+        emitter.end(true, 0);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        emitter.end(false, 1, `E_${op.toUpperCase()}_FAILED`, { error: msg });
+        throw e;
+    }
+}
+// openclaw 是 supervisor：fork 出 openclaw-gateway 后自己 epoll_wait 不退。
+// 直接 `nohup ... &` 会让外层 bash 在脚本末尾仍停在 wait4(-1) 上死等 supervisor，
+// Node 的 child.on('close') 因此永远不触发。用 `( nohup ... & )` 子 shell 双 fork：
+// 内层子 shell 背景化 supervisor 后立即退出，supervisor 被 init 收养，外层 bash
+// 没有子进程可等，直接 exit。
+const START_GATEWAY = "mkdir -p /root/.openclaw && ( nohup openclaw gateway </dev/null >/root/.openclaw/gateway.out 2>&1 & ) && sleep 3 && ps -C openclaw-gateway -o pid= >/dev/null";
+// `pkill -f openclaw-gateway` 会按 cmdline substring 命中,误杀任何 cmdline 含此
+// 字符串的进程(实测:bootstrap script 里跑 restart 时,其 bash -c 命令行也含
+// 'openclaw-gateway',被自杀,导致 restart 命令 exit null/1)。
+// `pkill -x openclaw-gateway` 用 comm 字段精确匹配,但 Linux comm 只 15 字符,
+// 而 'openclaw-gateway' 16 字符,直接报错。
+// 唯一稳的办法:`ps -C openclaw-gateway`(by command name,支持超 15 字符) →
+// xargs kill,只杀真的 gateway 进程,不命中 cmdline substring。
+const STOP_GATEWAY = "ps -C openclaw-gateway -o pid= 2>/dev/null | xargs -r kill 2>/dev/null || true";
 export async function startCommand() {
-    info('Starting openclaw gateway...');
-    await shell(`source ${OPENVIKING_ENV} 2>/dev/null || true; openclaw gateway start`);
-    success('Gateway started.');
+    await runSimpleOp('start', 'start', 'Starting', async () => {
+        await shell(START_GATEWAY);
+    });
 }
 export async function stopCommand() {
-    info('Stopping openclaw gateway...');
-    await shell('openclaw gateway stop 2>/dev/null || true');
-    success('Gateway stopped.');
+    await runSimpleOp('stop', 'stop', 'Stopping', async () => {
+        await shell(STOP_GATEWAY);
+    });
 }
 export async function restartCommand() {
-    info('Restarting openclaw gateway...');
-    await shell(`source ${OPENVIKING_ENV} 2>/dev/null || true; openclaw gateway restart`);
-    success('Gateway restarted.');
+    await runSimpleOp('restart', 'restart', 'Restarting', async () => {
+        await shell(`${STOP_GATEWAY}; sleep 1; ${START_GATEWAY}`);
+    });
 }
 export async function statusCommand() {
-    const result = await shellCapture('openclaw gateway status 2>&1 || true');
-    console.log(result.stdout || result.stderr || 'No output');
+    const emitter = new NdjsonEmitter('status');
+    registerExitHandlers(emitter);
+    emitter.start('querying gateway status');
+    emitter.stepStart('status', 'checking openclaw gateway process');
+    try {
+        // ps -C(by command name): 支持超 15 字符 comm,且不会误命中 cmdline 含
+        // 'openclaw-gateway' 字符串的其它进程(对照 STOP_GATEWAY 的注释)
+        const result = await shellCapture("ps -C openclaw-gateway -o pid,etime,cmd 2>&1 || true");
+        const output = result.stdout || result.stderr || 'No gateway process found';
+        if (!isNdjson()) {
+            console.log(output);
+        }
+        // ps -C 没命中时输出只有 header,没有 PID 行;命中时 stdout 含 'openclaw-gateway'
+        const running = /openclaw-gateway/.test(result.stdout);
+        emitter.stepDone('status', 'status query done');
+        emitter.end(running, running ? 0 : 1, running ? undefined : 'E_STATUS_NOT_RUNNING', { running, rawOutput: output });
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        emitter.end(false, 1, 'E_STATUS_FAILED', { error: msg });
+        throw e;
+    }
 }
 //# sourceMappingURL=service.js.map

package/dist/commands/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/commands/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACrC,MAAM,KAAK,CAAC,UAAU,cAAc,8CAA8C,CAAC,CAAC;IACpF,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACrC,MAAM,KAAK,CAAC,2CAA2C,CAAC,CAAC;IACzD,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IACvC,MAAM,KAAK,CAAC,UAAU,cAAc,gDAAgD,CAAC,CAAC;IACtF,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,sCAAsC,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,WAAW,CAAC,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/commands/service.ts"],"names":[],"mappings":"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"}

package/dist/commands/show.d.ts

@@ -0,0 +1,13 @@
+/**
+ * okclaw show <target...>
+ *
+ * 把 target 对应的文件内容原样输出到 stdout（text 模式）；
+ * 在 ndjson 模式下，文件内容放到 end 事件的 fields.content（plan 决策 #16）。
+ *
+ *   - 文件存在 → 输出文件内容，exit 0
+ *   - 文件不存在 → 输出空内容，exit 0（视为尚未创建）
+ *   - target 非法 → stderr 提示，exit 1
+ *
+ * `targets` 参数用于测试注入；生产调用不传第二个参数，使用 edit.ts 导出的 TARGETS。
+ */
+export declare function showCommand(args: string[], targets?: Record<string, string>): Promise<void>;

package/dist/commands/show.js

@@ -0,0 +1,70 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { error } from '../utils/logger.js';
+import { TARGETS as DEFAULT_TARGETS } from './edit.js';
+import { NdjsonEmitter, registerExitHandlers } from '../output/ndjson.js';
+import { isNdjson } from '../output/mode.js';
+/**
+ * okclaw show <target...>
+ *
+ * 把 target 对应的文件内容原样输出到 stdout（text 模式）；
+ * 在 ndjson 模式下，文件内容放到 end 事件的 fields.content（plan 决策 #16）。
+ *
+ *   - 文件存在 → 输出文件内容，exit 0
+ *   - 文件不存在 → 输出空内容，exit 0（视为尚未创建）
+ *   - target 非法 → stderr 提示，exit 1
+ *
+ * `targets` 参数用于测试注入；生产调用不传第二个参数，使用 edit.ts 导出的 TARGETS。
+ */
+export async function showCommand(args, targets = DEFAULT_TARGETS) {
+    const emitter = new NdjsonEmitter('file_read');
+    registerExitHandlers(emitter);
+    const requestedTargets = args.filter((arg) => !arg.startsWith('--'));
+    if (requestedTargets.length === 0 || requestedTargets.some((target) => !targets[target])) {
+        error(`Usage: okclaw show <${Object.keys(targets).join('|')}>`);
+        emitter.end(false, 1, 'E_USAGE');
+        process.exit(1);
+    }
+    if (!isNdjson() && requestedTargets.length > 1) {
+        error('Multiple targets are only supported with --output=ndjson');
+        emitter.end(false, 1, 'E_USAGE');
+        process.exit(1);
+    }
+    emitter.start(`reading ${requestedTargets.join(',')}`, { targets: requestedTargets });
+    try {
+        const files = [];
+        for (const target of requestedTargets) {
+            const path = targets[target];
+            emitter.stepStart(`read:${target}`, `reading ${path}`, { target, path });
+            const exists = existsSync(path);
+            const content = exists ? readFileSync(path, 'utf8') : '';
+            files.push({ fileKey: target, path, exists, content });
+            emitter.stepDone(`read:${target}`, exists ? 'read ok' : 'file not found, returning empty');
+        }
+        if (!isNdjson()) {
+            const { exists, content } = files[0];
+            if (exists) {
+                process.stdout.write(content);
+            }
+        }
+        // 单文件保持 content 兼容；批量读取用 files 数组承载返回值。
+        if (requestedTargets.length === 1) {
+            const file = files[0];
+            emitter.end(true, 0, undefined, {
+                target: file.fileKey,
+                path: file.path,
+                exists: file.exists,
+                content: file.content,
+            });
+        }
+        else {
+            emitter.end(true, 0, undefined, { files });
+        }
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        error(msg);
+        emitter.end(false, 1, 'E_READ_FAILED', { error: msg });
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=show.js.map

package/dist/commands/show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.js","sourceRoot":"","sources":["../../src/commands/show.ts"],"names":[],"mappings":"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"}

package/dist/commands/skill.d.ts

@@ -0,0 +1 @@
+export declare function skillCommand(args: string[]): Promise<void>;

package/dist/commands/skill.js

@@ -0,0 +1,114 @@
+import { readFileSync } from 'node:fs';
+import { SkillInstaller } from '../installers/skill.js';
+import { configureMirrors } from '../utils/mirror.js';
+import { info, error, success } from '../utils/logger.js';
+import { NdjsonEmitter, registerExitHandlers } from '../output/ndjson.js';
+export async function skillCommand(args) {
+    const subCommand = args[0];
+    const skillName = args[1];
+    if (!subCommand || !['install', 'uninstall'].includes(subCommand)) {
+        const emitter = new NdjsonEmitter('skill_install');
+        registerExitHandlers(emitter);
+        error('Usage: okclaw skill <install|uninstall> <name> [options]');
+        emitter.end(false, 1, 'E_USAGE');
+        process.exit(1);
+    }
+    const op = subCommand === 'install' ? 'skill_install' : 'skill_uninstall';
+    const emitter = new NdjsonEmitter(op);
+    registerExitHandlers(emitter);
+    if (!skillName) {
+        error(`Usage: okclaw skill ${subCommand} <name>${subCommand === 'install' ? ' --version <ver> [--package-url <url>]' : ''}`);
+        emitter.end(false, 1, 'E_USAGE');
+        process.exit(1);
+    }
+    const installer = new SkillInstaller(skillName);
+    if (subCommand === 'uninstall') {
+        emitter.start(`uninstalling skill ${skillName}`, { skillName });
+        info(`Uninstalling skill ${skillName}...`);
+        try {
+            emitter.stepStart('validate', `validating skill name ${skillName}`);
+            // installer 内部校验名称，SkillInstaller.uninstall 会在目标不存在时快速返回
+            emitter.stepDone('validate', 'skill name ok');
+            emitter.stepStart('uninstall', `removing ${skillName}`);
+            await installer.uninstall();
+            emitter.stepDone('uninstall', 'skill removed');
+            success(`Skill ${skillName} uninstalled.`);
+            emitter.end(true, 0, undefined, { skillName });
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            error(msg);
+            emitter.end(false, 1, 'E_SKILL_UNINSTALL_FAILED', { error: msg });
+            process.exit(1);
+        }
+        return;
+    }
+    // install
+    let version = '';
+    let config;
+    let packageUrl;
+    for (let i = 2; i < args.length; i++) {
+        const arg = args[i];
+        if ((arg === '--version' || arg.startsWith('--version=')) && !version) {
+            version = arg.includes('=') ? arg.split('=')[1] : args[++i];
+            continue;
+        }
+        if (arg === '--config' && args[i + 1]) {
+            try {
+                config = JSON.parse(args[++i]);
+            }
+            catch {
+                error('Invalid --config JSON');
+                emitter.end(false, 1, 'E_CONFIG_JSON');
+                process.exit(1);
+            }
+            continue;
+        }
+        if ((arg === '--config-file' || arg.startsWith('--config-file=')) && !config) {
+            const filePath = arg.includes('=') ? arg.split('=')[1] : args[++i];
+            try {
+                config = JSON.parse(readFileSync(filePath, 'utf8'));
+            }
+            catch (e) {
+                error(`Failed to read config file: ${e}`);
+                emitter.end(false, 1, 'E_CONFIG_FILE');
+                process.exit(1);
+            }
+            continue;
+        }
+        if ((arg === '--package-url' || arg.startsWith('--package-url=')) && !packageUrl) {
+            packageUrl = arg.includes('=') ? arg.split('=')[1] : args[++i];
+            continue;
+        }
+    }
+    if (!version) {
+        error('--version is required for install');
+        emitter.end(false, 1, 'E_VERSION_REQUIRED');
+        process.exit(1);
+    }
+    emitter.start(`installing skill ${skillName}@${version}`, { skillName, version });
+    info(`Installing skill ${skillName}@${version}...`);
+    try {
+        emitter.stepStart('validate', 'validating install args');
+        await installer.checkDeps();
+        emitter.stepDone('validate', 'args ok, deps ready');
+        emitter.stepStart('download', `downloading skill ${skillName}@${version}`);
+        await configureMirrors();
+        await installer.install(version, packageUrl);
+        emitter.stepDone('download', 'skill downloaded');
+        emitter.stepStart('install', `applying skill ${skillName}`);
+        if (config) {
+            await installer.configure(config);
+        }
+        emitter.stepDone('install', 'skill installed');
+        success(`Skill ${skillName}@${version} installed.`);
+        emitter.end(true, 0, undefined, { skillName, version });
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        error(msg);
+        emitter.end(false, 1, 'E_SKILL_INSTALL_FAILED', { error: msg });
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=skill.js.map

package/dist/commands/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/commands/skill.ts"],"names":[],"mappings":"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"}

package/dist/commands/uninstall.d.ts

@@ -0,0 +1 @@
+export declare function uninstallCommand(args: string[]): Promise<void>;

package/dist/commands/uninstall.js

@@ -0,0 +1,46 @@
+import { OpenclawInstaller } from '../installers/openclaw.js';
+import { error, info, success } from '../utils/logger.js';
+import { NdjsonEmitter, registerExitHandlers } from '../output/ndjson.js';
+function getInstaller(component) {
+    switch (component) {
+        case 'openclaw': return new OpenclawInstaller();
+        default: return null;
+    }
+}
+export async function uninstallCommand(args) {
+    const emitter = new NdjsonEmitter('uninstall');
+    registerExitHandlers(emitter);
+    const component = args[0];
+    if (!component) {
+        error('Usage: okclaw uninstall <component>');
+        emitter.end(false, 1, 'E_USAGE');
+        process.exit(1);
+    }
+    const installer = getInstaller(component);
+    if (!installer) {
+        error(`Uninstall not supported for component: ${component}`);
+        emitter.end(false, 1, 'E_UNSUPPORTED');
+        process.exit(1);
+    }
+    if (!installer.uninstall) {
+        error(`Component ${component} does not support uninstall`);
+        emitter.end(false, 1, 'E_UNSUPPORTED');
+        process.exit(1);
+    }
+    emitter.start(`uninstalling ${component}`, { component });
+    info(`Uninstalling ${component}...`);
+    try {
+        emitter.stepStart('uninstall', `running uninstall for ${component}`);
+        await installer.uninstall();
+        emitter.stepDone('uninstall', `${component} uninstalled`);
+        success(`${component} uninstalled.`);
+        emitter.end(true, 0, undefined, { component });
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        error(msg);
+        emitter.end(false, 1, 'E_UNINSTALL_FAILED', { error: msg });
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/commands/uninstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.js","sourceRoot":"","sources":["../../src/commands/uninstall.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE1E,SAAS,YAAY,CAAC,SAAiB;IACrC,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,UAAU,CAAC,CAAC,OAAO,IAAI,iBAAiB,EAAE,CAAC;QAChD,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAc;IACnD,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC;IAC/C,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAE9B,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,KAAK,CAAC,0CAA0C,SAAS,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,eAAe,CAAC,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QACzB,KAAK,CAAC,aAAa,SAAS,6BAA6B,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,eAAe,CAAC,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,gBAAgB,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,gBAAgB,SAAS,KAAK,CAAC,CAAC;IAErC,IAAI,CAAC;QACH,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,yBAAyB,SAAS,EAAE,CAAC,CAAC;QACrE,MAAM,SAAS,CAAC,SAAS,EAAE,CAAC;QAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,SAAS,cAAc,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,SAAS,eAAe,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvD,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,oBAAoB,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/index.js

@@ -1,21 +1,74 @@
 import { readFileSync } from 'node:fs';
 import { installCommand } from './commands/install.js';
+import { uninstallCommand } from './commands/uninstall.js';
 import { checkCommand } from './commands/check.js';
 import { editCommand } from './commands/edit.js';
+import { showCommand } from './commands/show.js';
 import { feedCommand } from './commands/feed.js';
 import { startCommand, stopCommand, restartCommand, statusCommand } from './commands/service.js';
+import { skillCommand } from './commands/skill.js';
 import { ensureRoot } from './utils/shell.js';
 import { error } from './utils/logger.js';
-const [command, ...args] = process.argv.slice(2);
+import { setNdjsonPath, setOutputMode, isNdjson } from './output/mode.js';
+import { getActiveEmitter, NdjsonEmitter } from './output/ndjson.js';
+/**
+ * 从 argv 里抽出全局 flag --output=<mode> 和 --op-id=<uuid>，返回剩余参数。
+ * 支持 "--flag=value" 与 "--flag value" 两种写法。
+ */
+function extractGlobalFlags(argv) {
+    const rest = [];
+    let output = 'text';
+    let opId;
+    let ndjsonPath;
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '--output' && argv[i + 1]) {
+            output = argv[++i] === 'ndjson' ? 'ndjson' : 'text';
+            continue;
+        }
+        if (arg.startsWith('--output=')) {
+            output = arg.slice('--output='.length) === 'ndjson' ? 'ndjson' : 'text';
+            continue;
+        }
+        if (arg === '--op-id' && argv[i + 1]) {
+            opId = argv[++i];
+            continue;
+        }
+        if (arg.startsWith('--op-id=')) {
+            opId = arg.slice('--op-id='.length);
+            continue;
+        }
+        if (arg === '--ndjson-path' && argv[i + 1]) {
+            ndjsonPath = argv[++i];
+            continue;
+        }
+        if (arg.startsWith('--ndjson-path=')) {
+            ndjsonPath = arg.slice('--ndjson-path='.length);
+            continue;
+        }
+        rest.push(arg);
+    }
+    return { rest, output, opId, ndjsonPath };
+}
+const { rest, output, opId, ndjsonPath } = extractGlobalFlags(process.argv.slice(2));
+setOutputMode(output, opId);
+setNdjsonPath(ndjsonPath);
+const [command, ...args] = rest;
 async function main() {
     // All commands require root (or auto-sudo)
     if (command && command !== '--help' && command !== '-h' && command !== '--version' && command !== '-v') {
         ensureRoot();
     }
     switch (command) {
+        case 'skill':
+            await skillCommand(args);
+            break;
         case 'install':
             await installCommand(args);
             break;
+        case 'uninstall':
+            await uninstallCommand(args);
+            break;
         case 'check':
             await checkCommand();
             break;
@@ -34,6 +87,9 @@ async function main() {
         case 'edit':
             await editCommand(args);
             break;
+        case 'show':
+            await showCommand(args);
+            break;
         case 'feed':
             await feedCommand(args);
             break;
@@ -58,15 +114,24 @@ function printHelp() {
     console.log(`
 okclaw - OKClaw Deployment CLI
 
-Usage: okclaw <command> [args...]
+Usage: okclaw [global-flags] <command> [args...]
+
+Global flags (before the command):
+  --output text|ndjson                  Output mode (default: text)
+  --op-id <uuid>                        Operation id, echoed in every ndjson event's fields.opId
+  --ndjson-path <path>                  Append ndjson to file instead of stdout (used in detached mode)
 
+  okclaw skill install <name> --version <ver> [--package-url <url>]   Install a skill
+  okclaw skill uninstall <name>                                       Uninstall a skill
   okclaw install <component> --version <ver> [--config '<json>'] [--config-file <path>] [--package-url <url>]
+  okclaw uninstall <component>                                        Uninstall a component (currently: openclaw)
   okclaw check                          Check & install system dependencies
   okclaw start                          Start openclaw gateway
   okclaw stop                           Stop openclaw gateway
   okclaw restart                        Restart openclaw gateway
   okclaw status                         Show gateway status
-  okclaw edit <target> --file <path>    Write config file (user/identity/soul/agents)
+  okclaw edit <target> --file <path>    Write config file (user/identity/soul/agents/memory/tools/openclaw-json)
+  okclaw show <target...>               Read config file content to stdout (batch requires --output=ndjson)
   okclaw feed --file <path>             Feed file into knowledge base
 
 Components:
@@ -82,6 +147,9 @@ Examples:
   okclaw install openviking --version 0.2.15 --package-url /tmp/ov-plugin.tar.gz --config-file /root/okclaw/config/openviking.json
   okclaw install dingtalk --version 2.0.1 --config '{"clientId":"xxx","clientSecret":"xxx"}'
   okclaw install s3 --version 1.0.0 --package-url /tmp/channel-s3.tar.gz
+  okclaw uninstall openclaw
+  okclaw skill install my-skill --version 1.0.0 --package-url https://example.com/skill.zip
+  okclaw skill uninstall my-skill
   okclaw restart
   okclaw status
 
@@ -89,11 +157,26 @@ Notes:
   - All commands auto-elevate to root via sudo if needed
   - All paths are anchored to /root/ (forced HOME=/root)
   - npm uses npmmirror, pip uses tsinghua mirror (China acceleration)
-  - Node.js >= 22.16 and Python >= 3.11 are auto-installed if missing
+  - Node.js >= 22.16 is auto-installed if missing
 `);
 }
 main().catch((err) => {
-    error(String(err.message || err));
+    const msg = String(err?.message || err);
+    // bug#4 修：顶层 catch 兜底发 end，防止 os-api 永远等不到终态。
+    // 有活 emitter 就用它；没有（比如 extractGlobalFlags/ensureRoot 阶段崩）→ 直接写一行 fallback。
+    if (isNdjson()) {
+        const active = getActiveEmitter();
+        if (active && !active.hasEnded()) {
+            active.end(false, 1, 'E_TOPLEVEL', { error: msg });
+        }
+        else if (!active) {
+            // 没有任何 emitter 被注册过：手写一条 end 行
+            const fallback = new NdjsonEmitter('unknown');
+            fallback.start('top-level error');
+            fallback.end(false, 1, 'E_TOPLEVEL', { error: msg });
+        }
+    }
+    error(msg);
     process.exit(1);
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEjD,KAAK,UAAU,IAAI;IACjB,2CAA2C;IAC3C,IAAI,OAAO,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACvG,UAAU,EAAE,CAAC;IACf,CAAC;IAED,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,SAAS;YACZ,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;YAC3B,MAAM;QACR,KAAK,OAAO;YACV,MAAM,YAAY,EAAE,CAAC;YACrB,MAAM;QACR,KAAK,OAAO;YACV,MAAM,YAAY,EAAE,CAAC;YACrB,MAAM;QACR,KAAK,MAAM;YACT,MAAM,WAAW,EAAE,CAAC;YACpB,MAAM;QACR,KAAK,SAAS;YACZ,MAAM,cAAc,EAAE,CAAC;YACvB,MAAM;QACR,KAAK,QAAQ;YACX,MAAM,aAAa,EAAE,CAAC;YACtB,MAAM;QACR,KAAK,MAAM;YACT,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;YACxB,MAAM;QACR,KAAK,MAAM;YACT,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;YACxB,MAAM;QACR,KAAK,WAAW,CAAC;QACjB,KAAK,IAAI,CAAC,CAAC,CAAC;YACV,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YAC1F,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACzB,MAAM;QACR,CAAC;QACD,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI,CAAC;QACV,KAAK,SAAS;YACZ,SAAS,EAAE,CAAC;YACZ,MAAM;QACR;YACE,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;YACrC,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCb,CAAC,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAmB,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAErE;;;GAGG;AACH,SAAS,kBAAkB,CAAC,IAAc;IAMxC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,MAAM,GAAe,MAAM,CAAC;IAChC,IAAI,IAAwB,CAAC;IAC7B,IAAI,UAA8B,CAAC;IAEnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpB,IAAI,GAAG,KAAK,UAAU,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACtC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;YACpD,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;YACxE,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACrC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACjB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,eAAe,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC3C,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACrC,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAChD,SAAS;QACX,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACrF,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC5B,aAAa,CAAC,UAAU,CAAC,CAAC;AAE1B,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AAEhC,KAAK,UAAU,IAAI;IACjB,2CAA2C;IAC3C,IAAI,OAAO,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACvG,UAAU,EAAE,CAAC;IACf,CAAC;IAED,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;YACzB,MAAM;QACR,KAAK,SAAS;YACZ,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;YAC3B,MAAM;QACR,KAAK,WAAW;YACd,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;YAC7B,MAAM;QACR,KAAK,OAAO;YACV,MAAM,YAAY,EAAE,CAAC;YACrB,MAAM;QACR,KAAK,OAAO;YACV,MAAM,YAAY,EAAE,CAAC;YACrB,MAAM;QACR,KAAK,MAAM;YACT,MAAM,WAAW,EAAE,CAAC;YACpB,MAAM;QACR,KAAK,SAAS;YACZ,MAAM,cAAc,EAAE,CAAC;YACvB,MAAM;QACR,KAAK,QAAQ;YACX,MAAM,aAAa,EAAE,CAAC;YACtB,MAAM;QACR,KAAK,MAAM;YACT,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;YACxB,MAAM;QACR,KAAK,MAAM;YACT,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;YACxB,MAAM;QACR,KAAK,MAAM;YACT,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;YACxB,MAAM;QACR,KAAK,WAAW,CAAC;QACjB,KAAK,IAAI,CAAC,CAAC,CAAC;YACV,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YAC1F,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACzB,MAAM;QACR,CAAC;QACD,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI,CAAC;QACV,KAAK,SAAS;YACZ,SAAS,EAAE,CAAC;YACZ,MAAM;QACR;YACE,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;YACrC,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+Cb,CAAC,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,EAAE,OAAO,IAAI,GAAG,CAAC,CAAC;IACxC,8CAA8C;IAC9C,2EAA2E;IAC3E,IAAI,QAAQ,EAAE,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAClC,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACrD,CAAC;aAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YACnB,+BAA+B;YAC/B,MAAM,QAAQ,GAAG,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;YAC9C,QAAQ,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YAClC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,CAAC;IACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/installers/base.d.ts

@@ -2,4 +2,5 @@ export interface Installer {
     checkDeps(): Promise<void>;
     install(version: string, packageUrl?: string): Promise<void>;
     configure(config: Record<string, unknown>): Promise<void>;
+    uninstall?(): Promise<void>;
 }

package/dist/installers/channel.d.ts

@@ -4,8 +4,17 @@ export declare class ChannelInstaller implements Installer {
     constructor(channelName: string);
     checkDeps(): Promise<void>;
     install(version: string, packageUrl?: string): Promise<void>;
+    private verifyInstalled;
     configure(config: Record<string, unknown>): Promise<void>;
-    private removeExistingPlugin;
+    /**
+     * Clean up both filesystem state (extensions/<name>) and openclaw.json state
+     * (plugins.entries/installs/allow.<name> + channels.<name>) for this channel,
+     * atomically. Partial cleanup — e.g., rm-ing the dir but leaving the JSON refs —
+     * leaves openclaw's config validation broken and poisons all subsequent
+     * `openclaw ...` commands ("unknown channel id: <name>").
+     */
+    private cleanupStaleState;
+    private hasJsonRef;
     private installFromLocalPackage;
     /**
      * Download tgz from npm (npmmirror) first, then install locally.
@@ -13,5 +22,11 @@ export declare class ChannelInstaller implements Installer {
      */
     private installViaNpmPack;
     private addToPluginsAllow;
+    /**
+     * Push the absolute extension dir into plugins.load.paths so the gateway
+     * scans it on startup. Idempotent — dedup against trailing-slash variants
+     * (e.g. `/.../dingtalk` vs `/.../dingtalk/` both count as the same entry).
+     */
+    private addToLoadPaths;
     private applyConfig;
 }