@okclaw-build/cli 1.0.0-beta.1

package/bin/okclaw.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../dist/index.js');

package/dist/commands/check.d.ts

@@ -0,0 +1 @@
+export declare function checkCommand(): Promise<void>;

package/dist/commands/check.js

@@ -0,0 +1,11 @@
+import { ensureNodeVersion, ensurePython } from '../utils/deps.js';
+import { configureMirrors } from '../utils/mirror.js';
+import { info, success } from '../utils/logger.js';
+export async function checkCommand() {
+    info('Checking system dependencies...');
+    await ensureNodeVersion();
+    await ensurePython();
+    await configureMirrors();
+    success('All dependencies satisfied.');
+}
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IACxC,MAAM,iBAAiB,EAAE,CAAC;IAC1B,MAAM,YAAY,EAAE,CAAC;IACrB,MAAM,gBAAgB,EAAE,CAAC;IACzB,OAAO,CAAC,6BAA6B,CAAC,CAAC;AACzC,CAAC"}

package/dist/commands/edit.d.ts

@@ -0,0 +1,10 @@
+/**
+ * okclaw edit <target> --file <path>
+ *
+ * Copies a file to the openclaw workspace directory.
+ *   user     → ~/.openclaw/workspace/USER.md
+ *   identity → ~/.openclaw/workspace/IDENTITY.md
+ *   soul     → ~/.openclaw/workspace/SOUL.md
+ *   agents   → ~/.openclaw/workspace/AGENTS.md
+ */
+export declare function editCommand(args: string[]): Promise<void>;

package/dist/commands/edit.js

@@ -0,0 +1,44 @@
+import { existsSync, mkdirSync } from 'node:fs';
+import { shell } from '../utils/shell.js';
+import { info, error } from '../utils/logger.js';
+import { OPENCLAW_WORKSPACE } from '../utils/constants.js';
+/**
+ * All targets are plain files under ~/.openclaw/workspace/.
+ */
+const TARGETS = {
+    user: `${OPENCLAW_WORKSPACE}/USER.md`,
+    identity: `${OPENCLAW_WORKSPACE}/IDENTITY.md`,
+    soul: `${OPENCLAW_WORKSPACE}/SOUL.md`,
+    agents: `${OPENCLAW_WORKSPACE}/AGENTS.md`,
+};
+/**
+ * okclaw edit <target> --file <path>
+ *
+ * Copies a file to the openclaw workspace directory.
+ *   user     → ~/.openclaw/workspace/USER.md
+ *   identity → ~/.openclaw/workspace/IDENTITY.md
+ *   soul     → ~/.openclaw/workspace/SOUL.md
+ *   agents   → ~/.openclaw/workspace/AGENTS.md
+ */
+export async function editCommand(args) {
+    const target = args[0];
+    if (!target || !TARGETS[target]) {
+        error(`Usage: okclaw edit <${Object.keys(TARGETS).join('|')}> --file <path>`);
+        process.exit(1);
+    }
+    const fileIdx = args.indexOf('--file');
+    const filePath = fileIdx >= 0 ? args[fileIdx + 1] : undefined;
+    if (!filePath) {
+        error('Missing --file argument');
+        process.exit(1);
+    }
+    if (!existsSync(filePath)) {
+        error(`File not found: ${filePath}`);
+        process.exit(1);
+    }
+    const dest = TARGETS[target];
+    mkdirSync(OPENCLAW_WORKSPACE, { recursive: true });
+    await shell(`cp -f '${filePath}' '${dest}'`);
+    info(`Written to ${dest}`);
+}
+//# sourceMappingURL=edit.js.map

package/dist/commands/edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.js","sourceRoot":"","sources":["../../src/commands/edit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;GAEG;AACH,MAAM,OAAO,GAA2B;IACtC,IAAI,EAAM,GAAG,kBAAkB,UAAU;IACzC,QAAQ,EAAE,GAAG,kBAAkB,cAAc;IAC7C,IAAI,EAAM,GAAG,kBAAkB,UAAU;IACzC,MAAM,EAAI,GAAG,kBAAkB,YAAY;CAC5C,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAc;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,uBAAuB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,SAAS,CAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,KAAK,CAAC,UAAU,QAAQ,MAAM,IAAI,GAAG,CAAC,CAAC;IAC7C,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/dist/commands/feed.d.ts

@@ -0,0 +1,10 @@
+/**
+ * okclaw feed --file <path>
+ *
+ * Feeds file content into OpenViking's memory system.
+ *
+ * - If the file is a .zip/.tar.gz, extract first then process each file.
+ * - For each text file, submit the entire file content as one session and extract memories.
+ * - Non-text files are added as resources (ov add-resource).
+ */
+export declare function feedCommand(args: string[]): Promise<void>;

package/dist/commands/feed.js

@@ -0,0 +1,158 @@
+import { existsSync, readFileSync, writeFileSync, readdirSync, statSync, mkdirSync, rmSync, unlinkSync } from 'node:fs';
+import { join, extname } from 'node:path';
+import { shell, shellCapture } from '../utils/shell.js';
+import { info, warn, error, success } from '../utils/logger.js';
+const OV_API = 'http://localhost:1933';
+const TEXT_EXTENSIONS = new Set(['.md', '.txt', '.text', '.csv', '.json', '.xml', '.yaml', '.yml', '.log']);
+/**
+ * okclaw feed --file <path>
+ *
+ * Feeds file content into OpenViking's memory system.
+ *
+ * - If the file is a .zip/.tar.gz, extract first then process each file.
+ * - For each text file, submit the entire file content as one session and extract memories.
+ * - Non-text files are added as resources (ov add-resource).
+ */
+export async function feedCommand(args) {
+    const fileIdx = args.indexOf('--file');
+    const filePath = fileIdx >= 0 ? args[fileIdx + 1] : undefined;
+    if (!filePath) {
+        error('Usage: okclaw feed --file <path>');
+        process.exit(1);
+    }
+    if (!existsSync(filePath)) {
+        error(`File not found: ${filePath}`);
+        process.exit(1);
+    }
+    const ext = extname(filePath).toLowerCase();
+    if (ext === '.zip' || ext === '.gz' || ext === '.tgz' || filePath.endsWith('.tar.gz')) {
+        await feedArchive(filePath);
+    }
+    else if (isTextFile(ext)) {
+        await feedTextFile(filePath);
+    }
+    else {
+        info(`Non-text file, adding as resource: ${filePath}`);
+        await shell(`ov add-resource '${filePath}' -o json`);
+        success('Resource added.');
+    }
+}
+async function feedArchive(archivePath) {
+    const tmpDir = '/tmp/okclaw_feed_extract_' + process.pid;
+    mkdirSync(tmpDir, { recursive: true });
+    try {
+        const ext = extname(archivePath).toLowerCase();
+        if (ext === '.zip') {
+            await shell(`unzip -o '${archivePath}' -d '${tmpDir}'`);
+        }
+        else {
+            await shell(`tar xzf '${archivePath}' -C '${tmpDir}'`);
+        }
+        const files = collectFiles(tmpDir);
+        info(`Extracted ${files.length} file(s) from archive`);
+        for (let i = 0; i < files.length; i++) {
+            const file = files[i];
+            const fileExt = extname(file).toLowerCase();
+            info(`[${i + 1}/${files.length}] Processing: ${file.replace(tmpDir + '/', '')}`);
+            if (isTextFile(fileExt)) {
+                await feedTextFile(file);
+            }
+            else {
+                await shell(`ov add-resource '${file}' -o json`);
+                info('  Added as resource');
+            }
+        }
+        success(`All ${files.length} file(s) processed.`);
+    }
+    finally {
+        rmSync(tmpDir, { recursive: true, force: true });
+    }
+}
+/**
+ * Feed an entire text file as one session → extract memories.
+ * Whole-file submission gives LLM full context for better memory extraction.
+ */
+async function feedTextFile(filePath) {
+    const content = readFileSync(filePath, 'utf-8').trim();
+    if (!content) {
+        warn(`Skipping empty file: ${filePath}`);
+        return;
+    }
+    info(`  Feeding file content (${content.length} chars)...`);
+    // 1. Create session
+    const createResult = await curlJson('POST', `${OV_API}/api/v1/sessions`, {});
+    const sessionId = createResult?.result?.session_id;
+    if (!sessionId) {
+        throw new Error('Failed to create session');
+    }
+    try {
+        // 2. Add entire file as one user message
+        await curlJson('POST', `${OV_API}/api/v1/sessions/${sessionId}/messages`, {
+            role: 'user',
+            content,
+        });
+        // 3. Extract memories (sync — waits for LLM to analyze and extract, may take minutes)
+        const extractResult = await curlJson('POST', `${OV_API}/api/v1/sessions/${sessionId}/extract`, {});
+        const memories = Array.isArray(extractResult?.result) ? extractResult.result : [];
+        info(`  Extracted ${memories.length} memories`);
+    }
+    finally {
+        // 4. Cleanup session (ignore errors — best effort)
+        try {
+            await curlJson('DELETE', `${OV_API}/api/v1/sessions/${sessionId}`, null);
+        }
+        catch {
+            // session cleanup is best-effort
+        }
+    }
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+async function curlJson(method, url, body) {
+    let cmd;
+    let tmpFile = null;
+    if (body === null) {
+        cmd = `curl -s -X ${method} '${url}'`;
+    }
+    else {
+        tmpFile = `/tmp/okclaw_curl_${process.pid}_${Date.now()}.json`;
+        writeFileSync(tmpFile, JSON.stringify(body), 'utf-8');
+        cmd = `curl -s -X ${method} '${url}' -H 'Content-Type: application/json' -d @'${tmpFile}'`;
+    }
+    try {
+        const result = await shellCapture(cmd);
+        if (result.code !== 0) {
+            throw new Error(`curl failed: ${result.stderr}`);
+        }
+        try {
+            return JSON.parse(result.stdout);
+        }
+        catch {
+            throw new Error(`Invalid JSON response: ${result.stdout}`);
+        }
+    }
+    finally {
+        if (tmpFile && existsSync(tmpFile)) {
+            unlinkSync(tmpFile);
+        }
+    }
+}
+function isTextFile(ext) {
+    return TEXT_EXTENSIONS.has(ext);
+}
+function collectFiles(dir) {
+    const files = [];
+    for (const entry of readdirSync(dir)) {
+        if (entry.startsWith('.'))
+            continue;
+        const fullPath = join(dir, entry);
+        const stat = statSync(fullPath);
+        if (stat.isDirectory()) {
+            files.push(...collectFiles(fullPath));
+        }
+        else {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+//# sourceMappingURL=feed.js.map

package/dist/commands/feed.js.map

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

package/dist/commands/install.d.ts

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

package/dist/commands/install.js

@@ -0,0 +1,72 @@
+import { readFileSync } from 'node:fs';
+import { OpenclawInstaller } from '../installers/openclaw.js';
+import { OpenvikingInstaller } from '../installers/openviking.js';
+import { ChannelInstaller } from '../installers/channel.js';
+import { configureMirrors } from '../utils/mirror.js';
+import { info, error, success } from '../utils/logger.js';
+function getInstaller(component) {
+    switch (component) {
+        case 'openclaw': return new OpenclawInstaller();
+        case 'openviking': return new OpenvikingInstaller();
+        default: return new ChannelInstaller(component);
+    }
+}
+export async function installCommand(args) {
+    const component = args[0];
+    if (!component) {
+        error('Usage: okclaw install <component> --version <ver> [--config <json>] [--config-file <path>] [--package-url <url>]');
+        process.exit(1);
+    }
+    let version = '';
+    let config;
+    let packageUrl;
+    for (let i = 1; 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');
+                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}`);
+                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');
+        process.exit(1);
+    }
+    info(`Installing ${component}@${version}...`);
+    const installer = getInstaller(component);
+    await installer.checkDeps();
+    await configureMirrors();
+    await installer.install(version, packageUrl);
+    if (config) {
+        await installer.configure(config);
+    }
+    else {
+        info('No config provided, keeping existing configuration.');
+    }
+    success(`${component}@${version} installed.`);
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

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

package/dist/commands/service.d.ts

@@ -0,0 +1,4 @@
+export declare function startCommand(): Promise<void>;
+export declare function stopCommand(): Promise<void>;
+export declare function restartCommand(): Promise<void>;
+export declare function statusCommand(): Promise<void>;

package/dist/commands/service.js

@@ -0,0 +1,23 @@
+import { shell, shellCapture } from '../utils/shell.js';
+import { info, success } from '../utils/logger.js';
+import { OPENVIKING_ENV } from '../utils/constants.js';
+export async function startCommand() {
+    info('Starting openclaw gateway...');
+    await shell(`source ${OPENVIKING_ENV} 2>/dev/null || true; openclaw gateway start`);
+    success('Gateway started.');
+}
+export async function stopCommand() {
+    info('Stopping openclaw gateway...');
+    await shell('openclaw gateway stop 2>/dev/null || true');
+    success('Gateway stopped.');
+}
+export async function restartCommand() {
+    info('Restarting openclaw gateway...');
+    await shell(`source ${OPENVIKING_ENV} 2>/dev/null || true; openclaw gateway restart`);
+    success('Gateway restarted.');
+}
+export async function statusCommand() {
+    const result = await shellCapture('openclaw gateway status 2>&1 || true');
+    console.log(result.stdout || result.stderr || 'No output');
+}
+//# sourceMappingURL=service.js.map

package/dist/commands/service.js.map

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,96 @@
+import { installCommand } from './commands/install.js';
+import { checkCommand } from './commands/check.js';
+import { editCommand } from './commands/edit.js';
+import { feedCommand } from './commands/feed.js';
+import { startCommand, stopCommand, restartCommand, statusCommand } from './commands/service.js';
+import { ensureRoot } from './utils/shell.js';
+import { error } from './utils/logger.js';
+const [command, ...args] = process.argv.slice(2);
+async function main() {
+    // All commands require root (or auto-sudo)
+    if (command && command !== '--help' && command !== '-h' && command !== '--version' && command !== '-v') {
+        ensureRoot();
+    }
+    switch (command) {
+        case 'install':
+            await installCommand(args);
+            break;
+        case 'check':
+            await checkCommand();
+            break;
+        case 'start':
+            await startCommand();
+            break;
+        case 'stop':
+            await stopCommand();
+            break;
+        case 'restart':
+            await restartCommand();
+            break;
+        case 'status':
+            await statusCommand();
+            break;
+        case 'edit':
+            await editCommand(args);
+            break;
+        case 'feed':
+            await feedCommand(args);
+            break;
+        case '--version':
+        case '-v':
+            console.log('1.0.0');
+            break;
+        case '--help':
+        case '-h':
+        case undefined:
+            printHelp();
+            break;
+        default:
+            error(`Unknown command: ${command}`);
+            printHelp();
+            process.exit(1);
+    }
+}
+function printHelp() {
+    console.log(`
+okclaw - OKClaw Deployment CLI
+
+Usage: okclaw <command> [args...]
+
+  okclaw install <component> --version <ver> [--config '<json>'] [--config-file <path>] [--package-url <url>]
+  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 feed --file <path>             Feed file into knowledge base
+
+Components:
+  openclaw       Core AI Agent framework (npm install)
+  openviking     Long-term memory plugin (pip + openclaw plugin, needs --package-url)
+  dingtalk       DingTalk channel (npm: @largezhou/ddingtalk)
+  feishu         Feishu/Lark channel (npm: @openclaw/feishu)
+  wechat         WeChat channel (npm: @tencent-weixin/openclaw-weixin)
+  s3             S3 IM channel (needs --package-url)
+
+Examples:
+  okclaw install openclaw --version 2026.3.24 --config-file /root/okclaw/config/openclaw.json
+  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 restart
+  okclaw status
+
+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
+`);
+}
+main().catch((err) => {
+    error(String(err.message || err));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,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;YACP,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACrB,MAAM;QACR,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"}

package/dist/installers/base.d.ts

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

package/dist/installers/base.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base.js.map

package/dist/installers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/installers/base.ts"],"names":[],"mappings":""}

package/dist/installers/channel.d.ts

@@ -0,0 +1,17 @@
+import type { Installer } from './base.js';
+export declare class ChannelInstaller implements Installer {
+    private channelName;
+    constructor(channelName: string);
+    checkDeps(): Promise<void>;
+    install(version: string, packageUrl?: string): Promise<void>;
+    configure(config: Record<string, unknown>): Promise<void>;
+    private removeExistingPlugin;
+    private installFromLocalPackage;
+    /**
+     * Download tgz from npm (npmmirror) first, then install locally.
+     * This bypasses ClawHub rate limiting (429 errors).
+     */
+    private installViaNpmPack;
+    private addToPluginsAllow;
+    private applyConfig;
+}

package/dist/installers/channel.js

@@ -0,0 +1,129 @@
+import { existsSync, mkdirSync, rmSync, readFileSync, writeFileSync } from 'node:fs';
+import { shell, shellCapture } from '../utils/shell.js';
+import { ensureCommand, checkDiskSpace } from '../utils/deps.js';
+import { info, warn } from '../utils/logger.js';
+import { CHANNEL_NPM_PACKAGES, BUNDLED_PLUGINS, OKCLAW_TMP_DIR, OPENCLAW_HOME, NPM_REGISTRY } from '../utils/constants.js';
+export class ChannelInstaller {
+    channelName;
+    constructor(channelName) {
+        this.channelName = channelName;
+    }
+    async checkDeps() {
+        await checkDiskSpace(200);
+        await ensureCommand('openclaw');
+    }
+    async install(version, packageUrl) {
+        if (BUNDLED_PLUGINS.has(this.channelName)) {
+            info(`${this.channelName} is bundled with openclaw, skipping install (config only).`);
+            return;
+        }
+        // Remove existing plugin to avoid "plugin already exists" error
+        this.removeExistingPlugin();
+        if (packageUrl) {
+            await this.installFromLocalPackage(packageUrl);
+        }
+        else {
+            await this.installViaNpmPack(version);
+        }
+        // Add to plugins.allow so openclaw trusts this plugin
+        await this.addToPluginsAllow();
+        info(`${this.channelName}@${version} installed.`);
+    }
+    async configure(config) {
+        if (!config || Object.keys(config).length === 0)
+            return;
+        // All channel configs go to channels.<name> (both bundled and external plugins)
+        // plugins.entries is managed by openclaw plugins install, we don't touch it
+        const configPrefix = `channels.${this.channelName}`;
+        info(`Configuring ${this.channelName} at ${configPrefix}...`);
+        await this.applyConfig(config, configPrefix);
+        info(`${this.channelName} configured.`);
+    }
+    // ---- private ----
+    removeExistingPlugin() {
+        const pluginDir = `${OPENCLAW_HOME}/extensions/${this.channelName}`;
+        if (existsSync(pluginDir)) {
+            info(`Removing existing plugin at ${pluginDir}...`);
+            rmSync(pluginDir, { recursive: true, force: true });
+        }
+    }
+    async installFromLocalPackage(packageUrl) {
+        mkdirSync(OKCLAW_TMP_DIR, { recursive: true });
+        const archive = `${OKCLAW_TMP_DIR}/${this.channelName}-plugin.tgz`;
+        if (packageUrl.startsWith('http')) {
+            info(`Downloading ${this.channelName} from ${packageUrl}...`);
+            await shell(`curl -fsSL --connect-timeout 30 --retry 3 -o "${archive}" "${packageUrl}"`);
+        }
+        else if (existsSync(packageUrl)) {
+            await shell(`cp "${packageUrl}" "${archive}"`);
+        }
+        else {
+            throw new Error(`Package not found: ${packageUrl}`);
+        }
+        info(`Installing ${this.channelName} from local package...`);
+        await shell(`openclaw plugins install "${archive}"`);
+        await shell(`rm -f "${archive}"`).catch(() => { });
+    }
+    /**
+     * Download tgz from npm (npmmirror) first, then install locally.
+     * This bypasses ClawHub rate limiting (429 errors).
+     */
+    async installViaNpmPack(version) {
+        const npmPkg = CHANNEL_NPM_PACKAGES[this.channelName];
+        if (!npmPkg) {
+            throw new Error(`No npm package mapping for '${this.channelName}'. ` +
+                `Use --package-url to install from a local package.`);
+        }
+        const pkgSpec = `${npmPkg}@${version}`;
+        mkdirSync(OKCLAW_TMP_DIR, { recursive: true });
+        info(`Downloading ${pkgSpec} from npm...`);
+        const packResult = await shellCapture(`cd "${OKCLAW_TMP_DIR}" && npm pack "${pkgSpec}" --registry ${NPM_REGISTRY} 2>&1 | tail -1`);
+        if (packResult.code !== 0) {
+            throw new Error(`npm pack failed for ${pkgSpec}: ${packResult.stderr}`);
+        }
+        const tgzFile = `${OKCLAW_TMP_DIR}/${packResult.stdout.trim()}`;
+        if (!existsSync(tgzFile)) {
+            throw new Error(`npm pack did not produce expected file: ${tgzFile}`);
+        }
+        info(`Installing ${this.channelName} from ${tgzFile}...`);
+        await shell(`openclaw plugins install "${tgzFile}"`);
+        await shell(`rm -f "${tgzFile}"`).catch(() => { });
+    }
+    async addToPluginsAllow() {
+        const configFile = `${OPENCLAW_HOME}/openclaw.json`;
+        if (!existsSync(configFile))
+            return;
+        try {
+            const cfg = JSON.parse(readFileSync(configFile, 'utf8'));
+            if (!cfg.plugins)
+                cfg.plugins = {};
+            if (!Array.isArray(cfg.plugins.allow))
+                cfg.plugins.allow = [];
+            if (!cfg.plugins.allow.includes(this.channelName)) {
+                cfg.plugins.allow.push(this.channelName);
+                writeFileSync(configFile, JSON.stringify(cfg, null, 2) + '\n', 'utf8');
+                info(`Added ${this.channelName} to plugins.allow`);
+            }
+        }
+        catch (e) {
+            warn(`Failed to update plugins.allow: ${e}`);
+        }
+    }
+    async applyConfig(obj, prefix) {
+        for (const [key, value] of Object.entries(obj)) {
+            if (value === null || value === undefined)
+                continue;
+            const path = `${prefix}.${key}`;
+            if (typeof value === 'object' && !Array.isArray(value)) {
+                await this.applyConfig(value, path);
+            }
+            else {
+                const strVal = String(value).replace(/'/g, "'\\''");
+                await shell(`openclaw config set '${path}' '${strVal}'`).catch(() => {
+                    warn(`Failed to set ${path}`);
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=channel.js.map