Get笔记

核心用法

Get笔记是一款面向AI Agent场景设计的个人笔记管理技能，主要提供四大功能模块：

1. 智能保存（/note save）

• 支持文本速记、链接收藏、图片归档三种模式
• 采用异步轮询机制确保内容完整保存
• 自然语言触发词：「记一下」「存到笔记」「保存」「收藏」

2. 语义搜索（/note search）

• 全局语义搜索：基于向量匹配召回相关笔记
• 知识库限定搜索：在特定知识库内精准检索
• 自然语言触发词：「搜一下」「找找笔记」「最近存了什么」

3. 知识库管理（/note kb）

• 支持知识库CRUD（创建、读取、更新、删除）
• 博主订阅与直播订阅功能
• 构建结构化个人知识体系

4. 标签与列表（/note tag, /note list）

• 灵活的标签增删管理
• 笔记列表浏览、详情查看、更新与删除

显著优点

• 深度集成AI工作流：专为Agent场景设计，API设计符合AI调用习惯
• 语义检索能力：超越关键词匹配，支持意图理解式搜索
• 隐私优先架构：支持GETNOTE_OWNER_ID绑定，确保数据仅对授权用户可见
• 异步处理机制：大内容保存采用轮询确认，保证数据完整性
• int64安全处理：针对JavaScript精度丢失问题提供明确解决方案

潜在缺点与局限性

• 会员门槛：核心功能（如高级搜索、大批量操作）需要会员资格（错误码10201）
• 限流策略：创建笔记建议间隔1分钟以上，高频场景受限
• 认证依赖：必须配置GETNOTE_API_KEY和GETNOTE_CLIENT_ID才能使用
• 生态封闭性：目前主要服务Get笔记自有平台，第三方集成有限

适合人群

• 需要AI助手协助管理碎片化信息的效率用户
• 构建个人知识管理体系的学习者、研究者
• 希望「对话即记录」的AI原生用户群体

常规风险

• API密钥泄露风险：gk_live_xxx格式密钥需妥善保管
• 数据隐私边界：虽支持OWNER_ID校验，但Agent侧仍需严格遵守「不在群聊主动展示」规则
• 服务可用性依赖：错误码50000/30000表明存在服务端不稳定场景，建议关键数据本地备份

Get笔记 Skill 综合评估

核心用法

Get笔记 Skill 是罗辑思维/得到公司官方推出的个人知识管理工具，主打「随时收藏、智能检索、体系化管理」三大场景。用户可通过自然语言或指令完成：

• 速记保存：支持链接（自动抓取网页内容）、图片（OCR识别+原图存储）、纯文本三种模式，一句「记一下」即可触发
• 语义搜索：基于向量召回的全局搜索，支持跨知识库筛选，找笔记无需精确关键词
• 知识库管理：创建专题知识库、订阅博主内容、整合直播笔记，构建个人知识图谱
• 标签体系：灵活打标签、删标签，配合搜索实现多维分类

技术实现上采用 OAuth 2.0 Device Flow 标准授权，所有数据通过 HTTPS 传输至 Get笔记官方 API（openapi.biji.com），笔记 ID 以字符串形式处理避免 JavaScript 精度丢失问题。

显著优点

1. 官方背书，来源可信：北京罗辑思维/得到公司（T2级可信组织）维护，GitHub 仓库公开透明，无恶意记录
2. 权限最小化设计：仅申请 note.content.read/write、note.recall.read 三项必要权限，用户可控授权范围
3. 隐私保护机制完善：支持 GETNOTE_OWNER_ID 配置防止群聊泄露，主动声明「不在群聊中展示笔记内容」
4. 安全编码规范：核心代码仅约200行，无 eval/exec/system 危险函数，无动态代码下载，依赖精简无已知CVE
5. 错误处理完备：覆盖鉴权失败、非会员、QPS限流、数据不存在等全场景，引导用户自助解决

潜在缺点与局限性

1. 功能依赖外部服务：所有核心能力绑定 Get笔记 API，若官方服务故障或 API 变更，Skill 将受影响
2. 会员功能限制：部分高级功能（如大容量知识库）需开通会员（error.reason: "not_member" / 错误码 10201）
3. 创建频率限制：建议间隔1分钟以上创建笔记，高频操作可能触发限流
4. 初始配置门槛：需完成 OAuth 授权流程（/note config），对非技术用户有一定学习成本

适合人群

• 知识工作者：需要跨平台收藏文章、构建专题知识库的自媒体人、研究员、学生
• 得到App用户：已与得到生态打通，适合原有 Get笔记/得到App 用户无缝衔接
• 隐私敏感型用户：企业级安全合规（GDPR、TLS1.2+、最小权限原则），数据不上传第三方

常规风险

• OAuth Token 泄露风险：配置存储于 ~/.openclaw/openclaw.json，建议用户备份并妥善保管
• OSS 临时凭证管理：图片上传使用阿里云 OSS 临时凭证，虽有10分钟时效限制，仍需避免日志泄露
• 群聊场景误触：未配置 OWNER_ID 时，存在他人在群聊中误操作笔记的风险，建议个人使用场景开启该配置

综上，Get笔记 Skill 是一款来源可信、安全合规、功能聚焦的官方级笔记管理工具，适合追求数据主权与知识体系化的用户，但需注意其服务依赖性与会员功能边界。