核心用法
Get笔记 Skill 是面向 Get笔记(得到旗下知识管理工具)用户的官方 API 集成方案,提供完整的笔记生命周期管理能力。用户通过 OAuth Device Flow 完成授权后,可通过自然语言指令实现:
笔记管理:支持文本速记、链接收藏(自动解析网页内容)、图片保存三种模式,异步任务轮询确保内容完整入库;提供笔记列表浏览、详情查看、内容更新、删除及分享链接生成。
智能检索:基于向量化语义搜索,支持全局笔记搜索和知识库内限定搜索,实现"模糊语义匹配"而非简单关键词匹配。
知识库运营:创建/管理个人知识库,订阅博主内容,关注直播并自动归档,构建结构化知识体系。
标签系统:为笔记添加或删除标签,实现灵活的多维度分类。
显著优点
1. 官方背书,接口稳定:直接调用 openapi.biji.com 官方 API,非第三方爬虫方案,功能与官方 App 同步更新。
2. 语义搜索体验优异:相比传统笔记工具的关键词搜索,Get笔记的向量化语义召回能捕捉用户真实意图,如搜索"AI 对就业的影响"可匹配到"大模型替代白领工作"等相关笔记。
3. 知识库生态整合:支持订阅得到系博主、关注直播内容并自动入库,将碎片化收藏升级为结构化知识资产。
4. 隐私防护机制完善:支持 GETNOTE_OWNER_ID 配置实现"单用户锁定",群聊场景下防止他人越权操作;明确约定不在群聊主动展示笔记内容。
5. 工程细节到位:64位整数 ID 的精度保护方案、异步任务进度轮询、清晰的错误码体系(10201 会员引导、10202 限流提示)体现生产级可靠性。
潜在缺点与局限性
1. 会员门槛限制:API 调用需要 Get笔记会员资格(免费会员 50 条/日,付费会员 200-1000 条/日),非会员无法使用核心功能。
2. 异步写入延迟:链接类型笔记需异步解析(轮询 task progress),极端情况下可能需等待数十秒才能确认保存成功,非即时反馈体验。
3. 生态封闭性:知识库订阅功能主要面向得到系内容生态,对非得到用户价值有限;不支持导入导出通用格式(如 Markdown、Notion)。
4. 中文场景优化:语义搜索模型针对中文语料训练,英文内容检索效果可能弱于中文。
适合人群
- 得到 App 深度用户:已将 Get笔记作为主力笔记工具,希望通过 AI 扩展交互场景
- 知识工作者:需要构建个人知识库、管理订阅源、归档直播内容的创作者
- 效率工具整合者:寻求将碎片化信息(链接、图片、语音转文字)自动归集到统一笔记中枢
常规风险
1. 凭证安全:API Key 存储于本地配置文件(~/.openclaw/openclaw.json),需确保 600 权限设置,避免多用户系统下的权限泄露。
2. 配额耗尽风险:高频自动保存场景(如批量导入)易触发日限额,建议实现客户端速率控制(文档建议创建间隔 1 分钟以上)。
3. 服务依赖单点:功能完全依赖 openapi.biji.com 可用性,平台维护或政策调整可能导致服务中断。
4. 数据迁移限制:Get笔记目前无完善的批量导出机制,长期投入存在数据锁定风险。