阔别六年，CSDN，我又回来啦~

话不多说，开干^_^……

---

20260503：卸载并重装小龙虾（因一个语音任务持续卡死把小龙虾搞挂了）：

1. 管理员命令打开powershell，执行如下命令：

iwr -useb https://openclaw.ai/install.ps1 | iex

2. 可以结合自己的喜好，让小龙虾接入一个或多个API开放平台：

（1）接入方式参考正文《6、FAQ》；

（2）国内免费的API Token推荐：https://chat.deepseek.com/share/o49mhqhjinau5pi411；

（3）个人推荐美团的LongCat模型（每天有5000万免费Token）：https://chat.deepseek.com/share/8sybe24bamgw3a8ymw

---

1、安装nodejs（node-v25.8.0-x64.msi）

（1）安装包下载：百度云网盘链接打开下载

https://pan.baidu.com/s/1xSF0w1teCnyCxJhJyEKulA?pwd=2026

（2）安装：点击一键安装

按默认推荐点击“NEXT”即可，注意如下步骤勾选。

（3）验证：win + r打开cmd

输入node -v

输入npm -v

2、安装Git（Git-2.53.0-64-bit.exe）

（1）安装包下载：百度云网盘链接打开下载

https://pan.baidu.com/s/1dv-nlGXE4V8cWFpX6Zif9Q?pwd=2026

（2）安装：点击一键安装

按默认推荐点击“NEXT”即可。

（3）验证：win + r打开cmd

输入git -v

3、安装openclaw

（1）管理员方式打开CMD

（2）配置NPM国内镜像（在CMD中输入命令）

npm config set registry https://registry.npmmirror.com

（3）执行安装命令（在CMD中输入命令）

npm i -g openclaw

（4）出现如下命令即表示安装成功

added 659 packages in 6m

127 packages are looking for funding

run `npm fund` for details

4、openclaw初始配置

（1）管理员方式打开CMD

（2）风险告知

输入openclaw onboard，通过电脑的左右键选择“Yes”

（3）选择 QuickStart 模式

（4）配置 AI 模型 API Key

Model选择“Z.AI（GLM 4.7）”，method选择API key

输入自己的 API Key：

• OpenClaw 需要连接到大语言模型才能工作。Openclaw 比较费token，国外模型成本高，门槛也高，可选择国内的智谱的 GLM 4.7。
• 如果没有智谱的API Key，点击官方地址自己注册账号获取API key：https://www.bigmodel.cn/glm-coding?ic=RBSKXMPNJP
• 智谱的 Key 通常在用户中心里管理：登录后进入 API Keys 页面创建即可。访问下面页面：https://open.bigmodel.cn/usercenter/apikeys
• 没有登录的先登录注册即可，然后点击API Key ， 创建即可。  

（5）选择 AI 模型：

这里我选择默认的GLM 4.7，也是智普当前的旗舰模型。

（6）连接即时通讯平台

（7）选择Skills

这里也选择：No，暂不配置，后面通过UI界面进行配置：

（8）是否开启Hooks

操作步骤：先敲空格，表示选中当前项，再敲回车键

此时它会自动再打开一个命令窗口来启动服务：

（9）打开Web UI界面

浏览器自动打开Web UI界面：

可以测试输入一下内容：

5、openclaw使用

（1）启动网关（win+r打开cmd）

输入openclaw gateway

（2）将第一次浏览器打开的网页地址保存，直接打开刷新即可

（3）如果未保存网址，可通过命令行打开（win+r打开cmd）

输入openclaw dashboard，复制网址浏览器打开即可使用

6、FAQ

（1）openclaw模型更换

（2）一、Node.js 安装相关错误

1. 安装后命令行无法识别 node / npm

错误表现：在 CMD 中输入 node -v 或 npm -v，提示"node不是内部或外部命令"

原因分析：Node.js 安装时未勾选"Add to PATH"选项，或环境变量未正确配置

解决方案：

• 方法一：重新运行 node-vxx.xx-x64.msi 安装包，选择"Modify"，勾选"Add to PATH"选项
• 方法二：手动添加环境变量
•    - 右键"此电脑" → 属性 → 高级系统设置 → 环境变量
•    - 在系统变量中找到"Path"，双击编辑
•    - 添加路径：C:\Program Files\nodejs\
•    - 重启 CMD 后验证：node -v

2. Node.js 版本不兼容

错误表现：npm install 报错，提示某些原生模块编译失败或版本不支持

原因分析：OpenClaw 对 Node.js 版本有要求，建议使用 Node.js 18+ 或 LTS 版本

解决方案：

• 推荐安装 Node.js 18 LTS 或 20 LTS 版本
• 下载地址：https://nodejs.org/
• 验证版本：node -v

（3）、npm 安装相关错误

1. npm install 报错 permission denied / EACCES

错误表现：npm i -g openclaw 报错，提示权限拒绝或 EACCES 错误

原因分析：Linux/macOS 系统下，全局安装需要 sudo 权限；Windows 下可能因杀毒软件阻止

解决方案：

• Windows：以管理员身份运行 CMD
• macOS/Linux：使用 sudo npm i -g openclaw
• 或配置 npm 全局目录到用户目录

npm config set prefix "~/.npm-global"

2. npm install 报错 registry error / ETIMEDOUT

错误表现：npm install 失败，提示连接 registry.npmjs.org 超时

原因分析：网络问题，访问 npm 官方源速度慢或被防火墙拦截

解决方案：

• 配置国内镜像源（推荐）：
• npm config set registry https://registry.npmmirror.com
• 配置完成后重新执行安装命令

3. npm install 报错 EINTEGRITY / checksum 对不上

错误表现：npm install 报错，提示 EINTEGRITY 或 checksum 校验失败

原因分析：npm 缓存损坏或网络传输导致文件损坏

解决方案：

• 清理 npm 缓存：npm cache clean --force
• 删除 node_modules（如有）和 package-lock.json
• 重新执行 npm install

（4）、OpenClaw 特定错误

1. openclaw command not found

错误表现：安装成功后，输入 openclaw 命令提示找不到命令

原因分析：Node.js 全局 bin 目录未加入 PATH 环境变量

解决方案：

• 重新运行 Node.js 安装程序，勾选"Add to PATH"
• 或手动添加 npm 全局 bin 路径到环境变量
•    - 获取 npm 全局路径：npm config get prefix
•    - 将得到的路径下的 bin 目录添加到 PATH

2. openclaw onboard 报错 / 无响应

错误表现：输入 openclaw onboard 后程序无响应或报错退出

原因分析：可能是 API Key 配置问题、网络连接问题或配置文件损坏

解决方案：

• 检查 API Key 是否正确配置
• 确保网络可以正常访问 AI 模型服务商
• 删除配置文件后重新运行 openclaw onboard
•    - 配置文件位置：~/.openclaw/config.json

3. 启动网关报错 openclaw gateway

错误表现：输入 openclaw gateway 后报错或闪退

原因分析：端口被占用、配置文件错误或权限不足

解决方案：

• 检查端口占用：netstat -ano | findstr :18792
• 如端口被占用，修改 OpenClaw 配置文件中的端口
• 以管理员身份运行 CMD
• 检查配置文件：~/.openclaw/config.json

4. Web UI 无法打开 / 空白页面

错误表现：浏览器打开 OpenClaw Web UI 地址，显示空白或连接失败

原因分析：网关未启动、防火墙拦截或浏览器缓存问题

解决方案：

• 确保 OpenClaw 网关已启动：openclaw gateway
• 检查防火墙设置，允许 openclaw 相关的程序通过
• 清除浏览器缓存或使用无痕模式尝试
• 尝试其他浏览器（Chrome / Edge / Firefox）

（5）、AI 模型配置相关错误

1. API Key 无效 / 认证失败

错误表现：OpenClaw 连接 AI 模型时报错，提示 API Key 无效或认证失败

原因分析：API Key 填写错误、Key 已过期或账户余额不足

解决方案：

• 登录 AI 模型服务商后台检查 API Key 是否正确
• 确认账户有足够余额或套餐额度
• 重新生成 API Key 并更新到 OpenClaw 配置中

2. 模型调用超时 / 请求失败

错误表现：AI 模型响应慢或提示请求失败

原因分析：网络问题、模型服务端负载过高或触发了限流

解决方案：

• 检查网络连接是否稳定
• 等待一段时间后重试，避免限流触发
• 考虑更换其他 AI 模型服务商

（6）、Windows 系统特定问题

1. npm install 报 ENOENT 错误

错误表现：npm install 报错，提示 ENOENT: no such file or directory

原因分析：路径过长、临时文件夹权限问题或磁盘空间不足

解决方案：

• 清理临时文件夹：%TEMP%
• 确保磁盘有足够空间（建议至少 5GB 可用空间）
• 将项目目录移动到更短的路径下

2. 杀毒软件误报拦截

错误表现：npm install 或 openclaw 相关程序被杀毒软件拦截删除

原因分析：部分杀毒软件对 Node.js 相关工具存在误报

解决方案：

• 临时关闭杀毒软件后重新安装
• 将 Node.js 和 npm 添加到杀毒软件白名单
• 安装完成后恢复杀毒软件

（7）、通用排查流程

1. 检查 Node.js 版本：node -v，npm -v

2. 检查网络连接：ping npmjs.org

3. 清理缓存后重试：npm cache clean --force

4. 以管理员身份运行 CMD

5. 查看详细错误日志：npm install --verbose

6. 查看 OpenClaw 官方文档或社区获取帮助