* CLI argv: add strict root help invocation guard * Entry: add root help fast-path bootstrap bypass * CLI context: lazily resolve channel options * CLI context tests: cover lazy channel option resolution * CLI argv tests: cover root help invocation detection * Changelog: note additional startup path optimizations * Changelog: split startup follow-up into #30975 entry * CLI channel options: load precomputed startup metadata * CLI channel options tests: cover precomputed metadata path * Build: generate CLI startup metadata during build * Build script: invoke CLI startup metadata generator * CLI routes: preload plugins for routed health * CLI routes tests: assert health plugin preload * CLI: add experimental bundled entry and snapshot helper * Tools: compare CLI startup entries in benchmark script * Docs: add startup tuning notes for Pi and VM hosts * CLI: drop bundled entry runtime toggle * Build: remove bundled and snapshot scripts * Tools: remove bundled-entry benchmark shortcut * Docs: remove bundled startup bench examples * Docs: remove Pi bundled entry mention * Docs: remove VM bundled entry mention * Changelog: remove bundled startup follow-up claims * Build: remove snapshot helper script * Build: remove CLI bundle tsdown config * Doctor: add low-power startup optimization hints * Doctor: run startup optimization hint checks * Doctor tests: cover startup optimization host targeting * Doctor tests: mock startup optimization note export * CLI argv: require strict root-only help fast path * CLI argv tests: cover mixed root-help invocations * CLI channel options: merge metadata with runtime catalog * CLI channel options tests: assert dynamic catalog merge * Changelog: align #30975 startup follow-up scope * Docs tests: remove secondary-entry startup bench note * Docs Pi: add systemd recovery reference link * Docs VPS: add systemd recovery reference link
191 lines
5.9 KiB
JavaScript
191 lines
5.9 KiB
JavaScript
#!/usr/bin/env node
|
|
import { spawn } from "node:child_process";
|
|
import { enableCompileCache } from "node:module";
|
|
import process from "node:process";
|
|
import { fileURLToPath } from "node:url";
|
|
import { isRootHelpInvocation, isRootVersionInvocation } from "./cli/argv.js";
|
|
import { applyCliProfileEnv, parseCliProfileArgs } from "./cli/profile.js";
|
|
import { shouldSkipRespawnForArgv } from "./cli/respawn-policy.js";
|
|
import { normalizeWindowsArgv } from "./cli/windows-argv.js";
|
|
import { isTruthyEnvValue, normalizeEnv } from "./infra/env.js";
|
|
import { isMainModule } from "./infra/is-main.js";
|
|
import { installProcessWarningFilter } from "./infra/warning-filter.js";
|
|
import { attachChildProcessBridge } from "./process/child-process-bridge.js";
|
|
|
|
const ENTRY_WRAPPER_PAIRS = [
|
|
{ wrapperBasename: "openclaw.mjs", entryBasename: "entry.js" },
|
|
{ wrapperBasename: "openclaw.js", entryBasename: "entry.js" },
|
|
] as const;
|
|
|
|
function shouldForceReadOnlyAuthStore(argv: string[]): boolean {
|
|
const tokens = argv.slice(2).filter((token) => token.length > 0 && !token.startsWith("-"));
|
|
for (let index = 0; index < tokens.length - 1; index += 1) {
|
|
if (tokens[index] === "secrets" && tokens[index + 1] === "audit") {
|
|
return true;
|
|
}
|
|
}
|
|
return false;
|
|
}
|
|
|
|
// Guard: only run entry-point logic when this file is the main module.
|
|
// The bundler may import entry.js as a shared dependency when dist/index.js
|
|
// is the actual entry point; without this guard the top-level code below
|
|
// would call runCli a second time, starting a duplicate gateway that fails
|
|
// on the lock / port and crashes the process.
|
|
if (
|
|
!isMainModule({
|
|
currentFile: fileURLToPath(import.meta.url),
|
|
wrapperEntryPairs: [...ENTRY_WRAPPER_PAIRS],
|
|
})
|
|
) {
|
|
// Imported as a dependency — skip all entry-point side effects.
|
|
} else {
|
|
process.title = "openclaw";
|
|
installProcessWarningFilter();
|
|
normalizeEnv();
|
|
if (!isTruthyEnvValue(process.env.NODE_DISABLE_COMPILE_CACHE)) {
|
|
try {
|
|
enableCompileCache();
|
|
} catch {
|
|
// Best-effort only; never block startup.
|
|
}
|
|
}
|
|
|
|
if (shouldForceReadOnlyAuthStore(process.argv)) {
|
|
process.env.OPENCLAW_AUTH_STORE_READONLY = "1";
|
|
}
|
|
|
|
if (process.argv.includes("--no-color")) {
|
|
process.env.NO_COLOR = "1";
|
|
process.env.FORCE_COLOR = "0";
|
|
}
|
|
|
|
const EXPERIMENTAL_WARNING_FLAG = "--disable-warning=ExperimentalWarning";
|
|
|
|
function hasExperimentalWarningSuppressed(): boolean {
|
|
const nodeOptions = process.env.NODE_OPTIONS ?? "";
|
|
if (nodeOptions.includes(EXPERIMENTAL_WARNING_FLAG) || nodeOptions.includes("--no-warnings")) {
|
|
return true;
|
|
}
|
|
for (const arg of process.execArgv) {
|
|
if (arg === EXPERIMENTAL_WARNING_FLAG || arg === "--no-warnings") {
|
|
return true;
|
|
}
|
|
}
|
|
return false;
|
|
}
|
|
|
|
function ensureExperimentalWarningSuppressed(): boolean {
|
|
if (shouldSkipRespawnForArgv(process.argv)) {
|
|
return false;
|
|
}
|
|
if (isTruthyEnvValue(process.env.OPENCLAW_NO_RESPAWN)) {
|
|
return false;
|
|
}
|
|
if (isTruthyEnvValue(process.env.OPENCLAW_NODE_OPTIONS_READY)) {
|
|
return false;
|
|
}
|
|
if (hasExperimentalWarningSuppressed()) {
|
|
return false;
|
|
}
|
|
|
|
// Respawn guard (and keep recursion bounded if something goes wrong).
|
|
process.env.OPENCLAW_NODE_OPTIONS_READY = "1";
|
|
// Pass flag as a Node CLI option, not via NODE_OPTIONS (--disable-warning is disallowed in NODE_OPTIONS).
|
|
const child = spawn(
|
|
process.execPath,
|
|
[EXPERIMENTAL_WARNING_FLAG, ...process.execArgv, ...process.argv.slice(1)],
|
|
{
|
|
stdio: "inherit",
|
|
env: process.env,
|
|
},
|
|
);
|
|
|
|
attachChildProcessBridge(child);
|
|
|
|
child.once("exit", (code, signal) => {
|
|
if (signal) {
|
|
process.exitCode = 1;
|
|
return;
|
|
}
|
|
process.exit(code ?? 1);
|
|
});
|
|
|
|
child.once("error", (error) => {
|
|
console.error(
|
|
"[openclaw] Failed to respawn CLI:",
|
|
error instanceof Error ? (error.stack ?? error.message) : error,
|
|
);
|
|
process.exit(1);
|
|
});
|
|
|
|
// Parent must not continue running the CLI.
|
|
return true;
|
|
}
|
|
|
|
function tryHandleRootVersionFastPath(argv: string[]): boolean {
|
|
if (!isRootVersionInvocation(argv)) {
|
|
return false;
|
|
}
|
|
import("./version.js")
|
|
.then(({ VERSION }) => {
|
|
console.log(VERSION);
|
|
})
|
|
.catch((error) => {
|
|
console.error(
|
|
"[openclaw] Failed to resolve version:",
|
|
error instanceof Error ? (error.stack ?? error.message) : error,
|
|
);
|
|
process.exitCode = 1;
|
|
});
|
|
return true;
|
|
}
|
|
|
|
function tryHandleRootHelpFastPath(argv: string[]): boolean {
|
|
if (!isRootHelpInvocation(argv)) {
|
|
return false;
|
|
}
|
|
import("./cli/program.js")
|
|
.then(({ buildProgram }) => {
|
|
buildProgram().outputHelp();
|
|
})
|
|
.catch((error) => {
|
|
console.error(
|
|
"[openclaw] Failed to display help:",
|
|
error instanceof Error ? (error.stack ?? error.message) : error,
|
|
);
|
|
process.exitCode = 1;
|
|
});
|
|
return true;
|
|
}
|
|
|
|
process.argv = normalizeWindowsArgv(process.argv);
|
|
|
|
if (!ensureExperimentalWarningSuppressed()) {
|
|
const parsed = parseCliProfileArgs(process.argv);
|
|
if (!parsed.ok) {
|
|
// Keep it simple; Commander will handle rich help/errors after we strip flags.
|
|
console.error(`[openclaw] ${parsed.error}`);
|
|
process.exit(2);
|
|
}
|
|
|
|
if (parsed.profile) {
|
|
applyCliProfileEnv({ profile: parsed.profile });
|
|
// Keep Commander and ad-hoc argv checks consistent.
|
|
process.argv = parsed.argv;
|
|
}
|
|
|
|
if (!tryHandleRootVersionFastPath(process.argv) && !tryHandleRootHelpFastPath(process.argv)) {
|
|
import("./cli/run-main.js")
|
|
.then(({ runCli }) => runCli(process.argv))
|
|
.catch((error) => {
|
|
console.error(
|
|
"[openclaw] Failed to start CLI:",
|
|
error instanceof Error ? (error.stack ?? error.message) : error,
|
|
);
|
|
process.exitCode = 1;
|
|
});
|
|
}
|
|
}
|
|
}
|