Mac mini 安装 OpenClaw 并对接飞书完整教程

1. 环境要求

macOS 10.15+，支持 Intel / Apple Silicon（M1/M2/M3）
内存 ≥ 2GB
网络正常（用于安装依赖、调用模型 API）

2. 安装 OpenClaw

2.1 一键安装（推荐，新手首选）

bash 复制代码

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

验证安装（终端输入）：

bash 复制代码

openclaw --version

输出版本号（如 2026.2.9）即安装成功。

2.2 手动安装（技术用户，Node.js 版本）

先安装 nvm（Node.js 版本管理工具）：

bash 复制代码

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.zshrc  # Intel 芯片若用 bash，替换为 source ~/.bashrc

安装并切换 Node.js 22（OpenClaw 官方指定版本）：

bash 复制代码

nvm install 22
nvm use 22
node -v  # 验证版本 ≥22

全局安装 OpenClaw：

bash 复制代码

npm install -g openclaw@latest

2.3 初始化 OpenClaw（必须步骤）

bash 复制代码

openclaw init

按终端提示完成配置，需输入：

AI 模型平台（如 OpenAI、Claude、通义千问等）
对应模型的 API Key（从模型平台获取）
Web 后台管理员密码（用于登录 http://localhost:3000）

2.4 启动/停止 OpenClaw 服务

bash 复制代码

# 启动服务
openclaw start

# 停止服务（按需执行）
openclaw stop

启动成功后，浏览器访问 http://localhost:3000，输入管理员密码即可进入 Web 后台。

3. 对接飞书（Feishu）

3.1 前置条件

OpenClaw 已安装并正常启动
有飞书企业/组织账号，且具备开发者/管理员权限

3.2 飞书开放平台创建机器人应用

打开飞书开放平台：https://open.feishu.cn/app，登录飞书账号
点击「创建企业自建应用」，填写信息：
复制代码
```
 点击「创建」
```
- 应用名称：OpenClaw 助手（可自定义）
- 应用描述：AI 智能体助手（可自定义）
添加应用能力：左侧菜单 → 「添加应用能力」→ 选择「机器人」→ 点击「添加」
获取核心凭证（务必保存）：左侧 → 「凭证与基础信息」→ 复制「App ID」「App Secret」
开通权限（必须）：左侧 → 「权限管理」→ 「开通权限」，勾选以下权限并批量开通：
- 即时通讯 → 「获取与发送单聊、群组消息」
- 联系人 → 「读取用户基本信息」「获取通讯录基本信息」
发布应用（必须）：左侧 → 「版本管理与发布」→ 「创建版本」，填写版本号（如 1.0.0）、更新说明，提交后申请发布，完成企业内审批，确认应用状态为「已发布」。

3.3 安装 OpenClaw 飞书插件

bash 复制代码

# 安装飞书官方插件
openclaw plugins install @openclaw/feishu

# 验证插件安装（输出列表包含 @openclaw/feishu 即成功）
openclaw plugins list

3.4 配置飞书渠道（两种方式任选其一）

方式 1：交互式配置（推荐，新手友好）

bash 复制代码

openclaw channels add

按终端提示操作：

选择渠道类型：Feishu
粘贴飞书应用的「App ID」
粘贴飞书应用的「App Secret」
确认配置，完成渠道添加

方式 2：命令行一键配置

bash 复制代码

openclaw config feishu \
  --app-id "你的飞书App ID" \
  --app-secret "你的飞书App Secret"

3.5 启动飞书网关并验证连接

bash 复制代码

# 启动飞书 WebSocket 网关（维持长连接）
openclaw gateway start

# 查看网关状态（显示 Feishu gateway running (connected) 即成功）
openclaw gateway status

# （可选）查看实时日志，用于排查错误
openclaw logs --follow

3.6 飞书客户端配对与使用

打开飞书客户端，搜索创建的机器人名称（如「OpenClaw 助手」），发起私聊
机器人会自动回复配对码（如 H9ZEHY8R）
终端执行配对授权（替换「你的配对码」为实际收到的代码）：
openclaw pairing approve feishu 你的配对码
配对完成后即可使用：
- 私聊：直接给机器人发指令（如「整理桌面文件」「写一段 Python 脚本」）
- 群聊：@机器人 + 指令（如「@OpenClaw 助手生成一份周报模板」）

4. 常见问题与解决方案

4.1 安装 OpenClaw 提示权限不足

bash 复制代码

# 方式 1：命令前加 sudo 提升权限
sudo curl -fsSL https://openclaw.ai/install.sh | bash

# 方式 2：手动赋予脚本权限（若下载了安装脚本）
chmod +x install.sh && ./install.sh

4.2 飞书网关连接失败（status 非 connected）

bash 复制代码

# 重启网关
openclaw gateway restart

# 核对 App ID/Secret 是否正确
cat ~/.openclaw/config.json | grep feishu

4.3 飞书机器人收不到消息/无响应

确认飞书应用已「发布并审批通过」（未发布无法正常使用）
确认飞书权限已开通「获取与发送单聊、群组消息」
重启飞书网关：openclaw gateway restart
查看日志排查错误：openclaw logs --follow

4.4 Apple Silicon（M1/M2/M3）Node.js 架构不匹配

bash 复制代码

# 卸载现有 Node.js 22
nvm uninstall 22

# 安装 ARM64 版本 Node.js 22
arch -arm64 /bin/zsh -c "nvm install 22"
nvm use 22

# 验证架构（输出 arm64 即成功）
node -p "process.arch"

5. 进阶配置（可选）

编辑 OpenClaw 配置文件 ~/.openclaw/config.json，可修改飞书权限策略：

json 复制代码

{
  "channels": {
    "feishu": {
      "dmPolicy": "open",          // 私聊策略：open（开放所有人）/ allowlist（白名单）
      "allowFrom": ["*"],          // 开放所有人私聊（白名单需填写用户ID）
      "groupPolicy": "open",       // 群聊策略：open/allowlist/disabled（禁用）
      "allowGroups": ["群ID1", "群ID2"]  // 群聊白名单（groupPolicy为allowlist时生效）
    }
  }
}

配置修改后，重启网关生效：

bash 复制代码

openclaw gateway restart

6. 卸载（按需执行）

6.1 卸载 OpenClaw 完整程序

bash 复制代码

openclaw stop
npm uninstall -g openclaw
rm -rf ~/.openclaw

6.2 仅卸载飞书插件

bash 复制代码

openclaw plugins uninstall @openclaw/feishu