从零开发一个掘金自动发布 Skill，并上架 Clawhub

本文记录了一次完整的 Skill 开发旅程：从一句「帮我创建一个可以自动发布文章到掘金的 skill」开始，到最终成功上架 ClawHub。内容尽量还原整个过程中的关键决策、踩坑经验，以及实际落地的思路。

背景：为什么要做这个 Skill？

我平时在运营一个 AI 资讯账号，每天需要把 Markdown 格式的文章同步发布到多个平台，例如微信公众号、小红书以及掘金等。

其中，微信公众号和小红书已经有现成的 Skill 可以使用，但掘金却没有对应的自动化方案。

于是每次发布掘金内容，都需要重复以下步骤：

• 打开浏览器并登录掘金
• 进入编辑器，粘贴 Markdown 内容
• 手动设置分类、标签、摘要、封面
• 点击发布

这套流程重复、机械，而且非常适合自动化处理。因此，我决定自己动手开发一个 juejin-publisher Skill。

第一步：分析掘金 API

要实现自动发布，首先必须搞清楚掘金的接口调用方式。

掘金并没有公开的开发者 API 文档，但可以通过浏览器抓包来分析请求流程。

抓包分析

打开掘金编辑器，按下 F12 进入开发者工具，在 Network 面板中记录请求。手动发布一篇文章后，可以观察到关键接口。

核心流程主要分为两个接口：

• 创建草稿
  POST https://api.juejin.cn/content_api/v1/article_draft/create

{
 "category_id": "xxx",
 "tag_ids": ["xxx"],
 "title": "文章标题",
 "brief_content": "摘要",
 "edit_type": 10,
 "mark_content": "# Markdown 内容",
 "cover_image": "",
 "html_content": "deprecated",
 "link_url": "",
 "theme_ids": []
}

• 发布文章
  POST https://api.juejin.cn/content_api/v1/article/publish

{
 "draft_id": "xxxx",
 "sync_to_org": false,
 "column_ids": [],
 "theme_ids": []
}

鉴权机制

掘金使用 Cookie 进行身份验证。只需要在请求头中携带登录后的 Cookie 即可完成授权。

Cookie 通常有效期约 30 天，其中最关键的字段是 sessionid。

第二步：设计 Skill 结构

在 OpenClaw 体系中，一个 Skill 本质上是一个包含 SKILL.md 的文件集合，用于描述能力、触发条件以及执行方式。:

因此，这个自动发布 Skill 的核心设计包括：

• 输入：Markdown 内容、标题、标签等
• 处理：调用掘金接口创建草稿并发布
• 输出：发布结果（成功 / 失败）

同时，需要在 Skill 中明确说明使用场景，例如：

• 当用户希望将 Markdown 发布到掘金时使用
• 当内容已经准备好，仅需自动发布时触发

第三步：实现自动发布逻辑

在实现层面，可以使用 Node.js 或 Python 编写请求逻辑，核心流程如下：

• 读取用户输入（标题、正文、标签等）
• 发送请求创建草稿
• 获取 draft_id
• 调用发布接口完成发布

需要特别注意：

• 请求头必须包含 Cookie
• 参数字段必须与抓包一致
• 错误处理要完善（例如草稿失败、发布失败）

第四步：打包并发布到 ClawHub

ClawHub 是 OpenClaw 的官方 Skill 注册中心，可以理解为 AI Agent 的「npm」。:

发布 Skill 的基本流程包括：

• 整理 Skill 文件（SKILL.md + 脚本 + 配置）
• 补充元数据（名称、版本、标签）
• 使用 CLI 发布到 ClawHub

发布后，Skill 会被索引并支持搜索，其他用户可以直接安装使用。:

踩坑总结

• 掘金没有官方 API，需要手动抓包分析
• Cookie 过期会导致发布失败
• 字段不完整会被接口拒绝
• Skill 描述不清晰会影响触发效果

总结

整个过程从一个简单需求出发，最终完成了从 API 分析、Skill 设计、代码实现到发布上架的完整闭环。

更重要的是，这类自动化 Skill 一旦完成，可以持续复用，大幅减少重复劳动。

如果你也在频繁做类似的重复操作，不妨尝试用 Skill 的方式把它“产品化”。