国内应用接入
印象笔记接入:搜索旧笔记、读正文、确认后写入
填一个 Developer Token 和账户对应的 NoteStore 地址,机器人就能翻您攒了多年的笔记本,并在您点头之后把新内容写回去。
印象笔记接入适合哪些人?
用了很久印象笔记的人,问题通常不是没记,而是找不着。接入之后,机器人可以按印象笔记自己的搜索语法翻找笔记,读出正文,再把散落在几篇笔记里的结论汇总成一段话。
读取全部是只读的;新建和更新会真的改动您的笔记,所以这两个动作被强制要求先确认。写入时正文按纯文本处理并转换成印象笔记的 ENML 格式,不会夹带可执行内容。
接入后可以做什么?
- 列出笔记本:拿到账户下所有笔记本及其 guid,后续搜索和写入都可以指定到具体笔记本。
- 按官方语法搜索:支持印象笔记的搜索语法,单次最多返回 50 条笔记元数据(标题、所属笔记本、创建与更新时间)。
- 读取正文:按 guid 读出纯文本正文和附件清单;正文超过约 30 万字符会截断并标注,附件只返回文件名与类型,不下载二进制内容。
- 确认后新建或更新:可以新建笔记、改标题正文、换笔记本或改标签;只传了部分字段时,其余字段保持原样。
如何拿到 Developer Token 和 NoteStore 地址?
连接需要两个字段,都在印象笔记开发者令牌页面上:以 S= 开头的 Developer Token,以及该页面同时显示的账户专属 NoteStore 地址。
- 打开开发者令牌页面 — 登录印象笔记账号后访问 app.yinxiang.com 的 Developer Token 页面,按提示创建令牌。
- 复制两个值 — 把 S= 开头的令牌和形如 https://app.yinxiang.com/shard/.../notestore 的地址一起复制下来,两个都要。
- 连接印象笔记 — 在国内应用列表选择印象笔记,分别填入 Token 与 NoteStore 地址并完成连接。
- 先只读验证 — 让机器人先列出笔记本、搜一个您熟悉的关键词,确认返回的是您本人的账户内容,再去试写入。
连接后可以直接这样问
- “在印象笔记里找一下去年写的那份供应商谈判记录”
- “把这几篇会议笔记的结论汇总成一段话”
- “在“工作”笔记本里新建一篇今天的复盘,先给我看内容再写入”
使用前必须知道的限制
印象笔记的 Developer Token 有有效期,过期需要重新生成并重新连接。单次搜索最多 50 条,正文读取有长度上限,附件只返回元数据。账户本月上传额度用尽、接口限流时,机器人会收到对应的中文提示。
笔记里往往混着账号、合同和私人记录,交给机器人搜索前先想清楚范围。更新笔记属于覆盖式写入,确认前请让机器人把改动后的完整正文给您看一遍。
托管连接还是自己搭工具?
| 方案 | 适合谁 | 您需要负责什么 |
|---|---|---|
| OpenClaw Launch 托管 | 希望尽快让机器人持续在线并连接印象笔记的用户 | 提供必要授权、确认敏感操作并管理自己的应用账户 |
| 自行部署 | 已有服务器、愿意维护 OpenClaw/Hermes 与兼容工具的开发者 | 自行申请并保管 Developer Token,自建 EDAM 客户端、ENML 转换、搜索分页、错误码映射和写入确认门槛。 |
自行部署是合理选择;托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3,续费 $6/月,支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。
已经有机器人?前往国内应用一键接入查看连接状态;第一次部署可先阅读养龙虾入门指南。
印象笔记接入常见问题
为什么要填两个字段?
印象笔记的 NoteStore 地址与账户绑定,不同账户地址不同,所以必须和 Developer Token 一起提供。
机器人会擅自改我的笔记吗?
不会。新建和更新都要求先确认;不带确认标记的写入请求会直接被拒绝。
能读到笔记里的附件内容吗?
当前只返回附件的文件名和类型,不下载附件本身。
国际版 Evernote 账号能用吗?
当前连接指向印象笔记中国版的服务地址,国际版账号的 NoteStore 地址不在接受范围内。