OpenClaw 安装笔记：Node 24 上装到能跑 CLI（2026.7）

在 Windows + Node 24.18 上安装 [email protected]，记录真实命令、allow-scripts 警告，以及 onboard 必须交互终端这件事。

作者 DingfengboOpenClaw2026/7/23更新 2026/7/23#OpenClaw #安装 #CLI

这篇只做一件事：把 OpenClaw 装到本机，确认 CLI 可用。
环境是我这台机器上真实跑过的，不是「请以官方为准」的空话套话。

项	值
日期	2026-07-23
系统	Windows 10/11，PowerShell
Node	`v24.18.0`（`node -v`）
安装版本	`[email protected]`（`0790d9f`）
包说明	npm：`Multi-channel AI gateway with extensible messaging integrations`

官方仓库：openclaw/openclaw。文档站：https://docs.openclaw.ai/（安装页写的是 Node 22.22.3+ / 24.15+ 一类要求，和我这边 24.18 对得上）。

1. 安装

npm install -g [email protected]

也可以跟文档写 openclaw@latest。我钉版本是为了这篇笔记可复现。

实际输出摘要：

added 309 packages in 34s
npm 提示 4 个包有 install scripts，当前策略下 尚未执行（allow-scripts pending），其中包括 openclaw 自己的 preinstall/postinstall
全局 bin 落在：%AppData%\npm\openclaw.cmd

如果你用的是较新的 npm 且默认拦脚本，可能要按提示处理 npm approve-scripts，否则某些插件/本地构建步骤会缺。我这边 CLI 已经能跑，但如果你后面发现 skills/插件异常，优先回头看 postinstall 有没有跑完。

PowerShell 若开启了 Restricted 执行策略，直接敲 openclaw 可能被拦 openclaw.ps1。用：

openclaw.cmd --version
# 或
& "$env:APPDATA\npm\openclaw.cmd" --version

我这边输出：

OpenClaw 2026.7.1-2 (0790d9f)

openclaw.cmd --help 会打印一整页子命令。和安装相关的几个：

命令	用途（以 help 文案为准）
`onboard`	引导配置：auth、模型、Gateway、workspace、channels、skills
`configure`	交互式改凭证、通道、gateway、agent 默认值
`gateway`	跑 / 检查 WebSocket Gateway
`daemon`	装 launchd / systemd / schtasks 服务
`doctor`	健康检查 + 快速修复
`channels`	管理聊天通道
`chat` / `tui`	本地终端对话

直接跑 openclaw（无子命令）时，我得到：

Onboarding needs an interactive TTY.
Use `openclaw onboard --non-interactive --accept-risk ...` for automation.

也就是说：

正常装机：在能交互的终端里跑
openclaw onboard
或文档推荐的
openclaw onboard --install-daemon
脚本/CI：才用 --non-interactive --accept-risk 那一套（help 里有一长串 --auth-choice、--openrouter-api-key 等）

我没有在这篇里跑完交互 onboard（要选模型、填 Key、决定 daemon），所以 不会假装已经配好 Telegram 或写好 SOUL.md。
装完 CLI 之后，你自己的下一步就是：

openclaw onboard --install-daemon
# 按向导填模型与通道
openclaw doctor
openclaw health   # gateway 起来之后

help 里多次出现配置隔离概念：

不要把含 API Key 的状态目录推进公开 git。备份用 CLI 自带的 openclaw backup（help 里有子命令），比自己乱拷靠谱。

PowerShell 执行策略：用 openclaw.cmd，别被 .ps1 挡道。
npm allow-scripts：全局装时给了 pending 警告；CLI 可用，但若后续插件异常，先处理 scripts。
别把 openclaw gateway 当唯一启动方式：长期跑应用 daemon install / onboard --install-daemon；前台调试再用 gateway。
旧站文档里的 openclaw init：当前 2026.7.1-2 的入口更偏向 onboard / configure。以你本机 openclaw --help 为准，不要死抄 2026 年 3 月的通稿。

解决了：
在 2026-07-23，用 Node 24.18，能稳定装上 2026.7.1-2 并跑通 --version / --help。

没解决（下篇或你自己 onboard 时做）：