Get笔记 API

⚠️ 必读约束

🌐 Base URL（重要！所有 API 共用）

https://openapi.biji.com

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

---

🔑 首次安装配置

在 ~/.openclaw/openclaw.json 中添加：

{
  "skills": {
    "entries": {
      "getnote": {
        "apiKey": "gk_live_你的key",
        "env": {
          "GETNOTE_CLIENT_ID": "cli_你的id",
          "GETNOTE_OWNER_ID": "ou_你的飞书ID（可选，用于权限控制）"
        }
      }
    }
  }
}

获取凭证：前往 Get笔记开放平台 创建应用获取。

---

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

笔记 ID（id、note_id、next_cursor 等）是 64 位整数（int64），超出 JavaScript Number.MAX_SAFE_INTEGER（2^53-1）范围，直接用 JSON.parse 会静默丢失精度，导致 ID 错误，后续操作（加入知识库、删除等）会报「笔记不存在」。

正确做法：

• 始终把 ID 当字符串处理，不要做数值运算
• 代码中使用 JSON.parse 时，先把响应文本中的 ID 数字替换为字符串：

  // 替换顶层数字型 ID 字段为字符串（在 JSON.parse 之前）
  const safe = text.replace(/"(id|note_id|next_cursor|parent_id|follow_id|live_id)"\s*:\s*(\d+)/g, '"$1":"$2"');
  const data = JSON.parse(safe);
  

• Python / Go 等语言原生支持大整数，无此问题
• 发请求时：note_id 字段传字符串或数字均可，服务端兼容两种格式

验证方法：取到 ID 后，检查 String(id).length >= 16，若满足说明是 int64，必须用字符串保存。

---

🔒 安全规则

• 笔记数据属于用户隐私，不在群聊中主动展示笔记内容
• 若配置了 GETNOTE_OWNER_ID，检查 sender_id 是否匹配；不匹配时回复「抱歉，笔记是私密的，我无法操作」；未配置则不检查