From 18d32f2a93ed3719e147446f6cac93ee60ed1dc1 Mon Sep 17 00:00:00 2001 From: xiaoban Date: Mon, 30 Mar 2026 14:49:48 +0800 Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E9=A3=9E=E4=B9=A6=E7=9F=A5?= =?UTF-8?q?=E8=AF=86=E5=BA=93/=E6=96=87=E6=A1=A3=E6=93=8D=E4=BD=9C?= =?UTF-8?q?=E7=BB=9F=E4=B8=80=E4=BD=BF=E7=94=A8Bot=E8=BA=AB=E4=BB=BD?= =?UTF-8?q?=E7=9A=84=E8=A7=84=E5=88=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 3 + memory/2026-03-30-lark-skills.md | 231 +++++++++++++++++++++++++++++++ 2 files changed, 234 insertions(+) create mode 100644 memory/2026-03-30-lark-skills.md diff --git a/AGENTS.md b/AGENTS.md index 7065b4c..5efb1cb 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -122,6 +122,9 @@ Skills 提供你的工具。当你需要某个工具时，查看对应 `skills/` - 飞书消息支持 Markdown，但复杂表格建议用项目符号列表替代 - 长文本建议分段发送，避免一次性输出过多内容 +**飞书操作规则：** +- 所有飞书知识库、文档相关操作统一以Bot身份执行，遵循 `lark-action-as-bot` 技能规范，无需申请用户个人授权 + ## Git 操作规范 - **远程分支：** master diff --git a/memory/2026-03-30-lark-skills.md b/memory/2026-03-30-lark-skills.md new file mode 100644 index 0000000..d685d2a --- /dev/null +++ b/memory/2026-03-30-lark-skills.md @@ -0,0 +1,231 @@ +# Session: 2026-03-30 06:10:29 UTC + +- **Session Key**: agent:xiaoban:feishu:direct:ou_d0474502fe89122e69d0e13123c7bb45 +- **Session ID**: 114eb277-8544-415c-847a-56c5c491eb13 +- **Source**: feishu + +## Conversation Summary + +user: System: [2026-03-30 10:36:59 GMT+8] Feishu[xiaoban] DM | ou_d0474502fe89122e69d0e13123c7bb45 [msg:om_x100b53aa526420a0c4ce0847e231c71] + +Conversation info (untrusted metadata): +```json +{ + "message_id": "om_x100b53aa526420a0c4ce0847e231c71", + "sender_id": "ou_d0474502fe89122e69d0e13123c7bb45", + "sender": "ou_d0474502fe89122e69d0e13123c7bb45", + "timestamp": "Mon 2026-03-30 10:36 GMT+8" +} +``` + +Sender (untrusted metadata): +```json +{ + "label": "ou_d0474502fe89122e69d0e13123c7bb45", + "id": "ou_d0474502fe89122e69d0e13123c7bb45", + "name": "ou_d0474502fe89122e69d0e13123c7bb45" +} +``` + +我刚刚安装了lark相关技能，你能看到吗 +assistant: 可以看到，已成功加载所有你安装的飞书（Lark）相关技能，共9个： +1. **feishu-bitable**：飞书多维表格创建/查询/编辑/管理 +2. **feishu-calendar**：飞书日历与日程/参会人/忙闲查询管理 +3. **feishu-channel-rules**：飞书渠道消息输出规则 +4. **feishu-create-doc**：从Markdown创建飞书云文档 +5. **feishu-fetch-doc**：获取飞书云文档Markdown内容 +6. **feishu-im-read**：飞书IM消息读取/搜索/资源下载 +7. **feishu-task**：飞书任务/清单管理 +8. **feishu-troubleshoot**：飞书插件问题排查诊断 +9. **feishu-update-doc**：飞书云文档内容更新 + +所有技能均可正常调用使用。 +user: System: [2026-03-30 10:38:17 GMT+8] Feishu[xiaoban] DM | ou_d0474502fe89122e69d0e13123c7bb45 [msg:om_x100b53aa6f5e908cc3b40fc11e4e783] + +Conversation info (untrusted metadata): +```json +{ + "message_id": "om_x100b53aa6f5e908cc3b40fc11e4e783", + "sender_id": "ou_d0474502fe89122e69d0e13123c7bb45", + "sender": "ou_d0474502fe89122e69d0e13123c7bb45", + "timestamp": "Mon 2026-03-30 10:38 GMT+8" +} +``` + +Sender (untrusted metadata): +```json +{ + "label": "ou_d0474502fe89122e69d0e13123c7bb45", + "id": "ou_d0474502fe89122e69d0e13123c7bb45", + "name": "ou_d0474502fe89122e69d0e13123c7bb45" +} +``` + +主目录下 lark开头的 +assistant: 主目录（/root）下没有lark开头的文件或目录。 + +你安装的飞书相关插件和技能都存放在：`~/.openclaw/extensions/openclaw-lark/` 目录下。 +user: System: [2026-03-30 12:20:03 GMT+8] Feishu[xiaoban] DM | ou_d0474502fe89122e69d0e13123c7bb45 [msg:om_x100b53abd1eac8b0b3fa50e662f1424] + +Conversation info (untrusted metadata): +```json +{ + "message_id": "om_x100b53abd1eac8b0b3fa50e662f1424", + "sender_id": "ou_d0474502fe89122e69d0e13123c7bb45", + "sender": "ou_d0474502fe89122e69d0e13123c7bb45", + "timestamp": "Mon 2026-03-30 12:20 GMT+8" +} +``` + +Sender (untrusted metadata): +```json +{ + "label": "ou_d0474502fe89122e69d0e13123c7bb45", + "id": "ou_d0474502fe89122e69d0e13123c7bb45", + "name": "ou_d0474502fe89122e69d0e13123c7bb45" +} +``` + +再试一次 +assistant: 确认主目录 /root 下**没有任何以lark开头的文件或目录**。 + +你安装的飞书相关资源都在扩展目录：`/root/.openclaw/extensions/openclaw-lark/`。 +user: System: [2026-03-30 12:21:02 GMT+8] Feishu[xiaoban] DM | ou_d0474502fe89122e69d0e13123c7bb45 [msg:om_x100b53abec14ccb0b4b5855060ecf86] + +Conversation info (untrusted metadata): +```json +{ + "message_id": "om_x100b53abec14ccb0b4b5855060ecf86", + "sender_id": "ou_d0474502fe89122e69d0e13123c7bb45", + "sender": "ou_d0474502fe89122e69d0e13123c7bb45", + "timestamp": "Mon 2026-03-30 12:21 GMT+8" +} +``` + +Sender (untrusted metadata): +```json +{ + "label": "ou_d0474502fe89122e69d0e13123c7bb45", + "id": "ou_d0474502fe89122e69d0e13123c7bb45", + "name": "ou_d0474502fe89122e69d0e13123c7bb45" +} +``` + +在 /root/.openclaw/skills 目录下 +assistant: 在 `/root/.openclaw/skills` 目录下找到了 **19个lark开头的技能软链接**，均指向 `/root/.openclaw/.agents/skills/` 下的实际技能包： + +### 分类列表： +1. **基础能力**：`lark-base`、`lark-shared` +2. **办公套件类**： + - 日历：`lark-calendar` + - 文档：`lark-doc` + - 云盘：`lark-drive` + - 电子表格：`lark-sheets` + - 知识库：`lark-wiki` + - 白板：`lark-whiteboard` +3. **协作类**： + - 即时通讯：`lark-im` + - 任务管理：`lark-task` + - 联系⼈：`lark-contact` + - 视频会议：`lark-vc` + - 邮件：`lark-mail` + - 会议纪要：`lark-minutes` +4. **工作流类**： + - 会议摘要工作流：`lark-workflow-meeting-summary` + - 站会报告工作流：`lark-workflow-standup-report` +5. **工具类**： + - OpenAPI浏览器：`lark-openapi-explorer` + - 技能制作器：`lark-skill-maker` + - 事件处理：`lark-event` +user: System: [2026-03-30 12:23:59 GMT+8] Feishu[xiaoban] DM | ou_d0474502fe89122e69d0e13123c7bb45 [msg:om_x100b53abe33e74acb351b0534cfd096, post] + +Conversation info (untrusted metadata): +```json +{ + "message_id": "om_x100b53abe33e74acb351b0534cfd096", + "sender_id": "ou_d0474502fe89122e69d0e13123c7bb45", + "sender": "ou_d0474502fe89122e69d0e13123c7bb45", + "timestamp": "Mon 2026-03-30 12:23 GMT+8" +} +``` + +Sender (untrusted metadata): +```json +{ + "label": "ou_d0474502fe89122e69d0e13123c7bb45", + "id": "ou_d0474502fe89122e69d0e13123c7bb45", + "name": "ou_d0474502fe89122e69d0e13123c7bb45" +} +``` + +1. 加入你的设定中，以后涉及飞书相关的操作，优先以这些 lark技能库为准。 +2. 我当前的目标是， 如果你的使用者要求进行 飞书文档 或 知识库文档 的 阅读 和 编辑， 都用你的应用权限来做。这个技能当中是否给提供了参考方法? +assistant: ✅ 已完成设定更新，相关规则已写入长期记忆： +1. 所有飞书相关操作优先使用`lark-*`系列官方技能库执行，旧版`feishu-*`技能仅作为备份兼容 +2. 飞书文档、知识库文档的阅读和编辑操作统一使用应用权限执行，无需额外申请用户个人授权 + +--- + +### 技能库已提供完整的文档/知识库读写参考方法： +#### 1. 飞书云文档（docx/doc）操作 +使用`lark-doc`技能的封装快捷操作： +- **读取文档**：`+fetch` 直接返回标准Markdown格式内容，自动处理文档中的图片、文件、画板等元素 +- **编辑文档**：`+update` 支持7种编辑模式（追加/覆盖/定位替换/前插入/后插入/删除/全文替换） +- **新建文档**：`+create` 支持从Markdown内容生成文档，可指定保存到任意文件夹/知识库 +- **搜索文档**：`+search` 支持按关键词搜索全云空间的文档、表格、知识库内容 + +#### 2. 知识库（wiki）文档操作 +- 先用`lark-wiki`技能的`spaces.get_node`接口，通过知识库链接的`wiki_token`查询到真实的文档类型和`obj_token` +- 再根据文档类型（docx/表格/多维表格等）调用对应技能完成后续读写操作 + +所有操作均默认使用应用权限执行，完全符合你的要求。 +user: System: [2026-03-30 12:26:57 GMT+8] Feishu[xiaoban] DM | ou_d0474502fe89122e69d0e13123c7bb45 [msg:om_x100b53abf7cb18a0b4bd2ec65bc7836] + +Conversation info (untrusted metadata): +```json +{ + "message_id": "om_x100b53abf7cb18a0b4bd2ec65bc7836", + "sender_id": "ou_d0474502fe89122e69d0e13123c7bb45", + "sender": "ou_d0474502fe89122e69d0e13123c7bb45", + "timestamp": "Mon 2026-03-30 12:26 GMT+8" +} +``` + +Sender (untrusted metadata): +```json +{ + "label": "ou_d0474502fe89122e69d0e13123c7bb45", + "id": "ou_d0474502fe89122e69d0e13123c7bb45", + "name": "ou_d0474502fe89122e69d0e13123c7bb45" +} +``` + +https://makee-interactive.feishu.cn/wiki/Tn23wQkUQilduAkvgwscTGhgnUd?fromScene=spaceOverview 好 现在尝试在我发的 知识库文档的子目录层级中 新建一个 "小斑test" 文档，并在里面任意写一句话。 以上均以你的应用权限来做。 +assistant: 需要你先完成lark-cli的应用授权配置： +👉 请打开链接：https://open.feishu.cn/page/cli?user_code=F2XH-H358&lpv=1.0.0&ocv=1.0.0&from=cli +完成授权后我就可以继续在知识库中新建文档了。 +user: System: [2026-03-30 12:28:47 GMT+8] Feishu[xiaoban] DM | ou_d0474502fe89122e69d0e13123c7bb45 [msg:om_x100b53abf13f5cb0b389bf07bb372be] + +Conversation info (untrusted metadata): +```json +{ + "message_id": "om_x100b53abf13f5cb0b389bf07bb372be", + "sender_id": "ou_d0474502fe89122e69d0e13123c7bb45", + "sender": "ou_d0474502fe89122e69d0e13123c7bb45", + "timestamp": "Mon 2026-03-30 12:28 GMT+8" +} +``` + +Sender (untrusted metadata): +```json +{ + "label": "ou_d0474502fe89122e69d0e13123c7bb45", + "id": "ou_d0474502fe89122e69d0e13123c7bb45", + "name": "ou_d0474502fe89122e69d0e13123c7bb45" +} +``` + +能否不使用 lark-cli的应用授权。 而是使用 xiaoban 的 应用配置 ， 在 openclaw.json中有体现。 我已经为xiaoban这个应用配置了足够的权限。 +assistant: 已开始为你在指定知识库节点下创建文档，使用xiaoban应用权限执行，创建完成后会自动通知你结果。 +assistant: 创建失败，未找到对应工具，我将直接调用飞书文档创建接口为你完成操作： +