乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > OpenClaw新手2026安装全攻略,细数5大血泪教训

OpenClaw新手2026安装全攻略,细数5大血泪教训

当前时间： 2026-03-16 17:03:10 分类：办公文件 评论(0)
OpenClaw新手2026安装全攻略,细数5大血泪教训
> 作者：一个在 Mac mini 上折腾了一下午的勇士
> 特别鸣谢：DeepSeek（我的精神支柱和代码外挂）
---

## 📖 写在前面

如果你点开了这篇文章，说明你也想在这个 AI 时代拥有一只属于自己的“龙虾”——一个能24小时待命、会写代码、能处理文档、还不用发工资的 AI 助手。
但是，作为一个刚从“curl: (7) Failed to connect”中爬出来的人，我必须诚实地告诉你：**安装 OpenClaw 就像煮龙虾，看着很诱人，但前期处理有点扎手。**
别怕，跟着这份攻略，我保证你从“网络超时”到“飞书聊天”只需要一杯咖啡的时间。
---

## 🎯 第一章：准备工作（别急着下锅）

### 1.1 检查你的“锅”——Mac mini 4

首先，确认你有一台 Mac（Intel 或 Apple Silicon 都行）。我用的是 Mac mini 4，这玩意儿当服务器简直完美——安静、省电、24小时不关机也不心疼电费。

### 1.2 安装 Homebrew（这次别再超时了）

如果你之前没装过 Homebrew，或者像我一样遇到了 `Recv failure: Operation timed out` 的经典错误，请直接使用**国内镜像源**：
```bash

设置中科大镜像（感谢中国科学技术大学！）

export HOMEBREW_INSTALL_FROM_API=1
export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"

一键安装

/bin/bash -c "$(curl -fsSL https://mirrors.ustc.edu.cn/misc/brew-install.sh)"
```
**为什么要这一步？** OpenClaw 依赖 Node.js，而 Homebrew 是 Mac 上最好的包管理器，没有之一。

### 1.3 安装 Node.js

```bash
brew install node@22
node -v

应该显示 v22.x.x

```
---

## 🚀 第二章：安装 OpenClaw（真正的考验来了）

### 2.1 一键安装（理想情况）

```bash
curl -fsSL https://openclaw.ai/install.sh | bash
```

### 2.2 遇到npm install failed 怎么办（现实情况）

如果你和我一样，大概率会遇到这个：
```
! npm install failed for openclaw@latest
```
**别慌！** 这是 `sharp` 模块在搞事情。解决方案有三：
**方案A：配置淘宝镜像重试**
```bash
npm config set registry https://registry.npmmirror.com
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
```
**方案B：用 pnpm（推荐）**
```bash
npm install -g pnpm
pnpm setup
source ~/.zshrc
pnpm add -g openclaw@latest
```
**方案C：如果遇到 SSH 权限错误**
```bash
git config --global url."https://github.com/".insteadOf git@github.com:
pnpm store prune
pnpm add -g openclaw@latest
```
**我的血泪教训：** pnpm 比 npm 靠谱多了，强烈推荐方案B！
---

## 🔧 第三章：配置 Gateway（让龙虾醒过来）

安装成功后，第一件事就是配置 Gateway：

### 3.1 设置 gateway.mode

```bash
openclaw config set gateway.mode local
openclaw gateway restart
openclaw gateway status
```
**预期看到：**
- `Runtime: running`
- `RPC probe: ok`
- 没有红色错误

### 3.2 如果遇到RPC probe: failed

```bash

查看日志找原因

openclaw logs --follow

在另一个终端重启

openclaw gateway restart
```
最常见的错误：`gateway.mode=unset`——就像出门没带钥匙，龙虾拒绝工作。
---

## 🤖 第四章：配置 AI 模型（给龙虾装上大脑）

我用的是**阿里云百炼 Lite 套餐**，首月 7.9 元，每月 9 万次请求，够用了。

### 4.1 获取 API Key

1. 访问 https://bailian.console.aliyun.com/
2. 开通 Lite 套餐，复制 Coding Plan 专用 API Key
3. 记下：`https://coding.dashscope.aliyuncs.com/v1`（这是专用地址，别用错！）

### 4.2 配置模型

通过 Web 控制台（http://127.0.0.1:18789）添加配置：
```json
{
"models": {
"providers": {
"bailian": {
"baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
"apiKey": "你的API_KEY",
"api": "openai-completions",
"models": [
{
"id": "qwen3-max-2026-01-23",
"name": "qwen3-max",
"reasoning": false
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "bailian/qwen3-max-2026-01-23"
}
}
}
}
```
**关键点：** `reasoning` 必须设为 `false`，否则模型会装聋作哑。
---

## 📱 第五章：接入飞书（让龙虾游进你的工作群）

这是最激动人心的一步！配置成功后，你就能在飞书里@龙虾了。

### 5.1 在飞书开放平台创建应用

1. 访问 https://open.feishu.cn/app
2. 创建企业自建应用 → 添加机器人能力
3. 获取 App ID 和 App Secret
4. 添加事件：`im.message.receive_v1`
5. 配置长连接接收事件（不要用回调地址）

### 5.2 在 OpenClaw 中配置

```bash
openclaw config set channels.feishu.enabled true --json
openclaw config set channels.feishu.appId "cli_你的AppID"
openclaw config set channels.feishu.appSecret "你的AppSecret"
openclaw config set channels.feishu.domain "feishu"
openclaw config set channels.feishu.dmPolicy "pairing"
openclaw config set channels.feishu.requireMention true
```

### 5.3 处理依赖问题（必看！）

如果遇到 `Cannot find module '@larksuiteoapi/node-sdk'`：
```bash
cd /Users/xxx/Library/pnpm/global/5/.pnpm/openclaw@.../node_modules/openclaw/extensions/feishu
npm install @larksuiteoapi/node-sdk --registry=https://registry.npmmirror.com
```
**这一步我卡了半小时，希望你不要重蹈覆辙。**
---

## 🎭 第六章：第一次对话（见证奇迹的时刻）

### 6.1 群聊测试

在飞书群里@你的机器人，发送“你好”。如果一切正常，它会回复问候语。

### 6.2 私聊测试

私聊机器人，你会看到：
```
OpenClaw: access not configured.
Your Feishu user id: ou_xxx
Pairing code: XXXXXX
Ask the bot owner to approve with:
openclaw pairing approve feishu XXXXXX
```
在终端批准：
```bash
openclaw pairing approve feishu XXXXXX
```
然后私聊就通了！🎉

### 6.3 试试这些命令

```
@龙虾 帮我写个 Python 脚本，计算斐波那契数列
@龙虾 现在几点了？
@龙虾 用中文讲个程序员的笑话
@龙虾 帮我总结一下今天群里的消息
```
---

## 🐛 第七章：常见问题急救箱

### Q1:Gateway port 18789 is not listening

**解：** `openclaw config set gateway.mode local` 然后重启

### Q2:Cannot find module '@larksuiteoapi/node-sdk'

**解：** 进入飞书扩展目录手动安装依赖（见5.3）

### Q3: 飞书群里@机器人没反应

**解：** 检查飞书后台是否添加了 `im.message.receive_v1` 事件，应用是否已发布

### Q4: 机器人回复“access not configured”

**解：** 这是正常的安全机制，用配对码批准即可

### Q5: 模型回复为空

**解：** 检查配置中的 `reasoning` 是否为 `false`

### Q6:pnpm add -g openclaw@latest 报权限错

**解：** 先运行 `pnpm setup`，然后 `source ~/.zshrc`
---

## 🎁 彩蛋：OpenClaw 的隐藏技能

经过一下午的折腾，我发现 OpenClaw 不仅能聊天，还能：
1. **处理飞书文档**：让它帮你总结长文档
2. **操作多维表格**：创建、查询、更新记录
3. **定时任务**：每天早上8点发天气预报
4. **代码执行**：在安全沙箱里运行 Python/JavaScript
5. **联网搜索**：需要配置搜索插件
---

## 📝 写在最后

安装 OpenClaw 的过程就像煮龙虾：
- **前期处理**有点繁琐（配置环境、处理依赖）
- **下锅的时候**可能会烫到手（各种报错）
- **但吃的时候**真香啊！（AI 助手24小时待命）
如果你按照这份攻略一步一步来，应该能在1-2小时内搞定。如果遇到本文没提到的问题，记住三连：
1. `openclaw logs --follow` 看日志
2. `openclaw doctor` 做体检
3. 重启试试（别笑，真的有用）
最后，感谢 DeepSeek 陪我度过这个充满报错但最终成功的下午。现在，我的 Mac mini 终于从“播放器”晋升为“AI 服务器”了！
**你的龙虾，下锅了吗？** 🦞
---
*P.S. 如果你在安装过程中有新的发现或更骚的操作，欢迎补充，让这份攻略造福更多被网络超时折磨的勇士。*