飞书日志记录技能

📖 功能

用户主动提供日志内容，智能整理、结构化、层次化后写入飞书文档：

• - ✅ 接收用户提供的日志内容（文本、会议记录、事件描述等）
• ✅ 不使用固定模板，根据内容智能整理
• ✅ 结构化层次化组织内容（保留所有关键细节）
• ✅ 使用飞书原生块格式（Block-based）写入内容
• ✅ 创建飞书云盘文件夹（日志/XX 年/XX 月/XX 日/log/）
• ✅ 创建飞书在线文档（主题 + 时间戳）
• ✅ 自动跳过已存在的文件夹（复用已有文件夹）
• ✅ 同一天可以有多个文件
• ✅ 添加用户为协作者（full_access 权限）

🎯 使用场景

• - 会议记录 - 记录会议内容、决策、行动项
• 项目日志 - 记录项目进展、里程碑、问题
• 工作复盘 - 记录每日/每周工作总结
• 重要事件 - 记录关键决策、客户沟通、突发事件
• 学习笔记 - 记录培训内容、技术分享

🔧 使用方式

方式 1: 对话中使用（推荐）

用户直接提供日志内容，例如：

请记录今天的会议内容：

• - 会议主题：[主题名称]
• 时间：[日期和时间]
• 参会人员：[人员名单]
• 主要内容：[讨论要点]
• 决策事项：[达成的决策]
• 下一步：[行动计划]

帮我记录项目进展：

• - 项目名称：[项目名称]
• 当前阶段：[项目阶段]
• 已完成：[完成的工作]
• 遇到问题：[遇到的挑战]
• 下一步计划：[后续安排]

记录今天的工作：

• - 完成的工作项 1
• 完成的工作项 2
• 参加的会议
• 遇到的问题和解决方案

📋 工作流程

步骤 1: 接收并理解内容

• - 阅读用户提供的全部内容
• 理解内容主题和关键信息
• 识别内容类型（会议/项目/工作/其他）

步骤 2: 智能整理与结构化

1. 1. 提取关键信息

1. 2. 层次化组织

1. 3. 保留所有细节

步骤 3: 确认当前日期

• - 获取当前日期（年 - 月-日）
• 用于文件夹命名和文档标题

步骤 4: 创建/复用文件夹结构

飞书云盘/
└── 日志/
└── 2026 年/
└── 03 月/
└── 04 日/
└── log/
├── 2026-03-04 华为会议.docx
└── 2026-03-04 信誉库节点网络配置.docx

逻辑:

1. 1. 检查日志文件夹是否存在 → 不存在则创建
2. 检查2026 年文件夹是否存在 → 不存在则创建
3. 检查03 月文件夹是否存在 → 不存在则创建
4. 检查04 日文件夹是否存在 → 不存在则创建
5. 检查log文件夹是否存在 → 不存在则创建
6. 已存在的文件夹直接复用
7. 添加用户为所有文件夹的协作者（full_access）

步骤 5: 创建文档

• - 文档标题格式：YYYY-MM-DD 主题
• 同一天可以有多个文件（不同主题）
• 添加用户为协作者（full_access 权限）

步骤 6: 写入内容（飞书块格式）

• - 文本块（blocktype: 2）- 普通段落
• 标题块（blocktype: 3/4/5）- H1/H2/H3 标题
• 列表块（blocktype: 12）- 无序列表
• 表格块（简化处理）- 数据表格
• 引用块（blocktype: 14）- 引用内容
• 分割线（block_type: 6）- 视觉分隔

🔐 所需权限

应用身份权限（使用 tenantaccesstoken）

重要：本技能使用 tenantaccesstoken（应用级令牌），无需用户授权即可使用。

权限申请链接

https://open.feishu.cn/app/YOURAPPID/auth?q=drive:drive,drive:file,docx:document,space:folder:create,docs:permission.member:add

Token 获取方式

技能自动使用 tenantaccesstoken，无需手动配置：

javascript
// 内部实现：使用 APPID 和 APPSECRET 获取 tenantaccesstoken
async function getTenantToken() {
const result = await httpRequest(POST, /auth/v3/tenantaccesstoken/internal/, {
body: { appid: CONFIG.APPID, appsecret: CONFIG.APPSECRET }
});
return result.tenantaccesstoken;
}

Token 有效期：2 小时（自动刷新）

⚠️ 配置参数

重要说明：本技能使用 tenantaccesstoken（应用级令牌），所有配置通过环境变量设置。

环境变量设置方式

方式 1：在 .env 文件中配置（推荐）
bash

~/.openclaw/workspace/.env

方式 2：在 Shell 中导出
bash
export FEISHUAPPID=yourappid
export FEISHUAPPSECRET=yourappsecret
export DEFAULTOWNERID=youropenid

🔑 如何获取 Open ID

方法 1: 通过 API 获取

curl -s https://open.feishu.cn/open-apis/contact/v3/users?useridtype=openid&pagesize=10 \
-H Authorization: Bearer $TOKEN | jq .data.items[] | {openid, userid}

方法 2: 从消息事件中获取

方法 3: 从飞书开发者后台查看

📊 输出结果

成功时返回：
json
{
success: true,
date: 2026-03-04,
title: 华为会议记录,
folder: {
root: 日志,
year: 2026 年,
month: 03 月,
day: 04 日,
subfolder: log,
token: fld_xxx
},
document: {
title: 2026-03-04 华为会议记录,
document_id: doxxx,
url: https://feishu.cn/docx/doxxx,
existed: false,
permission_added: true
},
permissions: