- name
- baijiahao-publish
- version
- 1.0.0
- description
- 使用 auth 登录态打开百家号发布页，可填入标题与正文（支持 .md 转富文本）、选封面、存草稿或发布。当用户需要发布百家号、用 cookie 打开编辑页、或配合 OpenClaw 自动发布/存草稿时使用。
- author
- Maynor
- license
- MIT
- tags
- ["baijiahao", "publish", "automation", "playwright"]
- entry
- scripts/open_baijiahao_edit.py
- language
- python
- requirements
- user-invocable
- true
- metadata
- {"openclaw":{"skillKey":"baijiahao-publish","requires":{"bins":["python3"]}}}
百家号自动发布 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 换成绝对路径）。
参数说明
| 参数 | 说明 |
|---|---|
--auth | 登录态文件路径，默认 auth.json。支持相对路径与绝对路径。 |
--headless | 无头模式（不显示浏览器窗口）。 |
--title | 文章标题，填入页面标题框。 |
--content | 正文纯文本，直接填入编辑区。 |
--content-file | 正文来源文件。若为 .md 会转为富文本 HTML 填入（依赖 markdown 库）；否则按纯文本读取。与 --content 二选一，优先本参数。支持绝对路径。 |
--strip-title-from-content | 当同时提供 --title 和 --content-file 时，在文件中用标题做第一次匹配并截断，只把该行之后的内容当正文，避免标题重复。 |
--publish | 填完正文后：等 2 秒 → 选择封面 → 确定 → 等 2 秒 → 按文字完全匹配点击「发布」。 |
--draft | 与 --publish 流程相同，但最后按文字完全匹配点击「存草稿」。 |
--keep-open | 执行完成后不立即关闭浏览器，等待用户按回车确认后再关闭；未指定则执行完直接关闭并返回结果。 |
执行结果：脚本结束前会输出一行 [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 中调用
- 放置 Skill
将本 Skill 目录放在 OpenClaw 会加载的位置，例如： - 工作区：<workspace>/skills/baijiahao-publish/ - 或全局：~/.openclaw/skills/baijiahao-publish/
- 调用方式
- 自然语言：对助手说「用 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。
- 传参约定
- 说明 auth 路径时，助手应传 --auth <路径>（支持绝对路径）。 - 说明「存草稿」时传 --draft；说明「发布」时传 --publish。 - 说明「正文用某 md 文件」时传 --content-file <路径>；若 md 里含标题且希望截断，同时传 --title <标题> 与 --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。