百家号自动发布 Skill

用途

本 Skill 提供：用已有登录态打开百家号发布页，自动关闭常见弹窗，可选填入标题与正文（支持 Markdown 文件转富文本 HTML），可选选封面后点击「存草稿」或「发布」。

发布页地址：https://baijiahao.baidu.com/builder/rc/edit?type=news&is_from_cms=1

环境准备

1. Python

需要 Python 3.8+，建议 3.10+。

2. 安装依赖

在项目根或任意可运行脚本的目录执行：

# 安装 Python 包（Playwright + Markdown）
pip install -r skills/baijiahao-publish/requirements.txt

# 安装浏览器（必须执行一次）
playwright install chromium

或手动安装：

pip install playwright>=1.40.0
pip install markdown>=3.5.0
playwright install chromium

说明：

• playwright：打开浏览器并操作百家号页面，playwright install chromium 会下载 Chromium，只需执行一次。
• markdown：使用 --content-file xxx.md 时，将 Markdown 转为富文本 HTML 填入正文，必装。

3. 准备 auth（二选一）

• auth.json：在浏览器中登录百度/百家号后，用 Playwright 的 context.storage_state(path="auth.json") 保存状态。
• Cookie 文本 .txt：一行 Cookie，格式可为 name1=value1; name2=value2; ... 或 账号----账号----cookie字符串，脚本会自动解析并注入。

--auth 支持相对路径和绝对路径；路径若从别处粘贴，会自动去掉常见不可见字符。

如何调用

脚本路径

入口脚本：skills/baijiahao-publish/scripts/open_baijiahao_edit.py

在项目根或能访问到该路径的目录下执行下面的命令（或将 skills/baijiahao-publish/scripts/open_baijiahao_edit.py 换成绝对路径）。

参数说明

执行结果：脚本结束前会输出一行 [RESULT] success 或 [RESULT] failed，进程退出码分别为 0 / 1，便于 OpenClaw 或其它调用方解析。默认执行完即关闭浏览器并返回，无需人工确认。

调用示例

# 仅打开发布页（使用默认或指定 auth）
python skills/baijiahao-publish/scripts/open_baijiahao_edit.py
python skills/baijiahao-publish/scripts/open_baijiahao_edit.py --auth test/baijiahao.txt
python skills/baijiahao-publish/scripts/open_baijiahao_edit.py --auth "C:/path/to/baijiahao.txt"

# 填入标题 + 正文（MD 转富文本）
python skills/baijiahao-publish/scripts/open_baijiahao_edit.py --auth test/baijiahao.txt --title "文章标题" --content-file article.md

# MD 里自带标题，用 --title 截断后只把后面当正文
python skills/baijiahao-publish/scripts/open_baijiahao_edit.py --auth test/baijiahao.txt --title "文章标题" --content-file article.md --strip-title-from-content

# 填完后选封面并发布
python skills/baijiahao-publish/scripts/open_baijiahao_edit.py --auth test/baijiahao.txt --title "标题" --content-file article.md --strip-title-from-content --publish

# 填完后选封面并存草稿
python skills/baijiahao-publish/scripts/open_baijiahao_edit.py --auth test/baijiahao.txt --title "标题" --content-file article.md --draft

# 无头模式（不弹浏览器）
python skills/baijiahao-publish/scripts/open_baijiahao_edit.py --auth test/baijiahao.txt --headless

# 执行完后不关浏览器，等用户按回车再关闭（便于人工确认）
python skills/baijiahao-publish/scripts/open_baijiahao_edit.py --auth test/baijiahao.txt --title "标题" --content-file article.md --keep-open

在 OpenClaw 中调用

1. 放置 Skill
   将本 Skill 目录放在 OpenClaw 会加载的位置，例如：

   • 工作区：\x3Cworkspace>/skills/baijiahao-publish/
   • 或全局：~/.openclaw/skills/baijiahao-publish/

2. 调用方式

   • 自然语言：对助手说「用 test/baijiahao.txt 打开百家号并发布」「用 article.md 填标题和正文然后存草稿」等，由模型解析后执行上述脚本并传入对应参数（如 --auth、--title、--content-file、--strip-title-from-content、--publish 或 --draft）。
   • 斜杠命令：若该 Skill 配置为可被用户调用，可在对话中使用对应斜杠命令。
   • CLI：在终端直接执行上面的 python skills/baijiahao-publish/scripts/open_baijiahao_edit.py ...，不依赖 OpenClaw。

3. 传参约定

   • 说明 auth 路径时，助手应传 --auth \x3C路径>（支持绝对路径）。
   • 说明「存草稿」时传 --draft；说明「发布」时传 --publish。
   • 说明「正文用某 md 文件」时传 --content-file \x3C路径>；若 md 里含标题且希望截断，同时传 --title \x3C标题> 与 --strip-title-from-content。
   • 需要「执行完不关浏览器、等用户确认再关」时传 --keep-open；未传则执行完直接关闭并输出 [RESULT] success / [RESULT] failed 与退出码，便于 OpenClaw 正确处理返回。

脚本与依赖位置

• 入口脚本：skills/baijiahao-publish/scripts/open_baijiahao_edit.py
• 依赖列表：skills/baijiahao-publish/requirements.txt（playwright、markdown）

OpenClaw 安装与上传

• 手动安装：将本目录 baijiahao-publish 整体复制到 ~/.openclaw/skills/ 或工作区 ./skills/，重启 OpenClaw 后即可使用。
• ClawHub 安装（若已上架）：npx clawhub@latest install baijiahao-publish。
• 上传 / 发布：在技能目录下执行 clawhub publish . --slug baijiahao-publish --name "百家号发布器" --version 1.0.0（需先配置 ClawHub 账号）。发布前请确保目录内包含 SKILL.md、package.json、_meta.json、scripts/open_baijiahao_edit.py、requirements.txt。