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. 如果你在安装过程中有新的发现或更骚的操作，欢迎补充，让这份攻略造福更多被网络超时折磨的勇士。*

## 📖 写在前面

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

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

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

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

一键安装

### 1.3 安装 Node.js

应该显示 v22.x.x

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

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

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

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

### 3.1 设置 gateway.mode

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

查看日志找原因

在另一个终端重启

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

### 4.1 获取 API Key

### 4.2 配置模型

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

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

### 5.2 在 OpenClaw 中配置

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

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

### 6.1 群聊测试

### 6.2 私聊测试

### 6.3 试试这些命令

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

### Q1:Gateway port 18789 is not listening

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

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

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

### Q5: 模型回复为空

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

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

## 📝 写在最后

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

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

### Q1:`Gateway port 18789 is not listening`

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

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