src/entry.tssrc/entry.ts是 OpenClaw 项目的主入口文件。它的核心职责是作为命令行工具的“

src/entry.ts是 OpenClaw 项目的主入口文件。它的核心职责是作为命令行工具的“引导程序”，负责环境初始化、进程管理、参数预处理，并最终启动核心业务逻辑。

这是一个工业级 CLI 应用的标准实现，包含了完善的错误处理、性能优化和跨平台兼容逻辑。以下是详细的功能模块解析：

1. 主模块保护机制

if (!isMainModule({ currentFile: ..., wrapperEntryPairs: ... })) {
  // 跳过所有入口逻辑
} else {
  // 执行初始化...
}

功能：防止代码被重复执行。
背景：在现代 Node.js 打包过程中，entry.js 可能会被其他脚本作为依赖导入。如果没有这个保护，导入时会再次触发 CLI 启动逻辑，导致端口冲突或重复运行。
逻辑：通过检查当前文件是否为“主模块”，决定是执行引导逻辑还是仅导出模块。

2. 运行环境初始化

在确认是主入口后，代码依次执行以下初始化操作：

process.title = "openclaw"：设置进程名，方便用户在系统任务管理器或 ps 命令中识别。
installProcessWarningFilter()：安装警告过滤器，屏蔽无关或干扰性的 Node.js 内部警告，保持控制台整洁。
normalizeEnv()：标准化环境变量，处理跨平台差异（如大小写问题）。
enableCompileCache()：启用 V8 编译缓存（Node.js 新特性），加速后续启动速度。包裹在 try-catch 中确保即使不支持也不影响启动。

3. 安全与配置预处理

shouldForceReadOnlyAuthStore：
- 场景：当用户执行 openclaw secrets audit（审计密钥）命令时。
- 作用：强制将 OPENCLAW_AUTH_STORE_READONLY 设为 1。这是一个安全防护措施，确保在审计密钥的过程中，程序绝对没有权限修改密钥存储，防止误操作或恶意篡改。
颜色控制：检测 --no-color 参数，统一设置 NO_COLOR 和 FORCE_COLOR 环境变量，确保子进程和日志库遵循用户的颜色偏好。

4. 核心机制：实验性警告抑制与进程重孵化

这是代码中最复杂的部分，用于优雅地处理 Node.js 的实验性 API 警告。

function ensureExperimentalWarningSuppressed(): boolean {
  // ... 检查是否已经抑制过警告 ...
  
  // 设置环境变量标记，防止无限重孵化
  process.env.OPENCLAW_NODE_OPTIONS_READY = "1";
  
  // 使用 spawn 启动一个新的子进程
  const child = spawn(
    process.execPath,
    [EXPERIMENTAL_WARNING_FLAG, ...process.execArgv, ...process.argv.slice(1)],
    { stdio: "inherit", env: process.env }
  );
  
  // 桥接子进程的信号，让用户感觉像是在操作同一个进程
  attachChildProcessBridge(child);
  
  // 父进程退出，让子进程接管
  return true; 
}

痛点：Node.js 在使用实验性功能（如 --experimental-modules 等）时会打印大量警告信息，干扰用户体验。且 --disable-warning 参数通常不能通过 NODE_OPTIONS 环境变量设置。
解决方案：
1. 程序首次启动时，检测是否已经抑制了警告。
2. 如果没有，“自我重孵化”：启动一个新的 Node.js 进程，并带上 --disable-warning=ExperimentalWarning 参数。
3. 父进程等待子进程结束并同步退出状态码。
4. 效果：用户执行命令时，实际上是启动了一个更“安静”的子进程来运行核心逻辑，但对用户透明。

5. 快速路径优化

为了避免加载庞大的 CLI 框架，代码针对简单命令进行了“短路”处理：

tryHandleRootVersionFastPath：
- 命令：openclaw -v 或 openclaw --version。
- 优化：仅动态加载 version.js 和 git-commit.js，直接打印版本号后退出。无需加载 Commander 或业务逻辑，响应速度极快。
tryHandleRootHelpFastPath：
- 命令：openclaw -h 或 openclaw --help。
- 优化：仅加载构建帮助信息的必要模块，打印帮助文档后退出。

6. 最终启动流程

如果通过了上述所有检查和优化，程序进入正式启动阶段：

process.argv = normalizeWindowsArgv(process.argv); // 处理 Windows 参数兼容性

if (!ensureExperimentalWarningSuppressed()) { // 如果不需要重孵化
  // 1. 解析 Profile 参数（针对不同环境配置）
  const parsed = parseCliProfileArgs(process.argv);
  // ... 错误处理 ...
  
  // 2. 应用 Profile 环境
  if (parsed.profile) {
    applyCliProfileEnv({ profile: parsed.profile });
  }

  // 3. 启动主程序
  import("./cli/run-main.js")
    .then(({ runCli }) => runCli(process.argv))
    // ... 错误处理 ...
}