从零开始：开发掘金自动发布Skill并上架Clawhub的完整指南

你是否厌倦了重复手动发布文章到掘金？是否想将这项工作自动化，提高效率？本文将带你一步步实现从零开发juejin-publisher Skill，并成功上架Clawhub的整个过程。

第一步：分析掘金发布接口

开发自动发布工具的第一步是搞清楚掘金的发布接口。由于掘金没有公开的开发者API文档，我们需要通过浏览器抓包来分析。打开掘金编辑器，按F12进入开发者工具，切换到Network标签，然后正常发布一篇文章，观察请求。

发现关键的两个接口：

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

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

第二步：设计Skill结构

参考Yi有的wechat-mp-publisher Skill的目录规范，我们设计如下结构：

skills/juejin-publisher/
├── SKILL.md              # Skill主文档
├── README.md             # 快速说明
├── _meta.json            # 本地元数据
├── example.md            # 文章格式示例
├── juejin.env.example    # 配置文件模板
├── scripts/
│   ├── publish.py        # 核心发布脚本
│   └── query_tags.py     # 标签ID查询工具
└── references/
    ├── category_ids.md   # 常用分类ID参考
    └── tag_ids.md        # 常用标签ID参考

第三步：实现核心发布逻辑

鉴权方式：掘金使用Cookie鉴权，只需在请求头中带上登录后的Cookie即可。Cookie有效期约30天其中Zui关键的字段是sessionid。

API调用封装

使用Python内置的urllib实现HTTP请求，无需安装requests:

def api_post:
    url = f"https://api.juejin.cn{path}"
    payload = json.dumps.encode
    headers = {
        "Content-Type": "application/json; charset=utf-8",
        "Cookie": cookie,
        "User-Agent": "Mozilla/5.0  ...",
        "Referer": "https://juejin.cn/",
        "Origin": "https://juejin.cn",
    }
    req = urllib.request.Request
    with urllib.request.urlopen as resp:
        return json.loads.decode)

完整发布流程

脚本实现了从创建草稿到发布文章的全流程：

def main:
    args = parse_args
    config = load_config
    cookie = config
    title = meta.get
    brief = generate_brief
    draft_id = create_draft
    if not args.draft_only:
        article_id = publish_draft
        print

使用示例

YAML frontmatter 示例：

---
title : 我的技术文章标题 
description : 这里是文章摘要，建议80-100字，会显示在文章列表中 
cover : https : //example.com/cover.jpg
category_id : "6809637767543259144"
tag_ids : "6809637769953556487,6809637773931929608"
---
# 正文内容开始 
你的 Markdown 内容...

命令行调用：

python3 scripts/publish.py article.md \
  --category "" \
  --tags ""
# 或仅创建草稿 
python3 scripts/publish.py article.md --draft-only 

踩坑记录

摘要长度限制 ：brief_content必须在80-100字之间，否则接口报错。

acceptLicenseTerms报错 ：Clawhub服务端要求payload中包含acceptLicenseTerms: true字段，但CLI默认脚本未传递。解决方案是修改CLI源码或在SKILL.md中添加license: MIT字段。

第四步：编写SKILL.md规范文件

Skill的核心是 SKILL.md，它既是使用文档，也是AI理解该Skill的“说明书”。文件头部需要包含frontmatter元数据：

---
name : juejin-publisher 
version : 1.0.0 
license : MIT 
description : 掘金文章自动发布技Neng。通过掘金官方API实现自动化发布。
metadata :
  openclaw :
    emoji : "⛏️"
    category : publishing 
  clawdbot :
    emoji : "⛏️"
    requires :
      bins : 
    install : 
---
## 使用说明...
正文内容...

第五步：上架Clawhub

安装Clawhub CLI：

npm install -g clawhub 

登录Clawhub：

clawhub login --token clh_xxxxxxxxxxxxxxxxxx 

Token获取方式：登录clawhub.ai → Settings → API Tokens → 创建新Token。

发布Skill：

clawhub publish . --version 1.0.0 

与思考

这次Skill开发的整体流程：

需求分析

抓包研究API

脚本实现

Skill规范封装

上架Clawhub

通过这个过程，我们不仅实现了自动化发布，还积累了宝贵的经验：

零依赖设计geng健壮 使用Python标准库，避免环境依赖问题。

良好的错误处理机制 处理了摘要长度、鉴权等常见问题。

详细的文档说明 方便用户理解和使用Skill。

现在任何人douKe以通过以下命令安装使用我们的juejin-publisher Skill：

clawhub install juejin-publisher 

让我们一起探索geng多自动化的可Neng性！

---