Skip to main content
getnote-openclaw - AI Agents on GitHub (100★) | SkillsLLM
Home AI Agents getnote-openclaw
# Add to your Claude Code skills
git clone https://github.com/iswalle/getnote-openclawGuides for using ai agents skills like getnote-openclaw.
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=6AydVpYeKl
创建笔记建议间隔 1 分钟以上，避免触发限流
🚫 反幻觉边界（严格禁止）
Get笔记 Skill
让 AI 成为你的第二大脑。随时记录，需要时召回。
✨ 核心能力
| 能力 | 说明 |
|------|------|
| 📎 一键保存链接 | 发个链接就能保存，自动抓取原文、生成摘要。支持小宇宙播客、小红书、微信公众号、B站、抖音及任意公开网页 |
| 🖼 图片秒变笔记 | 发张图片自动 OCR 识别文字、AI 分析图片内容 |
| 🔍 语义搜索 | 不用翻全部笔记，直接搜关键词，AI 语义召回相关内容 |
| 📚 知识库管理 | 用知识库和标签整理笔记，还能订阅博主、获取直播总结 |
| 🎤 语音笔记原文 | 录音笔记支持获取完整转写文本 |
| 🔗 笔记内链 | 在笔记正文里引用另一条笔记，用 biji.com/note/{id} 格式互相串联 |
| 📤 生成分享链接 | 任意笔记一键生成公开链接，发给别人直接查看 |
💡 使用场景
✏️ 随手记录
通勤路上想到一个点子
👤 记一下笔记：支付流程可以加一个进度条，用户等待时不焦虑
🤖 已记录，自动打上「产品优化」标签。
听播客时有感触
👤 刚听到一个观点挺好的，记一下：好的产品是让用户少做选择，不是多做选择
🤖 已记录。
开完会
👤 帮我记下刚才会上定的几件事：1. 下周三前完成设计稿 2. 找小王对接接口 3. 周五前给老板汇报进度
🤖 已记录。
🔍 要用时召回
写周报时
👤 帮我找找这周我记过的工作相关的东西
🤖 找到 5 条相关笔记：周一你记了客户反馈的问题、周三记了技术方案讨论、周四......
被领导问到
👤 上次我们讨论过用户分层的事，当时怎么说的来着？
🤖 11月8号你记过：高价值用户定义为月消费超过500元，占比约12%......
写文章找素材
👤 我想写篇关于做产品的文章，帮我找找我之前的相关想法
🤖 找到 8 条相关笔记，已按时间排序整理给你。
🔗 保存链接和图片
Sign in with GitHub to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
First-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
禁止编造 note_id
禁止跳过轮询 ：链接/图片笔记返回 task_id 后，必须 轮询 /task/progress 直到 success 或 failed，不得假设任务已完成
禁止伪造 API 响应 ：不得在未实际调用 API 的情况下告诉用户「已保存」「已删除」
禁止忽略错误码 ：API 返回 success: false 时必须处理，不得静默吞掉
禁止混淆内链和分享链接 ：biji.com/note/{id} 是内链（仅笔记主人可见），share_note/{id} 是分享链接（公开可访问），两者不可互换
🔄 失败重试策略
/task/progress 返回 status: "failed" 时，向用户报告失败原因（error_msg）自动重试一次：用相同参数重新调用 /note/save，获取新 task_id 并重新轮询
二次失败则停止，告知用户「保存失败，请稍后重试或检查链接是否可访问」
等待 5 秒后重试一次
仍然失败则报告错误，附上 request_id 方便排查
限流 （错误码 10202 或 HTTP 429）：
读取响应中的 rate_limit.retry_after 字段
等待指定秒数后重试
无 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，说明路径不对，请对照此表检查。
笔记 | 方法 | 路径 | 说明 | 详细文档 |
|------|------|------|----------|
| POST | /open/api/v1/resource/note/save | 新建笔记（文本/链接/图片） | save.md |
| POST | /open/api/v1/resource/note/task/progress | 查询异步任务进度 | save.md |
| GET | /open/api/v1/resource/note/list | 笔记列表（分页） | list.md |
| GET | /open/api/v1/resource/note/detail | 笔记详情 | list.md |
| POST | /open/api/v1/resource/note/update | 更新笔记 | list.md |
| POST | /open/api/v1/resource/note/delete | 删除笔记 | list.md |
| POST | /open/api/v1/resource/note/sharing | 创建笔记分享链接 | list.md |
| POST | /open/api/v1/resource/note/tags/add | 添加标签 | tags.md |
| POST | /open/api/v1/resource/note/tags/delete | 删除标签 | tags.md |
| GET | /open/api/v1/resource/image/upload_token | 获取图片上传凭证 | save.md |
搜索 | 方法 | 路径 | 说明 | 详细文档 |
|------|------|------|----------|
| POST | /open/api/v1/resource/recall | 全局语义搜索 | search.md |
| POST | /open/api/v1/resource/recall/knowledge | 知识库语义搜索 | search.md |
知识库 | 方法 | 路径 | 说明 | 详细文档 |
|------|------|------|----------|
| GET | /open/api/v1/resource/knowledge/list | 我的知识库列表 | knowledge.md |
| GET | /open/api/v1/resource/knowledge/subscribe/list | 订阅知识库列表 | knowledge.md |
| POST | /open/api/v1/resource/knowledge/create | 创建知识库 | knowledge.md |
| GET | /open/api/v1/resource/knowledge/notes | 知识库笔记列表 | knowledge.md |
| POST | /open/api/v1/resource/knowledge/note/batch-add | 添加笔记到知识库 | knowledge.md |
| POST | /open/api/v1/resource/knowledge/note/remove | 从知识库移除笔记 | knowledge.md |
| GET | /open/api/v1/resource/knowledge/bloggers | 知识库博主列表 | knowledge.md |
| GET | /open/api/v1/resource/knowledge/blogger/contents | 博主内容列表 | knowledge.md |
| GET | /open/api/v1/resource/knowledge/blogger/content/detail | 博主内容详情 | knowledge.md |
| GET | /open/api/v1/resource/knowledge/lives | 知识库直播列表 | knowledge.md |
| GET | /open/api/v1/resource/knowledge/live/detail | 直播详情 | knowledge.md |
| POST | /open/api/v1/resource/knowledge/live/follow | 关注直播 | knowledge.md |
通用错误处理 {
"success": false,
"error": {
"code": 10001,
"message": "unauthorized",
"reason": "not_member"
},
"request_id": "xxx"
}
| 错误码 | 说明 | 处理方式 |
|--------|------|---------|
| 10000 | 参数错误 | 检查请求参数 |
| 10001 | 鉴权失败 | 检查 API Key 和 Client ID，或重新授权 |
| 10100 | 数据不存在 | 确认笔记/知识库 ID 正确 |
| 10201 | 非会员 | 引导开通：https://www.biji.com/checkout?product_alias=6AydVpYeKl |
| 10202 | QPS 限流 | 降低频率，查看 rate_limit 字段 |
| 30000 | 服务调用失败 | 稍后重试 |
| 50000 | 系统错误 | 稍后重试 |
👤 存到笔记 https://example.com/article
🤖 链接已提交，正在抓取分析中...
🤖 搞定 ✓ 已保存：《如何做好产品设计》
👤 [发送图片]
🤖 存到笔记？
👤 对
🤖 搞定 ✓ 图片已保存。
👤 记一下，这家店叫船歌鱼水饺，招牌是鲅鱼饺子，人均80
🤖 已记录，打上「美食」标签。
📦 安装
方式一：通过 ClawHub 安装（推荐）
方式二：手动安装 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。
手动配置（可选）
前往 Get笔记开放平台
在 ~/.openclaw/openclaw.json 中添加：
{
"skills": {
"entries": {
"getnote": {
"apiKey": "gk_live_xxx",
"env": {
"GETNOTE_CLIENT_ID": "cli_xxx",
"GETNOTE_OWNER_ID": "ou_xxx"
}
}
}
}
}
💡 GETNOTE_OWNER_ID 可选，配置后只有你能操作笔记（群聊安全）
🔐 安全说明
⚠️ 隐私保护 ：笔记是你的私密数据，AI 会严格校验身份。
配置 GETNOTE_OWNER_ID 后，只有你能操作笔记
群聊中其他人无法通过 AI 读取你的笔记
不要在聊天中发送 API Key ，请手动配置到环境变量
🛠 支持的笔记类型 | 类型 | 说明 | 支持 |
|------|------|------|
| plain_text | 纯文本笔记 | ✅ 读写 |
| link | 链接笔记（自动抓取正文） | ✅ 读写 |
| img_text | 图片笔记 | ✅ 读写 |
| audio | 即时录音 | 📖 仅读取 |
| meeting | 会议录音 | 📖 仅读取 |
| local_audio | 本地音频 | 📖 仅读取 |
| internal_record | 内录音频 | 📖 仅读取 |
| class_audio | 课堂录音 | 📖 仅读取 |
| recorder_audio | 录音卡长录 | 📖 仅读取 |
| recorder_flash_audio | 录音卡闪念 | 📖 仅读取 |
💡 语音类笔记可读取 AI 摘要和转写原文，需调用详情接口获取。
🚀 进阶用法：用笔记内链实践柳比歇夫时间日志法 柳比歇夫时间日志法的核心是每天记录自己把时间花在了哪里 ，事后统计、复盘、改进。
👤 帮我记一条今日工作日志，内链到「产品设计方案」和「客户反馈」这两条笔记
🤖 已记录「2026-04-24 工作日志」，正文已插入两条内链。
👤 找找我这周的工作日志，整理一下时间分配
🤖 找到 5 条日志，你这周：产品设计 12h、客户沟通 6h、开会 4h……
内链格式 ：在笔记正文里用 https://biji.com/note/{note_id} 引用其他笔记。示例：
参考上次的讨论：https://biji.com/note/1234567890000000001
告诉 AI 要内链到哪条笔记，AI 会自动获取对应 note_id 插入。
🆕 更新日志 | 日期 | 版本 | 新能力 | 适合怎么用 |
|------|------|--------|------------|
| 2026-04-23 | v1.8.0 | 1. 笔记内链2. 保存分享链接自动变笔记 | 1. 用内链串联每天的工作日志和项目笔记，实践时间日志法2. 收到别人发来的分享链接直接存入笔记 |
| 2026-04-16 | v1.7.0 | 1. 生成笔记分享链接2. 知识库订阅得到直播 | 1. 把笔记一键分享给朋友2. 在知识库里订阅得到直播课，直播结束后 AI 摘要自动入库 |
| 2026-03-26 | v1.5.6 | 获取我订阅的知识库，支持语义搜索 | 开通了某个知识库，可以直接问 AI：「在我订阅的 XXX 知识库里搜一下时间管理」 |
| 2026-03-12 | v1.2.0 | 查看订阅博主内容、直播摘要和转写原文 | 把别人的知识变成自己可检索的笔记库 |
📜 相关链接
License 29,074
AI Agents ai-agents anthropic
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
AI Agents ai-agents anthropic
The agent that grows with you
AI Agents ai ai-agent
Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.
AI Agents
An open-source AI agent that brings the power of Gemini directly into your terminal.
AI Agents ai ai-agents
LLM inference in C/C++
AI Agents ggml
