Windows系统内置curl需确认版本≥1803、路径为System32，下载必用-o或-O指定文件，-L处理重定向，-k跳过证书验证（慎用），-C -支持断点续传，-u或-H添加认证凭据。
如果您在Windows系统中需要使用系统自带的curl命令下载远程文件，但发现命令执行失败或无法获取预期结果，则可能是由于curl未正确调用、URL格式不规范或缺少必要参数。以下是实现该操作的具体步骤：
一、确认Windows版本并启用内置curl
Windows 10 1803及更高版本、Windows 11默认集成了curl命令，但需确保功能已启用且未被第三方工具覆盖。系统curl位于System32目录下，优先级高于PATH中其他curl安装。
1、按下Win + R，输入winver，确认系统版本不低于1803。
2、以管理员身份打开命令提示符，执行where curl，检查返回路径是否为C:\Windows\System32\curl.exe。
3、若返回其他路径（如Git Bash或Cygwin的curl），需临时修改PATH或使用绝对路径调用：C:\Windows\System32\curl.exe --version。
二、基础下载命令语法与参数设置
系统curl默认不自动保存响应体，必须显式指定输出文件名，否则内容将直接打印至控制台，可能导致乱码或截断。
1、使用-o参数指定本地文件名：curl -o example.zip https://example.com/file.zip。
2、使用-O参数按远程URL末尾名称自动保存：curl -O https://example.com/data/report.pdf，此时本地文件名为report.pdf。
3、添加-L参数支持HTTP重定向跳转：curl -L -o index.html https://httpbin.org/html，避免因302跳转导致空文件。
三、处理HTTPS证书验证与跳过安全检查
部分自签名或配置异常的HTTPS站点会触发SSL证书校验失败，导致连接中止。系统curl默认启用严格校验，需手动干预才能继续传输。
1、跳过证书验证（仅限可信环境）：curl -k -o test.txt https://self-signed.badssl.com/。
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
2、若需保留证书校验但解决CA缺失问题，可指定Windows根证书存储：curl --cacert "%SystemRoot%\System32\curl-ca-bundle.crt" -o file.bin https://trusted-site.com/binary。
3、警告：-k参数会完全禁用TLS证书验证，暴露于中间人攻击风险，请勿在生产环境或敏感资源下载中使用。
四、断点续传与大文件下载优化
对于网络不稳定或大体积文件，直接重试会导致重复下载。系统curl支持基于HTTP Range头的断点续传，前提是服务端支持Accept-Ranges。
1、首次下载后中断，再次执行相同-o命令时，curl不会自动续传，必须手动追加-C -参数：curl -C - -o large.iso https://mirror.example.com/os.iso。
2、执行前确认目标文件已存在且非空，curl将读取当前文件长度并发送Range: bytes=xxx-请求头。
3、注意：-C -仅对同一URL、同一输出文件路径有效；若修改了-o后的文件名或URL路径，将视为全新下载。
五、带身份验证的资源下载
当目标URL受HTTP Basic或Bearer Token保护时，需在请求头中注入凭据，否则返回401 Unauthorized响应。
1、Basic认证（用户名密码）：curl -u "user:pass" -o secret.json https://api.example.com/v1/data。
2、Bearer Token认证：curl -H "Authorization: Bearer abc123xyz" -o token_data.csv https://service.com/export。
3、若密码含特殊字符（如@、/、:），需对密码部分进行URL编码，例如密码p@ss/wd应写为p%40ss%2Fwd。
