OC
LingYunCX · OpenClaw Guide
一键脚本 · 官方包装安装 · 最终健康检查
OpenClaw 安装教程

从 0 到可用，
一次装完。

这个页面提供 macOS 与 Windows 的一键安装脚本。脚本会优先复用你机器上已存在的环境， 缺什么补什么，最后自动进入 OpenClaw 的 onboarding、Gateway 校验与控制台打开流程。

macOS 自动调用官方 install.sh，补做 onboarding、gateway status、health 与 dashboard。
Windows 自动调用官方 install.ps1，补做 PATH 刷新、onboarding 与安装后的最终验证。
一键复制 页面内每个平台都提供一条命令直接下载并执行脚本，适合文档与工单场景直接转发。

一键安装命令

直接复制即可。macOS 在 Terminal 中执行；Windows 请在 PowerShell 中执行，若使用 Windows Terminal，请确保当前标签页是 PowerShell。

Windows 安装
统一入口，先下载 .ps1 到临时目录，再在当前 PowerShell 会话中执行；安装完成后当前窗口可直接使用 openclaw。
Windows
Latest Command
最新命令（推荐）：先下载脚本文件，再绕过执行策略限制执行该文件。
try{[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12 -bor [Net.SecurityProtocolType]::Tls11}catch{[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12};$p="$env:TEMP\install-openclaw-windows.ps1";(New-Object System.Net.WebClient).DownloadFile('https://www.lingyuncx.com/openclaw/install-openclaw-windows.ps1',$p);Unblock-File -Path $p -ErrorAction SilentlyContinue;powershell -ExecutionPolicy Bypass -File $p
Windows 脚本地址： https://www.lingyuncx.com/openclaw/install-openclaw-windows.ps1

安装过程会做什么

你不需要自己逐步判断机器状态。脚本会先补齐必要环境，再调用官方安装器，最后执行本地校验并尝试打开控制台。

01

检查系统与基础环境

识别 macOS 或 Windows，校验当前 shell、网络连通性和 OpenClaw 官方安装器下载能力。

02

调用官方安装器

Windows 无包管理器时会先补齐 Node.js 22 便携版，再进入 OpenClaw 官方安装器；随后由官方流程安装 OpenClaw CLI，并把命令暴露给当前 PowerShell 会话。

03

进入 Onboarding

若本机尚未完成配置，脚本会继续执行 openclaw onboard --install-daemon。

04

验证 Gateway 可用

自动执行 openclaw gateway status、openclaw status --deep、openclaw health --json，并尝试打开控制台。

详细使用过程

如果你要把这个教程发给同事，直接让他按下面流程做即可，不需要再补口头说明。

标准流程

  1. 打开当前系统的终端：macOS 用 Terminal；Windows 用 PowerShell，若使用 Windows Terminal，请切到 PowerShell 标签页。
  2. 复制页面上方对应平台的一键命令并执行。
  3. 如果系统弹出权限、管理员确认或软件安装提示，按提示允许继续。
  4. 脚本启动 OpenClaw onboarding 后，按向导完成模型授权、Gateway 选项和可选渠道配置。
  5. 脚本结束时，浏览器应自动打开 OpenClaw 控制台；若未自动打开，可手动访问 http://127.0.0.1:18789/。
下载 macOS 脚本 下载 Windows PowerShell 脚本

安装完成后检查

  • openclaw --version 能输出版本号。
  • openclaw gateway status 返回正常状态。
  • openclaw status --deep 能显示更完整的本地状态。
  • openclaw health --json 能输出健康检查 JSON。
  • 控制台页面 http://127.0.0.1:18789/ 可访问。
  • Windows 场景下，页面顶部只保留一条统一入口命令，并且直接在当前 PowerShell 会话中执行。

常见问题

这些问题不需要你重新找文档，先按这里处理即可。

macOS

  • 如果要求安装 Xcode Command Line Tools，先完成系统弹窗，再回到终端继续。
  • 如果 Homebrew 刚装好但当前 shell 还没刷新，重新开一个 Terminal 再执行一次脚本。
  • 如果 Gateway 状态异常，先执行 openclaw doctor --repair，再重试 openclaw gateway status。

Windows

  • 统一使用页面顶部的 PowerShell 一键命令，不再提供其他启动入口。
  • 如果出现 SSL/TLS 通道错误，优先确认系统时间正确，并直接使用页面上的最新“下载后执行”命令，不要复用旧版示例。
  • 新入口先把脚本下载到临时文件，再在当前会话执行该文件，不再启动额外的子 PowerShell。
  • 脚本内部仍会自动处理 TLS 协议设置，并在下载 OpenClaw 官方安装器失败时回退到 WebClient。
  • 如果 Node 或 PATH 刚更新但当前窗口没感知，关闭后重新打开终端，再重新执行一次脚本。
  • 如果需要更稳定的开发体验，官方复杂场景仍更推荐 WSL2。