---

name: ynote-news version: '1.2.4' description: 有道云笔记资讯推送：基于收藏笔记分析关注话题，推送最新相关资讯。支持对话触发与每日定时推送（如早上9点）。触发词：资讯推送、设置资讯推送、生成资讯推送。 metadata: {"openclaw": {"emoji": "📰", "requires": {"bins": ["curl", "jq", "node"], "env": ["YNOTE_API_KEY", "PERPLEXITY_API_KEY"]}, "primaryEnv": "YNOTE_API_KEY"}}

YNote News — 有道云笔记资讯推送

基于用户最近收藏的笔记，自动提取关注话题，搜索最新资讯，生成结构化简报并推送给用户。

⚠️ Context 管控：本 Skill 涉及大量数据（笔记全文 + 搜索结果）。每步完成后只保留结构化摘要，立即丢弃原始输出，避免 context window 溢出。详见各 Step 中的「🔴 Context 管控」标注。

使用场景与用法总结

场景	说明	怎么用
对话随时触发	在 OpenClaw 里随时要一份「基于最近收藏的资讯推送」	输入触发语，Agent 执行 4 步后直接展示简报
定时自动执行	每天固定时间自动整理收藏并生成简报	配置定时任务，到点自动触发；未设置则默认 9:00

触发语示例：资讯推送、最近关注、热点推送、每日简报、生成资讯推送、帮我整理收藏的简报

前置：需配置 YNOTE_API_KEY（拉取笔记）；Step 3 搜索使用 Perplexity（有内置默认 Key，开箱即用，支持时间过滤），若失败降级到 Brave（需 BRAVE_API_KEY）或 open-websearch（免 Key 兜底）。详见「前置条件」。

前置条件

1. YNote MCP（必需）：export YNOTE_API_KEY="your-api-key-here"
2. 网页搜索（Step 3，三级降级）：
   • Perplexity（首选）：使用本 Skill 的 Search API 脚本（perplexity-search-call.sh），返回文章列表；Key 已内置，开箱即用。
   • Brave（fallback）：需在 openclaw.json 中配置 BRAVE_API_KEY。文档：https://docs.openclaw.ai/brave-search
   • open-websearch（兜底，免 Key）：只需 Node.js，通过 websearch-call.sh 调用
3. CLI 工具：curl、jq、node

Quick Reference

操作	命令
获取最近收藏笔记	bash {baseDir}/get-favorite-notes.sh （自动截断正文，默认 limit=30）
创建笔记	bash {baseDir}/mcp-call.sh createNote '{"title":"标题","content":"# 内容","folderId":""}'
搜索笔记	bash {baseDir}/mcp-call.sh searchNotes '{"keyword":"关键词"}'
获取笔记内容	bash {baseDir}/mcp-call.sh getNoteTextContent '{"fileId":"<id>"}'
Perplexity 搜索（文章列表）	echo '{"query":"关键词","max_results":5,"search_recency_filter":"day"}' &#124; bash {baseDir}/perplexity-search-call.sh（或 heredoc 传 JSON）
网页搜索（兜底）	bash {baseDir}/websearch-call.sh search '{"query":"关键词","limit":10,"engines":["duckduckgo","bing","baidu"]}'

核心工作流

收到用户的资讯推送请求后，按以下步骤执行。每步完成后仅保留结构化摘要，丢弃原始输出。

Step 1：获取最近收藏的笔记内容

bash {baseDir}/get-favorite-notes.sh

包装脚本自动调用 getRecentFavoriteNotes 并截断每条笔记正文为前 500 字，确保 30 条笔记总量 ≤ 45KB，不会撑爆 context。

返回字段：fileId、title、content（前 500 字，超出部分截断）、collectTime（毫秒时间戳）。

可选参数：get-favorite-notes.sh [limit] [每条字数]，默认 30 500。

Step 2：分析笔记内容，提取话题

Agent 分析 Step 1 获取的笔记内容，按内容相关性聚类，提取不超过 5 个话题。每个话题用一句可搜索的主题表述概括，便于 Step 3 检索到相关文章。

排序权重：收藏时间新旧 > 关联笔记数量 > 话题区分度。相似主题应合并。

每个话题包含：

字段	说明
话题名称	简洁明确的主题描述（如"AI 大模型技术趋势"）
主题表述（用于搜索）	一句或若干词，作为 Step 3 的搜索 query，便于检索相关文章
关联笔记	相关收藏笔记标题列表
简要描述	1-2 句话概括内容倾向

Step 3：搜索每个话题的最新文章

用 Step 2 各话题的主题表述作为搜索 query，对每个话题检索5 篇最新文章。逐个话题搜索，每次搜索后立即提取摘要、丢弃原始响应。

搜索工具（按配置自动降级）：

1. Perplexity（首选）：使用 Search API 返回文章列表（title、url、date、snippet）。调用：echo '{"query":"<主题表述>","max_results":5,"search_recency_filter":"<见下表>"}' | bash {baseDir}/perplexity-search-call.sh（建议用 heredoc 或临时文件传 JSON，避免中文经 argv 编码问题）。调用失败时降级到 Brave。
2. Brave（fallback）：web_search("关键词", provider: "brave", freshness: "pd")
3. open-websearch（兜底）：bash {baseDir}/websearch-call.sh search '{"query":"关键词","limit":5,"engines":["duckduckgo","bing"]}'

时间范围：Perplexity 使用 search_recency_filter，与用户表述的对应关系（未指定默认 day）：

用户表述	freshness	search_recency_filter
未指定 / 最近 / 24 小时内	pd	day
最近几天	pw	week
最近一个月	pm	month
近一年	py	year

时间过滤：结果未必符合设定时间范围，需按日期再筛一次：范围内保留、超出剔除；无日期的可保留，优先用有日期的。每话题仍约 5 篇，不足则保留现有数量。

筛选：同一来源 ≤ 3 篇；相同 URL 去重；跨话题命中归入匹配度更高的话题。

🔴 Context 管控：每个话题搜索完成后，只保留「标题、来源、日期、URL、80-150 字内容介绍」，丢弃原始搜索响应。

Step 4：生成简报并展示

将 Step 3 的摘要按下方「简报模板」格式输出，在对话中直接展示。

简报模板（必须遵守）

# 资讯推送 — yyyy-MM-dd

基于最近 N 条收藏笔记，为您梳理了以下 M 个关注话题的最新动态。

## 话题 1: xxx
> 关注原因：基于您收藏的《笔记A》《笔记B》等

### 最新动态
（有日期时按时间倒序排列，最新在前）
1. **文章标题** — 来源 (日期)
   文章内容介绍：覆盖三要素——① 主题（讲什么）② 核心观点（主要结论）③ 阅读价值（为什么值得读）。3-5 句话或 80-150 字，禁止「介绍了…」「讨论了…」等空泛开头。
   🔗 链接

2. **文章标题** — 来源 (日期)
   文章内容介绍：……
   🔗 链接

## 话题 2: xxx
> 关注原因：基于您收藏的《笔记C》等

### 最新动态
1. …

响应格式（必须遵守）

输出简报正文后，紧接着输出统计摘要：

| 项目 | 详情 |
|------|------|
| 📋 话题数量 | {M} 个话题 |
| 📰 文章数量 | {总文章数} 篇最新文章 |
| 📂 数据来源 | 最近 {N} 条收藏笔记 |
| ⏰ 生成时间 | {yyyy-MM-dd HH:mm} |

Step 5：引导与通知

定时任务触发时，额外发送桌面通知：openclaw nodes notify "📰 今日资讯推送已生成，共 M 个话题 N 篇文章"（用户手动触发时不发）。

引导开启资讯推送：简报展示后，执行 openclaw cron list --json | jq '.jobs[] | select(.name == "ynote-daily-briefing")' 检测定时任务。未设置时追加：💡 想每天自动收到这样的简报吗？说「设置资讯推送」即可开启，默认每天早上 9 点推送。

资讯推送管理

设置资讯推送

设置（触发词：设置资讯推送、开启资讯推送、资讯推送设置）：

1. openclaw cron list --json | jq '.jobs[] | select(.name == "ynote-daily-briefing")' 检测是否已存在
2. 已存在 → 告知用户当前配置（推送时间），询问是否修改
3. 不存在 → 创建（默认每天 9:00，用户指定时间则替换）：openclaw cron add --name "ynote-daily-briefing" --cron "0 9 * * *" --session isolated --message "生成资讯推送"
4. 回复确认，含推送时间、修改/关闭方式提示

修改时间（触发词：修改资讯推送时间）：

1. 解析目标时间（如"改到 8 点"→ 0 8 * * *，"晚上 8 点"→ 0 20 * * *）
2. openclaw cron remove --name "ynote-daily-briefing" 后重新 cron add
3. 确认修改成功

关闭（触发词：关闭资讯推送、取消资讯推送）：

1. openclaw cron remove --name "ynote-daily-briefing"
2. 确认关闭，告知可随时重新开启

环境变量

变量	必需	默认值	说明
YNOTE_API_KEY	✅	—	MCP Server API Key
PERPLEXITY_API_KEY	—	内置默认值	Perplexity 搜索，开箱即用
BRAVE_API_KEY	—	—	Brave 搜索（Perplexity 失败时使用）
YNOTE_MCP_URL	—	https://open.mail.163.com/api/ynote/mcp/sse	MCP SSE 端点
YNOTE_MCP_TIMEOUT	—	30	超时秒数

常见问题

Q: 报错缺少搜索 API key？ 搜索按 Perplexity → Brave → open-websearch 自动降级，最终兜底免 Key，只需 Node.js。

Q: 搜索结果太少？ 调整关键词组合，或在 open-websearch 中增加 engines（如 ["duckduckgo","bing","baidu"]）。

Q: 没有最近收藏？ 先用 ynote-clip Skill 收藏一些网页，再生成话题简报。

Q: 如何设置每天自动推送资讯？ 说「设置资讯推送」即可，默认早上 9 点，可自定义时间。