OpenClaw 接入飞书全流程:从零搭建你的 24 小时 AI 助手

1. 引言

想象一下，你的 AI 助手不再局限于命令行或网页，而是直接出现在你每天使用的飞书里——随时待命，随时响应。无论是自动回复消息、定时推送日报，还是处理团队协作中的重复性任务，OpenClaw 都能帮你实现。

本文将带你从零开始，完整走通 OpenClaw 接入飞书的全部流程，让你拥有一个真正 7×24 小时在线的 AI 助手。

2. 准备工作

在开始之前，你需要准备以下环境和账号：

• 一台可以长期运行的服务器或电脑（建议使用云服务器，保证 24 小时在线）
• 一个飞书企业账号（个人账号无法创建自建应用）
• 一个 OpenClaw 的部署环境（支持 Docker 或源码运行）
• 基本的命令行操作能力

提示：如果你还没有飞书企业账号，可以免费创建一个企业，个人开发者也能使用。

3. 创建飞书自建应用

OpenClaw 接入飞书的核心，是通过飞书的「自建应用」机制实现消息收发。具体步骤如下：

3.1 进入开发者后台

打开飞书开放平台，使用企业管理员账号登录，进入「开发者后台」。

3.2 创建企业自建应用

点击「创建应用」，选择「企业自建应用」，填写应用名称和描述，例如：

• 应用名称：OpenClaw 助手
• 应用描述：24 小时在线的 AI 助手

创建完成后，你会获得一个 App ID 和 App Secret，这两个凭证是后续配置的关键，请妥善保存。

3.3 配置权限

在应用的「权限管理」页面，需要开通以下权限：

• im:message
  ：读取和发送单聊消息
• im:message.group_at_msg
  ：读取群聊中 @ 机器人的消息
• im:message.p2p_msg
  ：读取单聊消息
• contact:user.base:readonly
  ：读取用户基本信息（可选）

3.4 配置事件订阅

在「事件订阅」页面，开启事件订阅功能，并配置请求地址。这个地址需要指向你的 OpenClaw 服务，格式如下：

https://你的服务器域名/飞书回调路径

同时，在「事件」列表中订阅以下事件：

• im.message.receive_v1
  ：接收消息事件

3.5 发布应用

在「版本管理与发布」页面，创建版本并提交发布。发布后，在飞书管理后台中，将应用设置为「可用」，并添加可用成员。

4. 部署 OpenClaw

OpenClaw 支持多种部署方式，这里以 Docker 为例，演示最快捷的部署流程。

4.1 拉取镜像

docker pull openclaw/openclaw:latest

4.2 编写配置文件

创建一个 config.yaml 文件，内容如下：

platforms:  feishu:    enabled: true    app_id: "你的App ID"    app_secret: "你的App Secret"    event_verification_token: "你的事件验证Token"    encrypt_key: "你的加密Key（可选）"

4.3 启动服务

docker run -d \  --name openclaw \  -p 8080:8080 \  -v $(pwd)/config.yaml:/app/config.yaml \  openclaw/openclaw:latest

启动后，OpenClaw 会在 8080 端口监听飞书的回调请求。

5. 配置回调地址

飞书需要能够访问到你的 OpenClaw 服务，因此你需要一个公网可访问的地址。

5.1 使用公网服务器

如果你使用的是云服务器，直接配置域名或公网 IP 即可。建议配置 HTTPS 证书，保证通信安全。

5.2 使用内网穿透

如果你在本地开发测试，可以使用内网穿透工具（如 frp、ngrok）将本地端口映射到公网。

# 以 frp 为例./frpc -c frpc.ini

在 frpc.ini 中配置：

[openclaw]type = tcplocal_ip = 127.0.0.1local_port = 8080remote_port = 8080

5.3 更新飞书回调地址

回到飞书开发者后台，在「事件订阅」中将请求地址更新为你的公网地址：

https://你的公网地址/feishu/callback

6. 验证连接

配置完成后，进行以下验证步骤：

6.1 发送测试消息

在飞书中找到你的应用机器人，发送一条消息，例如：

你好

6.2 查看日志

在服务器上查看 OpenClaw 的日志：

docker logs -f openclaw

如果看到类似以下的日志，说明消息已经成功接收：

[INFO] Received message from user: 你好[INFO] Reply sent successfully

6.3 验证回复

回到飞书，如果机器人自动回复了你，说明整个链路已经打通。

7. 进阶玩法

连接成功后，你可以进一步扩展你的 AI 助手能力：

7.1 定时推送

通过 OpenClaw 的定时任务功能，让机器人每天定时推送日报、天气或股票信息。

7.2 群聊协作

将机器人拉入群聊，在群里 @ 机器人即可触发 AI 响应，实现团队协作自动化。

7.3 自定义指令

通过配置自定义指令，让机器人执行特定操作，例如查询数据库、调用 API 等。

8. 常见问题

8.1 收不到消息

• 检查事件订阅地址是否公网可访问
• 检查应用是否已发布并添加可用成员
• 检查权限是否配置完整

8.2 回调验证失败

飞书在配置回调地址时会发送一个验证请求，确保你的服务正确响应了 challenge 参数。

8.3 消息乱码

确保 OpenClaw 和飞书的消息编码一致，统一使用 UTF-8。

9. 总结

通过本文的完整流程，你已经成功将 OpenClaw 接入飞书，拥有了一个 24 小时在线的 AI 助手。从创建飞书应用、部署 OpenClaw，到配置回调地址和验证连接，每一步都有清晰的指引。

接下来，你可以根据自己的业务需求，不断扩展机器人的能力，让它真正成为你的得力助手。