飞书

YouClaw 支持通过飞书机器人向你发送提醒、通知和 AI 对话摘要。连接后,你可以在飞书中直接接收 YouClaw 的消息,也可以在飞书中和 YouClaw 进行对话。

连接飞书机器人

第一步:创建飞书应用

  1. 前往飞书开放平台并登录
  2. 创建一个新的自建应用
  3. 凭证与基础信息中,找到你的 App IDApp Secret
  4. 机器人能力中,开启机器人功能
  5. 权限管理中,授予以下权限:
    • im:message — 收发消息
    • im:message.group_at_msg — 接收群聊 @消息
    • im:resource — 访问消息资源

第二步:开启 WebSocket 长连接

  1. 在应用设置中,进入事件订阅
  2. 选择 WebSocket 作为连接方式 —— 这让 YouClaw 通过持久连接接收消息,无需部署公网 webhook
  3. 订阅 im.message.receive_v1 事件

第三步:在 YouClaw 中配置

打开 YouClaw 设置 > 渠道 > 飞书,填入以下信息:

App ID: your-app-id
App Secret: your-app-secret

点击 测试连接,如果飞书收到一条测试消息,说明配置成功。

支持的功能

定时提醒

通过自然语言设置提醒,到期后自动通过飞书推送:

用户:每天早上 10 点提醒我参加站会
AI:收到!每天 10:00 通过飞书提醒你

任务通知

当 YouClaw 完成后台任务时,通过飞书通知你结果。

双向对话

你可以直接在飞书中和 YouClaw 对话 —— 向机器人发送消息即可获得 AI 回复。机器人支持纯文本和富文本(post)消息。

处理中指示器

当 YouClaw 正在处理你的消息时,会在你的消息上显示一个打字中的 reaction,处理完成后自动移除。

消息格式

YouClaw 会智能选择最合适的飞书消息格式:

格式使用场景示例
富文本 (Post)常规文本回复摘要、提醒、解释
交互卡片包含代码块或表格的回复代码片段、数据分析结果

群聊支持

YouClaw 支持飞书群聊。将机器人添加到群组中,@机器人即可开始对话:

@YouClaw 昨天会议的待办事项有哪些?

机器人会在群聊中回复 AI 生成的回答。

常见问题

收不到消息怎么办?

  1. 确认 App ID 和 App Secret 填写正确
  2. 确认已开启 WebSocket 模式并订阅了 im.message.receive_v1 事件
  3. 在 YouClaw 设置中点击 测试连接 检查连通性
  4. 确认应用拥有必要的权限

可以在群聊中使用吗?

可以。将机器人添加到飞书群组中,@机器人即可交互。机器人同时支持单聊和群聊消息。

如何停止接收某类通知?

在 YouClaw 设置 > 渠道 > 飞书 > 通知偏好 中,你可以按类别开关不同类型的通知。