Mac mini 安装 OpenClaw 并对接飞书

Mac mini 安装 OpenClaw 并对接飞书 | 极客日志

Mac mini 安装 OpenClaw 并对接飞书

1. 环境要求

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

2. 安装 OpenClaw

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

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

验证安装（终端输入）：

openclaw --version

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

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

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

# 安装 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 官方指定版本）：

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

全局安装 OpenClaw：

npm install -g openclaw@latest

2.3 初始化 OpenClaw（必须步骤）

openclaw init

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

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

2.4 启动/停止 OpenClaw 服务

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

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

3. 对接飞书（Feishu）

3.1 前置条件

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

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

打开飞书开放平台：https://open.feishu.cn/app，登录飞书账号
- 应用名称：OpenClaw 助手
- 应用描述：AI 智能体助手
添加应用能力：左侧菜单 → 「添加应用能力」→ 选择「机器人」→ 点击「添加」
开通权限（必须）：左侧 → 「权限管理」→ 「开通权限」，勾选以下权限并批量开通：
- 「获取与发送单聊、群组消息」
- 「读取用户基本信息」
- 「获取通讯录基本信息」

发布应用（必须）：左侧 → 「版本管理与发布」→ 「创建版本」，填写版本号（如 1.0.0）、更新说明，提交后申请发布，完成企业内审批，确认应用状态为「已发布」。

获取核心凭证（务必保存）：左侧 → 「凭证与基础信息」→ 复制「App ID」「App Secret」。

点击「创建企业自建应用」，填写信息。

3.3 安装 OpenClaw 飞书插件

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

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

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

openclaw channels add

按终端提示操作：

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

方式 2：命令行一键配置

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

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

# 启动飞书 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 提示权限不足

# 方式 1：命令前加 sudo 提升权限
sudo curl -fsSL https://openclaw.ai/install.sh | bash
# 方式 2：手动赋予脚本权限（若下载了安装脚本）
chmod +x install.sh && ./install.sh

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

# 重启网关
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 架构不匹配

# 卸载现有 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，可修改飞书权限策略：

{
  "channels": {
    "feishu": {
      "dmPolicy": "open",
      "allowFrom": ["*"],
      "groupPolicy": "open",
      "allowGroups": ["群 ID1", "群 ID2"]
    }
  }
}

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

openclaw gateway restart

6. 卸载（按需执行）

6.1 卸载 OpenClaw 完整程序

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

6.2 仅卸载飞书插件

openclaw plugins uninstall @openclaw/feishu

Mac mini 安装 OpenClaw 并对接飞书

Mac mini 安装 OpenClaw 并对接飞书

1. 环境要求

2. 安装 OpenClaw

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

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

2.3 初始化 OpenClaw（必须步骤）

2.4 启动/停止 OpenClaw 服务

3. 对接飞书（Feishu）

3.1 前置条件

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

3.3 安装 OpenClaw 飞书插件

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

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

方式 2：命令行一键配置

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

3.6 飞书客户端配对与使用

4. 常见问题与解决方案

4.1 安装 OpenClaw 提示权限不足

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

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

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

5. 进阶配置（可选）

6. 卸载（按需执行）

6.1 卸载 OpenClaw 完整程序

6.2 仅卸载飞书插件

更多推荐文章

相关免费在线工具

Mac mini 安装 OpenClaw 并对接飞书

Mac mini 安装 OpenClaw 并对接飞书

1. 环境要求

2. 安装 OpenClaw

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

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

2.3 初始化 OpenClaw（必须步骤）

2.4 启动/停止 OpenClaw 服务

3. 对接飞书（Feishu）

3.1 前置条件

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

3.3 安装 OpenClaw 飞书插件

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

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

方式 2：命令行一键配置

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

3.6 飞书客户端配对与使用

4. 常见问题与解决方案

4.1 安装 OpenClaw 提示权限不足

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

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

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

5. 进阶配置（可选）

6. 卸载（按需执行）

6.1 卸载 OpenClaw 完整程序

6.2 仅卸载飞书插件

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具