Weeko

自由捕捉。每周消化。

设置

必需： 通过以下两种方式之一配置 API 密钥：

选项 1：openclaw.json（推荐）

添加到 ~/.openclaw/openclaw.json：

json
{
skills: {
entries: {
weeko: {
apiKey: wkyourapikeyhere
}
}
}
}

选项 2：环境变量

bash
export WEEKOAPIKEY=wkyourapikeyhere

从 Weeko 设置 → API 选项卡获取您的 API 密钥。密钥以 wk_ 开头。

身份验证

API 密钥查找顺序（优先找到的生效）：

1. 1. openclaw.json → skills.entries.weeko.apiKey
2. 环境变量 WEEKOAPIKEY

所有 API 请求都需要包含 Authorization 标头：

Authorization: Bearer wk_xxx

书签

列出所有书签

bash
curl -s https://weeko.blog/api/bookmarks \
-H Authorization: Bearer $WEEKOAPIKEY

查询参数：

获取单个书签

bash
curl -s https://weeko.blog/api/bookmarks/BOOKMARK_ID \
-H Authorization: Bearer $WEEKOAPIKEY

创建书签

bash
curl -s -X POST https://weeko.blog/api/bookmarks \
-H Authorization: Bearer $WEEKOAPIKEY \
-H Content-Type: application/json \
-d {title: 我的书签, url: https://example.com, groupId: clx..., description: 可选描述}

字段：

注意： URL 元数据（标题、描述、网站图标）会自动为链接获取。如果书签已存在于该组中，将使用新元数据进行更新。

更新书签

bash
curl -s -X PATCH https://weeko.blog/api/bookmarks/BOOKMARK_ID \
-H Authorization: Bearer $WEEKOAPIKEY \
-H Content-Type: application/json \
-d {title: 更新后的标题, description: 新描述, url: https://new-url.com, groupId: clx...}

所有字段均为可选。仅更新提供的字段。

删除书签

bash
curl -s -X DELETE https://weeko.blog/api/bookmarks/BOOKMARK_ID \
-H Authorization: Bearer $WEEKOAPIKEY

搜索书签

bash
curl -s https://weeko.blog/api/bookmarks/search?query=关键词 \
-H Authorization: Bearer $WEEKOAPIKEY

查询参数：

按标题、URL 或描述进行搜索。

分组

列出所有分组

bash
curl -s https://weeko.blog/api/groups \
-H Authorization: Bearer $WEEKOAPIKEY

获取单个分组

bash
curl -s https://weeko.blog/api/groups/GROUP_ID \
-H Authorization: Bearer $WEEKOAPIKEY

返回包含其书签的分组。

创建分组

bash
curl -s -X POST https://weeko.blog/api/groups \
-H Authorization: Bearer $WEEKOAPIKEY \
-H Content-Type: application/json \
-d {name: 我的分组, color: #3b82f6}

字段：

默认颜色：#3b82f6

更新分组

bash
curl -s -X PATCH https://weeko.blog/api/groups/GROUP_ID \
-H Authorization: Bearer $WEEKOAPIKEY \
-H Content-Type: application/json \
-d {name: 新名称, color: #ec4899}

所有字段均为可选。

删除分组

bash
curl -s -X DELETE https://weeko.blog/api/groups/GROUP_ID \
-H Authorization: Bearer $WEEKOAPIKEY

警告： 删除分组将移除其中的所有书签。无法删除系统分组。

用户

获取当前用户

bash
curl -s https://weeko.blog/api/user/me \
-H Authorization: Bearer $WEEKOAPIKEY

返回已验证用户的个人资料（id、name、email）。

响应格式

成功：
json
{
success: true,
data: { ... }
}

错误：
json
{
success: false,
error: 错误消息
}

书签对象：
json
{
id: clx...,
title: 示例,
description: 描述文本,
url: https://example.com,
image: https://example.com/og.png,
favicon: https://example.com/favicon.ico,
siteName: 示例,
type: link,
color: null,
isPublic: false,
groupId: clx...,
createdAt: 2024-01-01T00:00:00.000Z,
updatedAt: 2024-01-01T00:00:00.000Z,
group: { id: clx..., name: 开发, color: #3b82f6 }
}

分组对象：
json
{
id: clx...,
name: 开发,
color: #3b82f6,
isPublic: false,
bookmarkCount: 42,
createdAt: 2024-01-01T00:00:00.000Z,
updatedAt: 2024-01-01T00:00:00.000Z
}

速率限制

每个响应中的标头：X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset

错误代码

工作流程

在任何 API 调用之前：

1. 1. 按顺序检查 API 密钥：

1. 2. 如果未找到，输出以下消息并停止：

Weeko API 密钥未配置。请添加到 ~/.openclaw/openclaw.json：

json
{
\skills\: {
\entries\: {
\weeko\: {
\apiKey\: \wkyourkey_here\
}
}
}
}

或设置环境变量：export WEEKOAPIKEY=\wkyourkey_here\

1. 3. 确认密钥后，才继续执行 API 调用

添加书签：

1. 1. 对于没有标题的 URL