Clip2MD

该 Skill 提供本地 node 命令行脚本，用于配置 clip2md 访问 token、提交网页或文章 URL 作为 Markdown 剪藏任务、查询每日与永久额度、查询单个任务状态，以及等待任务完成或失败，并按状态码提示 token 失效、额度不足、重复链接或限流等情况。

热度 61.65

最近更新 2026-07-27 19:05:08

分类：效率依赖：代码执行 / 第三方 API / 读写文件应用场景：文件转换 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add clip2md

Metadata

name: clip2md
description: Use clip2md to configure an access token, save web pages or article URLs as Markdown clipping tasks, check remaining daily/permanent quota, query task status, and wait for clipping completion or failure. Use when the user mentions clip2md, 剪藏, clip, 保存网页为 Markdown, 查询额度, 提交链接, 查询任务, 等待剪藏完成, or wants an Agent to operate the clip2md product tool.
metadata: {"openclaw":{"requires":{"bins":["node"]},"emoji":"✂️"}}

Use the bundled CLI. Run commands from this skill folder unless the caller provides another path.

node scripts/clip2md.js <command>

Before clipping, querying quota, or checking a task, rely on the CLI to detect whether ~/.clip2md/config.json contains a token.
If the CLI says the token is missing, expired, or invalid, ask the user for a fresh clip2md token from the web profile page.
Never print, quote, summarize, or echo the token in user-facing output.
Summarize command results: task id, status, quota, title/error, and whether Markdown is ready. Do not paste full Markdown content unless the user explicitly asks for it.
Use clip only to submit a URL. Use wait only when the user asks to wait for completion or when completion is necessary for the request.

Configure token:

node scripts/clip2md.js config <token>

Check quota:

node scripts/clip2md.js quota

Submit a URL:

node scripts/clip2md.js clip "https://example.com/article"

Query one task:

node scripts/clip2md.js status <task_id>

Wait for one task:

node scripts/clip2md.js wait <task_id> [--timeout <seconds>] [--interval <seconds>]

Defaults: timeout 120 seconds, interval 5 seconds.

SUCCESS: completed; Markdown is ready when the summary says Markdown: 已生成.
PENDING, PROCESSING, WAITING_SERVICE: still waiting; use wait if the user asked for completion.
FAILED, FAILED_AUTH_EXPIRED, FAILED_SERVICE_UNAVAILABLE, MANUAL_REVIEW: not completed; explain the error message/category if present and suggest retrying later or refreshing credentials based on the CLI message.

401: token expired or invalid; ask the user for a new token and run config.
403: quota or permission problem; report quota/permission failure without retry loops.
409: duplicate link or task conflict; report the conflict and task context.
429 or 503: rate limit or temporary service outage; respect the CLI retry hint when present.

Token 存储在 ~/.clip2md/config.json。 API 默认地址为 https://clip2.md/api/v1。Set CLIP2MD_API_BASE only for tests or private deployments.