本文将对OpenClaw v2026.5.12如何启动GatewayServer做出源码分析。

   -- package.json   ...   "bin": {	  "openclaw": "openclaw.mjs"   },   ...

    -- openclaw.mjs    ...    if (await tryImport("./dist/entry.js")) {         // OK    }     ...

   -- src/entry.ts   async function runMainOrRootHelp(argv: string[]): Promise<void> {   	  ...   	  try {   	    const { runCli } = await gatewayEntryStartupTrace.measure(   	      "run-main-import",   	      () => import("./cli/run-main.js"),   	    );   	    await runCli(argv);   	  } catch (error) {   	  ...   	  }    }

   -- src/cli/run-main.ts   export async function runCli(argv: string[] = process.argv) {	  ...	  if (!bootstrapProxyBeforeFastPath &&          (await tryRunGatewayRunFastPath(normalizedArgv, startupTrace))		  ) {		      return;	  }	   if (!isHelpOrVersionInvocation) {	      await bootstrapCliProxyCaptureAndDispatcher(startupTrace, {	        ensureDispatcher: shouldUseCliEnvProxy,	      });	   }	    if (	      bootstrapProxyBeforeFastPath &&	      (await tryRunGatewayRunFastPath(normalizedArgv, startupTrace))	    ) {	      return;	    }	    ...   }   async function tryRunGatewayRunFastPath(		  argv: string[],		  startupTrace: ReturnType<typeof createGatewayCliMainStartupTrace>,   ): Promise<boolean> {		   ...		   const [			   ...			    { addGatewayRunCommand },			    ...		  ] = await startupTrace.measure("gateway-run-imports", () =>			    Promise.all([...			      import("./gateway-cli/run.js"),			    ...			    ]),		  );		  ...		  const gateway = addGatewayRunCommand(		    program.command("gateway").description("Run, inspect, and query the WebSocket Gateway"),		  );		  addGatewayRunCommand(		    gateway.command("run").description("Run the WebSocket Gateway (foreground)"),		  );	 	...   }

   --src/cli/gateway-cli/run.ts   export function addGatewayRunCommand(cmd: Command): Command {	  return cmd	  ...	  .action(async (opts, command) => {	     await runGatewayCommand(resolveGatewayRunOptions(opts, command));	  });   }   async function runGatewayCommand(opts: GatewayRunOpts) {...const { startGatewayServer } = await startupTrace.measure("cli.server-import", () =>withProgress(			  { label: "Loading gateway modules…", indeterminate: true },			  async () => import("../../gateway/server.js"),),);...const startLoop = async () =>await runGatewayLoop({			  runtime: defaultRuntime,			  lockPort: port,			  healthHost,			  start: async ({ startupStartedAt } = {}) => {const startupConfigSnapshotReadForThisStart = startupConfigSnapshotReadForNextStart;				startupConfigSnapshotReadForNextStart = undefined;return await startGatewayServer(port, {				  bind,				  auth: authOverride,				  tailscale: tailscaleOverride,				  startupStartedAt,				  ...(startupConfigSnapshotReadForThisStart? { startupConfigSnapshotRead: startupConfigSnapshotReadForThisStart }: {}),});			  },});...   }

--src/gateway/server.tsexport async function startGatewayServer(	  ...args: Parameters<typeof import("./server.impl.js").startGatewayServer>): ReturnType<typeof import("./server.impl.js").startGatewayServer> {	  const mod = await loadServerImpl();	  return await mod.startGatewayServer(...args);}

   --src/gateway/server.impl.ts   ...   const {    ...   } = await startupTrace.measure("runtime.state", () =>    createGatewayRuntimeState({     ...    }),  );  ...

   --src/gateway/server-runtime-state.ts   export async function createGatewayRuntimeState(params: {	 ...	 const httpServer = createGatewayHttpServer({...	 });	 ...	 await listenGatewayHttpServer({				  httpServer: server,				  bindHost: host,				  port: params.port,	 });	 ...   }

    package.json    → openclaw.mjs      → src/entry.ts        → src/cli/run-main.ts  //runCli() tryRunGatewayRunFastPath()          → src/cli/gateway-cli/run.ts   //addGatewayRunCommand()  runGatewayCommand()             → src/gateway/server.ts   //startGatewayServer()                  → src/gateway/server.impl.ts  //startGatewayServer()                      →  src/gateway/server-runtime-state.ts  //createGatewayRuntimeState()                            →  src/gateway//server-http.ts  //createGatewayHttpServer()                                  →  src/gateway/server/http-listen.ts  //listenGatewayHttpServer()