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

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

在日常工作中，我们常常需要关注科技领域的最新动态，但手动浏览多个网站效率低下。本文将介绍如何利用 OpenClaw（一个开源的 AI 自动化框架）结合飞书开放平台，快速搭建一个 AI 新闻推送机器人。该机器人可以自动访问指定网站，抓取科技新闻摘要，并通过飞书机器人实时推送给用户。

1 环境准备

1.1 开发环境准备

选择 Python 开发环境作为基础，确保预装的开发工具和依赖已就绪。

1. 安装 Python 及必要工具。
2. 配置终端环境，确保可执行相关命令。

1.2 AI 模型服务配置

为了使用 OpenClaw 的 AI 能力，需要先开通模型服务：

1. 在控制台进入在线推理服务页面。
2. 领取代金券或开通权益。
3. 点击预置服务，选择 DeepSeek-V3.2 等模型，勾选同意协议后一键开通。
4. 在调用说明中获取 API 地址和模型参数，并在 API Key 管理中创建新的 API Key。

⚠️ 注意：API Key 只会显示一次，请务必复制并妥善保存，后续配置 OpenClaw 时会用到。

1.3 启动 OpenClaw 网关

1. 运行 OpenClaw 启动器。
2. 在终端中输入之前创建的 API Key，回车确认。
3. 系统会自动在后台启动 OpenClaw 网关，并在浏览器中打开控制面板（http://127.0.0.1:18789）。
4. 在控制面板的 Chat 页面，发送消息测试 OpenClaw 是否正常工作，例如：'请向我介绍下你自己？'。

2 飞书开放平台配置

首先，在终端中安装飞书插件，实现 OpenClaw 与飞书的配置链接。

openclaw plugins install @m1heng-clawd/feishu

2.1 创建企业自建应用

1. 访问飞书开放平台，登录后点击创建企业自建应用。
2. 填写应用名称（如 OpenClaw_test）和描述，选择图标后点击创建。

2.2 添加机器人能力

1. 在应用左侧菜单，进入应用能力 > 添加应用能力。
2. 选择机器人能力，点击添加。

2.3 配置应用权限

为了让机器人能够接收和发送消息，我们需要配置相应的权限：

1. 进入开发配置 > 权限管理。
2. 点击批量导入 / 导出权限，将以下 JSON 粘贴到输入框中：

{
  "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

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. 稍等片刻，机器人就会自动抓取新闻并推送回来。

5 收尾工作

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

openclaw gateway stop

6 总结与扩展

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