L36: 这部分是：Gateway 的 auth.mode: "token" 配置 + device-auth.ts 处理的

L53-L134，先判断是不是main module，如果是，才会执行else里面的部分。避免启动两次导致程序crush。在else的逻辑里

L63-66: respawnWithoutOpenClawCompileCacheIfNeeded 的意思是"如果当前 Node 进程没启用 OpenClaw 的编译缓存，就 spawn 一个新子进程（带缓存），然后父进程退出"

所以waitingForCompileCacheRespawn的返回值含义如下 ：

返回 true → 我是父进程，我在等子进程重启 → 什么都不做，等着退出

返回 false → 我是子进程（或本来就有缓存）→ 不需要等，正常往下走

L67, 意思是，如果不需要等编译就可以直接重启了，那么，做一些初始化的设置，比如process.title='openclaw', 确保openclaw的标记线程被执行（ensureOpenClawExecMarkerOnProcess），安装线程告警过滤器（installProcessWarningFilter），设置环境变量（normalizeEnv），

L75, 在enableOpenClawCompileCache这个方法里，安装Root(installRoot)，

L78，这只是性能打点，记录从进程启动到"bootstrap完成"花了多少毫秒。Gateway 实际启动在很后面：runMainOrRootHelp → runCli(argv) → openclaw gateway run。

L80-82，这里判断的是"是否在执行 secrets audit 命令"

L89-98看openclaw有没有重启计划，如果没有，就执行默认的重启计划。

L100，不是"设置 Windows 环境变量"，而是规范化命令行参数。比如在 WSL 里跑时，路径里的反斜杠 \ 要转成正斜杠 /，Windows 风格的 C:\xxx 要转成 /mnt/c/xxx。

L102-132，如果没有重启计划，解析容器参数，如失败退出；解析文件参数，如失败退出；解析容器target，如果成功，并且文件参数也解析成功，报异常：--container 参数不能和 --profile/--dev 一起使用；如文件参数解析成功，把文件参数赋值给线程参数；gateway启动线程标志argv，

L129，这个处理的是 --version（版本号快速通道），不是 --help。

--help 在 tryHandleRootHelpFastPath 里处理。

逻辑是：先判断是不是 --version，如果是就输出版本号退出；如果不是，才进入 runMainOrRootHelp（里面有 help 分支 + 正常启动分支）。

L136-184，异步执行tryHandleRootHelpFastPath，把help命令输出到客户端的逻辑和过程；

L186-200：异步执行tryHandlePrecomputedCommandHelpFastPath，预计算的逻辑和过程；

L202-226：异步执行runMainOrRootHelp，异步执行主函数启动程序；

不只是"启动程序"。这个函数有三层判断：--help 快速通道 → 子命令 help → 都不是才真正启动。

L212 import("./cli/run-main.js") — 是动态加载 run-main.js 模块到内存（还没执行）

L214 await runCli(argv) — 才是真正开始执行，启动 Gateway

 ├─ isMainModule? ──No──→ 退出（被 import 了，不做任何事）

    ├─ 编译缓存检查 → 需要重启? → spawn 子进程，父进程退出

       ├─ 环境标准化（env, warning filter, runtime guard）

       ├─ 【打点】gatewayEntryStartupTrace.mark("bootstrap")

       ├─ secrets audit? → 设 auth store 只读

       ├─ --no-color?   → 关颜色

       ├─ 有 CLI respawn plan? → 执行 plan，退出

          ├─ 解析 --container, --profile 参数

          ├─ --container + --profile → 报错退出

          ├─ --version? → 输出版本，退出

             ├─ --help? → 输出 help，退出

             ├─ 子命令 help? → 输出，退出

             └─ import runCli → 真正启动 Gateway 

————————————————

正在规划《OpenClaw源码解读》书籍，欢迎出版社编辑交流

openclaw源码解读(1) —— 启动流程：entry.ts从命令行到 Gateway 跑起来

开发工具

后端

编程语言

`auth.mode:"token"`配置下，Gateway通过device-auth.ts判断主模块，防止重复启动。启用编译缓存机制，父进程等待子进程重启后退出。设置进程标识，解析容器参数，处理--version和--help快速通道，最终通过动态加载run-main.js启动Gateway。整体流程包括参数标准化、环境变量设置及异步命令处理。

OpenClaw

Windows

容器

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

`auth.mode:"token"`配置下，Gateway通过device-auth.ts判断主模块，防止重复启动。启用编译缓存机制，父进程等待子进程重启后退出。设置进程标识，解析容器参数，处理--version和--help快速通道，最终通过动态加载run-main.js启动Gateway。整体流程包括参数标准化、...

openclaw源码解读(1) —— 启动流程：entry.ts从命令行到 Gateway 跑起来

openclaw源码解读(1) —— 启动流程：entry.ts从命令行到 Gateway 跑起来

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐