每日知识沉淀引擎(KAPE)。自动完成:下载昨日Get笔记 → 结合对话记录 → 深度分析学习、感悟、工作状态 → 生成重点摘要日志简报 → 同步归档至Get笔记(带标签)+ 飞书知识库 + 飞书文档。触发场景:整理昨天的日志。
KAPE — 知识自动沉淀引擎 v0.1.18
功能概述
KAPE — 知识自动沉淀引擎 v0.1.18是一项面向实际任务的技能,主要用于本 skill 需要以下工具权限:;exec :调用 getnote CLI 获取笔记数据(只读操作);
核心要点
- feishu_wiki 、 feishu_doc :写入飞书文档;
- sessions_list 、 sessions_history :读取对话记录;
- 不会执行任何本地文件写入之外的 shell 命令 ,所有外部 API 调用均为只读。
使用与执行
它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。
结果检查与注意事项
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
KAPE — 知识自动沉淀引擎 v0.1.18
安全说明
本 skill 需要以下工具权限:
exec:调用 getnote CLI 获取笔记数据(只读操作)feishu_wiki、feishu_doc:写入飞书文档sessions_list、sessions_history:读取对话记录
不会执行任何本地文件写入之外的 shell 命令,所有外部 API 调用均为只读请求。
重要:禁止直接调用 https://openapi.biji.com/... HTTPS API(会返回 10004 未授权),必须使用 getnote CLI。
凭证配置
Get笔记 API 凭证存储位置:
GETNOTE_CLIENT_ID→openclaw.json的skills.entries.getnote.env.GETNOTE_CLIENT_IDGETNOTE_API_KEY→secrets.json的skills.entries.getnote.apiKey(SecretRef 解析后的实际值)
飞书 appSecret → secrets.json 的 channels.feishu.accounts.main.appSecret
⚠️ 核心约束:cron isolated session 不会自动注入环境变量
GETNOTE_CLIENT_ID和GETNOTE_API_KEY,所有调用 Get笔记 CLI 的 shell 命令前必须先从配置文件读取凭证(详见下方「运行时凭证读取」章节)。不读取凭证直接调用 CLI 会导致"API 未授权"错误。
飞书机器人需已加入知识库成员,否则 feishu_wiki(spaces) 返回空。
运行时凭证读取
⚠️ 所有调用 Get笔记 CLI 的步骤(第零步、第一步、第三步等),必须先执行以下凭证读取代码,再执行 CLI 命令。isolated session 无环境变量注入,绝不能省略此步骤。
GETNOTE_CLI="/Users/openclawer/.npm-global/lib/node_modules/@getnote/cli/bin/getnote"
# 从配置文件读取凭证(isolated session 不会自动注入环境变量)
GETNOTE_CFG=$(python3 -c "
import json
with open('/Users/openclawer/.openclaw/openclaw.json') as f:
oc = json.load(f)
with open('/Users/openclawer/.openclaw/secrets.json') as f:
sec = json.load(f)
# GETNOTE_CLIENT_ID:从 openclaw.json 直接读取
client_id = oc.get('skills',{}).get('entries',{}).get('getnote',{}).get('env',{}).get('GETNOTE_CLIENT_ID','')
# GETNOTE_API_KEY:从 secrets.json 读取(SecretRef 解析)
apikey_ref = oc.get('skills',{}).get('entries',{}).get('getnote',{}).get('apiKey',{})
if isinstance(apikey_ref, dict) and apikey_ref.get('source') == 'file':
key_path = apikey_ref.get('id','')
apikey = sec
for k in key_path.split('/'):
if k:
apikey = apikey.get(k, {})
api_key = apikey if isinstance(apikey, str) else apikey.get('apiKey','')
else:
api_key = str(apikey_ref)
print(f'{client_id}n{api_key}')
")
GETNOTE_CLIENT_ID=$(echo "$GETNOTE_CFG" | sed -n '1p')
GETNOTE_API_KEY=$(echo "$GETNOTE_CFG" | sed -n '2p')
# 验证读取结果(不打印完整 key)
echo "CLIENT_ID: ${GETNOTE_CLIENT_ID:0:10}..."
echo "API_KEY: ${GETNOTE_API_KEY:0:10}..."
共享文件夹配置
飞书文档统一存放在共享文件夹「牛管家日志」,确保张公子有删除权限。
| 配置项 | 值 |
|---|---|
| 文件夹名称 | 牛管家日志 |
| 文件夹 token | FQfXfYBGGllxxydJ1SgcJZWqnpf |
| 文件夹 URL | https://qcnu4qzh46f0.feishu.cn/drive/folder/FQfXfYBGGllxxydJ1SgcJZWqnpf |
| 张公子权限 | full_access(可删除文档) |
核心工作流
每天自动生成日志简报,三端同步归档。每个平台每次只执行一次原子操作,不允许先创建空文档再单独写入。
第零步:Get笔记 凭证读取与授权检查
⚠️ 重要:必须先读取凭证,再检查/执行授权。isolated session 无环境变量注入,不读取凭证会导致"API 未授权"。
第一步:读取凭证 + 检查认证状态
GETNOTE_CLI="/Users/openclawer/.npm-global/lib/node_modules/@getnote/cli/bin/getnote"
# 读取凭证
GETNOTE_CFG=$(python3 -c "
import json
with open('/Users/openclawer/.openclaw/openclaw.json') as f:
oc = json.load(f)
with open('/Users/openclawer/.openclaw/secrets.json') as f:
sec = json.load(f)
client_id = oc.get('skills',{}).get('entries',{}).get('getnote',{}).get('env',{}).get('GETNOTE_CLIENT_ID','')
apikey_ref = oc.get('skills',{}).get('entries',{}).get('getnote',{}).get('apiKey',{})
if isinstance(apikey_ref, dict) and apikey_ref.get('source') == 'file':
key_path = apikey_ref.get('id','')
apikey = sec
for k in key_path.split('/'):
if k:
apikey = apikey.get(k, {})
api_key = apikey if isinstance(apikey, str) else apikey.get('apiKey','')
else:
api_key = str(apikey_ref)
print(f'{client_id}n{api_key}')
")
GETNOTE_CLIENT_ID=$(echo "$GETNOTE_CFG" | sed -n '1p')
GETNOTE_API_KEY=$(echo "$GETNOTE_CFG" | sed -n '2p')
# 检查认证状态
${GETNOTE_CLI} auth status
第二步:根据认证状态决定操作
- 若返回
Not authenticated:${GETNOTE_CLI} auth login --api-key "${GETNOTE_API_KEY}" --client-id "${GETNOTE_CLIENT_ID}"等待Logged in successfully.确认后再继续。 - 若返回
Authenticated:直接继续,不做任何操作。
第一步:确定日期范围
- 目标日期:昨天
- 获取方式:
- 使用
date命令获取当前日期:date +%Y-%m-%d - 用
date命令计算昨天的日期:date -v-1d +%Y-%m-%d - 用
date命令验证星期:date -jf "%Y-%m-%d" "<目标日期>" +%A
- 使用
- 输出要求:在生成简报前,先输出
目标日期:YYYY-MM-DD(周X),并用date命令确认 - 日期格式:
YYYY-MM-DD(用于字符串前缀匹配)
第二步:获取数据(并行)
Get笔记读取
⚠️ 重要:Get笔记 API 必须通过
getnoteCLI 调用,禁止直接调用https://openapi.biji.com/...(会返回10004 未授权)。
读取步骤:
设置 CLI 路径 + 读取凭证(必须先读取凭证,因为 isolated session 无环境变量):
GETNOTE_CLI="/Users/openclawer/.npm-global/lib/node_modules/@getnote/cli/bin/getnote" # 读取凭证(isolated session 不会自动注入环境变量) GETNOTE_CFG=$(python3 -c " import json with open('/Users/openclawer/.openclaw/openclaw.json') as f: oc = json.load(f) with open('/Users/openclawer/.openclaw/secrets.json') as f: sec = json.load(f) client_id = oc.get('skills',{}).get('entries',{}).get('getnote',{}).get('env',{}).get('GETNOTE_CLIENT_ID','') apikey_ref = oc.get('skills',{}).get('entries',{}).get('getnote',{}).get('apiKey',{}) if isinstance(apikey_ref, dict) and apikey_ref.get('source') == 'file': key_path = apikey_ref.get('id','') apikey = sec for k in key_path.split('/'): if k: apikey = apikey.get(k, {}) api_key = apikey if isinstance(apikey, str) else apikey.get('apiKey','') else: api_key = str(apikey_ref) print(f'{client_id}n{api_key}') ") GETNOTE_CLIENT_ID=$(echo "$GETNOTE_CFG" | sed -n '1p') GETNOTE_API_KEY=$(echo "$GETNOTE_CFG" | sed -n '2p')检查认证状态(如未认证则登录):
${GETNOTE_CLI} auth status- 若返回
Not authenticated:${GETNOTE_CLI} auth login --api-key "${GETNOTE_API_KEY}" --client-id "${GETNOTE_CLIENT_ID}" - 若返回
Authenticated:直接继续
- 若返回
读取并过滤目标日期笔记(必须完成全部分页读取):
# ⚠️ CLI 输出格式:ID | Title | Type | Created(日期在最后一列,行首是笔记ID) # ⚠️ 正确写法:grep "2026-05-28 "(尾部空格),匹配最后一列的日期 # ❌ 错误写法:grep "^2026-05-28" —— 日期不在行首,永远匹配不到,**严禁使用** TARGET_DATE="2026-05-28" # 昨日日期,格式 YYYY-MM-DD ${GETNOTE_CLI} notes --since-id 0 --limit 200 2>/dev/null | grep "${TARGET_DATE} "分页读取(防止遗漏):当笔记数超过 200 条时,用最后一条笔记 ID 作为下次
since-id继续读取,循环直至has_more=false:# 第一页 ${GETNOTE_CLI} notes --since-id 0 --limit 200 2>/dev/null | grep "${TARGET_DATE} " # 下一页:用上一步最后一条笔记 ID 替换 0 ${GETNOTE_CLI} notes --since-id--limit 200 2>/dev/null | grep "${TARGET_DATE} " # 循环继续直至 has_more=false 获取单条笔记详情:
${GETNOTE_CLI} note--field content # 获取正文 ${GETNOTE_CLI} note --field title # 获取标题
对话记录获取
- 用
sessions_list获取所有 session(设置足够的activeMinutes覆盖目标日期) - 判断 session 在目标日期有活动的条件:
updatedAt>= 目标日期开始时间 ANDupdatedAt< 今日开始时间 - 用
sessions_history读取符合条件的 session 内容(includeTools=false) - 解析用户消息(
role: user)作为对话记录
词汇存档(若有)
- 容错读取:用
exec+cat读取workspace/vocabulary/{target_date}.md,若文件不存在或读取失败则跳过,不阻断流程 - 统计当日新增单词数量(如有)
⚠️ 路径处理规范:所有从
memory_search或sessions_list等工具返回的路径,返回格式可能为 Markdown 链接(如[2026-04-05.md](http://...)或纯路径。传给read工具前,必须先去除 Markdown 链接格式,只提取纯路径部分。
第三步:深度分析与整理
⚠️ 内容过滤规则(v0.1.6 新增,必须执行) 整理前需剔除【科技新闻日报】自动生成的内容:
- 排除文件:
memory/YYYY-MM-DD-tech-news.md- 排除文档:飞书文档标题含「科技新闻日报」或「科技新闻热榜」
- 排除笔记:Get笔记标签或来源为「科技新闻日报」相关条目
- 仅保留张公子个人学习、播客、录音、网页剪藏、手动笔记等主动获取内容
生成日志简报结构(见 references/briefing-template.md)
⚠️ 强制完整输出规则(v0.1.7 新增):无论输入数据多少,哪怕只有1条笔记,也必须生成完整模板的所有区块。简报不是摘要,是完整的结构化记录。
生成主题关联图(v0.1.5 新增): 根据当日笔记和对话记录,自动提取3-5个核心主题,标注主题间的关联关系。
关联类型标签:
→因果关系(A导致B)⟶支撑关系(A证实/支持B)⇄竞争关系(A与B竞争)↙衍生关系(A衍生出B)
飞书文档中使用列表格式替代 ASCII 图形。
第四步:写入本地文件
必须先确保目录存在:
mkdir -p /Users/openclawer/.openclaw/workspace/日志管理
文件路径:/Users/openclawer/.openclaw/workspace/日志管理/{target_date}-日志简报.md
第五步:三端同步归档(一次性操作到位)
⚠️ 核心原则:每个平台每次只执行一次原子操作。不允许先创建空文档/空笔记,再单独写入内容的分步操作。如果写入失败,先删除已创建的半成品,再重新执行完整的原子操作。
CLI 路径常量(所有 lark-cli 命令必须使用完整路径):
LARK_CLI="/Users/openclawer/.npm-global/bin/lark-cli"
① Get笔记(使用 getnote save 原子操作)
GETNOTE_CLI="/Users/openclawer/.npm-global/lib/node_modules/@getnote/cli/bin/getnote"
# 读取凭证(isolated session 不会自动注入环境变量)
GETNOTE_CFG=$(python3 -c "
import json
with open('/Users/openclawer/.openclaw/openclaw.json') as f:
oc = json.load(f)
with open('/Users/openclawer/.openclaw/secrets.json') as f:
sec = json.load(f)
client_id = oc.get('skills',{}).get('entries',{}).get('getnote',{}).get('env',{}).get('GETNOTE_CLIENT_ID','')
apikey_ref = oc.get('skills',{}).get('entries',{}).get('getnote',{}).get('apiKey',{})
if isinstance(apikey_ref, dict) and apikey_ref.get('source') == 'file':
key_path = apikey_ref.get('id','')
apikey = sec
for k in key_path.split('/'):
if k:
apikey = apikey.get(k, {})
api_key = apikey if isinstance(apikey, str) else apikey.get('apiKey','')
else:
api_key = str(apikey_ref)
print(f'{client_id}n{api_key}')
")
GETNOTE_CLIENT_ID=$(echo "$GETNOTE_CFG" | sed -n '1p')
GETNOTE_API_KEY=$(echo "$GETNOTE_CFG" | sed -n '2p')
# content 必须是完整简报正文,不允许简写
${GETNOTE_CLI} save "<完整简报正文>"
--title "日志简报 {target_date} | 张公子"
--tag AI整理
--tag 日志简报
⚠️ 禁止直接调用
https://openapi.biji.com/...HTTPS API,必须使用getnote saveCLI。
② 飞书知识库(先创建节点 → 再写入内容,两步都是原子的)
⚠️ 节点层级结构:
- 个人知识库(space_id:
7621391289904516315)日志简报节点(node_token:SERDwHBAniUqqBkx5vNctvgKn6f)- 每日日志简报文档(创建在此节点下)
步骤 1:创建 wiki 节点(原子操作)
cd /Users/openclawer/.openclaw/workspace/日志管理
${LARK_CLI} wiki +node-create
--space-id 7621391289904516315
--parent-node-token SERDwHBAniUqqBkx5vNctvgKn6f
--title "日志简报 {target_date} | 张公子"
- 从返回的
obj_token提取新文档的 doc token - 从返回的
node_token提取新 wiki 节点 token
步骤 2:写入简报内容(原子操作)
${LARK_CLI} docs +update
--api-version v2
--doc ""
--command overwrite
--doc-format xml
--content @./2026-05-25-日志简报.md
⚠️
--doc-format xml必须明确指定(默认 xml)。 ⚠️ 重要:飞书文档 不支持 Markdown 表格(写入时表格内容会丢失)。如简报包含表格,必须使用--doc-format xml并提供 XML 格式内容,XML 表格结构为。
... ...
步骤 3:记录知识库 URL
③ 飞书文档(创建+写入一次完成,再授权)
步骤 1:获取 tenant_access_token
python3 -c "
import json, urllib.request
with open('/Users/openclawer/.openclaw/openclaw.json') as f:
d = json.load(f)
# appSecret 从 secrets.json 读取
with open('/Users/openclawer/.openclaw/secrets.json') as f:
sec = json.load(f)
app_secret = sec.get('channels',{}).get('feishu',{}).get('accounts',{}).get('main',{}).get('appSecret','')
req = urllib.request.Request(
'https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal',
data=json.dumps({'app_id':'cli_a94b4a1e43781cc7','app_secret':app_secret}).encode(),
headers={'Content-Type':'application/json'}
)
resp = urllib.request.urlopen(req, timeout=10)
print(resp.read().decode())
"
步骤 2:创建文档并写入内容(原子操作)
cd /Users/openclawer/.openclaw/workspace/日志管理
${LARK_CLI} docs +create
--api-version v2
--parent-token FQfXfYBGGllxxydJ1SgcJZWqnpf
--doc-format xml
--content @./2026-05-25-日志简报.md
⚠️ 禁止先创建空文档再单独写入。必须在
--content中直接提供完整内容。 ⚠️ 重要:飞书文档 不支持 Markdown 表格,如简报包含表格,必须改用--doc-format xml并提供 XML 格式内容。
步骤 3:提取 document_id(从返回的 document.document_id)
步骤 4:授予张公子 full_access 权限
curl -X POST 'https://open.feishu.cn/open-apis/drive/v1/permissions//members?type=docx' -H 'Authorization: Bearer {tenant_access_token}' -H 'Content-Type: application/json' -d '{"member_type":"openid","member_id":"ou_d8ace8a146610ca26bc07d8e68a5620f","perm":"full_access"}'
步骤 5:记录文档 URL
第六步:用户反馈
向用户发送完成通知,包含:
- Get笔记数量(分类统计:录音/播客/纯文本等)
- 参考对话记录数量
- 简报核心发现摘要(1-3句话)
- 各端存储结果链接
错误处理原则
- 任何一步失败不影响其他步骤:三端归档是独立的,写入本地文件是最基本的保障
- 明确告知用户失败原因:如果某个平台失败,需要在反馈中说明
- 不要静默失败:如果关键步骤(如获取数据)失败,必须通知用户
- 写入前先查重:写入前先检查目标日期是否已有同名笔记/文档,若有则先删除再创建
热门AI工具
相关专题
SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。
0
2026.11.17
SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。
0
2026.11.17
本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。
0
2026.11.12
本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.12
本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。
0
2026.11.12
本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。
0
2026.11.06
围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。
0
2026.11.06
详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。
0
2026.11.06
DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。
0
2026.11.05
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.9万人学习
共6课时 | 54.7万人学习