夜雨聆风本文用图文方式将windows下原生系统的openclaw安装和配置免费版大模型过程详细记录下来，最终得到一个能够通过本地网页访问的OpenClaw系统，图文+踩坑经验集合，即使是小白一步一步跟着做就能在windows上部署成功。文末有小彩蛋（OpenClaw文件存储目录统计）
前期准备
大模型API key
在openclaw安装完成之后，需要接入大模型（例如：deepseek，阿里云百炼，腾讯，openAI等大模型）才能使用人工智能功能，所以在开始之前需要准备好。在配置大模型供应商后，openclaw要与大模型后台通信进行鉴权认证，认证通过后才能继续配置。
API key是你访问大模型的凭证，一定要保护好，避免泄露。
千问免费版体验大模型不需要你准备API key，但需要你先以下网站注册用户，在后续大模型认证步骤中使用。
网址：https://www.qianwen.com/
网络
在安装过程中会涉及从git/npm仓库下载安装包，保持网络通畅即可，能科*学上*网最好，不能科*学上*网也没关系，安装时间可能会长一些，中间如果因为下载超时失败可以多尝试几次，换闲时（比如早上）进行安装。
硬件推荐配置
使用云端大模型的前提下硬件推荐配置为：
CPU 2核或更高
内存 32GB或更高
存储 10GB 或更高
网络 稳定网络连接，公网带宽大于千兆（如果对外提供API服务）
请注意：以上要求仅针对 OpenClaw 框架本身。在这种模式下，实际的 AI 推理工作会通过 API 调用云端服务（如 OpenAI、Claude 等）完成，因此本地计算压力很小。
安装过程
1 安装node
从https://nodejs.org/en/download下载windows 安装镜像，版本不低于22即可。iwr命令会检查node版本，如果没有安装或者版本号小于22，会下载安装（用winget/Chocolatey/Scoop进行尝试），只有安装失败后才会提示用户自行安装。选择LTS（稳定版本下载）
安装Node.js
Next->install->Finish即可完成安装。
2 安装git
从https://git-scm.com/install/windows 下载windows git安装包
双击下载文件安装。
一路Next->install->Finish完成安装
3 准备访问大模型API key
如果不使用免费版通义千问，则需要自己准备收费版大模型API key，笔者购买了阿里百炼的Coding plan套餐和deepseek 充值套餐，下面是阿里百炼界面。
访问大模型的API key在配置后端大模型时使用，初学者/尝鲜者建议用包月方式购买套餐，推荐各平台的coding plan，性价比很高。我用的是阿里的coding plan Lite基础版，腾讯等公司也有对应的包月套餐，可以防止token超用造成损失。
从你使用的大模型后台获取API key。
在阿里云百炼平台，点击“我的订阅”，下面获得BaseURL和API key。（其他平台的BaseURL和API key获取方式大同小异）。
打开”我的订阅“，记下API Key和BaseURL，后续配置要使用到。
4 用管理员权限运行powershell
如果不用管理员权限，安装过程中会报权限相关错误。
5 解除powershell安全限制
注意：powershell要提前进行如下设置解锁powershell的安全设置,如果出现确认都输入Y确定。
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
6 git设置
git config --global url."https://github.com/".insteadOf ssh://git@github.com/
7 运行安装命令
powershell -c "irm https://openclaw.ai/install.ps1 | iex"
8 配置openclaw
第一步选择Yes
选择QuickStart
选择通义千问免费体验版本
把这个连接粘贴到浏览器地址栏（一般会触发浏览器自动打开这个网址）
登录千问
点击confirm
选择KeepCurrent，免费大模型
Select channel选择 Skip for now（后面在接入QQ,企业微信，飞书，钉钉部分再配置）
Search Provider 选择Skip for now（后续接入免费tavily search）
跳过skills安装，后续再根据需求安装。
Enable hooks按空格键选择跳过
自动安装gateway服务
把Dashboard URL 粘贴到浏览器查看web UI对话框。（如果打不开，需要等gateway启动完成，也可以运行openclaw doctor进行问题检查）（注意：这里要保持电脑插着电源，否则可能启动不了服务）
Web UI 窗口，至此一个免费体验Openclaw的本地实例就安装部署完成了。
安装踩坑集合
安装日志显示权限不够
解决方法：
1.右键点击powershell图标 用管理员权限运行powershell。
把你的%USERPROFILE%\AppData\Roaming\npm目录只读选项去掉，再进行重新安装。
错误信息：
warn cleanup Failed to remove some directories [
4415 warn cleanup [
4415 warn cleanup '\\\\?\\C:\\Users\\Administrator\\AppData\\Roaming\\npm\\node_modules\\openclaw\\node_modules\\@octokit',
4415 warn cleanup [Error: EPERM: operation not permitted, rmdir 'C:\Users\Administrator\AppData\Roaming\npm\node_modules\openclaw\node_modules\@octokit\webhooks\dist-types\middleware'] {
4415 warn cleanup errno: -4048,
4415 warn cleanup code: 'EPERM',
4415 warn cleanup syscall: 'rmdir',
4415 warn cleanup path: '
解开powershell安全防御机制：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
Git 错误
解决办法在安装powershell界面执行：
git config --global url."https://github.com/".insteadOf ssh://git@github.com/
错误信息：
3710 verbose stack at async RetryOperation._fn (C:\Users\Administrator\AppData\Roaming\npm\node_modules\npm\node_modules\@gar\promise-retry\lib\index.js:11:24)
3711 error code 128
3712 error An unknown git error occurred
3713 error command git --no-replace-objects ls-remote ssh://git@github.com/whiskeysockets/libsignal-node.git
3714 error git@github.com: Permission denied (publickey).
3714 error fatal: Could not read from remote repository.
3714 error
3714 error Please make sure you have the correct access rights
3714 error and the repository exists.
npm告警
安装完成后报告glob版本过低，这是openclaw使用的组件版本低，等后续openclaw更新即可。
npm warn deprecated node-domexception@1.0.0: Use your platform's native DOMException instead
npm warn deprecated glob@10.5.0: Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me
安装完成后web UI 报错，打不开
解决方案：
1.在windows下要确保电脑连接电源，使用电脑电池供电时不能试用gateway服务。windows任务计划程序中，openclaw启动条件默认是交流电供电时才能运行。
2.运行openclaw doctor进行检查，按照检查后提示进行修正后再启动gateway。
openclaw doctor
openclaw gateway start
npm error code 128 错误
网络连接不稳定，进行重试。笔者的经验是多重试几次就能成功。
npm error An unknown git error occurred
npm error command git --no-replace-objects ls-remote ssh://git@github.com/whiskeysockets/libsignal-node.git
npm error fatal: unable to access 'https://github.com/whiskeysockets/libsignal-node.git/': Failed to connect to github.com port 443 after 21049 ms: Could not connect to server
npm error A complete log of this run can be found in: C:\Users\Administrator\AppData\Local\npm-cache\_logs\2026-03-11T01_40_39_444Z-debug-0.log
小彩蛋：openclaw 运维常用命令与文件路径
1.常用命令
openclaw status
openclaw status --all
openclaw gateway probe
openclaw gateway status
openclaw doctor
openclaw channels status --probe
openclaw logs --follow
2.windows原生安装后openclaw相关文件存放位置
OpenClaw的所有核心文件、配置和数据都集中存储在用户主目录下的 .openclaw 隐藏文件夹中，这个目录相当于OpenClaw的“大脑”，你可以通过路径 %USERPROFILE%\.openclaw\ 快速访问它。需要注意的是，如果你是通过联想等第三方工具一键部署的，安装路径可能会有所不同（例如在 C:\ProgramData\Lenovo\baiying\OpenClaw\），但这属于特殊情况。
(1)%USERPROFILE%\.openclaw:这里存放的是属于你个人的、动态生成或修改的所有数据。
(2)%USERPROFILE%\AppData\Roaming\npm\node_models\openclaw 这里是OpenClaw 通过 npm 全局安装后的代码所在目录。
(3）%USERPROFILE%\.openclaw\logs\这里记录了用户通过openclaw进行的配置日志，用户进行配置回溯。
当龙虾完全启动不了，无法通过对话框让agent进行自动排障，此时需要人肉进行日志分析。
(4)修改龙虾运行输出日志级别为debug，文件：%USERPROFILE%\.openclaw\openclaw.json（%USERPROFILE%的值可以在powershell执行$evn:USERPROFILE得到），然后重启gateway
在openclaw.json配置文件中的顶层配置logging级别为debug（。
"logging": {
"level": "debug",
"consoleLevel": "info"
}
(5)openclaw的实时运行日志:%USERPROFILE%\AppData\Local\Temp\openclaw,例如在这个文件夹下实时日志:openclaw-2026-03-14.log
记住这些位置，龙虾卸载后要重点检查这几个位置确保删除干净。
