夜雨聆风5分钟领虾回家——安装不翻车指南
> AI龙虾创业笔记 · 田野和金豆
上一课说了，小龙虾跟ChatGPT的区别是：一个只动嘴，一个真动手。
今天我们把虾���回家。
我知道你在想什么——"安装？我电脑连个打印机驱动都装不明白。"
别慌。OpenClaw的安装比你想象的简单得多。真的只要一行命令。
但我不会骗你说一帆风顺。90%的人放弃养虾，就是卡在安装这一步。不是因为难，而是因为遇到报错之后不知道怎么办，然后就关了页面假装什么都没发生。
今天我把9个最常见的翻车现场全列出来。你照着做，5分钟装完。翻车了也别慌，往下翻，对症吃药。
### 一行命令，虾就来了
不管你是Mac、Windows还是Linux，核心就一句话：
```bash
npm install -g openclaw
```
没了。这就是安装命令。
"等等，npm是啥？"
好，往回退一步。
### 第零步：装Node.js
npm是Node.js自带的包管理工具。你需要先装Node.js，npm就自动有了。
Mac用户：
```bash
# 方法1：用Homebrew（推荐）
brew install node
# 方法2：没有Homebrew就先装Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node
```
Windows用户：
1. 打开 https://nodejs.org
2. 下载LTS版本（左边那个绿色按钮）
3. 双击安装，一路下一步
4. ⚠️ 安装时勾选"Add to PATH"——这一步别漏！
Linux用户：
```bash
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
```
装完验证一下：
```bash
node -v # 应该显示 v18.x 或更高
npm -v # 应该显示 9.x 或更高
```
看到版本号了？好，下一步。
### 正式安装OpenClaw
```bash
npm install -g openclaw
```
等它跑完（大概1-2分钟），然后：
```bash
openclaw --version
```
如果显示版本号——恭喜你，虾已经到家了。🦞
### 第一次启动
```bash
openclaw
```
第一次启动会问你几个问题：
1. 选择AI模型 —— 推荐先选阿里云百炼（免费90天）或者你有的API
2. 填API Key —— 从对���平台复制过来粘贴就行
3. 选消息平台 —— 先选"终端对话"就行，后面再接Telegram/钉钉
填完之后，它会在你的终端里跟你打招呼。
试着跟它说句话："你好，你是谁？"
它回复你了？好，你的虾活了。
### 国内用户特别通道
如果你在国内，API选择推荐这个顺序：
1. 阿里云百炼（首推）
- 注册送免费额度，足够玩90天
- 访问：https://bailian.console.aliyun.com
- 创建应用 → 获取API Key → 填进OpenClaw
- 模型选 `qwen-max` 或 `qwen-plus`
2. 小主AI中转（性价比王者）
- https://model.ixiaozu.cn
- 支持Claude/GPT全系列，价格是官方的几折
- 对OpenClaw兼容性好（因为我们自己就在用）
3. 本地模型Ollama（完全免费但吃配置）
- 适合有显卡的电脑
- 装上Ollama后，OpenClaw可以直连
- 推荐模型：`llama3.1:8b` 或 `qwen2.5:7b`
- 效果比云端差一些，但完全不花钱
### 9大翻车现场 + 救命药方
以下是我和读者们踩过的所有坑，按出现频率排序：
🔥 翻车1：`npm: command not found`
你Node.js没装好，或者PATH没配。
药方：
```bash
# Mac：用Homebrew重新装
brew install node
# Windows：重新运行Node.js安装包，确保勾选"Add to PATH"
# 装完后关掉命令行窗口重新打开
```
🔥 翻车2：安装时一堆红色报错
大概率是权限问题。
药方：
```bash
# Mac/Linux：加sudo
sudo npm install -g openclaw
# Windows：用管理员身份运行命令提示符
# 右键cmd → "以管理员身份运行"
```
🔥 翻车3：`openclaw: command not found`（装完了但找不到）
npm全局安装路径没加到系统PATH。
药方：
```bash
# 先找到npm全局目录
npm config get prefix
# 把输出的路径/bin加到PATH
# Mac：
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# Windows通常不会有这个问题，如果有，重启电脑
```
🔥 翻车4：Node版本太低
OpenClaw需要Node 18+。
药方：
```bash
node -v # 看看版本
# 如果低于18，升级：
# Mac：
brew upgrade node
# 或者用nvm：
nvm install 18
nvm use 18
```
🔥 翻车5：路径里有中文！！！
这个坑害了无数人。如果你的用户名是中文（比如 `C:\Users\张三\`），很多Node模块会直接崩溃。
药方：
- Windows：创建一个英文名的用户账户，用那个账户装
- 或者修改npm的缓存路径到英文目录：
```bash
npm config set cache "D:\npm-cache"
npm config set prefix "D:\npm-global"
```
- Mac一般不会有这个问题
🔥 翻车6：网络超时（npm install卡住不动）
国内下载npm包经常慢到怀疑人生。
药方：
```bash
# 换淘宝镜像源
npm config set registry https://registry.npmmirror.com
# 再重新安装
npm install -g openclaw
```
🔥 翻车7：`EACCES: permission denied`
Mac/Linux常见，没有写入权限。
药方：
```bash
# 方法1（推荐）：修改npm全局目录权限
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g openclaw
# 方法2（简单粗暴）：
sudo npm install -g openclaw
```
🔥 翻车8：某个依赖编译失败（一堆gyp ERR!）
有些依赖需要本地编译工具。
药方：
```bash
# Mac：装Xcode命令行工具
xcode-select --install
# Windows：装windows-build-tools
npm install --global windows-build-tools
# Linux：
sudo apt-get install -y build-essential python3
```
🔥 翻车9：启动后API连不上
API Key填对了但连不上模型。
药方：
- 检查API Key有没有多余空格
- 检查网络能不能访问API地址（curl测试一下）
- 国内用户如果用OpenAI官方API，需要代理或者中转服务
- 推荐用国内API（百炼/小主）避免网络问题
### 排查万能口诀
记住这个顺序，90%的问题都能解决：
Node版本 ��� PATH环境变量 → 权限 → 网络 → 路径中文 → 编译工具
如果以上都不行——到我们评论区留言，把报错信息贴出来，我帮你看。
### 课后任务
今天只有一个任务：装好OpenClaw，跟它说一句话，截图。
不需要配任何高级功能。就是：
1. 装好Node.js
2. `npm install -g openclaw`
3. `openclaw`
4. 跟它说"你好"
5. 它回复你了 → 成功！🎉
如果翻车了——翻到上面找你的报错，对症吃药。
实在搞不定也别急，评论区见。
### 下课预告
虾是领回家了，但现在它还是个"出厂设置"——不知道你是谁，不知道自己叫什么，跟谁说话都一个味。
第3课：给虾取名字、定性格——它不是工具，是你的搭子。
同样的虾，有人养出了毒舌女助理，有人养出了温柔小管家。你的虾，你来定义。
明天见。🦞
这是「养虾指南」系列第2课，共15课。
关注「AI龙虾创业笔记」，每天一课，从零养出你的AI搭子。