基于 OpenClaw 与飞书开放平台实现 AI 新闻推送机器人

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": []
  }
}

3. 点击 下一步，确认新增权限，然后点击 申请开通。
4. 在弹出的窗口中，点击 确认。

[图片]

2.4 发布应用版本

1. 点击顶部 创建版本，进入 应用发布 > 版本管理与发布。
2. 进入 创建版本 界面，填写版本号（如 1.0.0）和更新说明，移动端和桌面端的默认能力都选择 '机器人'。
3. 点击 保存，然后 确认发布。发布成功后，应用状态会变为 '已启用'。

[图片]

4. 进入 基础信息 > 凭证与基础信息，复制 App ID 和 App Secret，后续配置 OpenClaw 时会用到。

[图片]

3 OpenClaw 与飞书集成

3.1 配置 OpenClaw 的飞书凭证

1. 在终端中，执行以下命令，将飞书的 App ID 和 App Secret 配置到 OpenClaw 中：

openclaw config set channels.feishu.appId "YOUR_APP_ID"
openclaw config set channels.feishu.appSecret "YOUR_APP_SECRET"

2. 重启 OpenClaw 网关使配置生效：

openclaw gateway restart

[图片]

3.2 创建 Python 项目与长连接

为了让飞书能实时接收 OpenClaw 的消息，需要建立一个长连接：

1. 打开 IDE，点击 新建工程，选择 Python，命名为 openClaw_test。

[图片]

2. 打开 IDE 底部的 '终端'，激活虚拟环境并安装飞书 Python SDK：

pip install lark-oapi -U

3. 验证安装：

pip show lark-oapi

4. 将 main.py 文件中的代码替换为飞书官方提供的长连接示例代码，并将其中的 YOUR_APP_ID 和 YOUR_APP_SECRET 替换为我们之前复制的值。

import lark_oapi as lark

# P2ImMessageReceiveV1 为接收消息 v2.0；CustomizedEvent 内的 message 为接收消息 v1.0。
def do_p2_im_message_receive_v1(data: lark.im.v1.P2ImMessageReceiveV1) -> None:
    print(f'[ do_p2_im_message_receive_v1 access ], data: {lark.JSON.marshal(data, indent=4)}')

def do_message_event(data: lark.CustomizedEvent) -> None:
    print(f'[ do_customized_event access ], type: message, data: {lark.JSON.marshal(data, indent=4)}')

event_handler = lark.EventDispatcherHandler.builder("", "") \
    .register_p2_im_message_receive_v1(do_p2_im_message_receive_v1) \
    .register_p1_customized_event("这里填入你要自定义订阅的 event 的 key，例如 out_approval", do_message_event) \
    .build()

def main():
    cli = lark.ws.Client("YOUR_APP_ID", "YOUR_APP_SECRET", event_handler=event_handler, log_level=lark.LogLevel.DEBUG)
    cli.start()

if __name__ == "__main__":
    main()

5. 点击右上角的 '运行' 按钮，启动长连接。控制台显示 connected to wss://... 即表示连接成功。

⚠️ 注意：长连接程序必须保持运行，否则飞书无法接收事件推送。

[图片]

3.3 配置飞书事件订阅

1. 回到飞书开放平台，进入 开发配置 > 事件与回调。
2. 在 '事件配置' 中，订阅方式选择 使用长连接接收事件，点击 保存。

[图片]

3. 点击 添加事件，在 '应用身份订阅' 下找到 '消息与群组'，勾选 接收消息 v2.0，然后点击 '确认添加'。

[图片]

4. 再次进入 版本管理与发布，创建新版本（如 2.0.0）并发布，使事件订阅配置生效。

[图片]

4 功能测试

一切配置就绪后，我们来测试新闻推送功能：

1. 打开飞书客户端，找到我们创建的机器人 OpenClaw_test。

[图片]

2. 发送指令：@OpenClaw_test 去访问以下两个网站 (https://www.leikeji.com/)、(https://tech.gmw.cn)，有任何关于"科技"领域的新闻，立刻把最新的摘要推送给我。

3. 稍等片刻，机器人就会自动抓取新闻并推送回来，效果如下：

[图片]

发送后可同时在云端开发环境 OpenClaw 客户端查看到返回信息。

[图片]

5 收尾工作

测试完成后，可以通过以下命令停止 OpenClaw 网关服务：

openclaw gateway stop

6 总结与扩展

通过本文的实践，成功搭建了一个基于 OpenClaw 和飞书的 AI 新闻推送机器人。这个项目展示了如何将 AI 自动化能力与企业 IM 工具无缝集成，提供了一个可扩展的框架。