从踩坑到成功，手把手教你搭建属于自己的 AI 助手

前言

想拥有一个像"贾维斯"一样的个人 AI 助手？OpenClaw（昵称"龙虾"）就是你的不二之选！本文记录了我从零开始安装配置的完整过程，包含所有踩坑点和解决方案，希望能帮到你。

📌 重要说明

• 操作目录
  ：所有命令在 Windows Powershell（管理员） 下执行
• 推荐版本
  ：Node.js v22.14.0（经过验证的稳定版）
• 避坑提示
  ：千万不要在 C:\WINDOWS\system32 下执行命令！

一、环境准备

1. 安装 nvm-windows（Node 版本管理器）

下载地址：https://github.com/coreybutler/nvm-windows/releases下载文件：nvm-setup.exe安装方式：双击安装，全部默认选项即可

2. 安装 Node.js v22.14.0

# 安装指定版本 nvm install 22.14.0  # 切换到该版本 nvm use 22.14.0  # 验证版本 node -v  # 应显示 v22.14.0 npm -v   # 应显示 10.x

⚠️ 踩坑提醒： - 最初尝试 Node.js v20.18.0 失败，OpenClaw 强制要求 Node.js ≥22.12.0 - 如果 nvm install 下载慢，可用淘宝镜像手动下载 ZIP 放入 nvm 目录

3. 配置 npm 国内镜像

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

二、安装 OpenClaw

一键安装脚本（推荐）

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

⚠️ 踩坑提醒： - 如果报错"无法加载文件...禁止运行脚本"，先执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

⚠️ 踩坑提醒： - node-llama-cpp 在 Windows 上编译容易失败，用 --ignore-scripts 跳过 - 跳过不影响使用云端 API（如阿里云、DeepSeek）

三、配置与启动

1. 安装网关服务（只需一次）

openclaw gateway install

添加或修改为：

{   "gateway": {     "mode": "local",     "port": 18789   } }

3. 启动网关

openclaw gateway start

4. 查看访问地址和令牌

openclaw dashboard

浏览器访问显示的 URL，例如：

http://127.0.0.1:18789/?token=你的令牌

四、创建你的第一个 AI Agent

1. 查看现有 agents

openclaw agents list

2. 创建新 agent

openclaw agents add 你的agent名称

3. 配置 API 密钥

系统会提示选择： - 认证方式：根据你的 API 提供商选择（如 Coding-Plan-Global、阿里云等） - 密钥输入方式：选择"直接粘贴"并输入你的 API Key

4. 验证配置

openclaw --agent 你的agent名称 ask "你好"

五、常用命令速查

六、验证成功运行的标志

执行 openclaw gateway start --foreground 后看到类似日志：

11:15:26 [gateway] listening on ws://127.0.0.1:18789 11:15:26 [browser/server] Browser control listening on http://127.0.0.1:18791/

浏览器能正常打开 dashboard 显示的 URL，且界面可交互。

七、常见问题与解决方案

❌ 错误：Cannot find module 'openclaw.mjs'

原因：在错误目录执行命令（如 C:\WINDOWS\system32）解决：切换到用户目录 cd C:\Users\你的用户名

❌ 错误：Node.js v22.12+ is required

原因：Node.js 版本过低解决：nvm install 22.14.0 并 nvm use 22.14.0

❌ 错误：npm error code 3221225477

原因：本地模型编译失败解决：npm install -g openclaw@latest --ignore-scripts

❌ 错误：git@github.com: Permission denied

原因：依赖包尝试用 SSH 克隆解决：

git config --global url."https://github.com/".insteadOf git@github.com: git config --global url."https://".insteadOf git://

❌ 浏览器访问显示"拒绝连接"

原因：网关服务未运行解决：openclaw gateway start 或 openclaw gateway start --foreground 查看错误

❌ 配置文件修改不生效

解决：直接编辑 C:\Users\你的用户名\.openclaw\openclaw.json 后重启网关

📝 最终确认清单

• [ ] Node.js 版本：v22.14.0
• [ ] npm 镜像：https://registry.npmmirror.com/
• [ ] OpenClaw 安装：npm list -g openclaw
• [ ] 网关服务：openclaw gateway status
• [ ] Web 访问：浏览器打开 dashboard URL

💡 写在最后

首次使用需要在网页左下角设置中添加 AI 模型 API Key（如阿里云百炼、DeepSeek、Z.AI 等），之后就可以让"龙虾"帮你干活啦！

从写代码到查资料，从整理文档到自动化任务，OpenClaw 都能成为你的得力助手。快去试试吧！

如果本文对你有帮助，欢迎点赞、收藏、转发！有问题也可以在评论区留言，我会尽力解答。

OpenClaw #AI助手 #Windows安装 #技术教程 #效率工具