手把手教你将 OpenClaw AI 助手接入飞书平台

概述

今天我想和大家分享一下，我是如何将 OpenClaw AI 助手成功接入飞书（Feishu/Lark）平台的。整个过程就像给一个聪明的“大脑”装上“耳朵”和“嘴巴”，让它能在飞书里和大家聊天、解答问题。如果你也想在团队协作工具里拥有一个专属的AI助手，这篇实战指南或许能帮到你。

前置条件

在开始动手之前，我们需要确保几件事已经就绪：
- 你的 OpenClaw 已经安装完毕，并且 Gateway 服务正在正常运行。
- 你拥有飞书的管理员权限，或者至少能创建一个新的应用。
- 最关键的一点：你的 OpenClaw Gateway 服务必须能被公网访问。如果是在本地开发，就需要借助内网穿透工具了。

一、飞书开放平台配置

1.1 创建企业自建应用

首先，我们得去飞书开放平台创建一个“据点”。
1. 打开飞书开放平台并登录。
2. 找到并点击「创建企业自建应用」按钮。
3. 给你的应用起个名字，写点描述，然后创建。
4. 非常重要！ 立刻记下生成的 App ID 和 App Secret，这相当于机器人的“身份证”和“密码”，后面会反复用到。

1.2 配置机器人权限

创建完应用后，我们需要给它“授权”，告诉飞书这个机器人能做什么。进入应用管理页面，找到权限配置，开通以下这些权限：

权限类别	权限名称	说明
机器人	`im:chat:readonly`	获取群组信息
机器人	`im:message:send_as_bot`	以机器人身份发送消息
机器人	`im:message.group_msg`	接收群组消息
机器人	`im:message.p2p_msg`	接收单聊消息
通讯录	`contact:user.base:readonly`	获取用户基本信息

我的经验是，先把这些基础权限都加上，确保机器人能正常收发消息。

1.3 配置事件订阅

这是连接的关键一步，我们要告诉飞书：“有消息来了，请发到这个地址通知我。”
- 订阅方式： 选择“配置 HTTPS 回调”。
- 请求地址： 这里需要填写你的 OpenClaw Gateway 接收飞书消息的地址。
- 如果你有公网域名，格式是这样的：

https://<your-domain>/webhook/feishu

- 如果是本地开发，像我一样，就需要用内网穿透（比如 ngrok）生成一个临时地址：

https://<ngrok-domain>/webhook/feishu

- 订阅事件： 在事件列表里，勾选 im.message.receive_v1（接收消息）。这样机器人才能知道有人@它或者给它发消息了。

1.4 配置加密密钥

为了安全，飞书会对事件进行加密。我们需要在「事件订阅」页面开启加密功能，然后记录下这两串密钥：
- Encrypt Key（加密密钥）
- Verification Token（验证令牌）

它们就像是和飞书对接的“暗号”，配置 OpenClaw 时会用到。

二、OpenClaw 飞书适配器配置

飞书那边配置好了，现在轮到我们的 OpenClaw 了。我们需要安装一个“翻译官”（适配器），让它能听懂飞书的话。

2.1 安装飞书适配器

打开终端，运行以下命令来安装官方提供的飞书适配器：

# 安装 OpenClaw 飞书适配器
npm install -g @openclaw/adapter-feishu

2.2 配置适配器

接下来，编辑 OpenClaw 的配置文件。文件通常位于 ~/.openclaw/config.yaml。找到 adapters 部分，添加飞书适配器的配置：

adapters:
  - name: feishu
    type: feishu
    enabled: true
    config:
      # 飞书应用凭证（从1.1和1.4步获取）
      app_id: "cli_xxxxx"                    # 替换为你的 App ID
      app_secret: "xxxxxxxxxx"               # 替换为你的 App Secret

      # 加密配置（来自事件订阅页面）
      encrypt_key: "xxxxxxxxxx"              # 替换为你的 Encrypt Key
      verification_token: "xxxxxxxxxx"       # 替换为你的 Verification Token

      # 网关配置
      webhook_path: "/webhook/feishu"        # 与飞书后台填写的路径一致
      port: 18789                            # 与 OpenClaw Gateway 监听的端口一致

      # 可选：消息处理配置（按需调整）
      at_only: false                         # 设为 true 则只在被@时响应，避免刷屏
      prefix: ""                             # 可以设置一个触发前缀，比如 "/ai"

2.3 环境变量配置（可选）

把 App Secret、加密密钥这些敏感信息直接写在配置文件里不太安全。我更喜欢用环境变量来管理。你可以这样设置：

export FEISHU_APP_ID="cli_xxxxx"
export FEISHU_APP_SECRET="xxxxxxxxxx"
export FEISHU_ENCRYPT_KEY="xxxxxxxxxx"
export FEISHU_VERIFICATION_TOKEN="xxxxxxxxxx"

然后在配置文件中引用这些环境变量，这样更清晰也更安全：

adapters:
  - name: feishu
    type: feishu
    enabled: true
    config:
      app_id: ${FEISHU_APP_ID}
      app_secret: ${FEISHU_SECRET}
      encrypt_key: ${FEISHU_ENCRYPT_KEY}
      verification_token: ${FEISHU_VERIFICATION_TOKEN}

三、启动与验证

配置都填好了，是时候启动并验证一下我们的劳动成果了。

3.1 重启 OpenClaw Gateway

为了让新配置生效，我们需要重启一下 Gateway 服务：

# 停止服务
openclaw gateway stop

# 启动服务（应用新配置）
openclaw gateway start

# 或者直接重启
openclaw gateway restart

3.2 验证配置

重启后，进行三重验证，确保万无一失：

飞书后台验证
- 回到飞书开放平台的「事件订阅」页面。
- 点击那个令人紧张的「验证」按钮。
- 如果看到绿色的「验证成功」提示，恭喜你，最难关卡已过！这说明飞书已经能成功访问到你的 OpenClaw 服务了。
本地日志检查
- 打开终端，查看 OpenClaw 的运行日志，看看有没有错误信息。
```
# 查看 OpenClaw 日志
openclaw logs
```
飞书机器人实战测试
- 在飞书里，把你刚创建的机器人应用添加到某个群组，或者直接和它发起单聊。
- 发送一条测试消息，比如 @机器人你好。
- 耐心等待一下，如果收到了 AI 助手的回复，那么整个流程就彻底打通了！那一刻的成就感还是很足的。

四、常见问题与踩坑记录

在实际操作中，我遇到了一些小麻烦，这里总结一下，希望你能避开。

4.1 回调地址验证失败

这是最常见的问题。飞书后台点验证总是报错。

问题	解决方案
URL 不可访问	确保 `openclaw gateway start` 成功执行，并且配置的端口（如18789）已开放。
内网环境	本地开发必须用内网穿透。我强烈推荐 ngrok，非常方便。
防火墙拦截	检查你的服务器或电脑的防火墙，是否拦截了对应端口的入站请求。

ngrok 内网穿透示例：

# 安装 ngrok
npm install -g ngrok

# 启动隧道，映射到 OpenClaw 的端口
ngrok http 18789

# ngrok 会生成一个 https 开头的随机域名，用它去更新飞书后台的回调地址

4.2 消息接收不到

机器人加进去了，但发消息没反应？
- 检查机器人是否真的被成功添加到了群组或会话中。
- 确认飞书应用的所有权限已经发布了一个新版本。仅仅开通权限不发布是没用的。
- 回头仔细看看 OpenClaw 的日志，错误信息通常就在里面。

4.3 加密验证失败

如果日志里出现加密相关的错误：
- 双重确认 encrypt_key 和 verification_token 是否与飞书后台「事件订阅」页面显示的一模一样，一个字符都不能错。

4.4 Windows 服务启动问题

在 Windows 上，可能需要将 OpenClaw 安装为系统服务：

# 以管理员身份运行命令行
openclaw gateway install --port 18789 --force

# 安装后，可以查看服务状态
sc query OpenClawGateway

五、高级配置玩法

基础功能搞定后，我们可以玩点更花的。

5.1 多适配器配置

如果你需要管理多个飞书机器人（比如不同部门用不同的），可以在一个 OpenClaw 实例中配置多个适配器，只需区分不同的 webhook_path 和凭证即可：

adapters:
  - name: feishu-bot1
    type: feishu
    enabled: true
    config:
      app_id: "cli_xxx1"
      app_secret: "xxx1"
      webhook_path: "/webhook/feishu/bot1"

  - name: feishu-bot2
    type: feishu
    enabled: true
    config:
      app_id: "cli_xxx2"
      app_secret: "xxx2"
      webhook_path: "/webhook/feishu/bot2"

5.2 消息模板配置

觉得机器人回复的格式太朴素？可以自定义回复模板，让它的回复更美观、信息更丰富：

adapters:
  - name: feishu
    type: feishu
    config:
      # 回复消息模板
      reply_template: |
        🤖 **AI 助手回复**

        {{content}}

        ---
        耗时: {{duration}}ms

六、参考资料

在整个探索过程中，这些官方文档给了我巨大的帮助：
- OpenClaw 官方文档
- 飞书开放平台文档
- 飞书机器人开发指南

文档版本： v1.0
更新日期： 2026-03-05

当前文章价值1.51元，扫一扫支付后添加微信提供帮助！（如不能解决您的问题，可以申请退款）

你可能感兴趣的文章

来源：每日教程， 每日一例，深入学习实用技术教程，关注公众号TeachCourse
转载请注明出处： https://teachcourse.cn/3869.html ，谢谢支持！

资源分享

分类：DevOps 标签：Feishu, Gateway, ngrok, OpenClaw, Webhook, 事件订阅, 机器人, 适配器, 飞书

Open Claw接入飞书平台

手把手教你将 OpenClaw AI 助手接入飞书平台

概述

前置条件

一、飞书开放平台配置

1.1 创建企业自建应用

1.2 配置机器人权限

1.3 配置事件订阅

1.4 配置加密密钥

二、OpenClaw 飞书适配器配置

2.1 安装飞书适配器

2.2 配置适配器

2.3 环境变量配置（可选）

三、启动与验证

3.1 重启 OpenClaw Gateway

3.2 验证配置

四、常见问题与踩坑记录

4.1 回调地址验证失败

4.2 消息接收不到

4.3 加密验证失败

4.4 Windows 服务启动问题

五、高级配置玩法

5.1 多适配器配置

5.2 消息模板配置

六、参考资料

你可能感兴趣的文章

资源分享

harmony学习UIAbility生命周期

Python框架Flask开发接口详细介绍

浅谈线程和进程

python异常SyntaxError Non-UTF-8 code starting with ‘xe9’ in file

Android开发之混淆基础教程

011-wordpress接口wp-json wp v2 posts，如何设置需要密码才可以访问

使用Android Studio集成的GitHub功能需要注意的

动态给TextView控件设置权重

微信开放平台开发之闪退问题解决办法

一键Markdown转HTML工具

赞助2.00

手把手教你将 OpenClaw AI 助手接入飞书平台

概述

前置条件

一、飞书开放平台配置

1.1 创建企业自建应用

1.2 配置机器人权限

1.3 配置事件订阅

1.4 配置加密密钥

二、OpenClaw 飞书适配器配置

2.1 安装飞书适配器

2.2 配置适配器

2.3 环境变量配置（可选）

三、启动与验证

3.1 重启 OpenClaw Gateway

3.2 验证配置

四、常见问题与踩坑记录

4.1 回调地址验证失败

4.2 消息接收不到

4.3 加密验证失败

4.4 Windows 服务启动问题

五、高级配置玩法

5.1 多适配器配置

5.2 消息模板配置

六、参考资料

你可能感兴趣的文章

资源分享

选择：

赞助2.00