飞书交互卡片

技能简介

该技能用于在飞书（Lark）中创建并发送交互式卡片消息，替代纯文本回复。卡片支持按钮、表单、投票等富UI元素，用户可直接点击操作而无需手动输入。

能做什么

• 发送确认对话框，让用户选择是/否或多项选项
• 创建待办任务列表，支持勾选完成状态
• 发起投票或调查问卷
• 收集结构化表单数据
• 自动处理用户点击回调，通过长轮询连接实时接收响应

使用说明

安装准备

需先启动回调服务器以接收用户点击事件：

cd scripts
node card-callback-server.js

该服务器采用飞书长轮询模式，无需公网IP即可运行，具备自动重连功能。

发送卡片

命令行方式发送各类卡片：

# 确认对话框
node scripts/send-card.js confirmation "确认删除文件？" --chat-id oc_xxx

# 待办清单
node scripts/send-card.js todo --chat-id oc_xxx

# 投票
node scripts/send-card.js poll "团建活动" --options "保龄球,电影,聚餐" --chat-id oc_xxx

# 自定义模板
node scripts/send-card.js custom --template examples/custom-card.json --chat-id oc_xxx

在Agent中调用

当Agent需要向飞书发送消息时，优先使用交互卡片代替纯文本：

await exec({
  command: `node E:\\openclaw\\workspace\\skills\\feishu-interactive-cards\\scripts\\send-card.js confirmation "确认删除文件 test.txt?" --chat-id ${chatId}`
});

处理回调

回调服务器自动将用户点击事件转发至OpenClaw Gateway。Agent接收后解析callback.data.action.value中的数据，执行对应业务逻辑，并可调用updateCard更新卡片状态反馈结果。

输入与输出

风险提示

• 处理文件路径时需验证并清理输入，防止目录遍历攻击
• 建议使用Node.js内置fs API代替shell命令执行文件操作
• 按钮携带的value字段应包含完整状态信息，避免依赖外部查询
• 注意处理重复点击情况（系统内置3秒去重窗口）
• 长时间未响应需主动发送提醒消息

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/leecyang/feishu-interactive-cards/SKILL.md
来源类型：GitHub仓库