name: 得到大脑（Get笔记） description: | 得到大脑（Get笔记）- 保存、搜索、管理个人笔记和知识库。

当以下情况时使用此 Skill： (1) 用户要保存内容到笔记：发链接、发图片、说「记一下」「存到笔记」「保存」「收藏」 (2) 用户要搜索或查看笔记：「搜一下」「找找笔记」「最近存了什么」「看看原文」 (3) 用户要管理知识库或标签：「加到知识库」「建知识库」「加标签」「删标签」 (4) 用户要配置 得到大脑（Get笔记）：「配置笔记」「连接得到大脑（Get笔记）」 metadata: {"openclaw": {"requires": {}, "optionalEnv": ["GETNOTE_API_KEY", "GETNOTE_CLIENT_ID", "GETNOTE_OWNER_ID"], "baseUrl": "https://openapi.biji.com", "homepage": "https://biji.com"}}

得到大脑（Get笔记）Skill

⚠️ Agent 必读约束

🌐 Base URL

https://openapi.biji.com

所有 API 请求必须使用此 Base URL，不要使用 biji.com 或其他地址。

🔑 认证

请求头：

• Authorization: $GETNOTE_API_KEY（格式：gk_live_xxx）
• X-Client-ID: $GETNOTE_CLIENT_ID（格式：cli_xxx）

每次调用 API 前先检查 $GETNOTE_API_KEY 是否存在。若不存在，提示用户运行 /note config 完成配置，配置完成后再继续执行用户原本的请求。

Scope 权限：note.content.read（读取）、note.content.write（写入）、note.recall.read（搜索）。完整列表见 references/api-details.md。

🔢 笔记 ID 处理规则（重要！）

笔记 ID 是 64 位整数（int64），超出 JavaScript Number.MAX_SAFE_INTEGER，直接 JSON.parse 会静默丢失精度。

正确做法：始终把 ID 当字符串处理，在 JSON.parse 之前替换：

const safe = text.replace(/"(id|note_id|parent_id|follow_id|live_id)"\s*:\s*(\d+)/g, '"$1":"$2"');
// 注：next_cursor 已不需要处理，翻页请直接使用响应中的 cursor（string）字段
const data = JSON.parse(safe);

Python / Go 等语言原生支持大整数，无此问题。

🔒 安全规则

• 笔记数据属于用户隐私，不在群聊中主动展示笔记内容
• 若配置了 GETNOTE_OWNER_ID，检查 sender_id 是否匹配；不匹配时回复「抱歉，笔记是私密的，我无法操作」
• API 返回 error.reason: "not_member" 或错误码 10201 时，引导开通会员：https://www.biji.com/checkout?product_alias=9Ab36BB3ZD&spm=wangye
• 创建笔记建议间隔 1 分钟以上，避免触发限流

🚫 反幻觉边界（严格禁止）

• 禁止编造 note_id：所有 note_id 必须来自 API 响应，不得凭空构造或推测
• 禁止跳过轮询：链接/图片笔记返回 task_id 后，必须轮询 /task/progress 直到 success 或 failed，不得假设任务已完成
• 禁止伪造 API 响应：不得在未实际调用 API 的情况下告诉用户「已保存」「已删除」
• 禁止忽略错误码：API 返回 success: false 时必须处理，不得静默吞掉
• 禁止混淆内链和分享链接：biji.com/note/{id} 是内链（仅笔记主人可见），share_note/{id} 是分享链接（公开可访问），两者不可互换

🔄 失败重试策略

异步任务失败（链接/图片保存）：

1. /task/progress 返回 status: "failed" 时，向用户报告失败原因（error_msg）
2. 自动重试一次：用相同参数重新调用 /note/save，获取新 task_id 并重新轮询
3. 二次失败则停止，告知用户「保存失败，请稍后重试或检查链接是否可访问」

网络/服务错误（HTTP 5xx 或超时）：

1. 等待 5 秒后重试一次
2. 仍然失败则报告错误，附上 request_id 方便排查

限流（错误码 10202 或 HTTP 429）：

1. 读取响应中的 rate_limit.retry_after 字段
2. 等待指定秒数后重试
3. 无 retry_after 时默认等待 10 秒

执行流程概览

用户意图 → 路由匹配 → 读取 references 文档 → 构造 API 请求 → 执行
                                                                   ↓
                                              ┌─ 同步操作 ──→ 验证响应 → 返回结果
                                              │
                                              └─ 异步操作 ──→ 轮询进度 ──→ success → 返回结果
                                                                 ↓            ↓
                                                            10-30s 间隔    failed → 自动重试(1次)
                                                                              ↓
                                                                         二次失败 → 报告用户

关键原则：

• 模型输出 ≠ 最终结果：API 调用后必须验证响应，确认 success: true 且数据完整
• 状态来自 API：所有笔记状态（是否存在、内容、标签等）以 API 返回为准，不依赖上下文记忆
• 最小操作原则：更新笔记时只传需要修改的字段，不重写整篇内容

指令路由表

匹配指令后，用 read 工具读取对应的 references/xxx.md 获取完整 API 文档。

自然语言路由

包含 URL（`biji.com/note/share_note/*` 或 `d.biji.com/*` 短链）  → /note save（link 模式，同步返回 note_id）
包含 URL（`biji.com/note/{note_id}` 内链）    → /note list（查看详情），如需在正文引用其他笔记请使用 `https://biji.com/note/{note_id}` 格式内链（**默认用内链，除非用户明确要求分享**）
其他 URL                   → /note save（link 模式，异步返回 task_id）
包含图片                    → /note save（image 模式）
「记/存/保存/收藏」          → /note save（text 模式）
「搜/找找/有没有 XX」        → /note search
「最近/列表/看看/查笔记」    → /note list
「改/更新/编辑笔记」         → /note list（更新笔记）
「知识库」相关              → /note kb
「标签」相关                → /note tag
「配置/授权/连接笔记」       → /note config

决策原则：优先匹配最具体的意图。有 URL 就是 /save link，有图片就是 /save image，不确定时询问用户。

API 路由表

⚠️ 构造请求时必须使用下表中的完整路径，Base URL 为 https://openapi.biji.com。如果收到 404，说明路径不对，请对照此表检查。

笔记

搜索

知识库

通用错误处理

{
  "success": false,
  "error": {
    "code": 10001,
    "message": "unauthorized",
    "reason": "not_member"
  },
  "request_id": "xxx"
}

详细错误码和限流结构见 references/api-details.md。

得到大脑（Get笔记）Skill

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

✨ 核心能力

💡 使用场景

✏️ 随手记录

通勤路上想到一个点子

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

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

听播客时有感触

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

🤖 已记录。

开完会

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

🤖 已记录。

🔍 要用时召回

写周报时

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

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

被领导问到

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

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

写文章找素材

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

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

🔗 保存链接和图片

看到好文章

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

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

拍到有用的东西

👤 [发送图片]

🤖 存到笔记？

👤 对

🤖 搞定 ✓ 图片已保存。

探店记录

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

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

📦 安装

方式一：通过 ClawHub 安装（推荐）

clawhub install getnote

方式二：手动安装

mkdir -p ~/.openclaw/workspace/skills/getnote
cd ~/.openclaw/workspace/skills/getnote
curl -sL https://raw.githubusercontent.com/iswalle/getnote-openclaw/main/SKILL.md -o SKILL.md
curl -sL https://raw.githubusercontent.com/iswalle/getnote-openclaw/main/package.json -o package.json

🔑 授权登录

安装完成后说「请帮我授权 Get笔记」，AI 自动生成授权链接，点击完成登录，无需手动配置 API Key。

手动配置（可选）

1. 前往 Get笔记开放平台 获取 API Key 和 Client ID
2. 在 ~/.openclaw/openclaw.json 中添加：

{
  "skills": {
    "entries": {
      "getnote": {
        "apiKey": "gk_live_xxx",
        "env": {
          "GETNOTE_CLIENT_ID": "cli_xxx",
          "GETNOTE_OWNER_ID": "ou_xxx"
        }
      }
    }
  }
}

💡 GETNOTE_OWNER_ID 可选，配置后只有你能操作笔记（群聊安全）

💡 需要 Get笔记会员 才能使用 API

🔐 安全说明

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

• 配置 GETNOTE_OWNER_ID 后，只有你能操作笔记
• 群聊中其他人无法通过 AI 读取你的笔记
• 不要在聊天中发送 API Key，请手动配置到环境变量

🛠 支持的笔记类型

💡 语音类笔记可读取 AI 摘要和转写原文，需调用详情接口获取。

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

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

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

每天早上

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

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

每周复盘

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

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

内链格式：在笔记正文里用 https://biji.com/note/{note_id} 引用其他笔记。示例：

参考上次的讨论：https://biji.com/note/1234567890000000001

告诉 AI 要内链到哪条笔记，AI 会自动获取对应 note_id 插入。

🆕 更新日志

📜 相关链接

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

License

MIT-0 · Published on ClawHub