PowerShell Invoke-WebRequest 报错 Invalid URL 和 CommandNotFound 排查指南

1. 确保 PowerShell 以管理员身份运行（右键 PowerShell 图标 → 以管理员身份运行）；
2. 打开浏览器，先验证目标 URL 是否能正常访问（能打开/下载文件说明 URL 本身有效）。

步骤 1：修正 URL，重新下载脚本

写出正确的 URL

以 OpenClawChinese 仓库为例，正确的 jsDelivr URL 格式如下：

# 标准格式（替换为实际的用户名/仓库名/文件路径）
# https://cdn.jsdelivr.net/gh/用户名/仓库名@版本号/文件路径
# 针对本文案例的正确 URL（修正域名 + 规范格式）
https://cdn.jsdelivr.net/gh/OpenClawChinese/main/install.ps1

执行下载命令

# 清空当前目录可能存在的错误文件（可选）
Remove-Item -Path .\install.ps1 -ErrorAction SilentlyContinue

# 执行下载（关键：URL 必须 100% 正确）
Invoke-WebRequest -Uri "https://cdn.jsdelivr.net/gh/OpenClawChinese/main/install.ps1" -OutFile "install.ps1" -UseBasicParsing

这里加上 -UseBasicParsing 参数是为了避免因 IE 浏览器未配置导致的解析错误，这在 PowerShell 5.1 及以下版本比较常见。

如果下载成功，PowerShell 会返回文件的大小、状态码（200 表示成功）等信息。

验证下载结果

执行以下命令，查看当前目录是否有 install.ps1：

# 列出当前目录下的所有 ps1 文件
Get-ChildItem -Path . -Filter *.ps1

# 或直接检查文件是否存在
Test-Path .\install.ps1
# 返回 True 表示存在，False 表示不存在

步骤 2：解决 PowerShell 执行策略限制

即使文件存在，PowerShell 默认也会阻止脚本运行，需临时调整执行策略：

# 查看当前执行策略
Get-ExecutionPolicy -Scope CurrentUser

# 设置为 RemoteSigned（允许运行本地脚本，阻止未签名的远程脚本）
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

执行后输入 Y 确认，执行完成后可根据需求恢复默认策略：

# 恢复为 Restricted（默认值）
Set-ExecutionPolicy -ExecutionPolicy Restricted -Scope CurrentUser

步骤 3：正确执行脚本

方式 1：相对路径执行（推荐）

# 确保当前目录是脚本所在目录（可通过 cd 命令切换）
cd C:\Users\Administrator

# 切换到脚本下载目录
.\install.ps1

方式 2：绝对路径执行（避免目录错误）

若不确定当前目录，直接用绝对路径执行：

# 替换为实际的文件路径
& "C:\Users\Administrator\install.ps1"

& 是 PowerShell 的调用操作符，用于执行指定路径的脚本或程序。

步骤 4：特殊场景：内网/代理环境适配

若你的电脑处于内网或需要代理才能访问外网，需先为 PowerShell 配置代理：

# 设置临时代理（替换为你的代理地址和端口）
$proxyAddress = "http://192.168.1.100:8080"
[System.Net.WebRequest]::DefaultWebProxy = New-Object System.Net.WebProxy($proxyAddress)
[System.Net.WebRequest]::DefaultWebProxy.Credentials = [System.Net.CredentialCache]::DefaultCredentials

# 验证代理是否生效（访问百度）
Invoke-WebRequest -Uri "https://www.baidu.com" -UseBasicParsing

执行完成后，再重新执行下载和脚本运行命令。

四、避坑指南

坑 1：URL 复制时带多余空格

❌ 错误：" https://cdn.jsdelivr.net/gh/xxx/install.ps1"（开头有空格）
✅ 正确："https://cdn.jsdelivr.net/gh/xxx/install.ps1"（无多余字符）

坑 2：混淆 PowerShell 和 CMD 的路径语法

• PowerShell 中路径分隔符用 \，执行本地脚本必须加 .\\（如 .\\install.ps1）；
• 直接写 install.ps1 会优先去系统环境变量路径找，而非当前目录。

坑 3：忽略文件编码问题

若脚本下载后执行报'无法识别的字符'，大概率是编码问题：

# 重新下载并指定编码（以 UTF-8 为例）
Invoke-WebRequest -Uri "xxx" -OutFile "install.ps1" -UseBasicParsing -Encoding utf8

坑 4：忘记管理员权限

部分脚本需要修改系统配置，必须以管理员身份运行 PowerShell，否则会报'权限不足'而非'CommandNotFound'。

坑 5：私有仓库无法访问

jsDelivr 仅支持访问公开的 GitHub 仓库，若目标仓库是私有的，需先将仓库设为公开，或改用 GitHub Raw 地址（https://raw.githubusercontent.com/用户名/仓库名/分支/文件路径）。

五、验证与总结

如何确认问题已彻底解决？

1. 下载阶段：执行 Test-Path .\install.ps1 返回 True；
2. 执行阶段：脚本无'CommandNotFound'报错，能正常输出执行日志或完成功能；
3. 兜底验证：若仍报错，执行以下命令排查：

# 查看脚本文件详情
Get-Item .\install.ps1

# 测试脚本语法（不执行，仅检查语法错误）
powershell -noprofile -command "Get-Content .\install.ps1 | Test-ScriptFileInfo"

总结

1. 核心逻辑：CommandNotFound 是表象，Invalid URL 是根源，先修正 URL 确保脚本下载成功，再解决执行策略或路径问题；
2. 关键步骤：验证 URL 有效性 → 正确下载脚本 → 调整执行策略 → 规范执行脚本；
3. 避坑核心：URL 无拼写错误、执行脚本加 .\\、管理员权限、适配网络环境（代理/内网）。

按照上述步骤操作，99% 的 PowerShell 下载 + 执行脚本报错都能解决。如果仍有问题，优先检查 URL 是否能在浏览器访问、当前目录是否正确，这两个是新手最容易忽略的点。