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

2,350 阅读2分钟

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 机器人进行交互,实现:

  • 📱 通过手机指令远程操控电脑
  • ⚙️ 自动化办公
  • ⏰ 接收定时任务提醒
  • 更多功能...