2026-03-04 实测可用，版本 2026.3.2
前置条件
安装步骤
1. 配置 PowerShell 执行策略
以管理员身份打开 PowerShell：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
输入 Y 确认。
坑1：不设置会报错
禁止运行脚本，npm 命令无法执行。
2. 配置 npm 国内镜像
npm config set registry https://registry.npmmirror.com
国内直连 npm 官方源很慢或失败，必须换镜像。
3. 安装 Git
从 git-scm.com 下载安装包，一路下一步。
安装完后重启 PowerShell。
坑2：没有 Git 会报
spawn git ENOENT，npm 依赖 git 下载部分包。
4. 安装 OpenClaw（跳过本地编译）
npm install -g openclaw --ignore-scripts
坑3：
node-llama-cpp需要下载 cmake，国内网络会失败。用--ignore-scripts跳过本地模型编译，不影响使用远程 API。
安装约 6 分钟，693 个包。
5. 验证安装
openclaw --version
# 输出: 2026.3.2
6. 运行配置向导
openclaw onboard
按提示配置 API Key，完成后自动打开 Control UI。
7. 手动启动网关
openclaw gateway start
openclaw dashboard
常见问题
| 问题 | 原因 | 解决 |
|---|---|---|
禁止运行脚本 |
PowerShell 执行策略限制 | Set-ExecutionPolicy RemoteSigned |
spawn git ENOENT |
没装 Git | 安装 Git 并重启终端 |
node-llama-cpp 编译失败 |
国内下载 cmake 失败 | 加 --ignore-scripts 跳过 |
| npm 下载慢 | 直连国外源慢 | 配置 npmmirror 镜像 |
参考链接
- 官方文档：https://docs.openclaw.ai
- ClawHub 技能市场：https://clawhub.com
- 社区：https://discord.com/invite/clawd