Get笔记

Get笔记 - 保存、搜索、管理个人笔记和知识库。 **当以下情况时使用此 Skill**： (1) 用户要保存内容到笔记：发链接、发图片、说「记一下」「存到笔记」「保存」「收藏」 (2) 用户要搜索或查看笔记：「搜一下」「找找笔记」「最近存了什么」「看看原文」 (3) 用户要管理知识库或标签：「加到知识库」「建...

Security Scan

The skill's files, instructions, and optional environment variables are coherent with a note-saving/searching service; nothing requested or installed is disproportionate to that purpose.

Purpose & Capability

Name/description (note save/search/kb) match what code and SKILL.md do: call openapi.biji.com endpoints, OAuth device flow, image upload helper. Optional env vars (GETNOTE_API_KEY, GETNOTE_CLIENT_ID, GETNOTE_OWNER_ID) are appropriate for this integration and no unrelated credentials or binaries are requested.

Instruction Scope

SKILL.md gives concrete API calls and device-flow OAuth logic. It instructs the agent to auto-start the OAuth device polling (background) and to write obtained credentials into ~/.openclaw/openclaw.json — this is within the integration's needs but worth noting because the skill will initiate network polling and modify the agent config during setup without additional user commands beyond starting the flow.

Install Mechanism

No install spec or external downloads; the package is instruction-first and includes two small Python helper scripts. No remote URLs or archive extraction in install steps.

Credentials

Only optional environment variables relate directly to the service (API key, client id, owner id). The scripts read or accept these vars only as expected for uploading images and OAuth; there are no extra secrets or unrelated environment/config path requests.

Persistence & Privilege

always:false (normal). The skill instructs writing API credentials into ~/.openclaw/openclaw.json for future use — expected for an OAuth-backed integration but users should be aware credentials will be persisted in their OpenClaw config. The skill does not request system-wide privileges or alter other skills' configs.

Assessment

This skill appears to do what it claims (save/search/manage notes). Before installing, understand: 1) it will perform an OAuth Device Flow and start a background poll to obtain an API key if none is configured — you will be shown a verification link and code to complete in your browser; 2) once authorized the skill will write the API key / client ID into ~/.openclaw/openclaw.json for future use; 3) do not paste API keys into chat — prefer the OAuth flow or set GETNOTE_API_KEY and GETNOTE_CLIENT_ID in your config; 4) the included scripts (oauth_poll.py, upload_image.py) perform network calls to openapi.biji.com and an OSS host for uploads — review them if you need to verify behavior. If you only want a read-only helper or prefer not to persist credentials, do not install or configure GETNOTE_OWNER_ID / API key. If you have low trust in biji.com, avoid enabling the skill.

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 分钟以上，避免触发限流

---

指令路由表

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

指令	角色	说明	详细文档
/note save 或「记一下」	📝 速记员	保存文本/链接/图片笔记（含异步轮询流程）	references/save.md
/note search 或「搜一下」	🔍 搜索官	全局语义搜索 + 知识库语义搜索	references/search.md
/note list 或「最近的笔记」	📋 整理师	浏览列表、查看详情、更新、删除	references/list.md
/note kb 或「知识库」	📚 图书管理员	知识库 CRUD + 博主订阅 + 直播订阅	references/knowledge.md
/note tag 或「加标签」	🏷️ 标签员	添加/删除标签	references/tags.md
/note config 或「配置笔记」	⚙️ 配置	配置 API Key 和 Client ID	references/oauth.md

---

自然语言路由

包含 URL                    → /note save（link 模式）
包含图片                    → /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	系统错误	稍后重试

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