Mac本地部署OpenClaw + 飞书机器人对接全攻略

作为一名后端工程师，我一直想找一个能通过飞书随时调用的AI助手，帮我处理日常的自动化任务。OpenClaw（江湖人称“龙虾”）正是这样一个开源框架，它能把自然语言指令变成实际操作——整理文件、执行命令、查询信息，而且完全免费。本文记录了我在Mac（M3芯片）上从零搭建OpenClaw并接入飞书的完整过程，包含所有踩坑记录和解决思路。

一、为什么选择OpenClaw？

OpenClaw是一款开源跨平台AI助手框架，核心定位是**“将自然语言指令转化为实际操作”** 。简单来说，你可以把它想象成一个可以定制的“数字员工”：

• ✅ 模型自由选择：支持Kimi、通义千问、DeepSeek等主流大模型
• ✅ 多渠道联动：通过飞书、Telegram等常用工具随时发号施令
• ✅ 本地私有化部署：数据存储在本地，隐私安全可控
• ✅ 技能无限扩展：通过插件市场安装各种技能（文件处理、系统控制等）
• ✅ 开源免费：核心功能完全免费，无订阅费用

对于我这样的后端开发者来说，最吸引人的是它可以对接飞书——这意味着我不需要打开电脑，在手机上@机器人就能执行任务。

二、Mac本地部署OpenClaw（npm安装法）

2.1 前置准备

• 系统要求：macOS Sonoma或更新版本（M1/M2/M3芯片体验更佳）
• 磁盘空间：建议预留至少20GB
• 网络环境：需要流畅的网络（部分依赖需从GitHub下载）

2.2 安装Node.js（核心依赖）

OpenClaw基于Node.js运行，需要安装24.x LTS版本。我推荐使用nvm（Node版本管理器）来安装，避免版本冲突：

# 1. 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 2. 生效nvm（无需重启终端）
. "$HOME/.nvm/nvm.sh"

# 3. 安装Node.js 24（LTS版本）
nvm install 24

# 4. 设置为默认版本
nvm use 24

# 5. 验证安装
node -v   # 应该显示v24.13.0或更高
npm -v    # 应该显示11.6.2或更高

2.3 安装OpenClaw

# 1. 全局安装OpenClaw（需要输入Mac开机密码）
sudo npm install -g openclaw

# 2. 解决Git下载协议问题（避免Permission denied错误）
git config --global url."https://github.com/".insteadOf ssh://git@github.com/

# 3. 重新执行安装（如果第一步报错）
sudo npm install -g openclaw

# 4. 验证安装成功
openclaw --version  # 应该显示2026.2.x或更高

2.4 初始化配置向导

openclaw onboard

按照终端提示逐步配置（全程交互式操作）：

配置完成后，浏览器会自动打开控制台（http://127.0.0.1:18789）。

2.5 验证本地部署

浏览器验证：在控制台输入「介绍一下你的核心功能」，如果能收到结构化回复，说明部署成功。

终端验证：

openclaw tui
# 输入测试指令：帮我在桌面创建一个名为OpenClaw_Test的文件夹

如果桌面生成了目标文件夹，说明文件操作权限正常 。

三、对接飞书机器人（核心步骤）

3.1 飞书开放平台创建应用

1. 访问飞书开放平台，登录你的企业飞书账号

2. 创建企业自建应用：

   • 点击「创建企业自建应用」
   • 输入应用名称（如“OpenClaw AI助手”）
   • 填写应用描述，上传图标
   • 点击「创建」

3. 添加机器人能力：

   • 左侧导航栏「应用能力」→「添加应用能力」
   • 选择「机器人」→「添加」

4. 开通核心权限：

   • 左侧「权限管理」→「开通权限」
   • 搜索并勾选以下权限 ：
     • 消息与群组相关：所有以「im:」开头的权限
     • 云文档相关：所有以「docs:」「bitable:」开头的权限
     • 通讯录相关：「contact:contact.base:readonly」

5. 发布应用（测试版）：

   • 左侧「版本管理与发布」→「创建版本」
   • 版本号：1.0.0，更新说明：OpenClaw AI助手初版
   • 「可用范围」选择“部分成员”，添加自己的飞书账号
   • 点击「保存」→「确认发布」

3.2 OpenClaw配置飞书插件

# 1. 清理旧版飞书插件（避免冲突）
sudo rm -rf ~/.openclaw/extensions/feishu

# 2. 安装飞书插件
openclaw plugins install @m1heng-clawd/feishu

# 3. 启动配置命令
openclaw config

按终端提示完成配置：

注意：App ID和App Secret在飞书开放平台左侧「凭证与基础信息」中获取

3.3 飞书事件订阅配置（最关键的一步）

1. 设置订阅方式：

   • 飞书开放平台左侧「事件与回调」→「事件配置」
   • 订阅方式选择「使用长连接接收事件」
   • 点击「保存」

2. 添加事件：

   • 点击「添加事件」
   • 搜索并勾选以下4个事件 ：
     • 机器人进群v2.0（im.chat.member.bot.added_v1）
     • 机器人被移出群v2.0（im.chat.member.bot.deleted_v1）
     • 消息已读v2.0（im.message.message_read_v1）
     • 接收消息v2.0（im.message.receive_v1）
   • 点击「确认添加」

3. 重新发布应用：

   • 左侧「版本管理与发布」→「创建版本」
   • 版本号：2.0.0，更新说明：添加事件订阅
   • 发布后生效

3.4 验证飞书机器人

1. 打开飞书APP，搜索你创建的应用名称（如“OpenClaw AI助手”）
2. 进入单聊，发送指令「你用的什么模型？」
3. 如果机器人回复「我在用Kimi K2.5」，说明接入成功！

群聊测试：将机器人拉入飞书群，@机器人发送「帮我生成一份周末出行计划」，如果正常响应，说明群聊功能也正常。

3.5 常见问题排查

四、让OpenClaw更强大：配置大模型API

OpenClaw支持多种大模型，这里推荐两种国内用户友好的方案：

方案A：阿里云百炼API（国内直连）

1. 访问阿里云百炼平台，在「密钥管理」中创建API Key
2. 在OpenClaw控制台发送命令：配置阿里云百炼API
3. 按提示粘贴API Key即可

免费额度：新用户有大量免费额度，足以满足日常使用。

方案B：飞书API（限时无限额度）

2026年飞书针对OpenClaw用户开放了限时无限调用额度申请，同时免费版API调用额度已提升至每月100万次 。

申请方式：

• 在飞书开放平台找到专属申请入口
• 建议在现有额度接近用完时申请，成功率更高

五、进阶技巧：让OpenClaw自动执行任务

5.1 安装实用技能

# 查看可用技能
openclaw plugins search

# 安装文件处理技能
openclaw plugins install @openclaw/file-manager

# 安装系统控制技能
openclaw plugins install @openclaw/system-ctl

5.2 常用指令示例

六、写在最后

经过两个小时的折腾，我终于在Mac上成功跑起了OpenClaw，并且完美接入了飞书。现在通勤路上也能@机器人处理工作了，幸福感直线上升。

总结几点经验：

1. Node.js版本一定要用24.x，低版本会有兼容问题
2. 飞书事件订阅必须选“长连接”，这是最坑的地方，很多人卡在这里
3. 权限尽量开全，宁可多开不要少开，避免后续反复发布
4. 测试时先用单聊，成功后再试群聊

如果你也在折腾OpenClaw，遇到了问题，欢迎在评论区留言交流！如果这篇文章对你有帮助，点个赞支持一下～