用途:scripts\Build-NativeGatewayFromSource.ps1 从 openclaw/openclaw 源码构建 OpenClaw,用 openclaw/openclaw-windows-packaging 打包,并注册名为 OpenClawFoundation.OpenClawGateway-<patch> 的开发者模式松散包,提供 openclaw-<patch>.exe 与 clawctl-<patch>.exe 别名。patch 是并行身份槽位,各自拥有独立应用数据、隔离 agent 账户与 Gateway 端口,不影响商店包。
主要能力:支持 -OpenClawRef main 构建最新源码;-OpenClawSourceDirectory 构建本地检出;-OpenClawPackageDirectory 仅用已有 openclaw.tgz + source.json 构建载荷(约 2-3 分钟);-Force 强制重建;-Unregister 卸载注册。首次运行克隆两个仓库到 %SystemDrive%\OpenClawDev\native-gateway-source,约 25-30 分钟。
必要用法:需 Windows 开发者模式、支持隔离会话的 Windows、PowerShell 7.4+、git、.NET SDK 10.0.400+、VS Build Tools(C++ 与 Windows SDK)、Node.js 24.16+、与源码 packageManager 同主版本的 pnpm。示例:pwsh -File .\scripts\Build-NativeGatewayFromSource.ps1 -OpenClawRef main -Patch source。验证用 Get-AppxPackage 与 clawctl-source.exe --version/status --json。Companion 需设置 OPENCLAW_NATIVE_GATEWAY_DEV_PATCH=source 启动。
限制:同一机器同时只能有一个源码构建或卸载操作;工作根目录不得位于用户配置文件下;构建树不可被其他账户写入;注册期间不得移动或删除工作根;载荷与架构相关,需在目标架构构建;预构建包必须含有效提交/哈希/版本元数据。错误信息与处理见原文表格。