windows安装openclaw保姆级别教程
官方链接与安装文档
欢迎来到openclaw Windows安装指南！这份教程将带你一步步完成安装，避开那些常见的坑。先说几个核心要点：准备工作要做足，配置环节要细心，遇到报错别慌张。
首先，这是openclaw的官方安装链接：
openclaw安装前需要的基础软件
想要顺利安装openclaw，得先把这几个基础软件准备好：
- Node.js 22或更高版本（推荐LTS版）
- CMake构建工具
- Git版本控制系统
- GitHub账户
- Microsoft Visual C++运行库
需要注意的是，如果程序列表里已经显示安装了Microsoft Visual C++，那就说明这一步已经搞定了。
Node.js和CMake的安装相对简单，基本上就是一路“下一步”就行。Git安装后如果还提示找不到git命令，别急，把PowerShell或者CMD关掉重新打开试试。
Git这边有个关键步骤——需要在GitHub上配置SSH密钥。这步做好了，后续的安装会顺畅很多。
GitHub SSH密钥配置
本地生成密钥
操作其实很简单：按下Windows键+R，输入cmd进入命令提示符，或者输入powershell进入PowerShell。
在Windows系统里，SSH目录通常位于C:\Users\admin.ssh这个路径下。
输入这个命令：ssh-keygen -t rsa -b 4096 -C "你的邮箱"，然后连续按几次回车，就像上图展示的那样。找到图中红圈标注的sha256后面的密钥，复制下来准备添加到GitHub。
获取SSH公钥内容后，需要把查询出的公钥添加到GitHub设置中：
GitHub上添加SSH密钥
这里有个小细节：Title字段不能设置为中文。
本地检查是否设置成功
输入命令：ssh -T git@github.com
如果返回结果里显示“you've successfully authenticated...”，那就恭喜你，GitHub配置已经大功告成了！
openclaw安装时的常见报错
安装openclaw时，日志文件会保存在这个目录：C:\Users\admin\AppData\Local\npm-cache_logs
GitHub没有配置SSH密钥导致无法访问仓库
这个错误信息比较长，核心问题是权限被拒绝：
3317 error git@github.com: Permission denied (publickey).
3317 error fatal: Could not read from remote repository.
这意味着SSH密钥没有正确配置，GitHub不认识你的设备。
提示没有安装Git
另一个常见问题是系统找不到Git：
3304 error syscall spawn git
3305 error path git
3306 error errno -4058
这种情况通常是Git没有正确安装，或者环境变量没有配置好。
继续安装openclaw
基础环境配置妥当后，就可以正式安装openclaw了：
npm install -g openclaw@latest
安装成功的标志是看到类似的完成提示：
运行初始化并注册守护进程
接下来执行初始化命令：
openclaw onboard --install-daemon
为了快速上手，建议先选择QuickStart模式。
选择模型提供商时，为了快速测试，直接选择Qwen是最方便的：
选择完成后，浏览器会自动弹出登录页面：
可能有朋友会问：为什么没有支付宝或者手机号登录方式？其实原因很简单——openclaw作为开源工具，其默认的Qwen配置指向的是国际版API。国际版通常提供的是Google账号、GitHub账号等登录方式，而不是国内的支付平台或手机号。
选择Qwen主要是因为门槛低，容易上手。国际版往往还提供针对开发者的免费试用额度，比如每天2000次请求。后续完全可以更换模型供应商，当前的目标是先搭建起来跑通流程。
完成登录后回到控制台，选择具体模型时，用默认的就行：
下一步选择渠道，这里可以先跳过，因为这一步后面会详细说明。当前目标还是先完成安装并跑通流程：
选择是否配置skills，建议选“是”：
下一步询问是否启用Hooks（钩子/插件），建议选择session-memory。这个功能能让AI记住之前的对话内容，即使关闭终端重新打开，也能延续之前的话题。
基本配置到此结束。下一步询问如何孵化小机器人，直接选择推荐的方式，使用TUI完成最后一步：
配置完成！
访问上面图片中的地址即可开始使用。
常用openclaw命令
掌握这几个命令，日常使用就足够了：
openclaw config - 修改配置
openclaw update - 升级
openclaw doctor - 诊断问题
openclaw gateway restart - 重启gateway
查看运行状态：
openclaw status
启动/停止Gateway：
openclaw gateway start
openclaw gateway stop
访问聊天界面：在浏览器中打开 http://127.0.0.1:18789/chat
最后提醒一下：首次初始化强烈建议使用QuickStart模式，后续可以通过openclaw configure调整配置。为了保证稳定运行，推荐开启守护进程模式，并定期运行openclaw doctor --deep做健康检查。这样既能保证系统稳定性，又能及时发现问题。