飞书个人用户激活长连接(Websocket)接入Openclaw

OpenClaw 接入飞书完整指南

📋 前置准备

在开始之前，请确保你已准备好：

• ✅ Node.js 环境（版本 > 22）

• ✅ 第三方 AI 模型的 API 密钥（如 MiniMax、GLM 等）

---

步骤一：安装 OpenClaw

执行官方一键安装脚本：

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

安装过程中会自动处理依赖项。安装完成后，按照配置向导完成模型设置。

💡 提示：跳过内置的聊天渠道选择，后续我们将使用专门的飞书插件。

---

步骤二：配置服务访问

云服务器环境

1. 配置反向代理（如使用宝塔面板）

2. 设置 SSL 证书，确保公网可以安全访问 OpenClaw 控制台

授权设备访问

获取请求 ID：

openclaw devices list

授权设备：

openclaw devices approve <ID>

授权后，控制台状态将变为正常。

---

步骤三：安装飞书插件

执行以下命令安装飞书对接插件：

openclaw plugins install @m1heng-clawd/feishu

---

步骤四：创建飞书应用

1. 前往 飞书开放平台 创建自建应用

2. 在「凭证与基础信息」页面获取：

   1. App ID

   2. App Secret

3. 在「应用能力」中添加机器人功能

4. 在「权限管理」中开通必要权限：

   1. 读取用户消息

   2. 发送消息

   3. 其他所需权限

---

步骤五：配置事件订阅

1. 进入飞书开放平台的「事件与回调」页面

2. 推荐：选择「使用长连接接收事件」模式

> ⚠️ 长连接模式目前主要支持企业自建应用

激活长连接

1. 勾选消息接收相关的事件（如 im.message.receive_v1）

2. 如无法使用长连接，需配置回调 URL 指向你的 OpenClaw 服务地址

---

步骤六：配置 OpenClaw 凭证

在终端依次执行以下命令：

openclaw config set channels.feishu.appId "你的AppID"

openclaw config set channels.feishu.appSecret "你的AppSecret"

openclaw config set channels.feishu.enabled true

---

步骤七：发布应用

1. 返回飞书开放平台

2. 发布该应用版本

3. 在飞书客户端中找到你的机器人即可开始使用

---

🎉 完成！

现在你可以在飞书客户端与 OpenClaw 机器人进行交互，实现：

• 📱 通过手机指令远程操控电脑

• ⚙️ 自动化办公

• ⏰ 接收定时任务提醒

• 更多功能...