openclaw安装失败的五大原因及对应解决方案：一、修改powershell执行策略为remotesigned；二、配置git使用https替代ssh协议并清理npm缓存；三、禁用npm ssl校验或配置ca证书路径；四、重置npm全局目录权限；五、切换国内镜像源并跳过可选依赖编译。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试安装 OpenClaw，但命令执行中断、报错退出或 CLI 不可调用，则可能是由于执行策略限制、权限缺失、Node.js 环境异常或网络证书校验失败所致。以下是解决此问题的步骤：
一、修改 PowerShell 执行策略
Windows 默认禁止运行未签名的脚本，而 OpenClaw 安装脚本（install.ps1）属于远程下载的未签名脚本，需调整本地策略以允许其加载。
1、点击 Windows 开始菜单，搜索 PowerShell。
2、在搜索结果中右键点击 Windows PowerShell，选择“以管理员身份运行”。
3、在弹出的管理员窗口中输入命令：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，然后按回车。
4、系统提示确认时，输入 Y 并回车。
二、修复 Git 协议导致的权限拒绝
当 npm 尝试通过 SSH 协议拉取 GitHub 依赖（如 libsignal-node）时，若未配置 SSH 密钥，将触发 Permission denied (publickey) 错误，导致安装中断。
1、打开普通 PowerShell（无需管理员权限）。
2、执行命令：git config --global url."https://github.com/".insteadOf "ssh://git@github.com/"。
3、再执行命令：git config --global url."https://".insteadOf "git://"。
4、清除 npm 缓存：npm cache clean --force。
三、禁用 SSL 证书校验（适用于证书错误）
在 macOS 或部分企业网络环境下，Node.js 可能因无法验证 HTTPS 证书链而报 unable to get local issuer certificate，导致 OAuth 请求或模块安装失败。
1、在终端中运行：npm config set strict-ssl false。
2、若使用 zsh，编辑 ~/.zshrc，追加一行：export NODE_EXTRA_CA_CERTS="/etc/ssl/cert.pem"。
3、执行 source ~/.zshrc 使配置生效。
四、重置 npm 权限与全局目录
npm 全局安装时若因权限问题写入失败（如 EACCES），会导致 openclaw 命令不可用，需修正用户对 npm 全局路径的控制权。
1、执行命令查看当前全局路径：npm config get prefix。
2、运行：sudo chown -R $(whoami) $(npm config get prefix)/lib/node_modules。
3、再执行：sudo chown -R $(whoami) $(npm config get prefix)/bin。
4、验证权限修复：npm install -g openclaw@latest。
五、强制指定镜像源并跳过编译环节
国内网络直连 npm 官方源易出现 ETIMEDOUT 或 sharp 模块编译失败，可通过切换镜像与预编译二进制包规避。
1、设置 npm 镜像：npm config set registry https://registry.npmmirror.com。
2、设置 sharp 镜像：npm config set sharp_binary_host https://npmmirror.com/mirrors/sharp。
3、安装时跳过可选依赖编译：npm install -g openclaw@latest --no-optional。
