name: getnote version: 2.0.1 description: 通过官方 getnote CLI 连接得到大脑，完成浏览器授权、连接诊断、CLI 升级，以及保存、查询、搜索、整理和管理用户的真实笔记。用户明确要求登录、诊断或升级，或要保存链接/图片、查找和查看笔记、整理知识库/文件夹、订阅博主、管理标签时使用；不会自行安装或更新 Skill。 metadata: openclaw: emoji: "🧠" requires: bins: ["getnote"] install: - id: "node-getnote" kind: "node" package: "@getnote/cli" bins: ["getnote"] label: "Install official GetNote CLI (npm)"

得到大脑

让用户在当前 AI 中直接连接、诊断、升级 CLI，以及保存、查找和整理自己的得到大脑内容。本 Skill 理解用户意图、加载对应领域参考，并交给官方 getnote CLI 执行真实操作。

能力与外部影响

• 本 Skill 会按用户请求执行 getnote 命令，并通过得到大脑官方 API 读取或修改当前已授权账号的数据。
• 登录会打开浏览器授权页，并由 CLI 把授权信息保存在其本机配置目录；Skill 不读取、展示或转发完整凭证。
• 保存、更新、归档、分享和删除会修改远端笔记数据，并遵守下方的确认规则。
• 只有用户明确要求升级时才执行 getnote update；不会自行运行 npm、安装其他软件、下载并覆盖本 Skill 或修改其他 Skill 文件。
• getnote 缺失时停止任务并使用平台根据 frontmatter install 声明提供的官方安装流程，不绕过平台审批执行安装命令。

能力概览

不要要求用户记命令。用户用自然语言表达目标即可。

首次连接

1. 执行 getnote version 和 getnote auth status。如果 getnote 不可执行，停止并提示通过平台声明的官方 npm 安装项安装依赖，不直接运行 npm 或本地安装脚本。
2. 尚未授权时运行 getnote auth login 并让用户只在浏览器确认；不得索要 API Key、Cookie 或 Authorization。
3. 执行 getnote doctor -o json。只有 success=true 且 cli、auth、api 三项通过，才能说已经连接。
4. 独立 Skill 包已经包含 5 份领域参考，当前平台直接使用它们，不运行 getnote setup 改写本机 Skill。只有用户明确要求为其他本机 Agent 同步 CLI 内置 Skill 时，才按 references/auth.md 执行。
5. 先运行 getnote notes --limit 1 -o json 做无写入验收。只有用户同意时才保存测试笔记，而且必须返回真实标题、字符串笔记 ID 和可打开的 note_url 才算完成。

每次任务的执行闭环

1. 理解目标：识别用户要处理的对象、动作和目标位置；“这条笔记”“这个博主”等指代不明确时先澄清。
2. 加载领域参考：只读取本次任务涉及的 references/*.md，不要凭印象猜命令、参数或返回字段。
3. 确认真实对象：先读取笔记、知识库、文件夹或标签的真实字符串 ID。名称重名时让用户选择。
4. 执行官方 CLI：机器调用加 -o json；长内容使用领域参考规定的文件或标准输入方式。
5. 判断结果：同时检查退出码、success 和领域结果字段。异步任务轮询到最终状态，不能把“已提交”说成“已完成”。
6. 必要时复读：归档、更新、删除标签等操作按领域参考重新读取结果，确认服务端最终状态。
7. 回复用户：先给结论，再给标题、链接或必要摘要；失败时说明原因、是否可重试、下一步和 request_id。

路由

匹配用户意图后，必须读取并遵循对应领域参考：

• 登录、连接、配额、诊断和更新：references/auth.md
• 保存、查看、修改、分享和深层内容：references/note.md
• 按主题或自然语言查找笔记：references/search.md
• 知识库、文件夹、博主订阅和直播：references/kb.md
• 查看、添加和删除标签：references/tag.md

一个任务涉及多个领域时，按实际步骤依次读取对应参考。例如“找到最近的客户反馈并放进客户档案”先读搜索，再读知识库。

结果呈现标准

• 保存成功：回复标题、字符串 note_id 和真实 note_url。链接或图片仍在生成时持续等待；超时则明确说仍在处理，不伪造完成。
• 笔记列表与搜索：每条至少包含标题和真实链接；有摘要时简短展示。相同 note_id 的多个命中片段按领域参考去重。
• 笔记详情：按用户点名的视图展示标题、总结、原文、录音转写、附件、时间线、快捷笔记或会议待办，不用其他字段冒充。
• 知识库与目录：展示真实名称、Scope 和字符串 ID；归档完成后说明笔记进入了哪个知识库及目录。
• 更新、分享与删除：明确最终状态和影响范围。取消或权限不足不能回复成功。
• 空结果：说明没有找到以及实际搜索范围，可建议换关键词、时间或知识库，但不能编造候选项。
• 失败：用用户能理解的话解释，并保留错误码和 request_id 供排查；敏感凭证不得出现在回复中。

统一规则

• 所有真实操作由官方 getnote CLI 完成；参数不确定时读取对应命令 --help，机器调用统一加 -o json。
• 退出码非 0 一律是失败。成功结果读取 success=true 和领域 Skill 指定的 data 字段；失败结果读取 error.code/message/reason/retryable 和可选 request_id，不能根据自然语言猜成功。
• ID 始终按字符串原样传递；链接只使用真实返回值，不自行拼接域名。
• 写操作结果不确定时先查询原任务或最近结果，禁止盲目重复创建。
• 删除、覆盖、替换全部标签、公开分享和批量移出必须先确认。
• 群聊或共享会话中不主动展开私密全文，先确认请求者和展示范围。
• 失败时说明真实原因、是否可重试和下一步，并保留 request_id；不能伪造成功。

常见恢复方式

• unauthorized 或授权过期：读 references/auth.md，引导浏览器重新授权，不索取凭证。
• forbidden：说明当前账号或团队角色没有权限，不绕过权限或换 ID 猜测。
• not_found：重新解析真实笔记、知识库或目录 ID；环境不同的链接和 ID 不能混用。
• conflict：先读取当前版本或既有目录，避免覆盖和重复创建。
• rate_limited：按返回的重试提示等待，不高频循环调用。
• 网络中断或结果不确定：只做查询核验，不自动重复写入。

用户要求更新

区分两种更新，不扩大用户授权：

• 用户要求“升级得到大脑 CLI”时，按 references/auth.md 先检查再执行 getnote update，随后运行诊断并验证读取能力。
• 用户要求“更新这个 Skill”时，使用 ClawHub/OpenClaw 的 Skill 更新流程；本 Skill 不下载或覆盖自身文件。
• 用户只说“更新得到大脑”而无法从上下文判断对象时，先说明 CLI 与 Skill 是两个独立组件并询问要更新哪一个。

得到大脑（Get笔记）Skill

让 AI 成为你的第二大脑。随时记录，需要时召回。

✨ 核心能力

📦 安装

方式一：把一句话发给 AI（推荐）

把这句话发给 WorkBuddy、Claude、Codex 等 AI：

请从 https://github.com/iswalle/getnote-openclaw 安装得到大脑 Skill，并引导我完成授权。

方式二：下载 Skill 安装包

打开 得到大脑 Skill 发布页，下载最新版 ZIP，拖进 AI 的聊天框，然后说：

请安装这个得到大脑 Skill，并引导我完成授权。

🔑 授权登录

首次使用时，AI 会打开得到大脑授权页面。你只需在浏览器确认，不需要手动复制 API Key。

安装完成后，AI 会依次确认：

1. 得到大脑 CLI 可以运行；
2. 已在浏览器完成账号授权；
3. 可以读取当前账号的笔记；
4. 当前 AI 已加载保存、搜索、知识库和标签能力。

默认先读取最近一条笔记验收，不会擅自创建测试内容。CLI 依赖由 Skill 声明给平台，并通过平台的安装确认流程安装；Skill 本身不会执行下载脚本或自行覆盖文件。

🛠 支持的笔记类型

创建笔记支持：

• 指定知识库，直接存入普通、书籍、客户档案或有写权限的团队知识库；
• 选择知识库文件夹，把笔记直接归档到指定位置；
• 指定字符串父笔记 ID 创建子笔记；
• 使用幂等请求避免网络重试造成重复创建。

语音和会议笔记还能独立读取摘要、转写原文、附件、时间线、快捷笔记和会议待办。

💡 使用场景与进阶用法

✏️ 随手记录

通勤路上想到一个点子

👤 记一下笔记：支付流程可以加一个进度条，用户等待时不焦虑

🤖 已记录，自动打上「产品优化」标签。

听播客时有感触

👤 刚听到一个观点挺好的，记一下：好的产品是让用户少做选择，不是多做选择

🤖 已记录。

开完会

👤 帮我记下刚才会上定的几件事：1. 下周三前完成设计稿 2. 找小王对接接口 3. 周五前给老板汇报进度

🤖 已记录。

🔗 保存链接和图片

看到好文章

👤 存到笔记 https://example.com/article

🤖 链接已提交，正在抓取分析中... 🤖 搞定 ✓ 已保存：《如何做好产品设计》

拍到有用的东西

👤 [发送图片]

🤖 存到笔记？

👤 对

🤖 搞定 ✓ 图片已保存。

探店记录

👤 记一下，这家店叫船歌鱼水饺，招牌是鲅鱼饺子，人均80

🤖 已记录，打上「美食」标签。

🔍 要用时召回

写周报时

👤 帮我找找这周我记过的工作相关的东西

🤖 找到 5 条相关笔记：周一你记了客户反馈的问题、周三记了技术方案讨论、周四......

被领导问到

👤 上次我们讨论过用户分层的事，当时怎么说的来着？

🤖 11月8号你记过：高价值用户定义为月消费超过500元，占比约12%......

写文章找素材

👤 我想写篇关于做产品的文章，帮我找找我之前的相关想法

🤖 找到 8 条相关笔记，已按时间排序整理给你。

📚 整理到知识库

你可以直接对 AI 说：

在“产品研究”知识库里新建“竞品”文件夹，把刚才那篇笔记放进去。

把这个抖音博主订阅到“行业观察”知识库。

AI 会先读取真实知识库、文件夹和权限，再执行操作，不会根据名称猜 ID。默认知识库、书籍、客户档案和团队知识库都会按当前账号实际权限展示。

🚀 用笔记内链实践柳比歇夫时间日志法

柳比歇夫时间日志法的核心是每天记录自己把时间花在了哪里，事后统计、复盘、改进。

结合 Get笔记内链，AI 可以帮你自动串联：

每天早上

👤 帮我记一条今日工作日志，内链到「产品设计方案」和「客户反馈」这两条笔记

🤖 已记录「2026-04-24 工作日志」，正文已插入两条内链。

每周复盘

👤 找找我这周的工作日志，整理一下时间分配

🤖 找到 5 条日志，你这周：产品设计 12h、客户沟通 6h、开会 4h……

内链格式：在笔记正文里用 https://biji.com/note/{note_id} 引用其他笔记。告诉 AI 要内链到哪条笔记，AI 会自动找到真实 ID 并插入。

🔄 更新

直接对 AI 说：

帮我把得到大脑更新到最新版，并检查是否能正常读取和保存笔记。

AI 会先确认你要更新的是官方 CLI 还是 Skill：CLI 使用 getnote update，Skill 使用 ClawHub/OpenClaw 的更新流程；两者不会互相覆盖。

🔐 安全说明

⚠️ 隐私保护：笔记是你的私密数据，AI 会严格校验身份。

• 默认返回只有当前账号能打开的私有笔记链接；
• 群聊和共享会话中不会主动展开私密笔记全文；
• 删除、覆盖、替换全部标签和公开分享前会先确认；
• 不会要求你在聊天中发送 API Key、Cookie 或 Authorization；
• 失败会说明真实原因和下一步，并保留 request_id 方便排查。

🆕 更新日志

📜 相关链接

• Get笔记官网
• 开放平台
• ClawHub
• 开通会员

License

MIT