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

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. 打开桌面的 CodeArts IDE for Python，点击 新建工程，选择 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

通过本文的实践，我们成功搭建了一个基于 OpenClaw 和飞书的 AI 新闻推送机器人。这个项目不仅展示了如何将 AI 自动化能力与企业 IM 工具无缝集成，也为我们提供了一个可扩展的框架。后续可以根据需求调整抓取源或优化提示词，进一步提升推送内容的质量。