src/cli/run-main.ts这段代码位于 run-main.ts，是 OpenClaw CLI 的核心业务引导

这段代码位于 run-main.ts，是 OpenClaw CLI 的核心业务引导程序。如果说 entry.ts 负责系统和进程层面的启动，那么 run-main.ts 则负责应用层面的初始化与执行。

它主要完成了环境配置加载、命令行参数标准化、插件系统加载以及最终命令的执行。以下是详细的代码功能解析：

1. 辅助函数：参数清洗与逻辑判断

在主函数 runCli 执行前，代码定义了几个关键的工具函数，用于优化启动流程：

rewriteUpdateFlagArgv：
- 功能：将 --update 标志重写为 update 子命令。
- 场景：兼容用户习惯。允许用户使用 openclaw --update 这种标志写法，内部将其转换为标准的 openclaw update 命令格式，统一处理逻辑。

export function rewriteUpdateFlagArgv(argv: string[]): string[] {
  const index = argv.indexOf("--update");
  if (index === -1) {
    return argv;
  }

  const next = [...argv];
  next.splice(index, 1, "update");
  return next;
}

关于const next = [...argv];

... 是 ES6 引入的扩展运算符，用于将可迭代对象（如数组、字符串、Set、Map 等）在语法层面展开。

直接赋值 const next = argv; 并不会创建新数组，而是让 next 和 argv 指向同一个数组对象。之后对 next 的修改（如 push、pop 或修改元素）会直接影响到原数组 argv，反之亦然。
使用 [...argv] 会生成一个全新的数组，其元素是原数组元素的浅拷贝（即如果元素是基本类型，则是值拷贝；如果是引用类型，则拷贝的是引用）。

shouldEnsureCliPath：
- 功能：判断当前命令是否需要将 OpenClaw CLI 路径添加到系统 PATH 环境变量中。
- 逻辑：
  - 如果是 help 或 version，不需要。
  - 如果是 status、health、sessions 等轻量级查询命令，不需要。
  - 如果是 config get 或 models list，不需要。
  - 其他情况（如核心运行命令）返回 true。
- 意义：这是为了确保在执行核心任务（如启动智能体）时，子进程能够正确回调主 CLI 程序，同时避免在简单查询时不必要地修改环境变量。

export function shouldEnsureCliPath(argv: string[]): boolean {
  if (hasHelpOrVersion(argv)) {
    return false;
  }
  const [primary, secondary] = getCommandPathWithRootOptions(argv, 2);
  if (!primary) {
    return true;
  }
  if (primary === "status" || primary === "health" || primary === "sessions") {
    return false;
  }
  if (primary === "config" && (secondary === "get" || secondary === "unset")) {
    return false;
  }
  if (primary === "models" && (secondary === "list" || secondary === "status")) {
    return false;
  }
  return true;
}

shouldSkipPluginCommandRegistration：
- 功能：判断是否需要加载插件命令。
- 逻辑：如果当前是内置命令，或者正在查看帮助/版本，则跳过插件加载。
- 意义：性能优化。加载插件涉及文件 I/O 和配置解析，对于简单的内置命令或帮助查看，直接跳过可显著提升响应速度。

export function shouldSkipPluginCommandRegistration(params: {
  argv: string[];
  primary: string | null;
  hasBuiltinPrimary: boolean;
}): boolean {
  if (params.hasBuiltinPrimary) {
    return true;
  }
  if (!params.primary) {
    return hasHelpOrVersion(params.argv);
  }
  return false;
}

2. 核心函数：`runCli(argv)`

这是该文件的主入口，执行流程被严谨地分为以下几个阶段：

第一阶段：环境与配置初始化

// 1. 参数标准化
let normalizedArgv = normalizeWindowsArgv(argv);

// 2. Profile 配置解析
const parsedProfile = parseCliProfileArgs(normalizedArgv);
// ... 应用 profile 环境变量 ...

// 3. 加载 .env 文件与环境标准化
loadDotEnv({ quiet: true });
normalizeEnv();

// 4. 确保 CLI 在 PATH 中 (根据命令类型决定)
if (shouldEnsureCliPath(normalizedArgv)) {
  ensureOpenClawCliOnPath();
}

跨平台处理：首先处理 Windows 参数兼容性。
多环境支持：解析 --profile 参数，允许开发者切换不同的环境配置（如 dev/prod）。
环境注入：加载 .env 文件，确保运行时能读取到敏感配置或环境变量。
运行时守卫：assertSupportedRuntime() 检查 Node.js 版本，过低版本直接报错终止，防止后续出现不可预知的语法错误。

关于normalizeWindowsArgv(argv: string[]):

详见: src/cli/windows-argv.ts

第二阶段：路由拦截

if (await tryRouteCli(normalizedArgv)) {
  return;
}

功能：尝试匹配特殊的路由规则。
意义：这是一个“快捷通道”。某些特殊指令（可能涉及 IPC 通信或特定的守护进程指令）可能不需要完整的 Commander 程序实例，这里直接拦截执行并退出。

第三阶段：日志与异常兜底

enableConsoleCapture(); // 捕获 console.log 转为结构化日志

// 全局异常处理
installUnhandledRejectionHandler();
process.on("uncaughtException", (error) => {
  // ... 格式化错误并退出 ...
});

日志结构化：enableConsoleCapture 拦截全局的 console 输出，将其转化为 OpenClaw 内部的结构化日志格式，便于存储和分析。
防崩溃：注册 unhandledRejection 和 uncaughtException 处理器，防止因一个未捕获的 Promise 错误导致整个 CLI 进程无提示崩溃，提升系统健壮性。

第四阶段：命令注册与组装

这是 Commander.js 框架的初始化过程，采用了延迟加载策略：

构建根程序：buildProgram() 创建 Commander 实例。
注册核心命令：
- 根据参数识别主命令（primary），如 run、tool 等。
- 动态导入并注册该主命令的具体实现（registerCoreCliByName）。
- 注册子命令（registerSubCliByName）。
注册插件命令：
- 如果判断需要加载插件（非帮助、非内置命令），则加载配置文件。
- registerPluginCliCommands 将用户自定义的插件命令注入到 CLI 程序中。

第五阶段：执行

await program.parseAsync(parseArgv);

最终将控制权交给 Commander.js，解析剩余参数并执行对应的命令处理函数。

src/cli/run-main.ts